> 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/selphid-documentos/propiedades.md).

# Propiedades

Estas propiedades permiten personalizar el comportamiento del flujo de captura de documento.

## Constantes y tipado

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

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

En React, el enum `CameraPreferred` (entre otros) también se exporta 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 SelphID Widget

### Captura

* [allowUncertain](/sdks/sdk-web/componentes/selphid-documentos/propiedades/allowuncertain.md): Aumenta la permisividad en documentos no reconocidos.
* [allowUnknown](/sdks/sdk-web/componentes/selphid-documentos/propiedades/allowunknown.md): Permite capturar cualquier documento con fotografía.
* [barcode](/sdks/sdk-web/componentes/selphid-documentos/propiedades/barcode.md): Activa el lector de códigos de barras y QR.
* [barcodeSide](/sdks/sdk-web/componentes/selphid-documentos/propiedades/barcodeside.md): Lado del documento donde se lee el código.
* [blurredThreshold](/sdks/sdk-web/componentes/selphid-documentos/propiedades/blurredthreshold.md): Umbral de tolerancia al desenfoque.
* [captureRetries](/sdks/sdk-web/componentes/selphid-documentos/propiedades/captureretries.md): Número máximo de reintentos de captura.
* [captureTimeout](/sdks/sdk-web/componentes/selphid-documentos/propiedades/capturetimeout.md): Tiempo límite de captura por intento (segundos).
* [country](/sdks/sdk-web/componentes/selphid-documentos/propiedades/country.md): País del documento en ISO-2. **Deprecado:** usar `countryFilter`.
* [countryFilter](/sdks/sdk-web/componentes/selphid-documentos/propiedades/countryfilter.md): Países permitidos en ISO-2. **Recomendado:** `enabledCountries`.
* [documentType](/sdks/sdk-web/componentes/selphid-documentos/propiedades/documenttype.md): Tipos de documento admitidos en la captura.
* [expectedSides](/sdks/sdk-web/componentes/selphid-documentos/propiedades/expectedsides.md): Número de lados del documento a capturar.
* [maxAllowedMismatches](/sdks/sdk-web/componentes/selphid-documentos/propiedades/maxallowedmismatches.md): Errores OCR permitidos por palabra.
* [maxAttempts](/sdks/sdk-web/componentes/selphid-documentos/propiedades/maxattempts.md): Número máximo de intentos de captura del documento.
* [progressiveMismatches](/sdks/sdk-web/componentes/selphid-documentos/propiedades/progressivemismatches.md): Incremento de permisividad en cada reintento.
* [retryCurrentSide](/sdks/sdk-web/componentes/selphid-documentos/propiedades/retrycurrentside.md): Reintenta solo el lado actual del documento.
* [rules](/sdks/sdk-web/componentes/selphid-documentos/propiedades/rules.md): Reglas para filtrar la captura por país.

### Extracción

* [anonymizationMode](/sdks/sdk-web/componentes/selphid-documentos/propiedades/anonymizationmode.md): Modo de anonimización de datos extraídos.
* [capturePadding](/sdks/sdk-web/componentes/selphid-documentos/propiedades/capturepadding.md): Margen añadido a la imagen capturada.
* [cropFactor](/sdks/sdk-web/componentes/selphid-documentos/propiedades/cropfactor.md): Factor de escala del recorte del documento.
* [imageFormat](/sdks/sdk-web/componentes/selphid-documentos/propiedades/imageformat.md): Formato de las imágenes devueltas.
* [imageQuality](/sdks/sdk-web/componentes/selphid-documentos/propiedades/imagequality.md): Compresión JPEG (0.0–1.0).
* [tokenize](/sdks/sdk-web/componentes/selphid-documentos/propiedades/tokenize.md): Activa la tokenización de resultados.

### Cámara

* [cameraHeight](/sdks/sdk-web/componentes/selphid-documentos/propiedades/cameraheight.md): Resolución vertical preferida de la cámara.
* [cameraId](/sdks/sdk-web/componentes/selphid-documentos/propiedades/cameraid.md): Identificador de la cámara.
* [cameraSwitch](/sdks/sdk-web/componentes/selphid-documentos/propiedades/cameraswitch.md): Muestra el botón para cambiar de cámara.
* [cameraType](/sdks/sdk-web/componentes/selphid-documentos/propiedades/cameratype.md): Tipo de cámara (frontal o trasera). **Recomendado:** `cameraPreferred`.
* [cameraWidth](/sdks/sdk-web/componentes/selphid-documentos/propiedades/camerawidth.md): Resolución horizontal preferida de la cámara.
* [dpi](/sdks/sdk-web/componentes/selphid-documentos/propiedades/dpi.md): DPI de las imágenes extraídas.
* [externalCamera](/sdks/sdk-web/componentes/selphid-documentos/propiedades/externalcamera.md): Flujo de vídeo externo para la captura.

