Eventos de animação | Documentação - Central de Criadores Roblox

Você pode definir marcadores de eventos de animação ao longo da linha do tempo e usar GetMarkerReachedSignal() para detectar esses marcadores enquanto a animação é executada.

Por padrão, a faixa de eventos não é visível. Para mostrar a faixa de eventos:

Navegue até o lado direito da linha do tempo e clique no ícone de configurações. Um menu pop-up será exibido.
Selecione Mostrar Eventos de Animação. Isso abre a barra de Eventos de Animação logo abaixo dos controles de mídia e reprodução.

Criar eventos

Marcadores de eventos são indicadores visuais de onde um evento de animação começa. Depois de criar um marcador de evento, você pode movê-lo para qualquer posição de quadro na linha do tempo.

Para criar um novo marcador de evento:

Navegue até a linha do tempo, clique e arraste o controle deslizante para a posição do quadro onde o evento deve ocorrer.
Navegue até a faixa de eventos, depois clique no botão Editar Eventos de Animação.
Na caixa de diálogo, clique em + Adicionar Evento, em seguida, insira um nome para o evento.
OPCIONAL
No campo Parâmetro, insira uma string de parâmetro para o evento.
Clique no botão Salvar. Na barra de eventos dentro da linha do tempo, um novo símbolo de marcador será exibido na posição do quadro.

Detectar eventos

Para detectar eventos de animação em um LocalScript, conecte uma função à função GetMarkerReachedSignal() de AnimationTrack. Por exemplo:


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")

-- Cria uma nova instância de "Animação"
local walkAnim = Instance.new("Animation")
-- Define seu "AnimationId" para o ID do ativo de animação correspondente
walkAnim.AnimationId = "rbxassetid://5432167890"

-- Carrega a animação no animador
local walkAnimTrack = animator:LoadAnimation(walkAnim)

-- Conecta o evento "GetMarkerReachedSignal" a um keyframe específico nomeado
walkAnimTrack:GetMarkerReachedSignal("FootStep"):Connect(function(paramString)
	print(paramString)
end)

Você pode especificar um valor de Parâmetro para qualquer marcador de evento dentro do editor de animação. Isso permite que você passe uma string personalizada (valor único, string separada por vírgulas, etc.) para o método GetMarkerReachedSignal(), como ilustrado pelo argumento paramString no exemplo de código acima. Essa string pode ser analisada ou convertida, se necessário, e usada para qualquer ação que você deseja realizar no evento.

Duplicar eventos

À medida que você cria eventos, eles se tornam disponíveis para uso em toda a animação, não apenas na posição do quadro onde você os criou originalmente. Por exemplo, você pode criar um marcador de evento FootStep no ponto onde o pé esquerdo de um personagem toca o chão e, em seguida, usar o mesmo evento quando o pé direito do personagem tocar o chão.

Para duplicar um evento:

Clique com o botão direito em um marcador de evento na barra de eventos e selecione Copiar Selecionado no menu contextual.
Clique com o botão direito em outro momento ao longo da linha do tempo e selecione Colar Eventos. O evento copiado será inserido na posição de tempo mais próxima de onde você clicar.
OPCIONAL
Se o evento original usar um parâmetro, mas o evento duplicado deve usar um parâmetro modificado, execute as seguintes etapas:
1. Clique com o botão direito no marcador de evento duplicado e selecione Editar Evento de Animação no menu contextual. A caixa de diálogo Editar Eventos de Animação será exibida.
2. Faça suas alterações e clique no botão Salvar.