# getCinematicActors (Cliente)

> Lista los actores de la cinemática: los grabados y los colocados.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Función Lua
- **Lado**: Cliente
- **Categoría**: Cinemáticas
- **URL**: https://wiki.mymp.gg/es/getCinematicActors

## Sintaxis

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

## Parámetros

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `cinematic` | `cinematic` | La cinemática. |

## Retorno

Una tabla con una entrada por actor, o `false` si el elemento no es una cinemática.

### Campos comunes

Cada entrada de actor incluye:

- `slot`: nombre del actor.
- `type`: `"ped"`, `"vehicle"` u `"object"`.
- `recorded`: `true` si el actor tiene toma grabada, `false` en caso contrario.

### Actores colocados

Un actor colocado con `setCinematicProp` incluye además:

- `placed`: `true`.
- `model`: ID o nombre del modelo.
- `position` y `rotation`: valores `vec3` (`rotation` en grados).
- `start` y `stop`: intervalo visible en ms de la cinemática.

### Actores grabados

Un actor grabado incluye además:

- `at`, `speed`, `start` y `stop` (el tramo mostrado), más `takeStart` y `takeEnd` (donde empieza y termina la toma), todos en ms de la cinemática.
- `voice`: cuántos fotogramas de voz habló.
- `seats`: lista de entradas `{ time, change, vehicle, seat }`, donde `change` es `"entering"`, `"in"`, `"leaving"` u `"out"`, `vehicle` es el nombre del actor del vehículo y `seat` es el asiento (`0` es el del conductor).

## Ejemplo

```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
```

## Ver también

- [getCinematicActor (Cliente)](https://wiki.mymp.gg/es/getCinematicActor.md): Devuelve el elemento local (ped o vehículo) que interpreta a un actor en la reproducción actual.
- [setCinematicActorTiming (Cliente)](https://wiki.mymp.gg/es/setCinematicActorTiming.md): Coloca la toma de un actor en el tiempo de la cinemática, recorta el tramo mostrado y fija su velocidad. Fuera de ese tramo el actor sale de escena.
- [setCinematicProp (Cliente)](https://wiki.mymp.gg/es/setCinematicProp.md): Coloca un vehículo u objeto quieto durante una parte de la cinemática, o cambia uno ya colocado.
- [removeCinematicActor (Cliente)](https://wiki.mymp.gg/es/removeCinematicActor.md): Quita un actor de la cinemática, con su toma.