AnimationTrack

显示已弃用

*此内容使用人工智能（Beta）翻译，可能包含错误。若要查看英文页面，请点按 此处。

无法创建

在 Animator 上控制动画的播放。此对象无法创建，而是由 Animator:LoadAnimation() 方法返回。

概要

属性

查看继承自 Instance 的全部
查看继承自 Object 的全部

方法

查看继承自 Instance 的全部
查看继承自 Object 的全部

活动

查看继承自 Instance 的全部
查看继承自 Object 的全部

属性

Animation

Animation
只读
未复制
读取并联

代码示例

收听新动画
local humanoid = script.Parent:WaitForChild("Humanoid")

local animator = humanoid:WaitForChild("Animator")



animator.AnimationPlayed:Connect(function(animationTrack)

	local animationName = animationTrack.Animation.Name

	print("Animation playing " .. animationName)

end)

IsPlaying

boolean
只读
未复制
读取并联

代码示例

动画跟正在播放
local function playOrAdjust(animationTrack, fadeTime, weight, speed)

	if not animationTrack.IsPlaying then

		animationTrack:Play(fadeTime, weight, speed)

	else

		animationTrack:AdjustSpeed(speed)

		animationTrack:AdjustWeight(weight, fadeTime)

	end

end



local animation = Instance.new("Animation")

animation.AnimationId = "rbxassetid://507765644"



local humanoid = script.Parent:WaitForChild("Humanoid")

local animator = humanoid:WaitForChild("Animator")

local animationTrack = animator:LoadAnimation(animation)



playOrAdjust(animationTrack, 1, 0.6, 1)

Length

number
只读
未复制
读取并联

代码示例

播放特定时长的动画
local function playAnimationForDuration(animationTrack, duration)

	local speed = animationTrack.Length / duration

	animationTrack:Play()

	animationTrack:AdjustSpeed(speed)

end



local animation = Instance.new("Animation")

animation.AnimationId = "rbxassetid://507765000"



local humanoid = script.Parent:WaitForChild("Humanoid")

local animator = humanoid:WaitForChild("Animator")



local animationTrack = animator:LoadAnimation(animation)



playAnimationForDuration(animationTrack, 3)

Looped

boolean
读取并联

代码示例

动画循环
local Players = game:GetService("Players")



local localPlayer = Players.LocalPlayer



while not localPlayer.Character do

	task.wait()

end



local character = localPlayer.Character

local humanoid = character:WaitForChild("Humanoid")

local animator = humanoid:WaitForChild("Animator")



local animation = Instance.new("Animation")

animation.AnimationId = "rbxassetid://507770453"



local animationTrack = animator:LoadAnimation(animation)

animationTrack.Looped = false

task.wait(3)

animationTrack:Play()

task.wait(4)

animationTrack.Looped = true

animationTrack:Play()
播放动画跟踪一个数量循环
local function playForNumberLoops(animationTrack, number)

	animationTrack.Looped = true

	animationTrack:Play()

	local numberOfLoops = 0

	local connection = nil

	connection = animationTrack.DidLoop:Connect(function()

		numberOfLoops = numberOfLoops + 1

		print("loop: ", numberOfLoops)

		if numberOfLoops >= number then

			animationTrack:Stop()

			connection:Disconnect() -- 当连接不再需要时，需要断开连接

		end

	end)

end



local animation = Instance.new("Animation")

animation.AnimationId = "rbxassetid://507765644"



local humanoid = script.Parent:WaitForChild("Humanoid")

local animator = humanoid:WaitForChild("Animator")

local animationTrack = animator:LoadAnimation(animation)



playForNumberLoops(animationTrack, 5)

Priority

Enum.AnimationPriority
读取并联

Speed

number
只读
未复制
读取并联

代码示例

动画速度
local ContentProvider = game:GetService("ContentProvider")

local Players = game:GetService("Players")



local localPlayer = Players.LocalPlayer

while not localPlayer.Character do

	task.wait()

end

local character = localPlayer.Character

local humanoid = character:WaitForChild("Humanoid")

local animator = humanoid:WaitForChild("Animator")

local animation = Instance.new("Animation")

animation.AnimationId = "rbxassetid://507770453"



ContentProvider:PreloadAsync({ animation })



local animationTrack = animator:LoadAnimation(animation)



local normalSpeedTime = animationTrack.Length / animationTrack.Speed

animationTrack:AdjustSpeed(3)

local fastSpeedTime = animationTrack.Length / animationTrack.Speed



print("At normal speed the animation will play for", normalSpeedTime, "seconds")

print("At 3x speed the animation will play for", fastSpeedTime, "seconds")
播放特定时长的动画
local function playAnimationForDuration(animationTrack, duration)

	local speed = animationTrack.Length / duration

	animationTrack:Play()

	animationTrack:AdjustSpeed(speed)

