Guia de uso e integração

Apresenta as informações necessárias para uso e integração do biblioteca em aplicativos criados em React Native.

⚠️

Appkey em fluxos com Liveness 2D/3D + Doc Core

Cada appkey está associada a uma transação específica ou tem um prazo de expiração definido. Em fluxos que tenham apenas Liveness, a appkey não deve ser reutilizada.

Exceção: para os fluxos de trabalho que incluem Liveness 2D ou 3D e têm a etapa de Doc Core como próxima etapa, a appkey será reutilizada para realizar a análise do documento.

💡

Ambiente

Todos os módulos da biblioteca possuem o parâmetro de environment que indica o ambiente de execução desejado.

ValorDescrição
HMLAponta para o ambiente de homologação.
PRDAponta para o ambiente de produção.

1. Liveness 2D

Biblioteca responsável pelas views que iniciam o FaceCaptcha para prova de vida 2D e a DocCore para a leitura e reconhecimento de documentos com OCR.

1.1 Importação

Primeiro devemos importar a biblioteca e as views no início do documento.

import { DocumentsCopyView, Liveness2DView } from '@oiti/rn-liveness2d';

1.2. Componente do Liveness2D

Importe o componente Liveness2DView.

<Liveness2dView
   options={options}
   navigation={navigation}
	 loading={loading}
   callbackView="Home"
      /* CustomInstructionView={<InstructionsView  />} */
      /* CustomPermissionView={<PermissionView  />} */
   onSuccess={onSuccess} //  <--------
   onError={onError} // <---------- 
/>

1.2.1 Parâmetros

ParâmetroTipoDescrição
optionsArgsTypeChave gerada para execução dessa etapa.
navigationNavigationRecebe o contexto de navegação.
loadingApparenceTypeRecebe o objeto de customização do loadding.
callbackViewStringTela de retorno após o fim da jornada.
CustomInstructionViewFCComponente da Tela de Instruções.
CustomPermissionViewFCComponente da Tela de Permissões.
onSuccess(result) => voidFunção de retorno de sucesso.
onError(result) => voidFunção de retorno de erro.

1.2.2 Options Format

Formato do Objeto no parâmetro options:

{
   appkey:'SUA APPKEY',
   environment: 'HML',
   apparence: {
      backgroundColor: '#025951',
      loadingColor: '#0CF25D',
   }
}

1.3 Componente da Doc Core

Importe o componente DocumentsCopyView.

<DocumentsCopyView
   options={options}
   navigation={navigation}
   callbackView="Home"
      /* CustomInstructionView={<InstructionsView  />} */
      /* CustomPermissionView={<PermissionView  />} */
   onSuccess={onSuccess} //  <--------
   onError={onError} // <---------- 
/>
ParâmetroTipoDescrição
optionsArgsTypeChave gerada para execução dessa etapa.
navigationNavigationRecebe o contexto de navegação.
callbackViewStringTela de retorno após o fim da jornada.
CustomInstructionViewFCComponente da Tela de Instruções.
CustomPermissionViewFCComponente da Tela de Permissões.
onSuccess(result) => voidFunção de retorno de sucesso.
onError(result) => voidFunção de retorno de erro.

1.3.1 Construindo o options

Formato do Objeto no parâmetro options:

{
   appkey:'SUA APPKEY',
   ticket: 'SEU TICKET',
   environment: 'HML',
   nativeCustom: true,
   theme: {
      setCaptureInstructionGuideText: 'textGUIDE',
      setCaptureInstructionGuideBackgroundColor: '#DD0101',
      setCaptureInstructionGuideTextColor: '#4bb75f',
   }
}

1.3.2 Chaves do options

ParâmetroTipoDescrição
appkeystringIdentifica a App Key do cliente.
ticketstringIdentifica o ticket do cliente.
environmentstringIdentifica em qual ambiente está rodando o SDK. 'HML' ou 'PRD'
nativeCustombooleanAtiva as telas e a customização das telas iniciais de instruções e permissões nativa.
themeDocCustomTypeTela de retorno após o fim da jornada.

1.3.1 Parâmetros

📘

Parâmetros opcionais

O parâmetro theme e nativeCustom é opcional e esta relacionados a customização.

2. Liveness 3D

Biblioteca responsável pelas classes que iniciam o Liveness 3D para prova de vida tridimensional.

2.1. Importação

Primeiro devemos importar a biblioteca e as views no início do documento.

import { Liveness3dView } from '@oiti/rn-liveness3d';

2.2. Componente do Liveness 3D

Importe o componente DocumentsCopyView.

<Liveness3dView
   options={options}
	 loading={loading}
      /* CustomInstructionView={<InstructionsView navigation={navigation} />} */
      /* CustomPermissionView={<PermissionView navigation={navigation} />} */
   onSuccess={onSuccess} //  <--------
   onError={onError} // <---------- 
/>
ParâmetroTipoDescrição
optionsArgsTypeChave gerada para execução dessa etapa.
loadingLoadingTypePropiedades customizáveis da tela de loading.
CustomInstructionViewFCComponente da Tela de Instruções.
CustomPermissionViewFCComponente da Tela de Permissões.
onSuccess(result) => voidFunção de retorno de sucesso.
onError(result) => voidFunção de retorno de erro.

2.3 Construindo o options

Formato do Objeto no parâmetro options:

{
   appkey:'SUA APPKEY',
   environment: 'HML',
   liveness3Dtext: {
      READY_HEADER_1: 'Prepare-se para seu',
      READY_HEADER_2: 'reconhecimento facial.',
   }
  liveness3Dtheme: {
      guidanceCustomizationButtonBackgroundNormalColor = '#8e9334',
      ovalCustomizationStrokeColor = '#8e9334',
   }
}

2.4 Chaves do options

ParâmetroTipoDescrição
appkeyStringIdentifica a App Key do cliente.
environmentStringIdentifica em qual ambiente está rodando o SDK.
liveness3DtextObject?Customização de textos.
liveness3DthemeObject?Customização de cores e estilos.

📘

Parâmetros opcionais

Os parâmetros liveness3Dtext e liveness3Dtheme são opcionais e esta relacionados a customização.