> 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/propiedades/livenessmode.md).

# livenessMode

## Detalhes

**Atributo:** `liveness-mode`

**Tipo:** `LivenessMode`

**Valor padrão:** `LivenessMode.None`

### LivenessMode

| Membro    | Valor | Descrição                                            |
| --------- | ----- | ---------------------------------------------------- |
| `None`    | `0`   | Sem teste de vida por movimento.                     |
| `Move`    | `2`   | Ativa o teste de vida por movimento (liveness move). |
| `Passive` | `3`   | Compatibilidade; não tem efeito (ver abaixo).        |

## Morfologia

```typescript
import { LivenessMode } from '@facephi/selphi-web-component';

selphi.livenessMode = LivenessMode.Move;
```

## Descrição

Seleciona o modo de teste de vida de `facephi-selphi-widget`. A forma recomendada de ativar o liveness move é definir `livenessMode = LivenessMode.Move` junto com os passos (`livenessMoveSteps`, ou seu nome recomendado [`moveSuccessfulAttempts`](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/livenessmovesteps.md)).

Definir apenas os passos (sem `Move`) ainda ativa o move por compatibilidade, mas está **descontinuado**: `livenessMode = LivenessMode.Move` será obrigatório na próxima versão major. O valor `Passive` não tem efeito e também será removido na próxima major.

### Comportamento

O resultado diante de combinações incompletas ou contraditórias depende de [`settingsStrictness`](/docs.facephi-pt-br/sdks/sdk-web/componentes/sdk-provider/propiedades/settingsstrictness.md):

| Cenário                  | Tolerante (padrão)             | Estrito                        |
| ------------------------ | ------------------------------ | ------------------------------ |
| `Move` + passos > `0`    | Move com esses passos          | Move com esses passos          |
| `Move` + passos = `0`    | Move com `3` passos + aviso    | Erro bloqueante                |
| Passos > `0` sem `Move`  | Move + aviso de descontinuação | Move + aviso de descontinuação |
| `None` (ou sem informar) | Sem teste de vida              | Sem teste de vida              |
| `Passive`                | Descartado (sem efeito)        | Descartado (sem efeito)        |

***

## Exemplo

```jsx
import { LivenessMode } from '@facephi/selphi-web-component';

<facephi-selphi-widget
    livenessMode={LivenessMode.Move}
    moveSuccessfulAttempts={3}
/>
```