# getCinematicActors (Cliente)

> Lista os atores da cinemática: os gravados e os posicionados.

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

## Sintaxe

```lua
table|false getCinematicActors(cinematic cinematic)
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `cinematic` | `cinematic` | A cinemática. |

## Retorno

Uma tabela com uma entrada por ator, ou `false` se o elemento não é uma cinemática.

### Campos comuns

Cada entrada de ator traz:

- `slot`: nome do ator.
- `type`: `"ped"`, `"vehicle"` ou `"object"`.
- `recorded`: `true` se o ator tem tomada gravada, `false` caso contrário.

### Atores posicionados

Um ator posicionado com `setCinematicProp` traz também:

- `placed`: `true`.
- `model`: ID ou nome do modelo.
- `position` e `rotation`: valores `vec3` (`rotation` em graus).
- `start` e `stop`: intervalo exibido em ms da cinemática.

### Atores gravados

Um ator gravado traz também:

- `at`, `speed`, `start` e `stop` (o trecho mostrado), além de `takeStart` e `takeEnd` (onde a tomada começa e acaba), todos em ms da cinemática.
- `voice`: quantos quadros de voz falou.
- `seats`: lista de entradas `{ time, change, vehicle, seat }`, em que `change` é `"entering"`, `"in"`, `"leaving"` ou `"out"`, `vehicle` é o nome do ator do veículo e `seat` é o assento (`0` é o do motorista).

## Exemplo

```lua
local intro = createCinematic("cinematics/intro.cine")
for _, actor in ipairs(getCinematicActors(intro)) do
    outputDebugString(("%s (%s) from %d to %d ms"):format(actor.slot, actor.type, actor.start, actor.stop))
end
```

## Veja também

- [getCinematicActor (Cliente)](https://wiki.mymp.gg/pt/getCinematicActor.md): Devolve o elemento local (ped ou veículo) que faz um ator na reprodução atual.
- [setCinematicActorTiming (Cliente)](https://wiki.mymp.gg/pt/setCinematicActorTiming.md): Posiciona a tomada de um ator no tempo da cinemática, corta o trecho mostrado e define a velocidade. Fora desse trecho o ator sai de cena.
- [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.
- [removeCinematicActor (Cliente)](https://wiki.mymp.gg/pt/removeCinematicActor.md): Tira um ator da cinemática, com a tomada dele.