Captura de documentos - SelphID

A captura de documentos é feita com o SelphID Plugin.

Este componente é responsável por realizar capturas de documentos de identidade e pela análise dos dados obtidos. Seus principais processos são:

• Gerenciamento interno de câmeras e permissões.

• Assistente nos processos de captura da parte frontal e traseira do documento.

• Extração das informações contidas no documento.

• Obtenção das imagens do verso e do reverso do documento, assim como outras imagens incluídas no documento: rosto do usuário, assinatura do usuário,...

• Alto nível de configuração: diferentes países, idiomas, tipos de documentos...

---

Dependências

Capacitor:

npm install @facephi/sdk-selphid-capacitor@<versão>
npm run build
npx cap sync

Android - Gradle:

implementation "com.facephi.androidsdk:selphid_component:$version"

iOS - CocoaPods:

pod 'FPHISDKSelphIDComponent', '~> $version'

Métodos disponíveis

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

Método	Descrição
launchSelphID	Controlador principal de captura de documentos

Método startCapture

Uma vez iniciado o SDK e criada uma nova operação, o componente poderá ser lançado. Será possível usar qualquer um de seus controladores para executar sua funcionalidade.

Lançamento da captura facial:

startCapture(configuration: SelphIDConfiguration): Promise<SelphIDResult>;

Configuração básica

Para lançar o componente atual, será necessário criar um objeto SelphIDConfiguration que será a configuração do controlador do componente.

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

export interface SelphIDConfiguration 
{
    wizardMode?: boolean;
    documentSide: SelphIDDocumentSide;
    resourcesPath: string;
    debug?: boolean;
    showResultAfterCapture?: boolean;
    showTutorial?: boolean;
    tutorialOnly?: boolean;
    scanMode?: SelphIDScanMode;
    specificData?: string;
    fullscreen?: number;
    tokenImageQuality?: number;
    documentType?: SelphIDDocumentType;
    timeout?: SelphIDTimeout;
    tokenPrevCaptureData?: string;
    generateRawImages?: boolean;
    imageQuality?: number;
    compressFormat?: SelphIDCompressFormat;
    documentModels?: string;
    params?: any;
    showDiagnostic?: boolean;
    cameraId?: number;
    translationsContent?: string;
    viewsContent?: string;
    showPreviousTip?: boolean;
    vibrationEnabled?: boolean;
}

Configuração avançada do componente

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

SelphID Configuração

---

Recebimento do resultado

A inicialização retornará as informações no formato SelphIDResult. Podendo diferenciar entre uma inicialização correta e uma incorreta:

export interface SelphIDResult 
{
    finishStatus: number;
    finishStatusDescription: string;
    errorType: string;
    errorMessage?: string;
    frontDocumentImage?: string;
    backDocumentImage?: string;
    faceImage?: string;
    signatureImage?: string;
    fingerprintImage?: string;
    documentData?: string;
    tokenFrontDocument?: string;
    tokenBackDocument?: string;
    tokenFaceImage?: string;
    tokenOCR?: string;
    documentCaptured?: string;
    captureProgress: number;
    matchingSidesScore: number;
    rawFrontDocument?: string;
    rawBackDocument?: string;
    tokenRawFrontDocument?: string;
    tokenRawBackDocument?: string;
    lastActionBeforeCapture?: string;
}

Configuração avançada do componente

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

Selphid Resultado

Personalização do componente

Além das alterações que podem ser feitas no nível do SDK (as quais são explicadas no documento de Configurações avançadas), este componente específico permite sua própria personalização.

Selphid - Personalização do Componente