Integration Demo 示例

Integration Demo 应用程序包含一系列的演示，展示如何在游戏中集成声音引擎的各种功能。

Note: 本节中展示的所有代码在“samples\IntegrationDemo$(Platform)”目录下的工程示例中都可以找到。

Wwise 工程

此程序的 Wwise 工程也可在“samples\IntegrationDemo\WwiseProject”中找到。

Note: 此程序的 Wwise 工程使用各种音频文件转码格式，某些格式可能不可用，具体取决于安装的 Wwise 支持的平台。在 Wwise 中打开工程后，您可能会看到诸如以下警告：

'\Actor-Mixer Hierarchy\Dialogues\Captain_A\UNA-BM-AL_01\UNA-BM-AL_01' uses the conversion plugin 'XMA', which is not installed.

您可以将所有不可用平台的转码格式更改为 PCM，从而移除这些消息。有关详细信息，请参阅《Wwise 用户指南》中的以下主题：音频文件转码。

此工程的 SoundBank 也与 SDK 一起安装在“samples\IntegrationDemo\WwiseProject\GeneratedSoundBanks”文件夹中。

要重新生成 SoundBank，请确保在 SoundBank Manager 中执行以下操作：

勾选 SoundBank 列表中的所有 SoundBank。
勾选经过测试的所有平台。
勾选语言列表中的所有语言。

这些设置一旦正确，您可以在 SoundBank Manager 中单击 Generate 来生成 SoundBank。

构建和运行演示

Integration Demo 二进制文件位于“\[Debug|Profile|Release]\bin”目录下。如果您想自己重新构建此应用程序，则按照以下步骤执行：

Windows

确认在您的机器中安装的 DirectX SDK 版本与平台要求中提及的版本匹配。
在默认路径下为 Windows 生成 Integration Demo SoundBank。
打开在“samples\IntegrationDemo\Windows”中找到的解决方案，并使用期望的配置创建。

要运行 Integration Demo，只需启动在上述目录中找到的可执行文件即可。

Mac

确认在您的机器中安装的 XCode 版本与平台要求中提及的版本匹配。
打开在“samples\IntegrationDemo\Mac”中找到的 Xcode 工程，并使用期望的配置创建。
要运行 Integration Demo，只需启动在目录“Mac\[Debug|Profile|Release]”中找到的可执行文件即可。

Note: 安装程序中不包含这些 SoundBank，必须使用设计工具生成。

iOS/tvOS

确认在您的机器中安装的 iOS/tvOS SDK 版本与在平台要求中提及的版本匹配。
打开在“samples\IntegrationDemo\iOS”或“samples\IntegrationDemo\tvOS”中找到的 Xcode 工程，并使用期望的配置创建。

Note: 安装程序中不包含这些 SoundBank，必须使用设计工具生成。

Android

确认您机器中针对 Android 的 SDK 和工具版本与在平台要求中提及的版本匹配。
打开“samples\IntegrationDemo\WwiseProject”中的 Wwise 工程，并在默认路径下为 Android 生成 SoundBank。
重建 IntegrationDemo（注意，SDK 中已预先构建好了）
- 打开命令行窗口
- 将目录更改为 SDK\samples\IntegrationDemo\Android 。
- 键入 ndk-build AK_CONFIG=[Debug|Profile|Release] 。
- 键入 ant debug install，然后创建并安装 APK
为了安装到连接好的设备上，步骤如下：
- 打开命令行窗口
- 将目录更改为 SDK\Android_[the Android hardware you use] (armeabi-v7a, arm64-v8a, x86, x86_x64)\[Debug|Profile|Release]\bin 。例如： SDK\Android_armeabi-v7a\Debug\bin
- 键入 adb install IntegrationDemo.apk 。

备选构建方法，采用 NVIDIA CodeWorks：若已安装适用于 Visual Studio 的 CodeWorks 插件，我们将提供一个用于编译和部署 IntegrationDemo 的 Visual Studio 工程。它跟其他 Visual Studio 工程的构建或运行方式完全相同。

Note: 您将需要使用软件键盘或硬件键盘与 integration demo 进行互动。按住 Menu 按钮 2 秒钟可打开软件键盘。

使用说明

在 Windows 中，您可以使用键盘、连接的控制器或任何 DirectInput 兼容设备浏览 Integration Demo。

要在页面上的控件之间导航，使用 UP 和 DOWN 方向键或者游戏手柄上的 UP 和 DOWN 按钮。
要激活选中的控件，单击 Enter 键或者游戏手柄上的 A/X 按钮。
要在菜单中返回页面，单击 Esc 键或者游戏手柄上的 B/O 按钮。

某些控件（例如切换控件和数字滑块）可让您修改数值。要修改数值，单击 LEFT 和 RIGHT 方向键或者游戏手柄上的 LEFT 和 RIGHT 按钮。

Tip: 此应用程序有联机帮助功能！要访问帮助页面，按键盘上的 F1 键或者游戏手柄上的 START 按钮。

演示

