Captura facial - Selphi

Versão: 2.3.X

Introdução

A Captura Facial é realizada com o Selphi Plugin.

Este componente é responsável por realizar a captura de uma selfie do usuário e pela posterior extração das características faciais mais importantes. Seus principais processos são:

• Gestão interna de câmeras e permissões.

• Assistente nos processos de captura do rosto do usuário.

• Geração dos modelos com as características faciais e da imagem do usuário.

---

Dependências

Cordova:

cordova plugin add @facephi/sdk-selphi-cordova@<versão>

Android - Gradle:

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

iOS - CocoaPods:

pod 'FPHISDKSelphiComponent', '~> $version'

Métodos disponíveis

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

Método	Descrição
launchSelphi	Controlador principal de Reconhecimento Facial

Método launchSelphi

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

Lançamento da Captura Facial:

exports.launchSelphi = function (cfg) {
    return new Promise((resolve, reject) => {
        var config = [];
        try {
            config = [{
                config: cfg
            }];
        } catch (e) {
            console.log(e);
        }

        exec(resolve, reject, 'SdkSelphi', 'launchSelphi', config);
    });
};

Configuração básica

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

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

export interface SelphiFaceConfiguration {
    resourcesPath: string;
    debug?: boolean;
    cropPercent?: boolean;
    stabilizationMode?: boolean;
    templateRawOptimized?: boolean;
    compressFormat?: SelphiCompressFormat;
    jpgQuality?: number;
    logImages?: boolean;
    livenessMode?: SelphiFaceLivenessMode;
    enableGenerateTemplateRaw?: boolean;
    showDiagnostic?: boolean;
    showTutorial?: boolean;
    showResultAfterCapture?: boolean;
    fullscreen?: boolean;
    qrMode?: boolean;
    translationsContent?: string;
    viewsContent?: string;
    cameraId?: number;
    params?: any;
    cameraFlashEnabled?: boolean;
    showPreviousTip?: boolean;
    extractionDuration?: SelphiExtractionDuration;
    cameraPreferred?: SelphiCamera;
    vibrationEnabled?: boolean;
    moveSuccessfulAttempts?: number;
    moveFailedAttempts?: number;   
}

Configuração avançada do componente

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

Selphi Configuração

---

Recebimento do resultado

O lançamento retornará as informações no formato SelphiFaceResult. Podendo diferenciar-se entre um lançamento correto e um incorreto:

export interface SelphiFaceResult {
    finishStatus: number;
    finishStatusDescription: string;
    errorType: string;
    errorMessage?: string;
    template?: string;
    templateRaw?: string;
    eyeGlassesScore?: number;
    templateScore?: number;
    qrData?: string;
    images?: [string];
    bestImage?: string;
    bestImageCropped?: string;
    livenessDiagnostic?: string;
    iad?: string;
}

Configuração avançada do componente

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

Selphi 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)

Selphi - Personalização do Componente