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

Capacitor:

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

Android - Gradle:

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

iOS - CocoaPods:

s.dependency 'FPHISDKSelphiComponent', '~> $version'

Métodos disponíveis

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

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

Método startExtraction

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:

startExtraction(configuration: SelphiFaceConfiguration): Promise<SelphiFaceResult>;

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 {
  debug?: boolean;
  fullscreen?: boolean;
  cropPercent?: number;
  stabilizationMode?: boolean;
  templateRawOptimized?: boolean;
  resourcesPath?: string;
  enableGenerateTemplateRaw?: boolean;
  livenessMode?: SdkLivenessMode;
  showResultAfterCapture?: boolean;
  cameraFlashEnabled?: boolean;
  translationsContent?: string;
  viewsContent?: string;
  showTutorial?: boolean;
  cameraId?: number;
  videoFilename?: string;
  params?: any;
  qrMode?: boolean;
  showDiagnostic?: boolean;
  logImages?: boolean;
  compressFormat?: SdkCompressFormat;
  jpgQuality?: number;
  showPreviousTip?: boolean;
  vibrationEnabled?: boolean;
  extractionDuration?: SdkExtractionDuration;
  cameraPreferred?: SelphiCamera;
  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;
  errorType?: string;
  finishStatusDescription?: string;
  errorMessage?: string;
  bestImage?: string;
  bestImageCropped?: string;
  bestImageTemplateRaw?: string;
  qrData?: string;
  templateRaw?: string;
  images?: string[];
  livenessDiagnostic?: string;
}

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