Captura Facial - Selphi

A captura facial é realizada com o componente Selphi.

A captura facial é realizada com o Selphi Component.

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:

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

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

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

---

Dependências

Flutter:

dependencies:
  fphi_sdkmobile_selphi:
    hosted:
      name: fphi_sdkmobile_selphi
      url: https://facephicorp.jfrog.io/artifactory/api/pub/pub-pro-fphi/
    version: ^<versão>

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
startSelphiFaceWidget	Controlador principal de Reconhecimento Facial

Método startSelphiFaceWidget

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:

@override
Future<Map> startSelphiFaceWidget({
  required String resourcesPath,
  required SelphiFaceConfiguration widgetConfigurationJSON
}) async {
  final Map result = await methodChannel.invokeMethod('selphi',
      {"resourcesPath": resourcesPath, "widgetConfigurationJSON": widgetConfigurationJSON.toJson()}
  );
  return result;
}

Configuração básica

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

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

class SelphiFaceConfiguration {
  bool? mDebug;
  bool? mFullscreen;
  bool? mLogImages;
  bool? mStabilizationMode;
  bool? mTemplateRawOptimized;
  bool? mQRMode;
  bool? mShowResultAfterCapture;
  bool? mShowDiagnostic;
  bool? mShowTutorial;
  bool? mShowPreviousTip;
  bool? mVibrationEnabled;
  bool mEnableGenerateTemplateRaw;
  double mCropPercent;
  double mJPGQuality;
  String? mTranslationsContent;
  String? mViewsContent;
  String? mVideoFilename;
  int? mCameraId;
  int? mMoveSuccessfulAttempts;
  int? mMoveFailedAttempts;
  dynamic mParams;
  SelphiFaceLivenessMode? mLivenessMode;
  SelphiCompressFormat mCompressFormat;
  SelphiFaceExtractionDuration? mExtractionDuration;
  SelphiCamera mCameraPreferred;   
}

Configuração avançada do componente

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

Selphi Configuração

---

Recebimento do resultado

A execução retornará as informações no formato SelphiFaceResult. Sendo possível diferenciar entre uma execução correta e uma incorreta:

class SelphiFaceResult {
  final SdkFinishStatus finishStatus;
  final String finishStatusDescription;
  final String errorDiagnostic;
  final String? errorMessage;
  final String? templateRaw;
  final String? qrData;
  final String? bestImage;
  final String? bestImageCropped;
  final String? bestImageTemplateRaw;
  final String? livenessDiagnostic;
  final dynamic images;
}

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), este componente específico permite sua própria personalização.

Selphi - Personalização do Componente