版本
-
Wwise 帮助
-
-
-
-
-
-
Wwise SDK 2018.1.11
|
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 链接。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 随附的所有编解码器插件的输入库 。
<table cellspacing="0" border="1" width="800px"> <tr> <td colspan="3"><strong><center>编解码器插件库</center></strong></td> </tr> <tr> <td width="200px"><strong>输入库</strong></td> <td width="300px"><strong>说明</strong></td> <td width="300px"><strong>平台可用性</strong></td> </tr> <tr> <td>AkAACDecoder</td> <td>AAC 解码器库 </td> <td>适用于 Apple 平台,即 Mac、iOS 和 tvOS。</td> </tr> <tr> <td>AkVorbisDecoder</td> <td>Vorbis 解码器库 </td> <td>适用于 Wwise 支持的所有平台。</td> </tr> <tr> <td>AkOpusDecoder</td> <td>Opus 解码器库 </td> <td>适用于 Wwise 支持的所有平台。</td> </tr> <tr> <td>AkXWMADecoder</td> <td>xWMA 解码器库 </td> </tr> </table>
下表列出了Motion(振动)相关输入库 ,所有支持 Wwise Motion 的平台均可用。
|
|
Input Library | Description |
AkMotionGeneratorSource |
Controller vibration source plug-in. 只有您在 Wwise 工程中使用控制器 Mition Generator(振动生成器)源插件时才需要。 |
AkMotionSink | 控制器振动设备插件。只有您在 Wwise 工程中使用控制器 Motion 效果时才需要。 |
下表按平台列出了声音引擎集成所需的外部输入库。
Note: 记住,如需查看所需平台对应的表格,请务必参阅以下资源:
|
|
|
输入库 | 说明 |
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 | 此框架包含构成硬件抽象层(HAL)服务的所有 API。 |
|
||||
SoundBank | 说明 | |||
android | Android 的基本库 | |||
OpenSLES | Android 的自带音频库 | |||
zip | 用于读取压缩文件的库。由 Dieter Baron 和 Thomas Klausner 开发。此 SoundBank 与 SDK 一起发布。 | |||
z | Android z SoundBank |
|
|
框架 | 说明 |
AudioToolbox.framework | Audio Toolbox 框架包含提供应用层服务的 API。 |
CoreAudio.framework | 此框架包含构成硬件抽象层(HAL)服务的所有 API。 |
为了能够正确地链接相应的库(真机或者模拟器),您必须按照以下说明操作:
Note: "$(CONFIGURATION)" 将自动替换成 Debug、Profile 和 Release 中之一;根据 XCode 中的活跃配置, Integration Demo 以此方式设置,因此请查看它来了解进一步信息: SDK/samples/IntegrationDemo/iOS/IntegrationDemo.xcodeproj or SDK/samples/IntegrationDemo/tvOS/IntegrationDemo.xcodeproj |
Tip: 请注意,如果您不按照这些说明操作,可能必须使用单独的 XCode 目标创建设备和模拟器应用程序。否则,在从创建设备应用程序切换为创建模拟器应用程序(或者相反)后,您可能会遇到增量构建错误。 |
Wwise SDK 库依赖 Android NDK 中的以下基础库。
|
|
SoundBank | 说明 |
libandroid.a | 基础 Android API |
libOpenSLES.a | 原生音频 API |