Resultados

Resultados ofrecidos por el componente Selphi Widget.

En esta página explicaremos las diferentes posibilidades para finalizar el proceso de captura del widget.

Cada detalle de cada evento (atributos, datos...) ha sido especificado en la página (evento).

Casos de éxito

Captura y extracción satisfactoria

En el momento en que se completa la captura de la plantilla biométrica, los resultados extraídos se ofrecerán en el evento extractionFinish (enlace).

Una vez que se emite este evento, la lógica para cargar la siguiente vista o widget debe implementarse adaptándose al contexto de la aplicación.

Hay un ejemplo:

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(extractionFinishDetail.extractionData.bestImage, extractionFinishDetail.extractionData.templateRaw);

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

---

Casos de error

Se recomienda controlar los posibles errores que puedan ocurrir al procesar los datos obtenidos para evitar mal funcionamiento interno, uso incorrecto del widget o ataques de fuerza bruta.

Códigos de error

El widget lanzará una excepción si ocurre cualquier error de uso o interno.

Las excepciones podrán ser de dos tipos:

• Excepción terminal: Error que se lanzará cuando el widget no puede continuar con su ejecución. Estos errores pueden darse en entornos o configuraciones erróneas.

• Excepción de extracción: Error que se lanzará durante el flujo de captura o extracción. Estos errores permiten reintentar el flujo del widget, ya que se deben a un uso incorrecto del widget por parte del usuario.

Error	Código	Descripción
Excepciones terminales
AndroidWebViewBehaviour	SPI_227	Error producido tras la ejecución del componente en un WebView en un entorno android.
UnknownInternalError	SPI_235	Error interno en el widget. Si el error persiste será necesario contactar con el equipo de soporte de Facephi
CameraHardwareError	SPI_204	Error producido durante el acceso a cámaras del dispositivo.
PermissionsDenied	SPI_201	Error generado al no permitir los permisos necesarios para la ejecución del widget.
CameraPermissionDenied	SPI_201	Error al no conceder los permisos para utilizar la(s) cámara(s) del dispositivo.
MicrophonePermissionDenied	SPI_218	Error al no conceder los permisos para utilizar el(los) mocrófono(s) del dispositivo.
SettingsError	SPI_219	Error producido por una configuración incorrecta.
BrowserApiNotCompatible	SPI_220	Error producido por un navegador no compatible.
SpoofingDetected	SPI_221	Error generado al detectar un ataque de inyección en el widget.
ActiveLivenessError	SPI_205	Error generado al fallar la prueba de vida activa en la ejecución del widget.
Excepciones de exracción
ErrorTimeout	SPI_001	Error generado al haber superado el límite de tiempo establecido para la extracción.
FaceNotFound	SPI_222	Error generado al no encontrar un rostro durante el proceso de captura.
EyesNotFound	SPI_223	Error generado al no detectar los ojos en el proceso de captura.
OccludedEyes	SPI_237	Error generado al reconocer los ojos tapados en el proceso de captura.
OccludedMouth	SPI_238	Error generado al reconocer la boca tapada en el proceso de captura.
DarkLightError	SPI_224	Error generado al detectar poca iluminación en el proceso de captura.
AngleExceeded	SPI_225	Error generado al detectar un angulo excesivo del rostro del usuario en el proceso de captura.
TooManyFaces	SPI_226	Error generado al detectar varios rostros en el proceso de captura.
NotStabilizedSunGlasses	SPI_223	Error generado al detectar gafas de son en el usuario en el proceso de captura.
NotStabilizedNoColor	SPI_224	Error generado al no detectar color en el proceso de captura.

---

Límite de tiempo excedido durante la captura de la plantilla biométrica

Con los eventos extractionTimeout(enlace) y timeoutErrorButtonClick(enlace) es posible controlar cuándo el usuario excede el tiempo asignado o los intentos utilizados.

Hay un ejemplo:

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++;
}

---

El usuario cierra el widget antes de la captura del documento

Este evento se emite cuando el usuario hace clic en el ícono de salir del widget para cancelar el proceso de extracción. Una vez que se presiona el botón, el widget se cerrará.

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();
}

---

Excepciones terminales durante el ciclo de vida del Widget

Este evento se emite cuando se detecta un mal funcionamiento del sistema. Se puede usar para identificar y filtrar diferentes tipos de errores encontrados durante el proceso 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);
}

---