身体动画

查找指南，了解如何使用代码驱动的 Body Animation 模块为 Convai 角色添加待机、说话动作、行走和手势。

身体动画是 Convai 具身模块，可播放角色的待机、说话、移动、动作和指向动作。一个组件， ConvaiBodyAnimationController，构建并运行一个分层的 PlayableGraph 直接针对 Humanoid Animator ——无需编写 Animator Controller 资源。内容来自一个 ConvaiBodyAnimationSet 你分配的，而行为则在一个 ConvaiBodyAnimationConfig.

---

身体动画为角色带来的效果

行为	它的外观
空闲	角色会在多个已制作的待机变体之间切换，而不是保持一个静态姿势。
说话动作	角色说话时，会播放上半身手势片段，并根据实时语音能量进行缩放。
移动	与 NavMesh 同步的步行和慢跑；当所选素材集制作了这些动作时，还会包含方向性的起步、停止和转身。
动作和手势	命名片段，例如 挥手 或 舞蹈，由 Convai 动作触发，或通过你自己的代码触发 PlayAction.
指向	角色会将手臂抬向世界中的某个位置或一个移动目标，并保持该姿势。

添加 ConvaiBodyAnimationController 到角色上，通过 Convai > 具身化 > 身体动画。SDK 随附一套默认动画集，因此新角色无需你先获取任何片段就能移动。

---

无需 Animator Controller 资源

你可能已知的其他 Unity 动画工作流——在 Animator 窗口中配置状态、过渡和参数——在这里都不适用。该控制器会完全根据 PlayableGraph 在代码中完全基于 ConvaiBodyAnimationSet 和 ConvaiBodyAnimationConfig 你分配的内容进行构建，并在任一项发生变化时重新构建它。 身体动画的工作方式 涵盖了该图所运行的层级堆栈。

---

从哪里开始

身体动画快速上手

---

探索身体动画

身体动画的工作方式 用于播放待机、说话、动作和指向动作的分层图，以及对话状态如何驱动它。

身体动画快速入门 添加带有随附动画集的组件，并在播放模式下查看待机和说话动作。

构建动画集 从一个片段文件夹中，或逐项，自行组装你的 ConvaiBodyAnimationSet。

配置运动 添加 ConvaiNavMeshLocomotion，或连接自定义移动源，并调节步行和慢跑速度。

播放动作和手势 从你自己的代码中触发命名动作、锚定动作和指向。

身体动画配置参考 按部分分组的每个 ConvaiBodyAnimationConfig 字段及其默认值。

身体动画脚本参考 ConvaiBodyAnimationController 的公开 API：方法、句柄和事件。

身体动画使用示例 一个引导式行走、一个按提示触发的手势，以及对场景对象的指向。

排查身体动画故障 无动作、T 姿势、移动不同步，以及如何阅读跟踪日志。