Componente principal

É o componente mais importante do SDK, pois contém as bibliotecas necessárias para que tudo funcione corretamente.

A instalação do Core Plugin é obrigatória, independentemente dos produtos que sejam necessários utilizar e do caso de uso que tenha sido definido. Contém funcionalidades básicas para o funcionamento do SDK, além de outras funcionalidades transversais e necessárias para os plugins auxiliares.

Dependências

Capacitor:

npm i @facephi/sdk-core-capacitor@<Versão>
npm run build
npx cap sync

Android - Gradle:

api "com.facephi.androidsdk:sdk:$version"
api "com.facephi.androidsdk:core:$version"
implementation "com.facephi.androidsdk:tracking_component:$version"

iOS - CocoaPods:

s.dependency 'FPHISDKMainComponent', '~> $version'
s.dependency 'FPHISDKTrackingComponent', '~> $version'
s.dependency 'FPHISDKLicensingComponent', '~> $version'
s.dependency 'FPHISDKTokenizeComponent', '~> $version'
s.dependency 'FPHISDKStatusComponent', '~> $version'

Métodos disponíveis

Este componente contém vários métodos que executam diferentes funcionalidades:

Método	Descrição
initSession	Controlador principal do componente, responsável por validar as licenças, entre outras coisas.
initOperation	Método encarregado de gerar uma nova operação. O ID dela é recuperado no objeto de resultado, parâmetro data.
getExtraData	O método getExtraData permite gerar os identificadores necessários para uma operação que deva continuar no Serviço de Validações da Facephi (Backend).
closeSession	Antes que a aplicação seja destruída, a sessão do SDK deverá ser encerrada para avisar à plataforma sobre sua finalização.

initSession

Antes de poder utilizar qualquer componente, a sessão do SDK deverá ser inicializada. Essa inicialização deve ser feita o mais cedo possível, preferencialmente no início da aplicação. Ao mesmo tempo, uma vez concluídas todas as operações com o SDK Mobile, a sessão também deverá ser encerrada.

É possível inicializar o componente atual de duas formas, dependendo de como você deseja injetar a licença.

O novo método de licenciamento permite gerenciar as licenças de forma transparente para o integrador. A licença pode ser injetada de duas maneiras:

• a. Obtendo a licença por meio de um serviço por meio de uma URL e API-KEY

• b. Injetando a licença diretamente como String

Em ambos os casos, o resultado será retornado por meio de uma Promise, a qual contém um objeto da classe CoreResult.

initSession(configuration: InitSessionConfiguration): Promise<CoreResult>;

Configuração básica

Para iniciar o componente atual, deverá ser criado um objeto InitSessionConfiguration que será a configuração do controlador do componente.

A configuração básica necessária é a seguinte:

export interface InitSessionConfiguration {
    license?: string;
    licenseUrl?: string;
    licenseApiKey?: string;
    enableTracking?: boolean;
    internalOptions?: Record<String, String>;
    enableDebugMode?: boolean;
    locale?: string;
}

Configuração avançada do componente

A seguir, estão detalhados todos os campos que fazem parte desta classe.

Configuração do Init Session

---

initOperation

Ao iniciar um processo ou fluxo, sempre deverá ser realizada a chamada ao método launchInitOperation

initOperation(configuration: InitOperationConfiguration): Promise<CoreResult>;

Configuração básica

Para iniciar o componente atual, deverá ser criado um objeto InitOperationConfiguration que será a configuração do controlador do componente.

A configuração básica necessária é a seguinte:

export interface InitOperationConfiguration {
    type: SdkOperationType;
    steps?: string[];
    customerId: string;
}

Configuração avançada do componente

A seguir, estão detalhados todos os campos que fazem parte desta classe.

Configuração do Init Operation

---

closeSession

Antes que a aplicação seja destruída, a sessão do SDK deverá ser encerrada para avisar à plataforma sobre sua finalização. Para isso, executa-se o seguinte trecho de código:

closeSession(): Promise<CoreResult>;

---

launchGetExtraData

O método getExtraData permite gerar os identificadores necessários para uma operação que deva continuar no Serviço de Validações da Facephi (Backend). Essa situação costuma ocorrer em casos nos quais, uma vez obtidas as informações necessárias na aplicação do cliente, seja necessário enviar essas informações a um determinado serviço para validação ou análise posterior. Caso os resultados desses processos precisem ser rastreados na Plataforma, ela deverá ser capaz de unificar a primeira parte do processo realizada no cliente com a última realizada no serviço, já que, no final, ambas fazem parte da mesma operação.

getExtraData(): Promise<CoreResult>;

Lançamento de IDV

O processo de IDV inicia um fluxo configurado na plataforma a partir do seu ID (flowID). Para isso, será necessário invocar dois métodos: initFlow + startFlow.

launchInitFlow

Neste método, será definida a configuração necessária. O ID do fluxo configurado na plataforma (flowID) e o ID do cliente (customerID). Veja o código:

initFlow = async (): Promise<CoreResult> => 
{
  const widgetConfig: InitFlowConfiguration = {
    flow: "f40c098c-a878-4976-aef1-xxxxxxx",
    customerId: CUSTOMER_ID
  };
  return SdkCore.initFlow(widgetConfig);
};

startFlow = async (): Promise<CoreResult> => 
{
  console.log('Launching startFlow...');
  return SdkCore.startFlow();
};

Para configurar o controlador de fluxos, será criada uma lista dos controladores dos componentes que participarão no processo, o que permite inicializá-los corretamente. A ordem em que forem definidos não é importante; o próprio fluxo indicará a ordem em que serão executados. Por exemplo:

• setSelphiFlow: Captura Facial

• setSelphidFlow: Captura de documentos

Código para o lançamento:

/* Os resultados são escutados implementando um addListener, com a chave 'core.flow' */
listener: any = SdkCore.addListener('core.flow', (response: any) => 
{
  console.log("core.flow:", response);
});

await this.coreService.initFlow().then(async (result: CoreResult) => 
{
  if (result.finishStatus == SdkFinishStatus.Ok)
  {
    await this.selphiFaceService.setSelphiFlow()
      .then((res: SelphiFaceResult) => console.log("setSelphiFlow res", res))
      .catch((err) => console.log("setSelphiFlow err", err));
      
    await this.selphidService.setSelphidFlow()
      .then((res: SelphIDResult) => console.log("setSelphidFlow res", res))
      .catch((err) => console.log("setSelphidFlow err", err));


    await this.coreService.startFlow()
      .then((res: CoreResult) => console.log("startFlow res", res))
      .catch((err) => console.log("startFlow err", err));
  }
}, 
(err: any) => console.log(err));

Recebimento do resultado

O lançamento de TODOS os métodos retornará as informações no formato CoreResult. Podendo-se diferenciar entre um lançamento correto e um incorreto:

export interface CoreResult {
    finishStatus: number;
    finishStatusDescription?: string;
    errorType: string;
    errorMessage?: string;
    data?: string;
}

Core Resultado