end



local animation = Instance.new("Animation")

animation.AnimationId = "rbxassetid://507765000"



local humanoid = script.Parent:WaitForChild("Humanoid")

local animator = humanoid:WaitForChild("Animator")



local animationTrack = animator:LoadAnimation(animation)



playAnimationForDuration(animationTrack, 3)

TimePosition

number
未复制
读取并联

代码示例

在位置冻结动画
function freezeAnimationAtTime(animationTrack, timePosition)

	if not animationTrack.IsPlaying then

		-- 如果未播放动画，请播放它

		animationTrack:Play()

	end

	-- 将速度设置为 0 以冻结动画

	animationTrack:AdjustSpeed(0)

	-- 跳到所需的时间位置

	animationTrack.TimePosition = timePosition

end



function freezeAnimationAtPercent(animationTrack, percentagePosition)

	if not animationTrack.IsPlaying then

		-- 如果未播放动画，请播放它

		animationTrack:Play()

	end

	-- 将速度设置为 0 以冻结动画

	animationTrack:AdjustSpeed(0)

	-- 跳到所需的时间位置

	animationTrack.TimePosition = (percentagePosition / 100) * animationTrack.Length

end



local animation = Instance.new("Animation")

animation.AnimationId = "rbxassetid://507765644"



local humanoid = script.Parent:WaitForChild("Humanoid")

local animator = humanoid:WaitForChild("Animator")

local animationTrack = animator:LoadAnimation(animation)



freezeAnimationAtTime(animationTrack, 0.5)

freezeAnimationAtPercent(animationTrack, 50)

WeightCurrent

number
只读
未复制
读取并联

代码示例

重量当前和重量目标
local Players = game:GetService("Players")



local localPlayer = Players.LocalPlayer



while not localPlayer.Character do

	task.wait()

end

local character = localPlayer.Character



local humanoid = character:WaitForChild("Humanoid")

local animator = humanoid:WaitForChild("Animator")



local animation1 = Instance.new("Animation")

animation1.AnimationId = "rbxassetid://507770453"



local animation2 = Instance.new("Animation")

animation2.AnimationId = "rbxassetid://507771019"



task.wait(3) -- 随机等待时间，以允许角色进入位置



local animationTrack1 = animator:LoadAnimation(animation1)

local animationTrack2 = animator:LoadAnimation(animation2)



animationTrack1.Priority = Enum.AnimationPriority.Movement

animationTrack2.Priority = Enum.AnimationPriority.Action



animationTrack1:Play(0.1, 5, 1)

animationTrack2:Play(10, 3, 1)



local done = false

while not done and task.wait(0.1) do

	if math.abs(animationTrack2.WeightCurrent - animationTrack2.WeightTarget) < 0.001 then

		print("got there")

		done = true

	end

end

WeightTarget

number
只读
未复制
读取并联

代码示例

重量当前和重量目标
local Players = game:GetService("Players")



local localPlayer = Players.LocalPlayer



while not localPlayer.Character do

	task.wait()

end

local character = localPlayer.Character



local humanoid = character:WaitForChild("Humanoid")

local animator = humanoid:WaitForChild("Animator")



local animation1 = Instance.new("Animation")

animation1.AnimationId = "rbxassetid://507770453"



local animation2 = Instance.new("Animation")

animation2.AnimationId = "rbxassetid://507771019"



task.wait(3) -- 随机等待时间，以允许角色进入位置



local animationTrack1 = animator:LoadAnimation(animation1)

local animationTrack2 = animator:LoadAnimation(animation2)



animationTrack1.Priority = Enum.AnimationPriority.Movement

animationTrack2.Priority = Enum.AnimationPriority.Action



animationTrack1:Play(0.1, 5, 1)

animationTrack2:Play(10, 3, 1)



local done = false

while not done and task.wait(0.1) do

	if math.abs(animationTrack2.WeightCurrent - animationTrack2.WeightTarget) < 0.001 then

		print("got there")

		done = true

	end

end
查看继承自 Instance 的全部
查看继承自 Object 的全部

方法

AdjustSpeed

()

参数

speed: number
默认值：1

返回

()

代码示例

播放特定时长的动画
local function playAnimationForDuration(animationTrack, duration)

	local speed = animationTrack.Length / duration

	animationTrack:Play()

	animationTrack:AdjustSpeed(speed)

end



local animation = Instance.new("Animation")

animation.AnimationId = "rbxassetid://507765000"



local humanoid = script.Parent:WaitForChild("Humanoid")

local animator = humanoid:WaitForChild("Animator")



local animationTrack = animator:LoadAnimation(animation)



