在 Animator 上控制動畫的播放。此對象無法創建，而是由 Animator:LoadAnimation() 方法返回。
概要
屬性
用於創建此 AnimationTrack 的 Animation 對象。
一個只讀屬性，在 AnimationTrack 播放時返回真值。
一個只讀屬性，返回 AnimationTrack 的長度（以秒為單位）。直到動畫完全載入為止，此會返回 0，因此可能無法立即使用。
設置動畫在完成後是否會重複。如果在播放結果時變更，動畫完成後才會生效。
設置 AnimationTrack 的優先級。取決於這個設置是什麼，一次播放多個動畫時，將查看此屬性來決定哪個 Keyframe Poses 應該在一個上面播放。
一個 AnimationTrack 的速度是一個只能讀取的屬性，可以提供 AnimationTrack 的當前播放速度。這有一個預設值 1。當速度等於 1 時，動畫完成所需的時間等於 AnimationTrack.Length (以秒為單位)。
返回 AnimationTrack 在播放其源動畫時在秒鐘內的位置，該動畫會通過播放其源動畫來傳達。可設為使軌道跳到動畫中特定時刻。
只讀屬性，提供 AnimationTrack 的當前重量。它有預設值為 1。
只讀屬性，提供 AnimationTrack 的當前重量。
方法
變更動畫的 AnimationTrack.Speed 。正值速度播放動畫向前，負值則播放向後，0則暫停。
變更動畫的重量，其中可選擇的 fadeTime 參數決定 AnimationTrack.WeightCurrent 到達 AnimationTrack.WeightTarget 所需的時間長度。
返回一個 event ，在 animation 中被擊中時發射，當指定的 KeyframeMarker 被擊中時。
返回指定名稱的第一個 Keyframe 在 AnimationTrack 的時間位置。
播放 AnimationTrack 。一旦呼叫 AnimationTrack 將使用指定的淡出時間、重量和速度進行播放。
停止 AnimationTrack 。
活動
在上一個動畫循環結束後的下一次更新時發生 AnimationTrack 循環，當前動畫循環結束時發生火災。
當 AnimationTrack 完全移動世界上的任何東西時，發生火災。動畫已停止播放，「淡出」已完成，主題處於中立姿勢。
每次播放 AnimationTrack 的時候，都會發生一個沒有預設名稱 - "Keyframe" 的 Keyframe 。
當 AnimationTrack 結束播放時發生火災。動畫追蹤仍可能在動畫「消失」時動畫主題。要捕捉動畫追蹤完全完成在世界上移動任何東西時，請使用 AnimationTrack.Ended 事件。
屬性
Animation
用於創建此 AnimationTrack 的 Animation 對象。要創建 AnimationTrack ，您必須使用 Animation 方法將 Animator 對象載入到 Animator:LoadAnimation() 上。
範例程式碼
下面的代碼示例每當 AnimationTrack 在 Humanoid 上播放一個動畫時，都會打印動畫名稱。這個腳本可以放置在具有 Humanoid 兒童的模型中。
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
一個只讀屬性，在 AnimationTrack 播放時返回真值。
開發人員可以使用此屬性來檢查是否已經播放動畫（因為這會導致它重新啟動）。如果開發者想要獲得所有播放 AnimationTracks 在 Animator 或 Humanoid 上，他們應該使用 Animator:GetPlayingAnimationTracks()
範例程式碼
這個代碼樣本包含一個簡單的功能，如果未播放，或其他方式調整速度和重量以匹配新給出的參數。
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
一個只讀屬性，返回 AnimationTrack 的長度（以秒為單位）。直到動畫完全載入為止，此會返回 0，因此可能無法立即使用。
當 AnimationTrack.Speed 的 AnimationTrack 等於 1 時，動畫將需要 AnimationTrack.Length 秒才能完成。
範例程式碼
下列功能將為特定時間播放動畫軌道。這是通過將動畫速度變更為所需播放時間除以動畫長度來實現的。這可以在開發者想要播放不同時間的標準動畫（例如，重新充能不同能力）的情況下使用。
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
此屬性設置動畫在完成後是否會重複。如果在播放結果時變更，動畫結束後才會生效。
循環屬性對於 AnimationTrack 默認使用在動畫編輯器中設置的方式。但是，此屬性可以更改，允許在遊戲運行時控制 AnimationTrack 。循環也正確地處理反向播放的動畫（負 AnimationTrack.Speed）。在第一個關鍵幀被達到之後，它將在最後一個關鍵格重新啟動。
這個屬性讓開發人員可以擁有一個循環和非循環的同一動畫變體，而無需上傳兩個版本到 Roblox。
範例程式碼
這個例子中的動畫通常會循環。玩家和動畫載入後，動畫將以非循環方式播放，然後以循環方式播放。
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()在此代碼樣本中的功能將在循環上播放一個動畫軌道，對於特定數量的循環，在停止動畫之前。
在某些情況下，開發者可能希望在一定數量的循環後停止循環動畫，而不是在一定時間後。這是使用 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)Priority
此屬性設置 AnimationTrack 的優先級。取決於這個設置是什麼，一次播放多個動畫時，將查看此屬性來決定哪個 Keyframe Poses 應該在一個上面播放。
對於 AnimationTrack 的優先級屬性預設為從 Studio 的 動畫編輯器 設置和發布的方式。它使用 Enum.AnimationPriority ，它有 7 個優先級：
- 行動4（最高優先級）
- 行動3
- 行動2
- 行動
- 運動
- 閒置
- 核心 (最低優先級)
正確設置動畫優先級，通過編輯器或通過此屬性，可以讓多個動畫無需碰撞即可播放。當兩個正在播放的動畫將目標指向以不同方式移動相同的肢體時，最高優先級的 AnimationTrack 將會顯示。如果兩個動畫都有相同的優先級，軌道的重量將用於結合動畫。
此屬性也允許開發人員在不同優先級下播放相同的動畫，無需上傳額外版本到 Roblox。
Speed
一個 AnimationTrack 的速度是一個只能讀取的屬性，可以提供 AnimationTrack 的當前播放速度。這有一個預設值 1。當速度等於 1 時，動畫完成所需的時間等於 AnimationTrack.Length (以秒為單位)。
如果速度被調整，則實際播放所需的時間可以通過將長度除以速度來計算。速度是一個沒有單位的數量。
速度可用於將動畫長度與不同遊戲事件鏈結（例如重新充能能力），無需上傳不同版本的相同動畫。
此屬性只能閱讀，您可以使用 AnimationTrack:AdjustSpeed() 來更改它。
範例程式碼
在這個例子中載入了一名玩家和一個動畫。動畫軌道的長度決定速度為 1 時軌道需要多久才能播放。如果速度被調整，則實際播放所需的時間可以通過將長度除以速度來計算。
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
返回 AnimationTrack 在播放其源動畫時在秒鐘內的位置，該動畫會通過播放其源動畫來傳達。可設為使軌道跳到動畫中特定時刻。
時間位置可以設為前往動畫的特定點，但必須播放才能如此。它也可以與 AnimationTrack:AdjustSpeed() 一起使用，以在指定點凍結動畫 (將速度設為 0)。
範例程式碼
以下代碼示例包含兩個功能，可以展示如何使用 AdjustSpeed 和 TimePosition 來在特定點凍結動畫。
第一個功能在特定時間點凍結動畫（在秒內定義）。第二次凍結在百分比（介於 0 或 100 之間）上，乘以軌道長度。
當動畫跟不在播放時，功能會檢查確保動畫先播放，然後才能繼續進行。
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
當在 AnimationTrack 設置重量時,重量不會立即變更,但會從重量當前移動到AnimationTrack.WeightTarget。執行此操作所需的時間由播放動畫或調整重量時提供的 fadeTime 參數決定。
重量當前可以與 AnimationTrack.WeightTarget 對比，以查看是否已達到所需重量。請注意，這些值不應與 == 運算符進行等值檢查，因為這兩個值都是浮點。若要查看 WeightCurrent 是否已達到目標重量，建議查看這些值之間的距離是否足夠小 (見下方代碼示例)。
動畫權重系統用於確定如何AnimationTracks在同一優先級下播放的動畫會融合在一起。預設重量是一，在重量為零的 AnimationTrack 上沒有運動可見。在任何時間點顯示的姿勢由所有 Poses 和每個 AnimationTrack 的重量平均值決定。在大多數情況下，混合動畫不需要，使用 AnimationTrack.Priority 更適合。
範例程式碼
這個代碼示例載入兩個動畫到本地玩家的人形上，並展示如何使用 AnimationTrack.Play 中的 fadeTime 參數來確定動畫跟的重量現在到達其重量目標所需的時間。
因為 WeightCurrent 和 WeightTarget 是漂浮的 == 運算器無法用於比較，相反，更適合檢查他們之間的差異是否足夠小，以假設重量褪色已完成。
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
endWeightTarget
動畫跟蹤。重量目標是一個只能讀取的屬性，可以提供 AnimationTrack 的當前重量。它的默认值為 1，當 AnimationTrack:Play() 、 AnimationTrack:Stop() 或 AnimationTrack:AdjustWeight() 被呼叫時設置。當在 AnimationTrack 設置重量時,重量不會立即變更,但會從重量當前移動到AnimationTrack.WeightTarget 。執行此操作所需的時間由播放動畫或調整重量時提供的 fadeTime 參數決定。
重量當前可以與 AnimationTrack.WeightTarget 對比，以查看是否已達到所需重量。請注意，這些值不應與 == 運算符進行等值檢查，因為這兩個值都是浮點。若要查看 WeightCurrent 是否已達到目標重量，建議查看這些值之間的距離是否足夠小 (見下方代碼示例)。
動畫權重系統用於確定如何AnimationTracks在同一優先級下播放的動畫會融合在一起。預設重量是一，在重量為零的 AnimationTrack 上沒有運動可見。在任何時間點顯示的姿勢由所有 Poses 和每個 AnimationTrack 的重量平均值決定。在大多數情況下，混合動畫不需要，使用 AnimationTrack.Priority 更適合。
範例程式碼
這個代碼示例載入兩個動畫到本地玩家的人形上，並展示如何使用 AnimationTrack.Play 中的 fadeTime 參數來確定動畫跟的重量現在到達其重量目標所需的時間。
因為 WeightCurrent 和 WeightTarget 是漂浮的 == 運算器無法用於比較，相反，更適合檢查他們之間的差異是否足夠小，以假設重量褪色已完成。
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方法
AdjustSpeed
此功能會更改動畫的 AnimationTrack.Speed 。速度的正值播放動畫向前，負值播放向後，0則暫停它。
動畫軌道的初始速度設為 AnimationTrack:Play() 中的參數。但播放時，可以使用「調整速度」來變更軌道的速度。當速度等於 1 時，動畫完成所需的時間等於 AnimationTrack.Length (以秒為單位)。
調整時，實際播放所需的時間可以通過將長度除以速度來計算。速度是一個無單位數量。
速度可以用來將動畫長度與不同的遊戲事件鏈結（例如重新充能能力），而無需上傳不同版本的相同動畫。
參數
動畫的播放速度將更改為。
返回
範例程式碼
下列功能將為特定時間播放動畫軌道。這是通過將動畫速度變更為所需播放時間除以動畫長度來實現的。這可以在開發者想要播放不同時間的標準動畫（例如，重新充能不同能力）的情況下使用。
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)在這個例子中載入了一名玩家和一個動畫。動畫軌道的長度決定速度為 1 時軌道需要多久才能播放。如果速度被調整，則實際播放所需的時間可以通過將長度除以速度來計算。
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
變更動畫的重量，其中可選擇的 fadeTime 參數決定 AnimationTrack.WeightCurrent 到達 AnimationTrack.WeightTarget 所需的時間長度。
當在 AnimationTrack 設置重量時,重量不會立即變更,但會從重量當前移動到AnimationTrack.WeightTarget。執行此操作所需的時間由播放動畫或調整重量時提供的 fadeTime 參數決定。
重量當前可以與 AnimationTrack.WeightTarget 對比，以查看是否已達到所需重量。請注意，這些值不應與 == 運算符進行等值檢查，因為這兩個值都是浮點。若要查看 WeightCurrent 是否已達到目標重量，建議查看這些值之間的距離是否足夠小 (見下方代碼示例)。
動畫權重系統用於確定如何AnimationTracks在同一優先級下播放的動畫會融合在一起。預設重量是一，在重量為零的 AnimationTrack 上沒有運動可見。在任何時間點顯示的姿勢由所有 Poses 和每個 AnimationTrack 的重量平均值決定。請參見下方的動畫融合實例。在大多數情況下，混合動畫不需要，使用 AnimationTrack.Priority 更適合。
參數
返回
範例程式碼
這個代碼樣本包含一個改變動畫軌道重量的功能，直到重量變更為新目標重量為止。
本樣本的目的是展示動畫跟蹤調整重量的 fadeTime 參數如何工作。在大多數情況下，如果開發者希望超過淡出時間，建議使用 wait(fadeTime)。
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
此功能返回與 event 事件相似的 AnimationTrack.KeyframeReached，除了只在 KeyframeMarker 中發射時，指定的 animation 被擊中時才會發射外。差異允許更大控制事件何時發觸發。
要了解有關使用此功能的更多信息，請參閱 動畫事件 在 動畫編輯器 文章中。
也見：
參數
用於創建信號名稱的 KeyframeMarker 名稱正在被創建。與 Keyframe 的名稱不要混淆。
返回
當動畫達到創建的 KeyframeMarker 時創建和發射的信號。與 Keyframe 的名稱不要混淆。
範例程式碼
This LocalScript code waits for the local player's Humanoid object to load, then it creates a new Animation instance with the proper Animation.AnimationId. The animation is then loaded onto the humanoid, creating an AnimationTrack, and the track is played with AnimationTrack:Play(). Following that, the AnimationTrack:GetMarkerReachedSignal() function detects when the "KickEnd" marker is hit.
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)GetTimeOfKeyframe
返回指定名稱的第一個 Keyframe 在 AnimationTrack 的時間位置。如果多個 Keyframes 分享相同名稱，將返回動畫中最早的一個。
此功能會在使用無效的鑰匙框名稱 (例如不存在) 或基礎的 Animation 尚未載入時返回錯誤。為了解決這個問題，請確保只使用正確的鑰匙框名稱，並在呼叫此函數之前載入動畫。
要檢查動畫是否已加載，請確認 AnimationTrack.Length 是否大於零。
參數
返回
範例程式碼
這個範例包含一個會跳到動畫跟中指定名稱的第一個關鍵框的功能。
因為動畫追蹤的時間位置無法在動畫播放期間設置，所以在動畫播放之前檢查是否動畫正在播放。
此樣本只會在動畫載入後工作。
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
當 AnimationTrack:Play() 被呼叫時，軌道的動畫將開始播放，動畫重量將從 0 增加到指定重量(默認為 1)，過渡時間為指定時間(默認為 0.1)。
AnimationTrack 將播放的速度由速度參數決定(默認為 1)。當速度等於 1 時，軌道完成所需的秒數等於軌道的 AnimationTrack.Length 屬性。例如，2的速度會讓軌道播放速度翻倍。
動畫的重量和速度也可以在動畫開始播放後使用 AnimationTrack:AdjustWeight() 和 AnimationTrack:AdjustSpeed() 方法進行更改。
如果開發者想使用 AnimationTrack.TimePosition 在特定點開始動畫，這很重要，動畫必須在此之前播放。
參數
返回
範例程式碼
下列功能將為特定時間播放動畫軌道。這是通過將動畫速度變更為所需播放時間除以動畫長度來實現的。這可以在開發者想要播放不同時間的標準動畫（例如，重新充能不同能力）的情況下使用。
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)以下代碼示例包含兩個功能，可以展示如何使用 AdjustSpeed 和 TimePosition 來在特定點凍結動畫。
第一個功能在特定時間點凍結動畫（在秒內定義）。第二次凍結在百分比（介於 0 或 100 之間）上，乘以軌道長度。
當動畫跟不在播放時，功能會檢查確保動畫先播放，然後才能繼續進行。
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)Stop
停止 AnimationTrack 。一旦呼叫，動畫的重量將在指定的時間長度內移向零，由可選擇的 fadeTime 參數決定。例如，如果 Stop() 被稱為 fadeTime 的 2 ，則需要兩秒鐘才能將軌道的重量達到零並完全結束其效果。請注意，無論動畫的初始重量如何，這都會是如此。
不建議在嘗試覆蓋此效果並立即終止動畫時使用 的 ，因為這會導致關節在原空間凍結。如果必須立即結束，請確保你的裝備中的 Motor.MaxVelocity 的 Motor6Ds 足夠高，以便它們能夠正確地捕捉。
參數
動畫重量將在何時、以秒為單位，消失掉的時間。
返回
範例程式碼
這個代碼示例包含一個功能，可以停止具有特定淡出時間的動畫追蹤，直到淡出完成且動畫追蹤的重量等於零為止。
本範例的目的是展示動畫跟停止的 fadeTime 參數如何工作。在大多數情況下，如果開發者希望超過淡出時間，建議使用 wait(fadeTime)。
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)活動
DidLoop
此事件會在下次更新時發生，當循環 AnimationTrack 完成一個循環時發生。
目前它也可能在非循環動畫軌道的正確結束發射，但這種行為不應該被依賴。
範例程式碼
在此代碼樣本中的功能將在循環上播放一個動畫軌道，對於特定數量的循環，在停止動畫之前。
在某些情況下，開發者可能希望在一定數量的循環後停止循環動畫，而不是在一定時間後。這是使用 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
當 AnimationTrack 完全移動世界上的任何東西時，發生火災。動畫已停止播放，「淡出」已完成，主題處於中立姿勢。
您可以使用此來在動畫軌道的主題回到中立姿勢時執行行動，或清理 AnimationTrack 或 AnimationTrack 。或任何相關連線。
範例程式碼
在此代碼樣本中的功能播放動畫軌道，直到停止和結束為止，在路徑上的每一步都打印。
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 秒
-- 在我們呼叫動畫Track:Stop之後，因為我們傳入了一個 3
-- 第二個 fadeOut。
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
每次播放的 AnimationTrack 達到一個沒有預設名稱 - "Keyframe"的 Keyframe 時，都會發生火災。
這個事件允許開發人員在動畫中的預定點執行代碼(由 Keyframe 名稱設置)。這樣可以通過在動畫中添加 Sounds 或 ParticleEffects 來擴展 Roblox 動畫的預設功能。
Keyframe 名稱不需要獨一無二。例如，如果動畫有三個名為「粒子」的關鍵幀，達到關鍵幀事件將在這些關鍵幀之一被達到時發射。
Keyframe 名稱可以在 Roblox 動畫編輯器中設置，當創建或編輯動畫時。然而，它們無法在播放之前在現有動畫上設置 Script 。
參數
Stopped
在 AnimationTrack 結束播放時發射。
此事件有多種用途。它可以用來等到 AnimationTrack 停止，然後再繼續 (例如，如果連環播放一系列動畫後停止)。它也可以用來清理任何在動畫播放期間創建的 Instances 。
範例程式碼
在此代碼範例中的功能將播放動畫軌道並持續輸出，直到停止為止，然後才印出。
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)