> 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/selphi-biometria-facial/eventos/stabilizing.md).

# stabilizing

## Detalhes

É emitido em cada frame enquanto o processo de estabilização está ativo.

**Evento:** `stabilizing`

**Tipo:** `FacephiSelphiWidgetCustomEvent<StabilizingEvent>` | `CustomEvent<StabilizingEvent>`

### Sintaxe

```typescript
selphi.addEventListener('stabilizing', onStabilizing);
```

### Objeto recebido

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

* `eventType` (`string`): Tipo de evento emitido.
* `diagnostic` (`number`): Código de estabilização do frame atual.

**Códigos de estabilização `diagnostic`**:

| Id   | Nome                           | Descrição                                               |
| ---- | ------------------------------ | ------------------------------------------------------- |
| `1`  | Ok                             | Fase de estabilização concluída.                        |
| `2`  | NotStabilized                  | O usuário deve permanecer estático e de frente.         |
| `3`  | NotStabilizedTooFar            | O usuário deve estar na zona predefinida.               |
| `4`  | NotStabilizedSunGlasses        | Oclusões no rosto impedem a detecção.                   |
| `5`  | NotStabilizedTooClose          | O usuário deve se afastar para evitar distorção óptica. |
| `6`  | NotStabilizedTooMovement       | O usuário não permanece estático.                       |
| `8`  | NotStabilizedNoFrontal         | Rosto não centralizado (postura incorreta genérica).    |
| `9`  | NotStabilizedNoFrontalTooLeft  | Rosto girado demais para a esquerda.                    |
| `10` | NotStabilizedNoFrontalTooRight | Rosto girado demais para a direita.                     |
| `11` | NotStabilizedNoFrontalTooDown  | Rosto inclinado demais para baixo.                      |
| `12` | NotStabilizedNoFrontalTooUp    | Rosto inclinado demais para cima.                       |
| `13` | NoStabilizedNoColor            | Imagem colorida com cor insuficiente.                   |
| `14` | NotStabilizedLowQuality        | Baixa qualidade da imagem.                              |
| `15` | NotStabilizedLowFaceQuality    | Baixa qualidade do rosto.                               |
| `16` | NotStabilizedLowPatternQuality | Padrão deficiente.                                      |
| `17` | OkGlasses                      | Estabilização concluída com óculos.                     |
| `18` | NotStabilizedInvalidResolution | Resolução inválida (esperados 720 ou 480).              |
| `19` | NotStabilizedMask              | Não passa na estabilização devido ao uso de máscara.    |

## Descrição

Informa o resultado de cada tentativa de estabilização. Quando o widget retorna `Ok` u `OkGlasses`, avance para a próxima etapa antes da extração.

### Considerações

Só é emitido se [stabilization](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/stabilization.md) estiver habilitado. O payload útil está em `event.detail.detail` (veja [formato de eventos](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/eventos.md#formato-de-los-eventos)).

***

## Exemplo

```jsx
<facephi-selphi-widget
    onStabilizing={(event) => {
      const { diagnostic } = event.detail.detail;
      console.log('Stabilizing diagnostic:', diagnostic);
    }}
/>
```

```typescript
import { type SelphiStabilizingDetail } from '@facephi/sdk-web-wc';

selphi.addEventListener('stabilizing', (event) => {
  const detail: SelphiStabilizingDetail = event.detail.detail;
});
```