playAnimationForDuration(animationTrack, 3)
动画速度
local ContentProvider = game:GetService("ContentProvider")

local Players = game:GetService("Players")



local localPlayer = Players.LocalPlayer

while not localPlayer.Character do

	task.wait()

end

local character = localPlayer.Character

local humanoid = character:WaitForChild("Humanoid")

local animator = humanoid:WaitForChild("Animator")

local animation = Instance.new("Animation")

animation.AnimationId = "rbxassetid://507770453"



ContentProvider:PreloadAsync({ animation })



local animationTrack = animator:LoadAnimation(animation)



local normalSpeedTime = animationTrack.Length / animationTrack.Speed

animationTrack:AdjustSpeed(3)

local fastSpeedTime = animationTrack.Length / animationTrack.Speed



print("At normal speed the animation will play for", normalSpeedTime, "seconds")

print("At 3x speed the animation will play for", fastSpeedTime, "seconds")

AdjustWeight

()

参数

weight: number
默认值：1
fadeTime: number
默认值：0.100000001

返回

()

代码示例

动画跟踪更改重量
local function changeWeight(animationTrack, weight, fadeTime)

	animationTrack:AdjustWeight(weight, fadeTime)

	local startTime = tick()

	while math.abs(animationTrack.WeightCurrent - weight) > 0.001 do

		task.wait()

	end

	print("Time taken to change weight " .. tostring(tick() - startTime))

end



local animation = Instance.new("Animation")

animation.AnimationId = "rbxassetid://507765644"



local humanoid = script.Parent:WaitForChild("Humanoid")

local animator = humanoid:WaitForChild("Animator")

local animationTrack = animator:LoadAnimation(animation)



changeWeight(animationTrack, 0.6, 1)

GetMarkerReachedSignal

RBXScriptSignal

参数

name: string
默认值：""

返回

RBXScriptSignal

代码示例

Listening to Keyframe Markers
local Players = game:GetService("Players")



local player = Players.LocalPlayer

local character = player.Character or player.Character:Wait()

local humanoid = character:WaitForChild("Humanoid")



-- Create new "Animation" instance

local kickAnimation = Instance.new("Animation")

-- Set its "AnimationId" to the corresponding animation asset ID

kickAnimation.AnimationId = "rbxassetid://2515090838"



-- Load animation onto the humanoid

local kickAnimationTrack = humanoid:LoadAnimation(kickAnimation)



-- Play animation track

kickAnimationTrack:Play()



-- If a named event was defined for the animation, connect it to "GetMarkerReachedSignal()"

kickAnimationTrack:GetMarkerReachedSignal("KickEnd"):Connect(function(paramString)

	print(paramString)

end)

GetTargetInstance

Instance

参数

name: string
默认值：""

返回

Instance

GetTargetNames

Array

返回

Array

GetTimeOfKeyframe

number

参数

keyframeName: string
默认值：""

返回

number

代码示例

跳到键帧
local function jumpToKeyframe(animationTrack, keyframeName)

	local timePosition = animationTrack:GetTimeOfKeyframe(keyframeName)

	if not animationTrack.IsPlaying then

		animationTrack:Play()

	end

	animationTrack.TimePosition = timePosition

end



local ANIMATION_ID = 0

local KEYFRAME_NAME = "Test"



local animation = Instance.new("Animation")

animation.AnimationId = "rbxassetid://" .. ANIMATION_ID



local humanoid = script.Parent:WaitForChild("Humanoid")

local animator = humanoid:WaitForChild("Animator")

local animationTrack = animator:LoadAnimation(animation)



jumpToKeyframe(animationTrack, KEYFRAME_NAME)

Play

()

参数

fadeTime: number
默认值：0.100000001
weight: number
默认值：1
speed: number
默认值：1

返回

()

代码示例

播放特定时长的动画
local function playAnimationForDuration(animationTrack, duration)

	local speed = animationTrack.Length / duration

	animationTrack:Play()

	animationTrack:AdjustSpeed(speed)

end



local animation = Instance.new("Animation")

animation.AnimationId = "rbxassetid://507765000"



local humanoid = script.Parent:WaitForChild("Humanoid")

local animator = humanoid:WaitForChild("Animator")



local animationTrack = animator:LoadAnimation(animation)



playAnimationForDuration(animationTrack, 3)
在位置冻结动画
function freezeAnimationAtTime(animationTrack, timePosition)

	if not animationTrack.IsPlaying then

		-- 如果未播放动画，请播放它

		animationTrack:Play()

	end

	-- 将速度设置为 0 以冻结动画

	animationTrack:AdjustSpeed(0)

	-- 跳到所需的时间位置

	animationTrack.TimePosition = timePosition

end



