使用动画

一旦你创建了一个动画，你需要使用脚本将其包含到你的体验中。你可以从脚本中手动播放动画或为玩家角色替换默认动画。

从脚本播放动画

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

人形

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

1. 确保本地玩家的 Humanoid 包含一个 Animator 对象。
2. 创建一个新的 Animation 实例，并正确赋值 AnimationId。
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()

-- 确保角色的人形包含一个 "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（假定为模型的直接子级）加载一个“踢腿”动画并播放它。

脚本 - 在角色模型上播放自定义动画
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。例如，要将默认奔跑动画替换为Ninja Run 变体，使用 656118852。

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

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

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

   脚本 - 替换默认角色动画
   local Players = game:GetService("Players")
   
   local function onCharacterAdded(character)
   	-- 获取人形上的动画控制器
   	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。例如，要将默认奔跑动画更改为Ninja Run 变体：

   脚本 - 替换默认角色动画
   local Players = game:GetService("Players")
   
   local function onCharacterAdded(character)
   	-- 获取人形上的动画控制器
   	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 将播放 ⅔ 的时间。

脚本 - 替换默认角色动画
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 的引用。例如，如果你想应用Ninja Jump 动画，请使用 656117878。请注意，Idle 有多个变体。