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

# Propriedades

Essas propriedades permitem personalizar o comportamento do fluxo de captura de padrão facial.

## Constantes e tipagem

Selphi oferece tipos e constantes para facilitar sua implementação em ambientes tipados.

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

No React, esses enums (`CameraPreferred` e `LivenessMode`, entre outros) também são exportados de `@facephi/sdk-web-react`.

> **Recomendação:** Configure as propriedades por meio de JavaScript, JSX ou dos bindings do seu framework (React, Vue, Angular, etc.). Evite a configuração HTML nativa com atributos (`nombre-atributo="valor"`), pois isso pode fazer com que a tipagem e o formato esperados pelo componente sejam perdidos.

***

## Propriedades de configuração do Selphi Widget

#### Captura

* [maxAttempts](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/maxattempts.md): Número máximo de tentativas de captura facial.
* [stabilization](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/stabilization.md): Ativa a estabilização do rosto durante a captura.
* [timeout](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/timeout.md): Tempo limite em milissegundos para capturar o rosto.

#### Extração

* [cropFactor](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/cropfactor.md): Fator de ampliação do recorte facial.
* [imageFormat](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/imageformat.md): Formato das imagens retornadas pelo widget.
* [imageQuality](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/imagequality.md): Nível de compressão JPEG (0.0–1.0).
* [logImages](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/logimages.md): Retorna as melhores imagens usadas na extração.
* [templateFormat](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/templateformat.md): Formato de geração do Template Biométrico.
* [antispoof](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/antispoof.md): Ativa a detecção antifraude (anti-spoofing).
* [antispoofPayloadSize](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/antispoofpayloadsize.md): Tamanho do payload do antispoofing.

#### Câmera

* [cameraHeight](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/cameraheight.md): Resolução vertical preferida da câmera.
* [cameraId](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/cameraid.md): Identificador da câmera a ser utilizada.
* [cameraSwitch](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/cameraswitch.md): Mostra o botão para trocar de câmera.
* [cameraType](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/cameratype.md): Tipo de câmera (frontal ou traseira). **Recomendado:** `cameraPreferred`.
* [cameraWidth](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/camerawidth.md): Resolução horizontal preferida da câmera.
* [externalCamera](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/externalcamera.md): Fluxo de vídeo externo para a captura.
* [cameraRotation](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/camerarotation.md): Rotação aplicada à imagem da câmera.

#### Personalização

* [audible](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/audible.md): Ativa a leitura de textos em voz alta.
* [disableExit](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/disableexit.md): Oculta o botão de fechar o widget. **Recomendado:** `showExitButton`.
* [disableTutorial](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/disabletutorial.md): Desativa o acesso ao tutorial. **Recomendado:** `showTutorial`.
* [faceTracking](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/facetracking.md): Centraliza o rosto antes da captura.
* [initialTip](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/initialtip.md): Exibe uma dica antes da captura. **Recomendado:** `showPreviousTip`.
* [initialTipHeight](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/initialtipheight.md): Altura da dica inicial em pixels.
* [initialTipWidth](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/initialtipwidth.md): Largura da dica inicial em pixels.
* [interactible](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/interactible.md): Requer interação do usuário para iniciar.
* [tipAnimations](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/tipanimations.md): Animações da dica inicial (mobile e desktop).
* [livenessMode](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/livenessmode.md): Modo de teste de vida (liveness) do widget.
* [livenessMoveFailedAttempts](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/livenessmovefailedattempts.md): Tentativas falhas permitidas em Liveness Ativo. **Recomendado:** `moveFailedAttempts`.
* [livenessMoveSteps](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/livenessmovesteps.md): Passos requeridos no teste de vida ativo. **Recomendado:** `moveSuccessfulAttempts`.
* [livenessMoveTimeout](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/livenessmovetimeout.md): Tempo por passo do Liveness Ativo (segundos).
* [loadingAnimation](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/loadinganimation.md): Caminho da animação de carregamento personalizada.
* [logo](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/logo.md): Caminho do logo personalizado.
* [previewImage](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/previewimage.md): Mostra a pré-visualização após a captura. **Recomendado:** `showResultAfterCapture`.
* [tutorialAnimations](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/tutorialanimations.md): Animações personalizadas do tutorial.
* [tutorialModal](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/tutorialmodal.md): Mostra o tutorial em modo modal.

#### Configuração interna

* [advancedTracking](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/advancedtracking.md): Ativa a geração de tracking avançado.
* [androidWebViewBehaviour](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/androidwebviewbehaviour.md): Comportamento no WebView de Android.
* [diagnosticTimer](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/diagnostictimer.md): Tempo de diagnóstico on-line antes do erro.
* [engineLocation](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/enginelocation.md): Caminho ou CDN dos recursos do motor.
* [errorTimer](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/errortimer.md): Duração das telas de erro terminal.
* [settingsStrictness](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/settingsstrictness.md): Mostra erro se houver parâmetros mal configurados.

#### Gravação de Vídeo

* [enableVideoTimer](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/enablevideotimer.md): Mostra um cronômetro durante a gravação de vídeo.
* [videoRecord](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/videorecord.md): Ativa a gravação de vídeo na sessão.
* [videoRecordAudio](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/videorecordaudio.md): Grava áudio na gravação local.
* [videoRecordQuality](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/videorecordquality.md): Qualidade da gravação de vídeo.
* [videoRecordRate](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/videorecordrate.md): Taxa de quadros da gravação remota.
* [videoRecordType](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/videorecordtype.md): Tipo de gravação (local ou remota).

#### Ferramentas de desenvolvedor

* [debug](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/debug.md): Ativa o modo de depuração na tela.
* [showLog](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/showlog.md): Exibe informações detalhadas no console.

***

## Compatibilidade e validação de propriedades

Algumas propriedades foram renomeadas. O nome legado continua sendo o principal e funcional nesta versão, enquanto o novo nome é o **recomendado**. Regras de resolução:

* **Precedência:** se você definir ao mesmo tempo o nome legado e o novo, prevalece o **novo** e um aviso de precedência é emitido no console.
* **Somente legado:** usar apenas o nome legado emite um aviso de depreciação no console. O nome legado será removido na próxima versão major.
* **Propriedade desconhecida:** uma propriedade não reconhecida é **ignorada em silêncio** sempre.
* **Validação (**[**settingsStrictness**](/docs.facephi-pt-br/sdks/sdk-web/componentes/sdk-provider/propiedades/settingsstrictness.md)**, por padrão tolerante):** no modo tolerante, um valor inválido é substituído pelo seu valor padrão e um aviso é emitido; no modo estrito, ele interrompe o SDK com um erro bloqueante.