Wwise 声音引擎 SDK 随附三种构建配置:Debug、Profile 和 Release。
声音引擎的Debug(调试)版本是非优化构建配置,带有额外调试信息,例如断言和调试输出字符串。我们不推荐使用此配置,因为使用此配置时,性能将受到重大影响。尽管如此,如果在早期集成过程中发生问题,此版本可用于验证集成工作。
声音引擎的Profile(性能分析)版本是优化过的构建版本,为与
Wwise 通信提供支持。此配置适用于日常开发过程。由于它有通信功能,因此不应该用于游戏的最终零售版本。
最后,声音引擎的Release(发布)版本是不带通信支持的优化构建版本。使用此配置时,必须在编译时定义预处理器定义AK_OPTIMIZED
.
CommunicationCentral 库也应从链接依赖中移除。此构建配置提供所有三种配置中最高的性能,应该用于最终零售版本。
|
Note: 在 Windows 中,如果项目需要使用 C 运行时库的静态版本(/MT 或 /MTd),它应与 Debug(StaticCRT) 、Profile(StaticCRT) 和Release(StaticCRT) 文件夹中的 Wwise 库而非标准配置相链接。 |
以下是每个构建配置所要求的库依赖。当同一库有多个版本时,注意只有一个会标记为必需。由音频程序员决定应用程序需要哪个 Wwise SDK 版本。
下表列举声音引擎集成所需要的输入库。
输入库 |
描述 |
AkSoundEngine |
声音引擎核心 |
AkMemoryMgr |
内存管理器 |
AkStreamMgr |
I/O 管理器 |
AkMusicEngine |
音乐引擎 |
CommunicationCentral |
与 Wwise 通信 * |
* 不需要 Release 配置。 |
|
Note: Microsoft 平台的输入库文件使用 .lib 文件名扩展名。而 Nintendo 平台的库使用 .a 扩展名。其它平台使用库前缀和 .a 扩展名。 |
|
Note: 不使用互动音乐功能的应用程序不必与AkMusicEngine 链接。同样,不使用通信的应用程序不必与CommunicationCentral 链接。AkMemoryMgr 和 AkStreamMgr 分别是 Audiokinetic 对内存管理器和流管理器的默认实现。如果您决定不沿用它们,则要与您自己的库链接(请参阅取代管理器 )。 |
下表列出了 Wwise 随附的所有源插件的输入库。它们适用于 Wwise 支持的所有平台。
源插件库 |
输入库 |
描述 |
AkAudioInputSource |
Audio Input(音频输入)源插件示例(源码位于 samples/Plugins/AkAudioInput 下) |
AkSilenceSource |
Silence Generator(无声生成器)音源插件 |
AkSineSource |
Sine(正弦波)源插件(源码位于 samples/Plugins/AkSineTone 下) |
AkSoundSeedWind |
SoundSeed Air - Wind 源插件* |
AkSoundSeedWoosh |
SoundSeed Air - Woosh 源插件* |
AkSynthOne |
Synth One 源插件 |
AkToneSource |
Tone Generator(乐音发生器)源插件(源码位于 samples/Plugins/AkToneGenerator 下) |
* Wwise 提供,但需要单独的授权,除非作为 Wwise Power Pack 包的一部分购买。 |
下表列出了 Wwise 随附的所有效果器插件的输入库 。它们适用于 Wwise 支持的所有平台。
效果器插件库 |
输入库 |
说明 |
AkCompressorFX |
Wwise Compressor 效果器插件 |
AkConvolutionReverbFX |
Wwise Convolution Reverb 效果器插件* |
AkDelayFX |
Delay 效果器插件(源码位于 samples/Plugins/AkDelay) |
AkExpanderFX |
Wwise Expander 效果器插件 |
AkFlangerFX |
Wwise Flanger 效果器插件 |
AkGainFX |
Wwise Gain 效果器插件 |
AkGuitarDistortionFX |
Wwise Guitar Distortion 效果器插件 |
AkHarmonizerFX |
Wwise Harmonizer 效果器插件 |
AkMatrixReverbFX |
Wwise Matrix Reverb 效果器插件 |
AkMeterFX |
SoundSeed Meter 效果器插件 |
AkParametricEQFX |
Wwise Parametric EQ 效果器插件 |
AkPeakLimiterFX |
Wwise Peak Limiter 效果器插件 |
AkPitchShifterFX |
Wwise Pitch Shifter 效果器插件 |
AkRoomVerbFX |
Wwise RoomVerb,一个高品质混响效果器插件 |
AkSoundSeedImpactFX |
SoundSeed Impact 效果器插件* |
AkStereoDelayFX |
Wwise Stereo Delay 效果器插件 |
AkTimeStretchFX |
Wwise Time Stretch 效果器插件 |
AkTremoloFX |
Wwise Tremolo 效果器插件 |
* 在 Wwise 设计工具中可用,但需要单独购买授权。 |
|
Note: 各个插件库都是非强制的,除非要在 Wwise SoundBank中使用。 |
下表列举 Wwise 随附的所有编解码器插件的输入库 。
编解码器插件库 |
输入库 |
说明 |
可用的平台 |
AkAACDecoder |
AAC 解码器库 |
Mac、iOS 和 tvOS 等 Apple 平台可用。 |
AkATRAC9 |
ATRAC9 解码器库 |
PS Vita SW 可用。(在 PS4 或 PS Vita HW 上,ATRAC9 无需插件。) |
AkVorbisDecoder |
Vorbis 解码器库 |
Wwise 支持的所有平台都可用。 |
AkXWMADecoder |
xWMA 解码器库 |
下表列出了Motion(振动)相关输入库 ,所有支持 Wwise Motion 的平台均可用。
Motion 相关库 |
输入库 |
说明 |
AkMotionGenerator |
控制器振动源插件。只有您在 Wwise 工程中使用控制器 Mition Generator(振动生成器)源插件时才需要。 |
AkRumble |
控制器振动设备插件。只有您在 Wwise 工程中使用控制器 Motion 效果时才需要。 |
下表列出了声音引擎集成所需要的外部输入库 。在 CHM 中,您必须参阅预期平台专用的 Wwise SDK 帮助文件。在联机帮助中,登录后可访问您所登记的所有平台相关信息。
Windows
Windows |
输入库 |
说明 |
dinput8.lib |
Microsoft DirectX DirectInput。使用 Motion 功能时需要,以用来支持 DirectInput 设备。 |
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 配置则不需要。 |
Mac OS X
Mac |
Framework |
说明 |
AudioToolbox.framework |
Audio Toolbox 框架包含提供应用级服务的 API。 |
AudioUnit.framework |
Audio Unit 框架包含专门用于音频单元和音频编解码器的 API。 |
CoreAudio.framework |
此框架包含构成硬件抽象层(HAL)服务的所有 API。 |
Android™
Android |
SoundBank |
说明 |
android |
Android 的基本库 |
OpenSLES |
Android 的自带音频库 |
zip |
用于读取压缩文件的库。由 Dieter Baron 和 Thomas Klausner 开发。此 SoundBank 与 SDK 一起发布。 |
z |
Android z SoundBank |
iOS
iOS/tvOS |
框架 |
说明 |
AudioToolbox.framework |
Audio Toolbox 框架包含提供应用层服务的 API。 |
CoreAudio.framework |
此框架包含构成硬件抽象层(HAL)服务的所有 API。 |
为了能够正确地链接相应的库(真机或者模拟器),您必须按照以下说明操作:
- 在 XCode 工程中创建以下配置:Debug、Profile 和 Release。
- 打开工程的 Build Settings(构建设置)页面,并将“library search path”(库搜索路径)设为“/Developer/SDKs/Wwise/SDK/iOS//lib”或“/Developer/SDKs/Wwise/SDK/tvOS//lib”。(假设您已将 Wwise SDK 安装在默认位置)
- 打开目标应用程序的 Info(信息)页面。在“Other linker Flags”下为您要链接的各个库添加 -l[libraryName]。在大多数基本设置中,需要添加“-lAkMemoryMgr -lAkMusicEngine -lAkSoundEngine -lAkStreamMgr”。
|
Note: "$(CONFIGURATION)" 将自动替换成 Debug、Profile 和 Release 中之一;根据 XCode 中的活跃配置,
"$(EFFECTIVE_PLATFORM_NAME)" 将自动替换成 -iphoneos 或 -iphonesimulator
Integration Demo 以此方式设置,因此请查看它来了解进一步信息: SDK/samples/IntegrationDemo/iOS/IntegrationDemo.xcodeproj 或 SDK/samples/IntegrationDemo/tvOS/IntegrationDemo.xcodeproj
|
|
Tip: 请注意,如果您不按照这些说明操作,可能必须使用单独的 XCode 目标创建设备和模拟器应用程序。否则,在从创建设备应用程序切换为创建模拟器应用程序(或者相反)后,您可能会遇到增量构建错误。 |
Android™
Wwise SDK 库依赖 Android NDK 中的以下基础库。
Android |
SoundBank |
说明 |
libandroid.a |
基础 Android API |
libOpenSLES.a |
原生音频 API |
- 参见:
-
SDK 输入库 与分布式二进制文件