使用动画

一旦你创建了动画，你需要使用脚本将其包含在你的游戏中。你可以选择从脚本手动播放动画或替换玩家角色的默认动画。

从脚本播放动画

在某些情况下，你需要直接从脚本中播放动画，例如，当用户按下某个键或捡起特殊物品时。

人形

要在包含 Humanoid 对象的模型上播放动画，例如典型的可玩角色，请遵循以下基本模式：

1. 确保本地玩家的 Humanoid 包含一个 Animator 对象。
2. 创建一个具有正确 AnimationId 的新 Animation 实例。
3. 通过 Animator:LoadAnimation() 加载动画以创建 AnimationTrack。
4. 使用 AnimationTrack:Play() 播放轨道。

例如，以下 LocalScript，当放置在 StarterPlayerScripts 中时，将“踢腿”动画加载到玩家的角色上并播放。该脚本还利用 GetMarkerReachedSignal() 方法来检测特定的 动画事件 发生时。

LocalScript - 在玩家角色上播放自定义动画
local Players = game:GetService("Players")

local player = Players.LocalPlayer
local character = player.Character or player.CharacterAdded:Wait()

-- 确保角色的 humanoid 包含 "Animator" 对象
local humanoid = character:WaitForChild("Humanoid")
local animator = humanoid:WaitForChild("Animator")

-- 创建一个新的 "Animation" 实例并赋予动画资源 ID
local kickAnimation = Instance.new("Animation")
kickAnimation.AnimationId = "rbxassetid://2515090838"

-- 将动画加载到动画器上
local kickAnimationTrack = animator:LoadAnimation(kickAnimation)

-- 如果为动画定义了命名事件，将其连接到 "GetMarkerReachedSignal()"
kickAnimationTrack:GetMarkerReachedSignal("KickEnd"):Connect(function(paramString)
	print(paramString)
end)

task.wait(4)

-- 播放动画轨道
kickAnimationTrack:Play()

非人形

要在不包含 Humanoid 的模型上播放动画，您必须创建一个 AnimationController 及其子 Animator。例如，以下 Script（假定为模型的直接子项）加载“踢腿”动画并播放。

Script - 在角色模型上播放自定义动画
local rig = script.Parent

-- 创建一个新的 "Animation" 实例并赋予动画资源 ID
local kickAnimation = Instance.new("Animation")
kickAnimation.AnimationId = "rbxassetid://2515090838"

-- 创建一个新的 "AnimationController" 和 "Animator"
local animationController = Instance.new("AnimationController")
animationController.Parent = rig

local animator = Instance.new("Animator")
animator.Parent = animationController

-- 将动画加载到动画器上
local kickAnimationTrack = animator:LoadAnimation(kickAnimation)

-- 如果为动画定义了命名事件，将其连接到 "GetMarkerReachedSignal()"
kickAnimationTrack:GetMarkerReachedSignal("KickEnd"):Connect(function(paramString)
	print(paramString)
end)

task.wait(4)

-- 播放动画轨道
kickAnimationTrack:Play()

替换默认动画

默认情况下，Roblox 玩家角色包括常见的动画，如跑步、攀爬、游泳和跳跃。您可以用来自 目录 的动画或您自己的 自定义 动画替换这些 默认动画。

1. 按如下方法获取新动画的 资源 ID：

   • 对于使用 动画编辑器 创建的自定义动画，请遵循 导出 指令。
   • 从下面的 目录动画参考 中复制一个适当的 ID。例如，要将默认跑步动画替换为 忍者 跑 变体，请使用 656118852。

2. 在 资源管理器 窗口中，向 ServerScriptService 添加一个新的 Script。

   1. 将鼠标悬停在 ServerScriptService 上并点击 ⊕ 按钮。
   2. 从上下文菜单中插入 脚本。

