trackStatus

Alteração de estado interna 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: FacephiSelphidWidgetCustomEvent<TrackStatusEvent> | CustomEvent<TrackStatusEvent>

Sintaxe

selphid.addEventListener('trackStatus', onTrackStatus);

Objeto recebido

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

• eventType (string): Tipo de evento emitido.

• currentState (string) | tapButton (string) | retriesConsumed (number) | documentPresent (boolean): Chave dinâmica com o estado, a ação ou metadados de captura (somente as presentes em cada emissão).

Valores currentState:

Valor	Descrição
initializing	O motor do SelphID está sendo inicializado.
initEngine	Inicialização do motor em andamento.
ready	SelphID foi carregado e está pronto.
analyzing	A imagem atual está sendo analisada.
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.
repeatExtraction	Tentar captura novamente.
continueExtraction	Continuar extração.
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-selphid-widget
    onTrackStatus={(event) => {
      const detail = event.detail.detail;
      console.log('Track status:', detail);
    }}
/>

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

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