SuperAPI AI 工具集

roblox-animations

编程与开发

查看项目

更新于 10-17 16:13

技能介绍

Roblox 动画系统参考,围绕 Humanoid 角色与非 Humanoid 模型的动画播放、停止和混合展开。

一、核心对象。Animation 为资产引用,保存 AnimationId;Animator 位于 Humanoid 或 AnimationController 内,负责加载和驱动轨道;AnimationController 用于非角色骨架,替代 Humanoid;AnimationTrack 由 LoadAnimation 返回,控制播放。

二、代码运行位置。本地玩家角色应使用 LocalScript,放在 StarterCharacterScripts;NPC 或服务器拥有的模型应使用 Script,放在模型内或 ServerScriptService。资料明确提示:不要用 Script 播放玩家角色动画,否则无法正确复制到本地客户端。

三、加载与播放。示例在 StarterCharacterScripts 的 LocalScript 中获取 Humanoid 下的 Animator,创建 Animation 并设置 AnimationId,再通过 animator:LoadAnimation(animation) 得到 track。调用 track:Play() 使用默认淡入 0.1 秒、权重 1、速度 1;可传参 track:Play(0.1, 1, 0.5) 分别指定淡入时间、权重、速度。运行中可用 AdjustSpeed(1.5) 改变速度,用 AdjustWeight(0.5, 0.2) 设置权重与淡入时间;Stop() 默认淡出 0.1 秒,Stop(0.5) 淡出 0.5 秒。

四、事件。Stopped 在淡出完成后触发,可用 :Once 做一次性清理;GetMarkerReachedSignal("FootStep") 在到达 Animation Editor 中设置的命名关键帧标记时触发,回调可接收参数。

五、循环与单次。Looped 属性在 Animation Editor 中设置,也可运行时覆盖;循环动画不会自动停止,需调用 Stop;单次动画一个周期后自动停止。可将循环动画的 Looped 设为 false 强制只播一次,并用 Stopped:Once 监听结束。

六、优先级与混合。优先级由低到高为 Idle、Movement、Action、Action2、Action3、Action4、Core,高优先级在冲突关节上覆盖低优先级。相同优先级时用权重分配影响,如两个轨道分别以 0.6 和 0.4 权重播放,在共享关节上混合。

七、Humanoid 与 AnimationController。Humanoid 通过 FindFirstChildOfClass("Humanoid") 和 Animator 加载轨道;AnimationController 用于道具、载具、生物,需在其下查找或创建 Animator 再加载。缺少 Animator 子对象会导致轨道无法播放。

八、替换默认角色动画。角色内的 Animate LocalScript 保存动画引用,可在 CharacterAdded 后修改其 AnimationId。示例提供 replaceAnim 函数按槽位替换,可用槽位包括 idle、walk、run、jump、fall、climb、swim、swimidle、toolnone、toolslash、toollunge。

九、停止全部动画。示例 stopAll 遍历 animator:GetPlayingAnimationTracks() 并逐个 Stop,可指定淡出时间。

十、播放属性速查。Play 参数为 fadeTime(默认 0.1 秒)、weight(默认 1.0,0–1)、speed(默认 1.0);可读写 TimePosition、Length,读取 IsPlaying、WeightCurrent、WeightTarget,设置 Looped、Priority。

十一、上半身动画限制。优先级混合会影响动画涉及的所有关节;若只想让手臂播放挥手而腿部保持跑动或待机,动画本身在编辑器中只能给上半身骨骼打关键帧,不设置下半身关节。资料说明没有运行时关节遮罩 API,解决方式在动画资产而非脚本。

十二、常见错误与修正。在 Script 中播放角色动画应改用 StarterCharacterScripts 中的 LocalScript;在 Humanoid 上调用 LoadAnimation(已弃用)应改为在 Animator 上调用;两个动画在同一关节冲突应设置不同 Priority;Stopped 立即触发通常是动画长度为零或 Looped 设置错误;GetMarkerReachedSignal 不触发多因标记名拼写错误或添加标记后未重新上传动画;NPC 动画对其他客户端不可见应改用服务器 Script 播放;AnimationController 轨道不播放通常是缺少 Animator 子对象。