For the complete documentation index, see llms.txt. This page is also available as Markdown.

Propriedades

Propriedades de configuração do componente SelphID Widget.

Essas propriedades permitem personalizar o comportamento do fluxo de captura de documento.

Constantes e tipagem

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

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

No React, o enum CameraPreferred (entre outros) também é exportado por @facephi/sdk-web-react.

Recomendação: Configure as propriedades usando JavaScript, JSX ou os 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 o componente perca a tipagem e o formato esperado.


Propriedades de configuração do SelphID Widget

Captura

Extração

Câmera

  • cameraHeight: Resolução vertical preferida da câmera.

  • cameraId: Identificador da câmera.

  • cameraSwitch: Exibe o botão para trocar de câmera.

  • cameraType: Tipo de câmera (frontal ou traseira). Recomendado: cameraPreferred.

  • cameraWidth: Resolução horizontal preferida da câmera.

  • dpi: DPI das imagens extraídas.

  • externalCamera: Fluxo de vídeo externo para a captura.

Personalização

Configuração interna

Gravação de Vídeo

Ferramentas do desenvolvedor

  • Debug: Ativa o modo de depuração na tela.

  • showLog: Emite informações detalhadas no console.


Compatibilidade e validação de propriedades

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

  • Precedência: se você definir tanto o nome legado quanto o novo, prevalece o novo e um aviso de precedência é exibido no console.

  • Somente legado: usar apenas o nome legado exibe um aviso de descontinuação no console. O nome legado será removido na próxima versão principal.

  • Propriedade desconhecida: uma propriedade não reconhecida é ignorada silenciosamente sempre.

  • Validação (settingsStrictness, tolerante por padrão): no modo tolerante, um valor inválido é substituído pelo valor padrão e um aviso é exibido; no modo estrito, o SDK é interrompido com um erro bloqueante.

Atualizado