Eventos de animación | Documentación del Centro de creación de Roblox

Puedes definir marcadores de evento de animación a lo largo de la línea de tiempo y usar GetMarkerReachedSignal() para detectar esos marcadores mientras la animación se reproduce.

Por defecto, la pista de eventos no es visible. Para mostrar la pista de eventos:

Navega a la derecha de la línea de tiempo y haz clic en el icono de configuración. Se muestra un menú emergente.
Selecciona Mostrar Eventos de Animación. Esto abre la barra de Eventos de Animación justo debajo de los controles de medios y reproducción.

Crear eventos

Los marcadores de eventos son indicadores visuales de dónde comienza un evento de animación. Después de crear un marcador de evento, puedes moverlo a cualquier posición de fotograma en la línea de tiempo.

Para crear un nuevo marcador de evento:

Navega a la línea de tiempo, luego haz clic y arrastra el controlador a la posición de fotograma donde debe ocurrir el evento.
Navega a la pista de eventos, luego haz clic en el botón Editar Eventos de Animación.
En el cuadro de diálogo, haz clic en + Agregar Evento, luego ingresa un nombre para el evento.
OPCIONAL
En el campo Parámetro, ingresa una cadena de parámetro para el evento.
Haz clic en el botón Guardar. En la barra de eventos dentro de la línea de tiempo, se mostrará un nuevo símbolo de marcador en la posición de fotograma.

Detectar eventos

Para detectar eventos de animación en un LocalScript, conecta una función al método GetMarkerReachedSignal() de AnimationTrack. Por ejemplo:


local Players = game:GetService("Players")

local player = Players.LocalPlayer
local character = player.Character or player.CharacterAdded:Wait()
local humanoid = character:WaitForChild("Humanoid")
local animator = humanoid:WaitForChild("Animator")

-- Crear una nueva instancia "Animación"
local walkAnim = Instance.new("Animation")
-- Establecer su "AnimationId" al ID de activo de animación correspondiente
walkAnim.AnimationId = "rbxassetid://5432167890"

-- Cargar la animación en el animador
local walkAnimTrack = animator:LoadAnimation(walkAnim)

-- Conectar el evento "GetMarkerReachedSignal" a un fotograma clave específico nombrado
walkAnimTrack:GetMarkerReachedSignal("FootStep"):Connect(function(paramString)
	print(paramString)
end)

Puedes especificar un valor de Parámetro para cualquier marcador de evento dentro del editor de animación. Esto te permite pasar una cadena personalizada (valor único, cadena separada por comas, etc.) al método GetMarkerReachedSignal(), como se ilustra en el argumento paramString en el ejemplo de código anterior. Esta cadena puede ser analizada o convertida, si es necesario, y utilizada para cualquier acción que desees llevar a cabo en el evento.

Duplicar eventos

A medida que creas eventos, estos se vuelven disponibles para su uso en toda la animación, no solo en la posición de fotograma donde los creaste originalmente. Por ejemplo, puedes crear un marcador de evento FootStep en el punto donde el pie izquierdo de un personaje toca el suelo, y luego usar el mismo evento cuando el pie derecho del personaje toca el suelo.

Para duplicar un evento:

Haz clic derecho en un marcador de evento en la barra de eventos, y luego selecciona Copiar Seleccionado en el menú contextual.
Haz clic derecho en otro momento a lo largo de la línea de tiempo y selecciona Pegar Eventos. El evento copiado se inserta en la posición de tiempo más cercana a donde haces clic.
OPCIONAL
Si el evento original usa un parámetro pero el evento duplicado debería usar un parámetro modificado, realiza los siguientes pasos:
1. Haz clic derecho en el marcador de evento duplicado y selecciona Editar Evento de Animación en el menú contextual. Se muestra el cuadro de diálogo Editar Eventos de Animación.
2. Realiza tus cambios y haz clic en el botón Guardar.