所有演示代码均可在 samples 目录中找到。 例如，您可以在该目录下的 DemoLocalization.h 和 DemoLocalization.cpp 文件中找到 Localization 演示代码。

Tip: 有关每个演示的相关信息也可在 Integration Demo 应用程序联机帮助中找到。

本地化

此演示展示如何实现本地化音频。本地化的音频对象位于 SoundBank 生成目录的子目录下的相关语言 SoundBank 中。我们通过卸载当前 SoundBank，然后加载期望的特定语言的 SoundBank 来达到本地化效果。

使用“Language”切换控件切换当前语言。然后按 Say Hello 按钮试听选定语言的问候。

有关语言和本地化的更多信息，请参阅集成详情——语言与语音

动态对白

Dynamic Dialogue 演示运行一系列使用 Wwise Dynamic Dialogue 功能的测试。每项测试演示不同的控制流程，以便您可以试听它产生的效果：

测试 1：显示如何使用 Wwise ID 播放简单的动态序列。
测试 2：与测试 1 一样，但使用的是字符串而不是 ID。
测试 3：展示在播放期间如何向动态播放列表中添加项目。
测试 4：展示在播放期间如何向动态播放列表中插入项目，
测试 5：展示当向空播放列表中添加项目时的情况。
测试 6：展示如何对动态序列使用“Stop”调用。
测试 7：展示如何对动态序列使用“Break”调用。
测试 8：展示如何对动态序列使用“Pause”和“Resume”调用。
测试 9：展示在将项目排队送入动态序列时如何使用“Delay”调用。
测试 10：展示如何在播放期间清空播放列表。
测试 11：展示在停止和清空播放列表时的情况。
测试 12：展示当对播放列表调用“Break”并将它清空的情况。
测试 13：展示暂停和清空播放列表时的情况。
测试 14：展示在使用动态对白时如何使用带自定义参数的回调函数。
测试 15：显示如何使用回调执行任务（在这种情况下，在播放 3 个项目后取消播放）。
测试 16：显示如何使用回调执行任务（在这种情况下，在第一个序列结束后播放第二个序列）。
测试 17：显示如何结合 Dynamic Dialogue 使用 Wwise Event。

有关动态对白的更多信息，请参阅集成详情——动态对白

RTPC（汽车发动机）

此演示展示如何使用 RTPC。RPM 数字滑块链接到与发动机相关联的 RTPC 值（RPM）。按“Start Engine”按钮启动/停止汽车发动机音频。使用 RPM 滑块更改 RTPC 值并试听效果。

有关 RTPC 的更多信息，请参阅集成详情——RTPC

脚步

此演示展示在游戏中实现脚步声的各种方式。它还展示了基于表面类型驱动的 SoundBank 管理，以最大限度地降低当某个表面类型不用时的媒体和元数据内存占用。最后，此演示还展示了一个非常简单的环境效果器示例。

在此示例中，脚步声通过 3 个变量来修改：表面类型、行走速度和行走人体重。

表面问题（Surface 切换开关）表面将更改声音的实际属性，因此表面不可模拟。然而，脚步声为撞击声，因此我们选择使用 SoundSeed Impact 来代表大多数表面类型。每个表面都有 SS Impact 可以调制的特定共振特性。SS Impact 、使用一小部分真实声音来产生大量各种声音，因此可以节省空间。

行走速度问题（Footstep_Speed RTPC）此工程支持几乎在所有情况下的从行走到奔跑的顺畅过渡。对于此变量，我们假设存在以下条件：走得越快，脚步声越短，撞击地面越重。这分别相当于更改音高和音量。在工程中查找有关这些参数的 RTPC。在此演示中，速度 RTPC 直接由操纵杆位移来驱动。

行走人体重问题（Footstep_Weight RTPC）脚步结构支持各种行走人体重。我们假定在现实生活中，行走人体重越重，脚步声越长，并且越模糊。这分别相当于修改音高和 LPF。在工程中查找有关这些参数的 RTPC。

对于每种表面，我们展示了处理声音样本和变量的不同方式。它们只是一些您可以在自己的结构中使用的建议和想法。

碎石我们的碎石样本非常嘈杂，它们使用 SoundSeed Impact 的效果不太好。另外它们非常相似，因此我们无需采集大量有关此表面的样本。使用一点音量、LPF 和音高随机化可以获得更多版本。体重影响通过 EQ 效果器来实现，它的增益参数由体重 RTPC 驱动。对于轻脚步声，提高频率，对于重脚步声，则采取相反的操作。注意 RTPC 对音高和音量的影响。

金属金属表面是关于如何使用 SoundSeed Impact 的教科式案例；金属表面上存在大量的共振。在我们的例子中，我们可以轻松地识别脚后跟撞击声，接着是脚尖撞击声。为了获得更多化的变化，我们将每个样本一分为二。这可以让我们独立地将每段的音高随机化。我们使用精确到采样点级过渡序列，对它们进行了重新组合。基于 5 个原始样本，我们获得了 25 个基本组合。通过添加某个音高随机化和 SS Impact 的自然随机化，我们可以获得各式各样的声音。体重和速度 RTPC 驱动 SS Impact 参数以及基本的音高和 LPF。

