目录

Wwise Unity Integration Documentation
Wwise Timeline Integration

Timeline 是 Unity 的一款过场动画内容编辑工具。它可以用来创建游戏序列、音频序列和其他过场动画内容。

有关 Timeline 的详细信息,请参阅 Timeline 文档

有关如何创建 Timeline Asset 和 Timeline instance 的说明,请参阅 Timeline 用法

Wwise Timeline Track

Wwise Unity Integration 增加了两个 Track: AkRTPC Track 和 AkEvent Track 。AkRTPC Track 用于设置 Game Parameter 值, AkEvent Track 用于发送 Wwise Event。您可以在 Unity 中使用 Add 下拉按钮将 AkRTPC Track 和 AkEvent Track 添加到 Timeline。

Timeline_Tracks.png
Adding AK tracks to Timeline

Ak Track 对象绑定

AkEvent Track 和 AkRTPC Track 包含对象绑定,可设为任意 Game Object。若将此项保留设为 None,则将针对 Timeline 所属的 Game Object 触发 Track 中的 Event 消息或 RTPC 消息(即该 Game Object 包含 PlayableDirector 组件,可用于触发 Timeline)。若 Track 绑定设为其他 Game Object,则将针对该 Game Object 触发所述消息。

AkRTPC Parameter 属性

AkRTPC Track 在其对应属性检视器中包含一项属性: Parameter 。该属性为 Wwise RTPC 参数,可在 Track 中的各个 Clip 中设置。

Timeline_RTPCTrackProperties.png
RTPC Track Parameter Property

Wwise Timeline Playable Clip

AkEvent Track 和 AkRTPC Track 分别存在相应的 Clip: AkEventPlayable Clip 和 AkRTPCPlayable Clip 。您可以使用 Track 对应的菜单将这些 Clip 添加到 Track 中。

Timeline_AddingAClip.png
Adding AK clips to AK tracks

Timeline Clip 属性

Timeline 中的所有 Clip 都有计时属性,显示在检视器的顶部分区中。有关这些属性的详细信息,请参阅 Clip 属性

AkRTPCPlayable Clip 属性

您可以在 AkRTPCPlayable Clip 对应的检视器中访问这些属性:

Timeline_RTPCProperties.png
AkRTPCPlayable Clip Properties
  • Set RTPC Globally:若选中此项,则针对所有对象统一设置 RTPC。
  • Override Track Object:若选中此项,则针对 RTPC Object 属性中所选 Game Object 设置 RTPC(仅在未选中 Set RTPC Globally 时可用)。
  • RTPC Object:需要更新 RTPC 的 Game Object。若将此项设为 None,则针对 Track 对象设置 RTPC(若 Track 对象设为 None,则针对 Timeline 所属对象设置 RTPC)。此项仅在选中 Override Track Object 时可用。
  • Animated Value: RTPC Value:由 RTPC Track 进行动态处理的值。为了对此值进行动态处理,需要对用于录制的 Track 进行预备,并将播放光标移动到 RTPCPlayable Clip 内的某个位置,然后在属性检视器中编辑该值。
Timeline_AnimatingRTPCValues.png
Animating RTPC Values from Timeline

按照以下步骤将关键帧插入到 RTPC Track 中(RTPC Clip 下方)。然后,便可使用此 Unity 曲线编辑器添加更多关键帧。这些关键帧设有上下文菜单,可用来精确设定数值。

Timeline_RTPCKeyframeContextMenu.png
RTPC Keyframe Context Menu
Timeline_RTPCKeyframeEdit.png
Editting RTPC Keyframe Values

AkEventPlayable Clip 属性

您可以在 AkEventPlayable Clip 对应的检视器中访问以下属性:

Timeline_EventProperties.png
AkEventPlayable Clip Properties
  • Override Track Object:若选中此项,则通过特定 Game Object(不同于 Track 绑定对象)触发 Event。若将 Track 绑定设为 None(参见 Ak Track 对象绑定 ),则会同时覆盖 Timeline 所属对象。
  • Emitter Object Ref:用来触发 Event 的 Game Object(仅在选中 Override Track Object 时可用)。
  • Event:要通过此 Clip 触发的 Wwise Event。

已知问题和限制

目前在 Unity Editor 中仅支持在 Play 模式下拖动播放。这是因为在 Edit 模式下 Unity Playable 回调存在问题。Unity 已经注意到这一问题:953109。也就是说,在 Edit 模式下不支持 Play from anywhere(从任意位置开始播放)行为。若将播放光标放在 Clip 的开头和结尾之间,并在 Edit 模式下播放时间线,将不会触发该 Event。

Wwise 工程设置

为了确保在 AkEvent Track 中正确表示 Event 长度,需要对 Wwise 工程进行相应设置,以便估算音频 Event 的时长。同时,还必须生成 JSON 元数据。若要启用这些工程全局设置,请转到 Project Settings 的 SoundBanks 选项卡。在 Metadata Options 分组框内选中 Estimated duration 复选框,并在 SoundBank Settings 分组框内选中 Generate JSON Metadata 复选框(如下所示)。

project_settings.png
Required Project Settings for AkEvent Tracks