PlayableGraph Visualizer

本文档中的所有示例都使用 PlayableGraph Visualizer（如下图所示）来说明 Playables API 创建的树和节点。PlayableGraph Visualizer 是通过 GitHub 提供的工具。

要使用 PlayableGraph Visualizer，请执行以下操作：

1.从 GitHub 代码仓库下载与您的 Unity 版本对应的 PlayableGraph Visualizer

2.通过选择 Window > PlayableGraph Visualizer 打开该工具

3.使用 GraphVisualizerClient.Show(PlayableGraph graph, string name) 来注册您的图。

图中的可播放项 (Playable) 以彩色节点表示。线条颜色强度表示混合的权重。请参阅 GitHub 以了解关于此工具的更多信息。

播放游戏对象上的单个动画剪辑

以下示例演示一个简单的 PlayableGraph，它有一个链接到单个可播放节点的可播放项输出。可播放节点将播放单个动画剪辑（剪辑）。AnimationClipPlayable 必须包裹动画剪辑，使其与 Playables API 兼容。

使用 AnimationPlayableUtilities 来简化动画可播放项的创建和播放，如以下示例中所示：__ __

创建动画混合树

以下示例演示如何使用 AnimationMixerPlayable 来混合两个动画剪辑。在混合动画剪辑之前，它们必须由可播放项包裹。为此，AnimationClipPlayable（clipPlayable0 和 clipPlayable1）包裹每个 AnimationClip（clip0 和 clip1）。SetInputWeight() 方法动态调整每个可播放项的混合权重。

虽然在此示例中未显示 AnimationMixerPlayable，但也可使用它来混合可播放的混合器和其他可播放项。

混合 AnimationClip 和 AnimatorController

以下示例演示如何使用 AnimationMixerPlayable 来混合 AnimationClip 与 AnimatorController。

在混合 AnimationClip 和 AnimatorController 之前，它们必须由可播放项包裹。为此，AnimationClipPlayable (clipPlayable) 包裹 AnimationClip (clip)，而 AnimatorControllerPlayable (ctrlPlayable) 包裹 RuntimeAnimatorController (controller)。SetInputWeight() 方法动态调整每个可播放项的混合权重。

创建具有若干输出的 PlayableGraph

以下示例演示如何使用以下两个不同的可播放项输出类型来创建 PlayableGraph：AudioPlayableOutput 和 AnimationPlayableOutput。一个 PlayableGraph 可以有许多不同类型的可播放项输出。

此示例还演示如何通过连接到 AudioPlayableOutput 的 AudioClipPlayable 来播放 AudioClip。

控制树的播放状态

以下示例演示如何使用 Playable.SetPlayState() 方法来控制 PlayableGraph 树上节点的播放状态。SetPlayState 方法控制整个树、其分支之一或单个节点的播放状态。

设置节点的播放状态时，状态会传播到所有子节点（无论其播放状态如何）。例如，如果显式暂停了子节点，则将父节点设置为“播放”也会将其所有子节点设置为“播放”。

在此示例中，PlayableGraph 包含的一个混合器将混合两个动画剪辑。AnimationClipPlayable 包裹每个动画剪辑，而 SetPlayState() 方法显式暂停第二个可播放项。第二个 AnimationClipPlayable 被显式暂停，因此其内部时间不会推进而输出相同值。确切值取决于 AnimationClipPlayable 暂停时的具体时间。

控制树的时序

以下示例演示如何使用 Play() 方法来播放 PlayableGraph、如何使用 SetPlayState() 方法来暂停可播放项以及如何使用 SetTime() 方法来通过变量手动设置可播放项的本地时间。

创建 PlayableBehaviour

以下示例演示如何使用 PlayableBehaviour 公有类来创建自定义的可播放项。此示例还演示如何重载 PrepareFrame() 虚拟方法以控制 PlayableGraph 上的节点。自定义的可播放项可重载 PlayableBehaviour 类的任何其他虚拟方法。

在此示例中，受控节点是一系列动画剪辑 (clipsToPlay)。SetInputMethod() 将修改每个动画剪辑的混合权重，确保一次只播放一个剪辑，而 SetTime() 方法将调整本地时间，以便在激活动画剪辑时开始播放。