> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/productos/idv-suite/flujos-and-integraciones/configuracion-tecnica-del-cliente/sdk-mobile/android-sdk/componentes-modulos/captura-facial.md).

# Captura facial

## Introducción <a href="#id-1-introduccion" id="id-1-introduccion"></a>

La captura facial se realiza mediante el **Selphi Component**.

Este componente se encarga de capturar un selfie del usuario y extraer sus características faciales más relevantes. Durante el proceso se realizan, entre otros, los siguientes pasos:

* Gestión interna de cámaras y permisos.
* Asistencia guiada durante la captura facial.
* Generación de plantillas biométricas e imágenes del usuario.

***

## Dependencia <a href="#id-2-dependencia" id="id-2-dependencia"></a>

La dependencia específica del componente es:

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

***

## Controladores disponibles

Este componente incluye varios controladores, cada uno orientado a una funcionalidad concreta.

| Controlador         | Descripción                                    |
| ------------------- | ---------------------------------------------- |
| `FSelphiController` | Controlador principal de reconocimiento facial |

***

## Recepción de errores de captura facial <a href="#id-6-recepcion-del-resultado" id="id-6-recepcion-del-resultado"></a>

Los errores se devolverán como un objeto 'SelphiError'.

<details>

<summary>Listado de errores de captura facial:</summary>

* SPI\_ACTIVITY\_RESULT\_ERROR: El resultado de la actividad es incorrecto.
* SPI\_ACTIVITY\_RESULT\_MSG\_ERROR: El resultado de la actividad recibido en el msg es incorrecto.
* SPI\_APPLICATION\_CONTEXT\_ERROR: El contexto de aplicación necesario es nulo.
* SPI\_BAD\_EXTRACTOR\_CONFIGURATION\_ERROR: Widget: Configuración del extractor incorrecta.
* SPI\_CAMERA\_PERMISSION\_DENIED: El usuario ha rechazado los permisos.
* SPI\_CANCEL\_BY\_USER: El usuario ha cancelado el proceso.
* SPI\_CANCEL\_LAUNCH: Se ha hecho una cancelación general del SDK.
* SPI\_COMPONENT\_LICENSE\_ERROR: La licencia del componente no es correcta.
* SPI\_CONTROL\_NOT\_INITIALIZATED\_ERROR: Widget: Error de inicialización.
* SPI\_EMPTY\_LICENSE: El String de licencia está vacío.
* SPI\_EXTRACTION\_LICENSE\_ERROR: Widget: Error de licencia.
* SPI\_FETCH\_DATA\_ERROR: Error en la recogida del resultado.
* SPI\_FLOW\_ERROR: Error en el proceso de flow.
* SPI\_HARDWARE\_ERROR: Widget: Error de hardware.
* SPI\_INITIALIZATION\_ERROR: Error de inicialización.
* SPI\_MANAGER\_NOT\_INITIALIZED: Los managers son nulos.
* SPI\_NO\_DATA\_ERROR: Los datos de entrada son nulos.
* SPI\_OPERATION\_NOT\_CREATED: No hay ninguna operación en curso.
* SPI\_RESOURCES\_NOT\_FOUND: No se ha encontrado el zip de recursos.
* SPI\_SETTINGS\_PERMISSION\_ERROR: Widget: Error de permisos.
* SPI\_TEMPLATE\_ERROR:
* SPI\_TIMEOUT: Timeout en el proceso.
* SPI\_UNEXPECTED\_CAPTURE\_ERROR: Widget: Error en la captura.
* SPI\_UNKNOWN\_ERROR: Error desconocido.
* SPI\_WIDGET\_RESULT\_DATA\_ERROR: Error en los datos de salida del widget.

</details>
