> 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/video-recording-video-grabacion/propiedades/settings.md).

# settings

## Detalhes

**Atributo:** `settings`

**Tipo:** `VideoSettings`

**Valor padrão:** Ver tabela de campos

### VideoServiceType

| Membro  | Valor   | Descrição                               |
| ------- | ------- | --------------------------------------- |
| `WS`    | `ws`    | Gravação remota por WebSocket (padrão). |
| `SSE`   | `sse`   | Gravação remota por Server-Sent Events. |
| `LOCAL` | `local` | Gravação local no navegador.            |

### CameraType

| Membro        | Valor         | Descrição        |
| ------------- | ------------- | ---------------- |
| `USER`        | `user`        | Câmera frontal.  |
| `ENVIRONMENT` | `environment` | Câmera traseira. |

### VideoQuality

| Membro   | Valor    | Descrição  |
| -------- | -------- | ---------- |
| `LOW`    | `low`    | 250 kbps.  |
| `MEDIUM` | `medium` | 625 kbps.  |
| `HIGH`   | `high`   | 1000 kbps. |

### Campos de `VideoSettings`

| Propriedade    | Tipo               | Padrão        | Descrição                                                 |
| -------------- | ------------------ | ------------- | --------------------------------------------------------- |
| `serviceType`  | `VideoServiceType` | `ws`          | Modo de gravação. Use `local` para gravação no navegador. |
| `cameraWidth`  | `number`           | `1280`        | Largura da resolução da câmera em pixels.                 |
| `cameraHeight` | `number`           | `720`         | Altura da resolução da câmera em pixels.                  |
| `audioEnabled` | `boolean`          | `true`        | Captura o áudio do microfone junto com o vídeo.           |
| `cameraType`   | `CameraType`       | `environment` | Orientação inicial da câmera.                             |
| `cameraId`     | `string`           | `''`          | `deviceId` de uma câmera específica.                      |
| `cameraSwitch` | `boolean`          | `true`        | Permite alternar entre câmeras em tempo de execução.      |
| `videoQuality` | `VideoQuality`     | `medium`      | Taxa de bits da gravação.                                 |
| `videoTimer`   | `boolean`          | `false`       | Sobrepõe um temporizador `HH:MM:SS` na gravação local.    |

## Morfologia

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

video.settings = {
  serviceType: VideoServiceType.LOCAL,
  audioEnabled: true,
  videoTimer: false,
};
```

## Descrição

Configura o comportamento da gravação de vídeo. Somente propriedade JS (sem atributo HTML). Os campos omitidos usam os valores padrão da tabela.

### Considerações

* Com `serviceType: 'local'`, a gravação começa ao renderizar o componente; o vídeo é obtido com [stopVideo](/docs.facephi-pt-br/sdks/sdk-web/componentes/video-recording-video-grabacion/metodos/stopvideo.md).
* `videoTimer` só se aplica no modo `local`.
* Os modos `ws` e `sse` requerem licença de gravação e configuração de `baseUrl` e `apiKey` na licença.

***

## Exemplo

```jsx
import { VideoServiceType } from '@facephi/sdk-web-wc';

<facephi-video-provider
    settings={{
        serviceType: VideoServiceType.LOCAL,
        audioEnabled: true,
        videoTimer: false,
    }}
    onChangeLoading={(event) => {
        if (!event.detail) {
            // Iniciar widgets filhos
        }
    }}
>
    <facephi-selphi-widget />
</facephi-video-provider>
```