> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/docs.facephi-pt-br/sdks/sdk-web/componentes/sdk-provider/propiedades/qr.md).

# qr

## Detalhes

**Atributo:** `qr`

**Tipo:** `boolean`

**Valor por padrão:** `undefined`

## Morfologia

```typescript
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](/docs.facephi-pt-br/sdks/sdk-web/componentes/sdk-provider/metodos/stopqr.md) para encerrar corretamente a sessão QR no desktop.

Você pode monitorar o progresso com [emitTrackStatus](/docs.facephi-pt-br/sdks/sdk-web/componentes/sdk-provider/eventos/emittrackstatus.md).

As animações exibidas no desktop durante o fluxo QR são personalizadas com [customAnimations](/docs.facephi-pt-br/sdks/sdk-web/componentes/sdk-provider/propiedades/customanimations.md) (`qr.selphi`, `qr.selphid`, `qr.fileUploader`).

***

## Exemplo

```jsx
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>
```

```typescript
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();
  }
}
```