function freezeAnimationAtPercent(animationTrack, percentagePosition)

	if not animationTrack.IsPlaying then

		-- 如果未播放动画，请播放它

		animationTrack:Play()

	end

	-- 将速度设置为 0 以冻结动画

	animationTrack:AdjustSpeed(0)

	-- 跳到所需的时间位置

	animationTrack.TimePosition = (percentagePosition / 100) * animationTrack.Length

end



local animation = Instance.new("Animation")

animation.AnimationId = "rbxassetid://507765644"



local humanoid = script.Parent:WaitForChild("Humanoid")

local animator = humanoid:WaitForChild("Animator")

local animationTrack = animator:LoadAnimation(animation)



freezeAnimationAtTime(animationTrack, 0.5)

freezeAnimationAtPercent(animationTrack, 50)

SetTargetInstance

()

参数

name: string
默认值：""
target: Instance
默认值：""

返回

()

Stop

()

参数

fadeTime: number
默认值：0.100000001

返回

()

代码示例

动画跟踪停止
local function fadeOut(animationTrack, fadeTime)

	animationTrack:Stop(fadeTime)

	local startTime = tick()

	while animationTrack.WeightCurrent > 0 do

		task.wait()

	end

	local timeTaken = tick() - startTime

	print("Time taken for weight to reset: " .. tostring(timeTaken))

end



local animation = Instance.new("Animation")

animation.AnimationId = "rbxassetid://507765644"



local humanoid = script.Parent:WaitForChild("Humanoid")

local animator = humanoid:WaitForChild("Animator")

local animationTrack = animator:LoadAnimation(animation)



animationTrack:Play()



fadeOut(animationTrack, 1)
查看继承自 Instance 的全部
查看继承自 Object 的全部

活动

DidLoop


代码示例

播放动画跟踪一个数量循环
local function playForNumberLoops(animationTrack, number)

	animationTrack.Looped = true

	animationTrack:Play()

	local numberOfLoops = 0

	local connection = nil

	connection = animationTrack.DidLoop:Connect(function()

		numberOfLoops = numberOfLoops + 1

		print("loop: ", numberOfLoops)

		if numberOfLoops >= number then

			animationTrack:Stop()

			connection:Disconnect() -- 当连接不再需要时，需要断开连接

		end

	end)

end



local animation = Instance.new("Animation")

animation.AnimationId = "rbxassetid://507765644"



local humanoid = script.Parent:WaitForChild("Humanoid")

local animator = humanoid:WaitForChild("Animator")

local animationTrack = animator:LoadAnimation(animation)



playForNumberLoops(animationTrack, 5)

Ended


代码示例

动画跟踪已结束
local InsertService = game:GetService("InsertService")

local Players = game:GetService("Players")



-- 创建一个 NPC 模型来进行动画。

local npcModel = Players:CreateHumanoidModelFromUserId(129687796)

npcModel.Name = "JoeNPC"

npcModel.Parent = workspace

npcModel:MoveTo(Vector3.new(0, 15, 4))

local humanoid = npcModel:WaitForChild("Humanoid")



-- 加载一个动画。

local animationModel = InsertService:LoadAsset(2510238627)

local animation = animationModel:FindFirstChildWhichIsA("Animation", true)

local animator = humanoid:WaitForChild("Animator")

local animationTrack = animator:LoadAnimation(animation)



-- 连接到停止事件。这发生在动画停止时

-- 它自己同意，或者我们明确地调用停止。

animationTrack.Stopped:Connect(function()

	print("Animation stopped")

end)



-- 连接到结束事件。这发生在动画完全完成时

-- 已成功影响世界。在这种情况下，将发射 3 秒

-- 在我们调用动画跟踪：停止之前，因为我们传递了一个 3

-- 第二次渐渐消失。

animationTrack.Ended:Connect(function()

	print("Animation ended")

	animationTrack:Destroy()

end)



-- 跑步，给它玩一点，然后停止。

print("Calling Play")

animationTrack:Play()

task.wait(10)

print("Calling Stop")

animationTrack:Stop(3)

KeyframeReached

参数

keyframeName: string

Stopped


代码示例

动画跟停止了
local function yieldPlayAnimation(animationTrack, fadeTime, weight, speed)

	animationTrack:Play(fadeTime, weight, speed)

	animationTrack.Stopped:Wait()

	print("Animation has stopped")

end



local animation = Instance.new("Animation")

animation.AnimationId = "rbxassetid://507765644"



local humanoid = script.Parent:WaitForChild("Humanoid")

local animator = humanoid:WaitForChild("Animator")

local animationTrack = animator:LoadAnimation(animation)



yieldPlayAnimation(animationTrack, 1, 0.6, 1)
查看继承自 Instance 的全部
查看继承自 Object 的全部