Resultados

Resultados oferecidos pelo componente Selphi Widget.

Nesta página, explicaremos as diferentes possibilidades para finalizar o processo de captura do widget.

Cada detalhe de cada evento (atributos, dados...) foi especificado na página (Eventos).

Casos de sucesso

Captura e extração bem-sucedida

No momento em que a captura do Template Biométrico é concluída, os resultados extraídos serão disponibilizados no evento extractionFinish (link).

Uma vez que este evento é emitido, a lógica para carregar a próxima tela ou widget deve ser implementada de acordo com o contexto da aplicação.

Há um exemplo:

import { type ExtractionFinishEvent } from "@facephi/selphi-web-component";

const selphiWidget = document.querySelector('facephi-selphi-widget');
selphiWidget.addEventListener('extractionFinish', onExtractionFinish);

function onExtractionFinish(event: CustomEvent<ExtractionFinishEvent>) {
  const result = event.detail.detail;
  console.log('extractionFinish:', result);

  // Procesar los resultados en el backend
  saveResults(result.extractionData.bestImage, result.extractionData.templateRaw);

  // Cargar el siguiente widget o vista
  loadNextView();
}

---

Casos de erro

Recomenda-se controlar os possíveis erros que possam ocorrer ao processar os dados obtidos para evitar mau funcionamento interno, uso incorreto do widget ou ataques de força bruta.

Códigos de erro

O widget lançará uma exceção se ocorrer qualquer erro de uso ou interno.

As exceções poderão ser de dois tipos:

• Exceção terminal: erro que será lançado quando o widget não puder continuar sua execução. Esses erros podem ocorrer em ambientes ou configurações incorretas.

• Exceção de extração: erro que será lançado durante o fluxo de captura ou extração. Esses erros permitem reintentar o fluxo do widget, já que se devem a um uso incorreto do widget por parte do usuário.

Erro	Código	Descrição
Exceções terminais
AndroidWebViewBehaviour	SPI_227	Erro produzido após a execução do componente em um WebView em um ambiente Android.
UnknownInternalError	SPI_235	Erro interno no widget. Se o erro persistir será necessário entrar em contato com a equipe de suporte da Facephi
CameraHardwareError	SPI_204	Erro produzido durante o acesso às câmeras do dispositivo.
PermissionsDenied	SPI_242	Erro gerado ao não permitir as permissões necessárias para a execução do widget.
CameraPermissionDenied	SPI_201	Erro ao não conceder as permissões para utilizar a(s) câmera(s) do dispositivo.
MicrophonePermissionDenied	SPI_218	Erro ao não conceder as permissões para utilizar o(s) microfone(s) do dispositivo.
SettingsError	SPI_219	Erro produzido por uma configuração incorreta.
BrowserApiNotCompatible	SPI_220	Erro produzido por um navegador não compatível.
SpoofingDetected	SPI_221	Erro gerado ao detectar um ataque de injeção no widget.
ActiveLivenessError	SPI_205	Erro gerado ao falhar no teste de vida ativa na execução do widget.
Exceções de extração
ErrorTimeout	SPI_001	Erro gerado ao ter ultrapassado o limite de tempo estabelecido para a extração.
FaceNotFound	SPI_222	Erro gerado ao não encontrar um rosto durante o processo de captura.
EyesNotFound	SPI_223	Erro gerado ao não detectar os olhos no processo de captura.
OccludedEyes	SPI_237	Erro gerado ao reconhecer os olhos cobertos no processo de captura.
OccludedMouth	SPI_238	Erro gerado ao reconhecer a boca coberta no processo de captura.
DarkLightError	SPI_224	Erro gerado ao detectar pouca iluminação no processo de captura.
AngleExceeded	SPI_225	Erro gerado ao detectar um ângulo excessivo do rosto do usuário no processo de captura.
TooManyFaces	SPI_226	Erro gerado ao detectar vários rostos no processo de captura.
NotStabilizedSunGlasses	SPI_223	Erro gerado ao detectar óculos de sol no usuário no processo de captura.
NotStabilizedNoColor	SPI_224	Erro gerado ao não detectar cor no processo de captura.

---

Límite de tempo excedido durante a captura do Template Biométrico

Com os eventos extractionTimeout (link) e timeoutErrorButtonClick (link) é possível controlar quando o usuário excede o tempo atribuído ou as tentativas utilizadas.

Há um exemplo:

import { type ExtractionTimeoutEvent, type TimeoutButtonClickEvent } from "@facephi/selphi-web-component";

const selphiWidget = document.querySelector('facephi-selphi-widget');
selphiWidget.addEventListener('extractionTimeout', onErrorTimeout);
selphiWidget.addEventListener('timeoutErrorButtonClick', onTimeoutButtonClick);
let userRetries = 0;

// El usuario no ha completado la extracción del patrón facial dentro del tiempo permitido
const onExtractionTimeout = (event: CustomEvent<ExtractionTimeoutEvent>) => {
  if (userRetries >= 3) {
    // Redirigir al usuario a una vista de error
    showRetriesExceededView();
  }
}

// El usuario ha hecho clic en el botón para reintentar la extracción en la vista de tiempo de espera del widget
const onTimeoutButtonClick = (event: CustomEvent<TimeoutButtonClickEvent>) => {
  userRetries++;
}

---

O usuário fecha o widget antes da captura do documento

Este evento é emitido quando o usuário clica no ícone de sair do widget para cancelar o processo de extração. Uma vez que o botão é pressionado, o widget será fechado.

Ejemplo de código

import { type UserCancelEvent } from "@facephi/selphi-web-component";
  
const selphiWidget = document.querySelector('facephi-selphi-widget');
selphiWidget.addEventListener('userCancel', handleUserCancel);

// El usuario ha hecho clic en el ícono de salir del widget para cancelar el proceso de extracción
function handleUserCancel(event: CustomEvent<UserCancelEvent>) {
  // Redirigir al usuario a la página principal del sitio web
  goLandingPage();
}

---

Exceções terminais durante o ciclo de vida do Widget

Este evento é emitido quando uma falha do sistema é detectada. Pode ser usado para identificar e filtrar diferentes tipos de erros encontrados durante o processo de captura.

Ejemplo de código:

import { type ExceptionCapturedEvent, type ErrorTimeoutEvent } from "@facephi/selphi-web-component";

const selphiWidget = document.querySelector('facephi-selphi-widget');
selphiWidget.addEventListener('exceptionCaptured', handleExceptionCaptured);
selphiWidget.addEventListener('errorTimeout', handleErrorTimeout);

// Se detecta un mal funcionamiento y el widget se ha detenido
function handleExceptionCaptured(event: CustomEvent<ExceptionCapturedEvent>) {
  const exceptionDetail = event.detail.detail;
  console.error('Widget Exception:', exceptionDetail.exceptionType);
}

// Se ha alcanzado el tiempo establecido en la propiedad `errorTimeout`
function handleErrorTimeout(event: CustomEvent<ErrorTimeoutEvent>) {
  const errorTimeoutDetail = event.detail.detail;
  // Redirigir al usuario a una vista de error
  showErrorView(errorTimeoutDetail.exceptionType);
}

---