版本
menu_open
警告：此页面上某些受保护的信息未予显示。
若为特定平台的授权用户，请确保已登录相应的帐户。
若为特定平台的授权用户，请确保已登录相应的帐户。
|
Wwise SDK 2024.1.1
|
构建配置
简介
Wwise 声音引擎 SDK 随附三种构建配置：Debug、Profile 和 Release。
声音引擎的 Debug（调试） 版本是非优化构建配置，带有额外调试信息，例如断言和调试输出字符串。我们不推荐使用此配置，因为使用此配置时，性能将受到重大影响。尽管如此，如果在早期集成过程中发生问题，此版本可用于验证集成工作。
声音引擎的 Profile（性能分析） 版本是优化过的构建版本，为与 Wwise 通信提供支持。此配置适用于日常开发过程。由于它有通信功能，因此不应该用于游戏的最终零售版本。
最后，声音引擎的 Release（发布） 版本是不带通信支持的优化构建版本。使用此配置时，必须在编译时定义预处理器定义 AK_OPTIMIZED 。CommunicationCentral 库也应从链接依赖中移除。此构建配置提供所有三种配置中最高的性能，应该用于最终零售版本。
 | 备注: 在 Windows 中，如果项目需要使用 C 运行时库的静态版本（/MT 或 /MTd），它应与 Debug(StaticCRT) 、 Profile(StaticCRT) 和 Release(StaticCRT) 文件夹中的 Wwise 库而非标准配置相链接。 |
