Wwise SDK 2023.1.6
|
集成 Wwise 声音引擎的第一步是在游戏启动时正确初始化构成声音引擎的各种模块。
在本示例工程中,定义了以下函数来执行与声音引擎初始化相关的一切操作:
在主函数的开头调用它。让我们查看一下需要初始化的各项:
第一个您必须初始化的组件是 Memory Manager(内存管理器)。您可以使用以下代码来创建默认的 Memory Manager:
![]() | 备注: 您可以覆盖 Memory Manager,在这种情况下,必须根据需要修改上述代码。请参阅 取代内存管理器 了解更多信息。 |
请参阅 Memory Manager 了解有关 Memory Manager 的更多详情。
Memory Manager 一旦初始化,我们就可以继续初始化 Streaming Manager 了。
以下代码对默认 Streaming Manager 进行初始化。它需要 AK::StreamMgr::IAkFileLocationResolver
实例,并会创建流播放设备。This requires an instance of AK::StreamMgr::IAkLowLevelIOHook
. This interface is defined in AkStreamMgrModule.h, which contains all definitions that are specific to the default Stream Manager implementation provided with the SDK.
对于磁盘 I/O,集成声音引擎的推荐方式是使用默认 Stream Manager 实现,并实现 AkStreamMgrModule.h 中定义的接口。这些接口构成了 Low-Level I/O 子模块。请参阅 流播放/流管理器 了解更多信息。
This example uses the sample CAkFilePackageLowLevelIODeferred as is. This class implements both AK::StreamMgr::IAkFileLocationResolver and AK::StreamMgr::IAkLowLevelIOHook interfaces, and is able to load file packages generated with the File Packager utility (refer to 文件包底层 I/O 实现 and File Packager 实用程序 for more information about the File Packager and how it works in the Low-Level I/O).
请参阅 Low-Level I/O 了解有关 Low-Level I/O 的更多信息。
有关默认 Stream Manager 和流播放设备初始化设置的更多信息,请参阅 Audiokinetic Stream Manager 初始化设置 。
![]() | 注意: 某些初始化设置使用针对特定平台的成员结构,例如 AkThreadProperties。 |
如果您决定覆盖默认的 Low-Level I/O 实现或者整个 Streaming Manager,需要相应地修改此代码。请参阅 流播放/流管理器 了解更多信息。
现在基本模块已经初始化,下面我们可以对声音引擎本身进行初始化了:
有关如何初始化声音引擎的更多信息,请参阅 高级声音引擎集成
如果您的工程使用互动音乐功能,在声音引擎之后必须对音乐引擎进行初始化。
若您的工程使用 Wwise Spatial Audio,则在声音引擎之后还须初始化 Spatial Audio 库。有关如何使用 Spatial Audio 的基本信息,请参阅 API 设置 章节。如需了解可用于配置 Spatial Audio 的各项参数,请参阅 AkSpatialAudioInitSettings 章节。
![]() | 备注: 若要使用 Spatial Audio,必须链接 Spatial Audio 模块。 |
如果您希望使用 Wwise 创作应用程序来连接游戏并进行游戏内混音、性能分析和故障排除,下一步就要对通信功能进行初始化。强烈建议这样做,因为游戏内混音、性能分析和故障排除是声音设计师高效处理游戏音频的强大武器。
![]() | 备注: 要使用通信功能,您需要与 CommunicationCentral 模块建立链接。 |
![]() | 备注: 通信功能只有在声音引擎的 Debug 和 Profile 配置中才可用。游戏的零售版中不需要通信功能,因此声音引擎的发布版本中没有这一功能。以下代码使用 AK_OPTIMIZED 符号将通信相关代码排除在发布版本之外。 |
现在您已将声音引擎的所有模块初始化。然后应注册插件(请参阅 插件示例 )。请参阅 创建重复调用来执行音频处理 详细了解您在游戏循环中用于处理音频的、必须执行的调用。
有些控制台通信库不能正确地平衡初始化/终止调用;因此,调用 AK::Comm::Term 将终止控制台的底层通信库。这将关闭游戏的所有 TCP/IP 通信。如果您的游戏需要在终止后使通信库保持启用状态,AkCommSettings(结合 Ak::Comm:Init 使用)具有可供选择是否将系统库初始化的参数。如果您选择自己将通信库初始化,则请参照 Wwise 声音引擎的以下代码。游戏中应执行类似的代码。
Windows 套接字初始化:
终止:
AkCommSettings 结构的 AkCommSettings::ports 成员代表 Wwise 创作应用程序与声音引擎之间进行通信所使用的网络端口。当 Wwise 通信功能启用时,所有这些端口在游戏中都会打开。
其中 AkCommSettings::Ports::uDiscoveryBroadcast 端口不是动态的(不能设置为 0)。Wwise 创作应用程序需知道该端口才能在网络上发现游戏。另外,此处的指定值必须是创作应用程序 Project Settings 的 Network 选项卡中指定的值。
![]() | 技巧: 如果您的团队正在使用 Wwise 制作多款游戏,可以为每款游戏使用不同的 Discovery Broadcast 端口。通过这种方法,在 Wwise 创作应用程序中打开 Remote Connections 窗口时,只有对应当前 Wwise 工程的游戏才会被列出。更改此端口时,请确保在创作应用程序的 Project Settings 中和游戏中传递给 AK::Comm::Init() 的 AkCommSettings 结构中一起更改。 |
结构中的另一端口可以是动态的(或临时的)。这意味着,操作系统使用的不是固定端口,而是自动选择一个端口:
此端口在默认情况下是动态的。建议将其保留为动态端口以尽量降低与其他应用程序发生冲突的机率。
若其与游戏的其他组件所用的端口发生冲突,请在调用 AK::Comm::Init() 前在 AkCommSettings 结构中加以更改。
![]() | 备注: 在多平台游戏中,可在不同平台上对 AkCommSettings::Ports::uCommand 使用不同的端口。 |
![]() | 技巧: 有关动态/临时端口的详细信息,请参阅以下文章: |
Wwise 通信中还涉及另一个端口,但它只在创作应用程序中打开,因此不是 AkCommSettings::Ports 结构的一部分。
创作应用程序使用该端口来接收针对 Discovery Broadcast 消息的响应,这些消息用于检测网络上运行的游戏。它在默认情况下是动态的(设置为 0),但可以在创作应用程序的 Project Settings 中进行更改。