trackStatus

Mudança de status interno durante a captura.

Detalhes

É emitido após ações do usuário ou mudanças de estado durante o Fluxo de captura.

Evento: trackStatus

Tipo: FacephiSelphiWidgetCustomEvent<TrackStatusEvent> | CustomEvent<TrackStatusEvent>

Sintaxe

selphi.addEventListener('trackStatus', onTrackStatus);

Objeto recebido

O payload útil é do tipo SelphiTrackStatusDetail e está em event.detail.detail:

• eventType (string): Tipo de evento emitido.

• currentState (string) | tapButton (string): Chave dinâmica com o estado ou a ação (apenas uma presente por emissão).

Valores currentState:

Valor	Descrição
initializing	O motor de Selphi está sendo inicializado.
ready	Selphi foi carregado e está pronto.
liveness	O teste de vida ativo foi iniciado.
analyzing	O processo de captura foi iniciado.
previewImage	A pré-visualização da captura é exibida.
resetting	O motor interno está sendo reiniciado.
fim	A captura foi finalizada.
error	Ocorreu um erro no Fluxo.
end	A extração foi finalizada.

Valores tapButton:

Valor	Descrição
tutorial	Botão de tutorial pressionado.
exit	Botão de fechar pressionado.
startCapture	Início da captura.
repeatExtraction	Tentar captura novamente.
finishExtraction	Finalizar extração.
retryExtraction	Tentar extração novamente.
switchCamera	Troca de câmera.
back	Voltar atrás.

Descrição

Permite rastrear as ações do usuário e as mudanças de estado internas do Widget.

Considerações

O payload útil está em event.detail.detail (veja formato de eventos).

---

Exemplo

<facephi-selphi-widget
    onTrackStatus={(event) => {
      const detail = event.detail.detail;
      console.log('Track status:', detail);
    }}
/>

import { type SelphiTrackStatusDetail } from '@facephi/sdk-web-wc';

selphi.addEventListener('trackStatus', (event) => {
  const detail: SelphiTrackStatusDetail = event.detail.detail;
});