### Personalización

* [audible](/sdks/sdk-web/componentes/selphid-documentos/propiedades/audible.md): Activa la lectura de textos en voz alta.
* [cameraOverflow](/sdks/sdk-web/componentes/selphid-documentos/propiedades/cameraoverflow.md): Muestra toda la imagen de la cámara como fondo.
* [chooseDocument](/sdks/sdk-web/componentes/selphid-documentos/propiedades/choosedocument.md): Activa la selección de documento previa. **Recomendado:** `showDocumentSelector`.
* [disableExit](/sdks/sdk-web/componentes/selphid-documentos/propiedades/disableexit.md): Oculta el botón de cerrar el widget. **Recomendado:** `showExitButton`.
* [disableTutorial](/sdks/sdk-web/componentes/selphid-documentos/propiedades/disabletutorial.md): Desactiva el acceso al tutorial. **Recomendado:** `showTutorial`.
* [enableDocumentFlip](/sdks/sdk-web/componentes/selphid-documentos/propiedades/enabledocumentflip.md): Activa la animación de giro de documento.
* [initialTip](/sdks/sdk-web/componentes/selphid-documentos/propiedades/initialtip.md): Muestra un consejo previo a la captura. **Recomendado:** `showPreviousTip`.
* [initialTipHeight](/sdks/sdk-web/componentes/selphid-documentos/propiedades/initialtipheight.md): Altura del tip inicial en píxeles.
* [initialTipWidth](/sdks/sdk-web/componentes/selphid-documentos/propiedades/initialtipwidth.md): Ancho del tip inicial en píxeles.
* [tipAnimations](/sdks/sdk-web/componentes/selphid-documentos/propiedades/tipanimations.md): Animaciones del tip inicial (mobile y desktop).
* [loadingAnimation](/sdks/sdk-web/componentes/selphid-documentos/propiedades/loadinganimation.md): Ruta de la animación de carga.
* [logo](/sdks/sdk-web/componentes/selphid-documentos/propiedades/logo.md): Ruta del logo personalizado.
* [previewImage](/sdks/sdk-web/componentes/selphid-documentos/propiedades/previewimage.md): Muestra previsualización tras la captura. **Recomendado:** `showResultAfterCapture`.
* [tutorialAnimations](/sdks/sdk-web/componentes/selphid-documentos/propiedades/tutorialanimations.md): Animaciones personalizadas del tutorial.
* [tutorialModal](/sdks/sdk-web/componentes/selphid-documentos/propiedades/tutorialmodal.md): Muestra el tutorial en modo modal.

### Configuración interna

* [advancedTracking](/sdks/sdk-web/componentes/selphid-documentos/propiedades/advancedtracking.md): Activa la generación de tracking avanzado.
* [androidWebViewBehaviour](/sdks/sdk-web/componentes/selphid-documentos/propiedades/androidwebviewbehaviour.md): Comportamiento en WebView de Android.
* [engineFallback](/sdks/sdk-web/componentes/selphid-documentos/propiedades/enginefallback.md): Habilita el motor secundario.
* [engineLocation](/sdks/sdk-web/componentes/selphid-documentos/propiedades/enginelocation.md): Ruta o CDN de los recursos del motor.
* [errorTimer](/sdks/sdk-web/componentes/selphid-documentos/propiedades/errortimer.md): Duración de las vistas de error terminal.
* [settingsStrictness](/sdks/sdk-web/componentes/selphid-documentos/propiedades/settingsstrictness.md): Muestra error si hay parámetros mal configurados.

### Video grabación

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

### Herramientas de desarrollador

* [debug](/sdks/sdk-web/componentes/selphid-documentos/propiedades/debug.md): Activa el modo de depuración en pantalla.
* [showLog](/sdks/sdk-web/componentes/selphid-documentos/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.