# startCinematicRecording (Cliente)

> Começa a gravar um ped, jogador ou veículo como ator da cinemática. Chamada de novo durante a gravação, acrescenta outro ator à mesma gravação.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Função Lua
- **Lado**: Cliente
- **Categoria**: Cinemáticas
- **URL**: https://wiki.mymp.gg/pt/startCinematicRecording

## Sintaxe

```lua
bool startCinematicRecording(cinematic cinematic, string slot, ped|vehicle actor [, int time = nil])
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `cinematic` | `cinematic` | A cinemática. |
| `slot` | `string` | Nome do ator. Uma tomada já gravada com esse nome é substituída. |
| `actor` | `ped\|vehicle` | O ped, jogador ou veículo a gravar. |
| `time` | `int` | Tempo da cinemática, em ms, a partir do qual o ator é regravado. Sem ele, a tomada é gravada do zero. *(padrão: `nil`)* |

## Retorno

`true` se começou a gravar, `false` se a cinemática está sendo reproduzida, se o elemento já está sendo gravado ou se não é possível regravar a partir de `time`.

Os outros atores que já têm tomada são reproduzidos enquanto um grava. Um ped gravado leva junto cada veículo em que entra.

Com `time`, o ator `slot` precisa existir e ser um ped com tomada gravada, com velocidade 1 e a pé nesse momento, e o ped precisa ser controlado por este cliente. Nos 2 segundos antes de `time` o ped segue a tomada antiga, invisível; depois assume a gravação.

## Exemplo

```lua
local scene = createCinematic()

addCommandHandler("rec", function()
    startCinematicRecording(scene, "hero", localPlayer)
end)

addCommandHandler("stoprec", function()
    stopCinematicRecording(scene)
end)
```

## Veja também

- [stopCinematicRecording (Cliente)](https://wiki.mymp.gg/pt/stopCinematicRecording.md): Para a gravação da cinemática. Os outros atores que eram reproduzidos durante a gravação param também.
- [playCinematic (Cliente)](https://wiki.mymp.gg/pt/playCinematic.md): Reproduz a cinemática: os atores com clones locais, e também a câmera, o clima, a hora, o fade, os sons e as legendas.
- [getCinematicActors (Cliente)](https://wiki.mymp.gg/pt/getCinematicActors.md): Lista os atores da cinemática: os gravados e os posicionados.
- [setCinematicProp (Cliente)](https://wiki.mymp.gg/pt/setCinematicProp.md): Posiciona um veículo ou objeto parado numa parte da cinemática, ou muda um que já foi posicionado.