> 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/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades.md).

# Propiedades

Estas propiedades permiten personalizar el comportamiento del flujo de captura de patrón facial.

## Constantes y tipado

Selphi ofrece tipos y constantes para facilitar su implementación en entornos tipados.

```javascript
import { CameraType, CameraPreferred, LivenessMode } from '@facephi/selphi-web-component'
```

En React, estos enums (`CameraPreferred` y `LivenessMode`, entre otros) también se exportan desde `@facephi/sdk-web-react`.

> **Recomendación:** Configura las propiedades mediante JavaScript, JSX o los bindings de tu framework (React, Vue, Angular, etc.). Evita la configuración HTML nativa con atributos (`nombre-atributo="valor"`), ya que puede perder el tipado y el formato esperado por el componente.

***

## Propiedades de configuración de Selphi Widget

#### Captura

* [maxAttempts](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/maxattempts.md): Número máximo de intentos de captura facial.
* [stabilization](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/stabilization.md): Activa la estabilización del rostro durante la captura.
* [timeout](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/timeout.md): Tiempo límite en milisegundos para capturar el rostro.

#### Extracción

* [cropFactor](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/cropfactor.md): Factor de ampliación del recorte facial.
* [imageFormat](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/imageformat.md): Formato de las imágenes devueltas por el widget.
* [imageQuality](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/imagequality.md): Nivel de compresión JPEG (0.0–1.0).
* [logImages](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/logimages.md): Devuelve las mejores imágenes usadas en la extracción.
* [templateFormat](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/templateformat.md): Formato de generación de la plantilla biométrica.
* [antispoof](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/antispoof.md): Activa la detección antifraude (anti-spoofing).
* [antispoofPayloadSize](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/antispoofpayloadsize.md): Tamaño del payload del antispoofing.

#### Cámara

* [cameraHeight](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/cameraheight.md): Resolución vertical preferida de la cámara.
* [cameraId](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/cameraid.md): Identificador de la cámara a utilizar.
* [cameraSwitch](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/cameraswitch.md): Muestra el botón para cambiar de cámara.
* [cameraType](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/cameratype.md): Tipo de cámara (frontal o trasera). **Recomendado:** `cameraPreferred`.
* [cameraWidth](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/camerawidth.md): Resolución horizontal preferida de la cámara.
* [externalCamera](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/externalcamera.md): Flujo de vídeo externo para la captura.
* [cameraRotation](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/camerarotation.md): Rotación aplicada a la imagen de la cámara.

#### Personalización

* [audible](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/audible.md): Activa la lectura de textos en voz alta.
* [disableExit](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/disableexit.md): Oculta el botón de cerrar el widget. **Recomendado:** `showExitButton`.
* [disableTutorial](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/disabletutorial.md): Desactiva el acceso al tutorial. **Recomendado:** `showTutorial`.
* [faceTracking](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/facetracking.md): Centra el rostro antes de la captura.
* [initialTip](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/initialtip.md): Muestra un consejo previo a la captura. **Recomendado:** `showPreviousTip`.
* [initialTipHeight](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/initialtipheight.md): Altura del tip inicial en píxeles.
* [initialTipWidth](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/initialtipwidth.md): Ancho del tip inicial en píxeles.
* [interactible](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/interactible.md): Requiere interacción del usuario para iniciar.
* [tipAnimations](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/tipanimations.md): Animaciones del tip inicial (mobile y desktop).
* [livenessMode](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/livenessmode.md): Modo de prueba de vida (liveness) del widget.
* [livenessMoveFailedAttempts](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/livenessmovefailedattempts.md): Intentos fallidos permitidos en liveness activo. **Recomendado:** `moveFailedAttempts`.
* [livenessMoveSteps](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/livenessmovesteps.md): Pasos requeridos en la prueba de vida activa. **Recomendado:** `moveSuccessfulAttempts`.
* [livenessMoveTimeout](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/livenessmovetimeout.md): Tiempo por paso del liveness activo (segundos).
* [loadingAnimation](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/loadinganimation.md): Ruta de la animación de carga personalizada.
* [logo](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/logo.md): Ruta del logo personalizado.
* [previewImage](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/previewimage.md): Muestra previsualización tras la captura. **Recomendado:** `showResultAfterCapture`.
* [tutorialAnimations](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/tutorialanimations.md): Animaciones personalizadas del tutorial.
* [tutorialModal](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/tutorialmodal.md): Muestra el tutorial en modo modal.

#### Configuración interna

* [advancedTracking](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/advancedtracking.md): Activa la generación de tracking avanzado.
* [androidWebViewBehaviour](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/androidwebviewbehaviour.md): Comportamiento en WebView de Android.
* [diagnosticTimer](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/diagnostictimer.md): Tiempo de diagnóstico en línea antes del error.
* [engineLocation](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/enginelocation.md): Ruta o CDN de los recursos del motor.
* [errorTimer](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/errortimer.md): Duración de las vistas de error terminal.
* [settingsStrictness](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/settingsstrictness.md): Muestra error si hay parámetros mal configurados.

#### Video grabación

* [enableVideoTimer](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/enablevideotimer.md): Muestra temporizador durante la grabación de vídeo.
* [videoRecord](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/videorecord.md): Activa la grabación de vídeo en la sesión.
* [videoRecordAudio](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/videorecordaudio.md): Graba audio en la grabación local.
* [videoRecordQuality](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/videorecordquality.md): Calidad de la grabación de vídeo.
* [videoRecordRate](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/videorecordrate.md): Frame rate de la grabación remota.
* [videoRecordType](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/videorecordtype.md): Tipo de grabación (local o remota).

#### Herramientas de desarrollador

* [debug](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/debug.md): Activa el modo de depuración en pantalla.
* [showLog](/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/showlog.md): Emite información detallada en consola.

***

## Compatibilidad y validación de propiedades

Algunas propiedades se han renombrado. El nombre legacy sigue siendo la página principal y operativo en esta versión, mientras que el nombre nuevo es el **recomendado**. Reglas de resolución:

* **Precedencia:** si defines a la vez el nombre legacy y el nuevo, gana el **nuevo** y se emite un aviso de precedencia en consola.
* **Solo legacy:** usar únicamente el nombre legacy emite un aviso de deprecación en consola. El nombre legacy se retirará en la próxima versión major.
* **Propiedad desconocida:** una propiedad no reconocida se **ignora en silencio** siempre.
* **Validación (**[**settingsStrictness**](/sdks/sdk-web/componentes/sdk-provider/propiedades/settingsstrictness.md)**, por defecto tolerante):** en modo tolerante un valor inválido se sustituye por su valor por defecto y se emite un aviso; en modo estricto detiene el SDK con un error bloqueante.