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

# settings

## Detalles

**Atributo:** `settings`

**Tipo:** `VideoSettings`

**Valor por defecto:** Ver tabla de campos

### VideoServiceType

| Miembro | Valor   | Descripción                                      |
| ------- | ------- | ------------------------------------------------ |
| `WS`    | `ws`    | Grabación remota por WebSocket (predeterminado). |
| `SSE`   | `sse`   | Grabación remota por Server-Sent Events.         |
| `LOCAL` | `local` | Grabación local en el navegador.                 |

### CameraType

| Miembro       | Valor         | Descripción     |
| ------------- | ------------- | --------------- |
| `USER`        | `user`        | Cámara frontal. |
| `ENVIRONMENT` | `environment` | Cámara trasera. |

### VideoQuality

| Miembro  | Valor    | Descripción |
| -------- | -------- | ----------- |
| `LOW`    | `low`    | 250 kbps.   |
| `MEDIUM` | `medium` | 625 kbps.   |
| `HIGH`   | `high`   | 1000 kbps.  |

### Campos de `VideoSettings`

| Propiedad      | Tipo               | Predeterminado | Descripción                                                    |
| -------------- | ------------------ | -------------- | -------------------------------------------------------------- |
| `serviceType`  | `VideoServiceType` | `ws`           | Modo de grabación. Usa `local` para grabación en el navegador. |
| `cameraWidth`  | `number`           | `1280`         | Ancho de resolución de la cámara en píxeles.                   |
| `cameraHeight` | `number`           | `720`          | Alto de resolución de la cámara en píxeles.                    |
| `audioEnabled` | `boolean`          | `true`         | Captura audio del micrófono junto al vídeo.                    |
| `cameraType`   | `CameraType`       | `environment`  | Orientación de la cámara inicial.                              |
| `cameraId`     | `string`           | `''`           | `deviceId` de una cámara concreta.                             |
| `cameraSwitch` | `boolean`          | `true`         | Permite cambiar entre cámaras en tiempo de ejecución.          |
| `videoQuality` | `VideoQuality`     | `medium`       | Bitrate de grabación.                                          |
| `videoTimer`   | `boolean`          | `false`        | Superpone temporizador `HH:MM:SS` en grabación local.          |

## Morfología

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

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

## Descripción

Configura el comportamiento de la grabación de vídeo. Solo propiedad JS (sin atributo HTML). Los campos omitidos toman los valores predeterminados de la tabla.

### Consideraciones

* Con `serviceType: 'local'`, la grabación comienza al renderizar el componente; el vídeo se obtiene con [stopVideo](/sdks/sdk-web/componentes/video-recording-video-grabacion/metodos/stopvideo.md).
* `videoTimer` solo aplica en modo `local`.
* Los modos `ws` y `sse` requieren licencia de grabación y configuración de `baseUrl` y `apiKey` en la licencia.

***

## Ejemplo

```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 hijos
        }
    }}
>
    <facephi-selphi-widget />
</facephi-video-provider>
```