库依赖要求
以下是每个构建配置所要求的库依赖。当同一库有多个版本时，注意只有一个会标记为必需。由音频程序员决定应用程序需要哪个 Wwise SDK 版本。
声音引擎
下表列举声音引擎集成所需要的输入库。
| 库 | 说明 |
| AkSoundEngine | 声音引擎核心 |
| AkMemoryMgr | 内存管理器 |
| AkStreamMgr | I/O 管理器 |
| AkMusicEngine | 音乐引擎 |
| AkSpatialAudio | 内置 Spatial Audio 功能 |
| CommunicationCentral | Wwise 通信 * |
| * Release 配置不需要。 | |
| 备注: Microsoft 平台所用库文件使用 |
| 备注: 不使用互动音乐功能的应用程序不必与 AkMusicEngine 链接。AkMemoryMgr 和 AkStreamMgr 分别是 Audiokinetic 对内存管理器和流管理器的默认实现。如果您决定不沿用它们，则要与您自己的库链接（请参阅 取代管理器 ）。 |
源与效果器插件
下表列出了 Wwise 随附的所有源插件的输入库。它们适用于 Wwise 支持的所有平台。
| 库 | 说明 |
| AkAudioInputSource | Audio Input 样本源插件（提供了源码，位于 samples/Plugins/AkAudioInput 下） |
| AkSilenceSource | Silence Generator 源插件 |
| AkSineSource | Sine 源插件（提供了源码，位于 samples/Plugins/AkSineTone 下） |
| AkSoundSeedGrainSource | SoundSeed Grain - Grain 源插件 * |
| AkSoundSeedWindSource | SoundSeed Air - Wind 源插件 * |
| AkSoundSeedWooshSource | SoundSeed Air - Woosh 源插件 * |
| AkSynthOneSource | Synth One 源插件 |
| AkToneSource | Tone Generator源插件（提供了源码，位于 samples/Plugins/AkToneGenerator 下） |
| * Wwise 提供，但需要单独授权。 | |
下表列出了 Wwise 随附的所有效果器插件的输入库 。它们适用于 Wwise 支持的所有平台。
| 库 | 说明 |
| AkCompressorFX | Compressor 效果器插件 |
| AkConvolutionReverbFX | AK Convolution Reverb 效果器插件 * |
| AkDelayFX | Delay 效果器插件（可用源位于 samples/Plugins/AkDelay 下） |
| AkExpanderFX | Expander 效果器插件 |
| AkFlangerFX | Flanger 效果器插件 |
| AkGainFX | Gain 效果器插件 |
| AkGuitarDistortionFX | Guitar Distortion 效果器插件 |
| AkHarmonizerFX | Harmonizer 效果器插件 |
| AkMatrixReverbFX | Matrix Reverb 效果器插件 |
| AkMeterFX | Meter 效果器插件 |
| AkParametricEQFX | Parametric EQ 效果器插件 |
| AkPeakLimiterFX | Peak Limiter 效果器插件 |
| AkPitchShifterFX | Pitch Shifter 效果器插件 |
| AkRecorderFX | Recorder 插件 |
| AkReflectFX | Reflect 插件 |
| AkRoomVerbFX | RoomVerb 高品质混响效果器插件 |
| AkStereoDelayFX | Stereo Delay 效果器插件 |
| AkTimeStretchFX | Time Stretch 效果器插件 |
| AkTremoloFX | Tremolo 效果器插件 |
| * Wwise 提供，但需要单独授权。 | |
| 备注: 各个插件库都是非强制的，除非要在 Wwise SoundBank中使用。 |
编解码器插件
下表列举 Wwise 随附的所有编解码器插件的输入库 。
| 库 | 说明 | 平台可用性 |
| AkVorbisDecoder | Vorbis 解码器库 | 适用于 Wwise 支持的所有平台。 |
| AkOpusDecoder | Opus 解码器库 | 适用于 Wwise 支持的所有平台。 |
振动
下表列出了Motion（振动）相关输入库 ，所有支持 Wwise Motion 的平台均可用。
| 库 | 说明 |
| AkMotionSink | 控制器振动设备插件。只有您在 Wwise 工程中使用控制器 Motion 效果时才需要。* |
| AkMotionSourceSource | Motion 付费插件 * |
| * Wwise 提供，但需要单独授权。 | |
Waapi
下表列出了 WAAPI 相关输入库，适用于所有支持通过 WAAPI 连接 Wwise 设计工具的平台。
| 库 | 说明 |
| AkAutobahn | WAMP_POCO 库的改良版、civetweb 库和所需 Client 类。 |
外部库依赖
下表按平台列出了声音引擎集成所需的外部输入库。
| 备注: 记住，如需查看所需平台对应的表格，请务必参阅以下资源：
|
| 库 | 说明 |
| dinput8.lib | Microsoft DirectX DirectInput。使用 Motion 功能时需要，以用来支持 DirectInput 设备。 |
| Winmm.lib | Microsoft Multimedia API. 使用 Motion 时需要，用于内部设备定向管理。 |
| dsound.lib | Microsoft DirectX DirectSound 库 |
| dxguid.lib | Microsoft DirectX Audio GUID |
| ws2_32.lib * | Microsoft Winsock 2 库（用于 Wwise 性能分析） |
| xinput.lib | Microsoft XInput。使用 Motion 功能时需要，用来支持 XInput 设备（Xbox 控制器）。 |
| * 对于 Release 配置则不需要。 | |
| Framework | 说明 |
| AudioToolbox.framework | Audio Toolbox 框架包含提供应用级服务的 API。 |
| AudioUnit.framework | Audio Unit 框架包含专门用于音频单元和音频编解码器的 API。 |
| CoreAudio.framework | This framework contains all the APIs that make up Hardware Abstraction Layer (HAL) Services. |
| AVFoundation.framework | This framework contains the AVAudioEngine API which is used for outputting audio on modern OSes. |
| SoundBank | 说明 | |||
| android | Android 的基本库 | |||
| OpenSLES | Android 的自带音频库 | |||
| zip | 用于读取压缩文件的库。由 Dieter Baron 和 Thomas Klausner 开发。此 SoundBank 与 SDK 一起发布。 | |||
| z | Android z SoundBank | |||
| Library | Description | |||
| hilog_ndk.z | OpenHarmony logging library | |||
| ohaudio | The native audio library for OpenHarmony | |||
| ace_napi.z | Library for interoperability between native and Javascript runtimes | |||
| ace_ndk.z | Utilities for native apps on OpenHarmony | |||
| rawfile.z | Library for reading files stored in the OpenHarmony app package format | |||
| ohvibrator.z | Library for using the Vibrator functionality of OpenHarmony. Required when using Wwise Motion only. | |||
| Framework | Description |
| AudioToolbox.framework | The Audio Toolbox framework contains the APIs that provide application-level services. |
| CoreAudio.framework | This framework contains all the APIs that make up Hardware Abstraction Layer (HAL) Services. |
| AVFoundation.framework | This framework contains the AVAudioEngine API which is used for outputting audio on modern OSes. |
| 库 | 说明 |
| libandroid.a | 基础 Android API |
| libOpenSLES.a | 原生音频 API |
在 XCode 中链接静态 iPhone 库
为了能够正确链接相应的库（设备或模拟器），必须按照以下说明进行操作：
- 在 XCode 工程中创建以下配置：Debug、Profile 和 Release。
- Open the build settings page of your project and set the "library search path" to
"/Developer/SDKs/Wwise/SDK/iOS_Xcode$(XCODE_VERSION_MAJOR)/$(CONFIGURATION)$(EFFECTIVE_PLATFORM_NAME)/lib". ReplaceiOSin the previous string totvOSorvisionOSas necessary. This assumes that you have installed Wwise SDK to its default location. - 打开目标应用程序的 Info 页面。在“Other linker Flags”下为您要链接的各个库添加 -l[libraryName]。在大多数基本设置中，需要添加“-lAkMemoryMgr -lAkMusicEngine -lAkSoundEngine -lAkStreamMgr”。
| 备注: 将自动替换为 Debug、Profile 或 Release。 将依据 XCode 中的活跃配置自动替换为 -iphoneos 或 -iphonesimulator。 The Integration Demo for iOS is set up in the same way. You can refer to it for further information: |
 | 技巧: 若不按这些说明进行操作，则可能只能使用单独的 XCode 目标来构建设备或模拟器应用程序。否则，在设备和模拟器应用程序的构建之间切换时可能会遇到增量构建错误。 |