Aprenda
Classe do mecanismo
Animator

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.


Resumo
Membros herdados

Referência API
Propriedades
EvaluationThrottled
Somente leitura
Não replicado
Escrever Parallel
Recursos: Animation
Animator.EvaluationThrottled:boolean

PreferLodEnabled
Ler Parallel
Recursos: Animation
Animator.PreferLodEnabled:boolean

Métodos
ApplyJointVelocities
Recursos: Animation
Animator:ApplyJointVelocities(motors:Variant):()
Parâmetros
motors:Variant
Devolução
()

GetPlayingAnimationTracks
Recursos: Animation
Acesso à simulação
Animator:GetPlayingAnimationTracks():{any}
Devolução

GetTrackByAnimationId
Recursos: Animation
Acesso à simulação
Animator:GetTrackByAnimationId(animationId:ContentId):AnimationTrack?
Parâmetros
animationId:ContentId
Devolução
Amostras de código
Obter Faixa de Animação pelo ID
local Players = game:GetService("Players")
local RunService = game:GetService("RunService")
local ANIM_ID = "rbxassetid://2515090838"
local player = Players.LocalPlayer
local character = player.Character or player.CharacterAdded:Wait()
-- Garantir que o humanoide do personagem contém um objeto Animator
local humanoid = character:WaitForChild("Humanoid")
local animator = humanoid:WaitForChild("Animator")
-- Criar uma nova instância de Animação e atribuir um ID de ativo de animação
local kickAnimation = Instance.new("Animation")
kickAnimation.AnimationId = ANIM_ID
-- Carregar a animação no animador
local kickAnimationTrack = animator:LoadAnimation(kickAnimation)
-- Reproduzir a faixa de animação após um pequeno atraso
task.wait(3)
kickAnimationTrack:Play()
local startTime = tick()
RunService:BindToSimulation(function(deltaTime: number)
if tick() - startTime > 1 then
-- Obter faixa pelo ID e parar sua reprodução
local kickTrack = animator:GetTrackByAnimationId(ANIM_ID)
if kickTrack and kickTrack.IsPlaying then
kickTrack:Stop()
end
end
end)

LoadAnimation
Recursos: Animation
Acesso à simulação
Animator:LoadAnimation(animation:Animation):AnimationTrack
Parâmetros
animation:Animation
Devolução

StepAnimations
Segurança do plugin
Recursos: Animation
Animator:StepAnimations(deltaTime:number):()
Parâmetros
deltaTime:number
Devolução
()
Amostras de código
Pré-visualização de Animação no Estúdio
local RunService = game:GetService("RunService")
local function previewAnimation(model, animation)
-- Encontre o AnimationController e o Animator
local animationController = model:FindFirstChildOfClass("AnimationController")
local animator = animationController and animationController:FindFirstChildOfClass("Animator")
if not animator then return end
-- Carregue a animação para criar um AnimationTrack
local track = animationController:LoadAnimation(animation)
track:Play()
-- Visualize a animação
local startTime = tick()
while (tick() - startTime) < track.Length do
local step = RunService.Heartbeat:wait()
animator:StepAnimations(step)
end
-- Pare a animação
track:Stop(0)
animator:StepAnimations(0)
-- Reinicie as juntas
for _, descendant in pairs(model:GetDescendants()) do
if descendant:IsA("Motor6D") then
local joint = descendant
joint.CurrentAngle = 0
joint.Transform = CFrame.new()
end
end
end
local character = script.Parent
local animation = Instance.new("Animation")
animation.AnimationId = "rbxassetid://507765644"
previewAnimation(character, animation)

Eventos
AnimationPlayed
Recursos: Animation
Animator.AnimationPlayed(animationTrack:AnimationTrack):RBXScriptSignal
Parâmetros
animationTrack:AnimationTrack

©2026 Roblox Corporation, Roblox, o logotipo Roblox e Powering Imagination estão entre nossas marcas registradas e não registradas nos EUA e em outros países.