Propriedades
Propriedades de configuração do componente Selphi Widget.
Estas 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.
import { CameraType, CameraPreferred, LivenessMode } from '@facephi/selphi-web-component'No React, estes 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 ela pode perder a tipagem e o formato esperado pelo componente.
Propriedades de configuração do Selphi Widget
Captura
stabilization: Ativa a estabilização do rosto durante a captura.
Timeout: Tempo limite em milissegundos para capturar o rosto.
Extração
cropFactor: Fator de ampliação do recorte facial.
imageFormat: Formato das imagens retornadas pelo widget.
imageQuality: Nível de compressão JPEG (0.0–1.0).
logImages: Retorna as melhores imagens usadas na extração.
templateFormat: Formato de geração do Template Biométrico.
antispoof: Ativa a detecção antifraude (anti-spoofing).
antispoofPayloadSize: Tamanho do payload do antispoofing.
Câmera
cameraHeight: Resolução vertical preferida da câmera.
cameraId: Identificador da câmera a ser usada.
cameraSwitch: Exibe o botão para alternar de câmera.
cameraType: Tipo de câmera (frontal ou traseira). Recomendado:
cameraPreferred.cameraWidth: Resolução horizontal preferida da câmera.
externalCamera: Fluxo de vídeo externo para a captura.
cameraRotation: Rotação aplicada à imagem da câmera.
Personalização
audible: Ativa a leitura de textos em voz alta.
disableExit: Oculta o botão de fechar o Widget. Recomendado:
showExitButton.disableTutorial: Desativa o acesso ao tutorial. Recomendado:
showTutorial.faceTracking: Centraliza o rosto antes da captura.
initialTip: Exibe uma dica antes da captura. Recomendado:
showPreviousTip.initialTipHeight: Altura da dica inicial em pixels.
initialTipWidth: Largura da dica inicial em pixels.
interactible: Requer interação do usuário para iniciar.
tipAnimations: Animações da dica inicial (mobile e desktop).
livenessMode: Modo de teste de vida (liveness) do Widget.
livenessMoveFailedAttempts: Tentativas falhas permitidas em Liveness Ativo. Recomendado:
moveFailedAttempts.livenessMoveSteps: Etapas necessárias no teste de vida ativo. Recomendado:
moveSuccessfulAttempts.livenessMoveTimeout: Tempo por etapa do Liveness Ativo (segundos).
loadingAnimation: Caminho da animação de carregamento personalizada.
logo: Caminho do logotipo personalizado.
previewImage: Exibe pré-visualização após a captura. Recomendado:
showResultAfterCapture.tutorialAnimations: Animações personalizadas do tutorial.
tutorialModal: Exibe o tutorial em modo modal.
Configuração interna
advancedTracking: Ativa a geração de Tracking avançado.
androidWebViewBehaviour: Comportamento no WebView de Android.
diagnosticTimer: Tempo de diagnóstico online antes do erro.
engineLocation: Caminho ou CDN dos recursos do motor.
errorTimer: Duração das telas finais de erro.
settingsStrictness: Exibe erro se houver parâmetros configurados incorretamente.
Gravação de Vídeo
enableVideoTimer: Exibe um temporizador durante a Gravação de Vídeo.
videoRecord: Ativa a Gravação de Vídeo na sessão.
videoRecordAudio: Grava áudio na gravação local.
videoRecordQuality: Qualidade da Gravação de Vídeo.
videoRecordRate: Taxa de quadros da gravação remota.
videoRecordType: Tipo de gravação (local ou remota).
Ferramentas de desenvolvedor
Compatibilidade e validação de propriedades
Algumas propriedades foram renomeadas. O nome legacy 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 legacy e o novo, prevalece o novo e é emitido um aviso de precedência no console.
Somente legacy: usar apenas o nome legacy emite um aviso de depreciação no console. O nome legacy será removido na próxima versão major.
Propriedade desconhecida: uma propriedade não reconhecida se ignora silenciosamente sempre.
Validação (settingsStrictness, 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.
Atualizado