3. 在新脚本中，粘贴以下代码：

   Script - 替换默认角色动画
   local Players = game:GetService("Players")
   
   local function onCharacterAdded(character)
   	-- 获取 humanoid 上的动画器
   	local humanoid = character:WaitForChild("Humanoid")
   	local animator = humanoid:WaitForChild("Animator")
   
   	-- 停止所有动画轨道
   	for _, playingTrack in animator:GetPlayingAnimationTracks() do
   		playingTrack:Stop(0)
   	end
   
   	local animateScript = character:WaitForChild("Animate")
   	--animateScript.run.RunAnim.AnimationId = "rbxassetid://"
   	--animateScript.walk.WalkAnim.AnimationId = "rbxassetid://"
   	--animateScript.jump.JumpAnim.AnimationId = "rbxassetid://"
   	--animateScript.idle.Animation1.AnimationId = "rbxassetid://"
   	--animateScript.idle.Animation2.AnimationId = "rbxassetid://"
   	--animateScript.fall.FallAnim.AnimationId = "rbxassetid://"
   	--animateScript.swim.Swim.AnimationId = "rbxassetid://"
   	--animateScript.swimidle.SwimIdle.AnimationId = "rbxassetid://"
   	--animateScript.climb.ClimbAnim.AnimationId = "rbxassetid://"
   end
   
   local function onPlayerAdded(player)
   	player.CharacterAppearanceLoaded:Connect(onCharacterAdded)
   end
   
   Players.PlayerAdded:Connect(onPlayerAdded)

4. 对于每一行引用 默认角色动画 的代码，取消注释并在 rbxassetid:// 后粘贴替换 ID。例如，要将默认跑步动画改为 忍者 跑 变体：

   Script - 替换默认角色动画
   local Players = game:GetService("Players")
   
   local function onCharacterAdded(character)
   	-- 获取 humanoid 上的动画器
   	local humanoid = character:WaitForChild("Humanoid")
   	local animator = humanoid:WaitForChild("Animator")
   
   	-- 停止所有动画轨道
   	for _, playingTrack in animator:GetPlayingAnimationTracks() do
   		playingTrack:Stop(0)
   	end
   
   	local animateScript = character:WaitForChild("Animate")
   	animateScript.run.RunAnim.AnimationId = "rbxassetid://656118852"
   	--animateScript.walk.WalkAnim.AnimationId = "rbxassetid://"
   	--animateScript.jump.JumpAnim.AnimationId = "rbxassetid://"
   	--animateScript.idle.Animation1.AnimationId = "rbxassetid://"
   	--animateScript.idle.Animation2.AnimationId = "rbxassetid://"
   	--animateScript.fall.FallAnim.AnimationId = "rbxassetid://"
   	--animateScript.swim.Swim.AnimationId = "rbxassetid://"
   	--animateScript.swimidle.SwimIdle.AnimationId = "rbxassetid://"
   	--animateScript.climb.ClimbAnim.AnimationId = "rbxassetid://"
   end
   
   local function onPlayerAdded(player)
   	player.CharacterAppearanceLoaded:Connect(onCharacterAdded)
   end
   
   Players.PlayerAdded:Connect(onPlayerAdded)

设置动画权重

您可以对同一动作使用多个动画。例如，代码示例中针对 替换默认动画 有两个 idle 变体。

当角色状态存在多个动画时，Animate 脚本会随机选择播放哪个，但您可以通过设置动画的 Weight 值来影响结果，公式如下：

• 动画权重 / 所有状态动画的总权重

在以下示例中，idle.Animation1 会在角色静止时播放 ⅓ 的时间，而 idle.Animation2 会播放 ⅔ 的时间。

Script - 替换默认角色动画
animateScript.idle.Animation1.AnimationId = "rbxassetid://656117400"
	animateScript.idle.Animation2.AnimationId = "rbxassetid://656118341"
	animateScript.idle.Animation1.Weight.Value = 5
	animateScript.idle.Animation2.Weight.Value = 10

动画参考

默认角色动画

以下表格包含您可以与 目录 动画或您自己的 自定义 动画 替换 的所有默认角色动画。请注意，Idle 有两个变体，您可以为其设置权重以播放得更多或更少。

目录动画

当使用头像动画包替换默认动画时，请使用以下引用来获取相应的资源 ID。例如，如果您想应用 忍者 跳跃 动画，请使用 656117878。请注意，Idle 有多个变体。