qr

Habilita a captura em dispositivos móveis por meio de Código QR no desktop.

Detalhes

Atributo: qr

Tipo: boolean

Valor por padrão: undefined

Morfologia

provider.qr = true;

Descrição

Habilita o fluxo de continuação no dispositivo móvel por meio de Código QR quando facephi-sdk-provider é usado no desktop. Ao ativá-lo, um Código QR é exibido no navegador de origem; ao escaneá-lo, a captura continua no dispositivo móvel enquanto o desktop informa o progresso.

O SDK determina automaticamente se a visualização é mobile ou desktop, sem configuração adicional.

Considerações

Componentes compatíveis: SelphID, Selphi, File Uploader e Video Provider.

Ao finalizar a captura no dispositivo móvel, chame o método stopQr para encerrar corretamente a sessão QR no desktop.

Você pode monitorar o progresso com emitTrackStatus.

As animações exibidas no desktop durante o fluxo QR são personalizadas com customAnimations (qr.selphi, qr.selphid, qr.fileUploader).

---

Exemplo

import { ComponentStatus, FacephiComponent } from '@facephi/sdk-web-wc';

<facephi-sdk-provider
    apikey={process.env.FACEPHI_SDK_APIKEY}
    customAnimations={{
        qr: {
            selphi: '/assets/anim/desktop-selphi.gif',
            selphid: '/assets/anim/desktop-selphid.gif',
            fileUploader: '/assets/anim/desktop-file-uploader.gif',
        },
    }}
    qr={true}
>
    <facephi-selphid-widget onExtractionFinish={handleExtractionFinish} />
</facephi-sdk-provider>

const provider = document.querySelector('facephi-sdk-provider');
const selphid = document.querySelector('facephi-selphid-widget');

async function handleExtractionFinish(event: CustomEvent) {
  const result = event.detail.detail;
  await provider.stopQr();
  sendResultsToBackend(result);
}

provider.addEventListener('emitTrackStatus', handleEmitTrackStatus);

function handleEmitTrackStatus(event: CustomEvent) {
  const trackStatus = event.detail;
  if (
    trackStatus.component === FacephiComponent.QrWidget
    && trackStatus.status === ComponentStatus.finish
  ) {
    continueAfterOnboarding();
  }
}