木材对于木质表面，行走和奔跑样本大相径庭。重脚步声和轻脚步声也是如此。因此它的组织方式更偏向于传统切换层级结构。两种切换容器均由 RTPC 驱动的切换开关驱动（查询 GameSync 选项卡、Footstep_Gait 和 Footstep_Weight）。木质表面也很适合使用 SS Impact。

泥土在这种表面上行走和奔跑的样本有些类似，因此我们决定使用混合容器执行过渡。有关音高和音高的 RTPC 用于考虑体重。

在此演示中， SoundBank 分为四个媒体 SoundBank （每种表面各一个媒体 SoundBank ）。我们将屏幕一分为四，每种表面之间有一个缓冲区，在该缓冲区内要加载两个媒体 SoundBank。其目的在于避免加载媒体 SoundBank 时导致脚步声中存在间隙。在 SoundBank 管理器中，查看 GameSync 选项卡。注意，每个表面 SoundBank 仅包含相应的表面切换开关。这仅包括与该 SoundBank 中的切换开关相关的层级结构，与其它的无关。在大型游戏中，这一设置有限制特定场景中用不上的样本数量，从而限制内存占用的优势。对于基于关卡或分区的游戏，识别所用的表面非常容易，因为在设计阶段就已经知道了。对于开放世界式游戏，这更为棘手，很大程度上取决于游戏的组织，但仍可以实现。例如，如果玩家目前位于一个温暖的城市，在长时间内不会移到寒冷的环境，那么在内存中保留“冰雪”表面声音则没有任何用处。

字幕/标记

此演示展示如何设置回调函数以在点击声音文件内部的标记时接收通知。对于此演示，我们使用标记来对字幕和音频轨进行同步。

有关标记的更多信息，请参阅集成 Marker 。

音乐回调

音乐同步回调演示——此演示展示一般如何使用音乐回调。节拍和小节通知从音乐节拍和拍号信息中生成。音乐播放列表回调演示——此示例强制随机播放列表按顺序选择下一项目。播放列表项目也可通过回调来阻止。 MIDI 回调演示——展示在回调期间游戏可收到的 MIDI 消息。MIDI 消息包括 MIDI 音符、CC 值、弯音、触后和程序变化。

有产在音乐回调的更多信息，请参阅集成详情——音乐回调

互动音乐

此示例使用音乐切换容器。尝试切换状态，方法是触发在演示页面中所列的事件。切换状态可能产生立即结果，或者在音乐容器规则中指定的时间发生状态切换。

振动

这是多人游戏演示，展示如何将 Wwise 的振动引擎集成到游戏中。

在此演示中，每个玩家可选择是关闭房门还是使用他们手中所持的枪支开枪。靠近门这个游戏对象的每个玩家和玩家自己的枪支都设有听者。通过这种方法，当任何玩家关门时，所有玩家都会收到强制反馈反应。然而，只有开枪的玩家才会收到该事件的强制反馈。另外，在 PS4 上，将只在各个玩家对应的游戏控制器扬声器中播放枪声。

Windows

Note: 使用键盘的玩家应插入游戏手柄来参与此演示。

此代码展示了如何使用二路输出、Wwise Motion 以及 Listener/Emitter 管理。

参见:

背景音乐演示

本例展示了 Xbox One 和 PS4 相关 DVR 法律要求的应对措施。由于很多游戏中的音乐都受版权保护，所以一般不允许使用内置 DVR 进行录制。此演示展示了使用和不使用 DVR 录制的声音之间的差异。请参阅 Wwise Project 并检查 BGMDemo 文件夹中的声音设置，同时注意其通路及所用 Audio Device。Non-Recordable 声音将被发送到输出至 DVR_Bypass 输出的总线。

参见:

集成二路输出

话筒/音频输入

此演示展示如何记录来自话筒的音频以及在 Wwise 声音引擎中输入该音频。在 Integration Demo 中，选择“Microphone Demo”，并对着话筒讲话，以试听从 Wwise 声音引擎播放出来的您的声音。切换“Enable Delay”以试听送入到音频输入插件中的音频数据如何被处理，如同在 Wwise 中创建的任何其它声音一样。

每个平台用来访问话筒的核心 API 大不相同。检查 Integration Demo 代码中的 SoundInput 和 SoundInputMgr 类以查看它们如何与 AudioInput 插件互动。

话筒样本都在所有平台上使用“Logitech USB Microphones”进行了测试。

参见:

音频输入源插件.

外部源

此演示展示如何使用外部源。两个按钮播放同一声音结构，但在运行时使用源“1”、“2”和“3”或源“4”、“5”和“6”设置。

有关外部源功能的更多信息，请阅集成 External Source 。

另外，外部源在文件包装程序中打包，并在打开演示页面时加载。请参阅 Wwise 帮助了解有关 File Packager 的更多信息，并参阅流播放/流管理器一章了解有关文件包运行时情况的更多详情。

Wwise SDK 2017.2.10