目录

Wwise SDK 2019.2.0
版本说明 2019.2

The following sections list and describe the changes to Wwise between version 2019.1.7 and version 2019.2. 对于早期版本,请参阅 过往版本的发行说明

平台 SDK 改进

  • (PS4, Windows, UWP) These platforms now support SDK builds for Visual Studio 2019.
  • Authoring requires Windows 7 SP1 and up. Changed the Wwise Authoring tool, including all plug-ins, to be compiled using Visual Studio 2019, with Windows SDK target version 10.0.17763.0.

新增功能

  • WG-26680 添加了 Resource Monitor,允许直接在运行 Wwise 的游戏内监控声音引擎占用的资源。无需另外打开设计工具。
  • WG-32589 (WAAPI) 新增了用来捕获 Wwise 用户界面图像的 WAAPI 命令。
  • WG-39654 用户现在可以直接使用 Wwise 内 User Preferences 中默认的 JSON 编辑器来创建、编辑和重载自定义命令文件。
  • WG-40348 现在一旦加载便会记录自定义属性和命令扩展。
  • WG-40381 (WAAPI) 添加了 ak_wwise_soundengine_setState 函数。
  • WG-41088 在 Wwise 设计工具中针对 Spatial Audio Auxiliary Bus 新增了预设:Room Reverb 和 Reflect。
  • WG-41090 Stochastic ray-tracing is now used to compute Reflections and Diffraction, in Spatial Audio.
  • WG-41111 新增了 Spatial Audio 和 Wwise Reflect 出厂预设。
  • WG-41112 预设现在支持多个 Work Unit。
  • WG-41223 A new sub menu is now available to create a new child or a new parent from a preset.
  • WG-41481 Custom commands can now use common directory variables in program, args and cwd fields, in order to avoid machine-specific absolute paths.
  • WG-41530 使用新的 WwiseConsole 替代了原有的 WwiseCLI。WwiseConsole supports new syntax, built-in help display and strict validation of arguments. WwiseCLI is now deprecated but remains available.
  • WG-41727 已修复:(WAAPI) 现在可将平台名称用作 WAAPI 中的平台参数,而不像之前那样只能使用 GUID。
  • WG-41953 自定义命令现在可使用新的 redirectOutputs 字段,来在终止时将程序的标准输出流 (stdout + stderr) 重定向到 Wwise。
  • WG-42470 添加了对四阶和五阶 Ambisonics 的支持。
  • WG-42755 (WAAPI) 现在在 Wwise Log 的 WAAPI 选项卡中显示 WAAPI Subscription Publish 消息。
  • WG-42812 A new Profiler view, the Voice Explorer, has been added. It enables you to list playing voices, sorted by playing events and game objects.
  • WG-42814 A new Filter bar has been added to most Profiler views, enabling you to search specifically for game objects, sounds, buses, events and more.
  • WG-42829 现在可使用新的性能分析视图 Voice Explorer。
  • WG-42963 现在可在通过 Wwise Launcher 执行常规安装时一并安装 Lumin Integration Demo。
  • WG-43219 添加了 Any 平台,可用在插件定义文件中。
  • WG-43246 现在暴露了跨平台设备枚举函数 _AK::SoundEngine::GetDeviceList_。
  • WG-43249 现在可通过 AK::SoundEngine::GetDeviceList 来枚举 ASIO 设备。
  • WG-43250 Added support for device output enumeration and selection on macOS.
  • WG-43284 Capture Log 视图现在包含经过重新设计的筛选器。
  • WG-43465 It is now possible to create/edit/remove command Add-ons directly from the Keyboard Shortcuts and Commands dialog.
  • WG-43498 Parameteric EQ 效果器属性 Band Gain 和 Output Gain 现在支持多个 RTPC 和 State。
  • WG-43544 用户现在可直接在 Wwise 内的 User Preferences 中选用三个预定义的目录,来使用默认的 JSON 编辑器创建和编辑自定义命令文件。
  • WG-43580 Game Simulator 现在支持 Magic Leap。
  • WG-43809 用户现在可通过输入 > 来直接在主 Search 栏中搜索和执行 Wwise 命令。
  • WG-43889 (WAAPI) New WAAPI commands to support granular SoundBanks:
    • Added more information to the info file
    • Each Event lists their associated media.
    • Each SoundBank lists their associated AuxBuses, Game Parameters (RTPC), Switches, States and Triggers.
    • Each event lists a tree of Switch value to Media ID, allowing to only load media when the Switch value is referenced in a given level.
    • Added a new WAAPI command: ak.wwise.core.soundbank.generate. 在默认情况下,它会使用内存中的 SoundBank 生成模型来生成 SoundBank。You can also direct it to write the SoundBanks to disk in the default SoundBanks Generated folder. 在该命令中,可指定一系列 SoundBank 并自定义其各自所含的内容。You can use the WAAPI callback: ak.wwise.core.soundbank.generated to get the SoundBank data encoded as base64 and the JSON info file embedded within the WAAPI callback.
    • Added the WAAPI callback: ak.wwise.core.soundbank.generationdone, when the SoundBank generation is done.
    • Added the –skip-languages WwiseConsole command line switch to skip generation of localized SoundBanks.
    • Added the –use-stable-guid WwiseConsoloe command line switch for projects that don't save SoundBanks in their Wwise project and want a stable GUID in their info file.
  • WG-44057 添加了对命令扩展定义文件的版本控制。
  • WG-44358 为了消除对 Watch 的依赖和方便查看 Voice Inspector 数据,对 Game Sync Monitor 进行了重新设计。
  • WG-44511 It is now possible to create Work Units and Folders in the Master-Mixer Hierarchy.
  • WG-44633 为了处理延迟型 I/O 操作,添加了新的接口 AK::IAkIOHookDeferredBatch。It enables performance improvements to I/O threading CPU utilization and allows for greater flexibility in ordering and dispatching concurrent I/O requests, when many concurrent I/O requests are submitted.
  • WG-44974 (WAAPI) 添加了新的设置来控制最多可有多少个客户端同时通过 WAAPI 连接到 Wwise。这些设置可在 User Preferences 中或通过命令行进行修改。
  • WG-45522 Keyboard Shortcuts 对话框中现在默认显示搜索字段。
  • WG-45682 (WAAPI) 添加了 ak.wwise.core.profiler.getRTPCs,以便针对性能分析器时间光标检索活跃的 RTPC。
  • WG-45746 The Game Object 3D view is now available on macOS, without the 3D area.
  • WG-45797 Added a splitter in the Reflect Effect Editor between the curves graph and the list.
  • WG-46067 Double clicking a game object in the list view automatically locates the object in the Game Object 3D View.

API 改进

  • WG-35130 Wwise 现在使用 civetweb v1.11。
  • WG-39381 Memory Manager 接口:详见 新的 Memory Manager 章节。
  • WG-39563 针对 SetRTPCValueByPlayingID 调用添加了新的错误代码 AK_PlayingIDNotFound。
  • WG-40342 添加了新的 AkGlobalCallbackLocation 函数 AkGlobalCallbackLocation_Init,以便用户在声音引擎初始化后马上注册回调。
  • WG-40738 现在将多项附加的 Wwise UI 操作绑定到了 Wwise 命令。
  • WG-41513AK::Wwise::ISourceControlUtilities 中移除了 GetRegistryPath 方法。
  • WG-43542 (WAAPI) The WAAPI C++ client, in AkAutobahn, now supports timeout on Connect. This allows for timing out during the WAMP handshake, in order to avoid a potential infinite lock, if Wwise stops responding at the wrong time (if it is closed, for example). The API change is backward compatible and should not require code changes, unless you want to specify the timeout value.
  • WG-43648 AK/Wwise plug-ins API stability enhancements, by using the Wide version of parameters when applicable
  • WG-44516 现在支持在 DynamicSequence 中寻址,不过只能针对第一项执行该操作。
  • WG-44635 添加了新的声音引擎初始化设置 AkInitSettings::uBankReadBufferSize,以便在从文件加载 SoundBank 时自定义读取粒度。
  • WG-44661 添加了 AK::IAkStdStream::WaitForPendingOperation(),允许中断需要触发异步任务的 IO Stream。
  • WG-44710 Added IAkGlobalPluginContext::ApplyGain and IAkGlobalPluginContext::ApplyGainAndInterleave so that sink plug-ins can use the sound engine's existing capabilities to perform final rearrangement of audio data for certain hardware, for example, as part of the device sink plug-in processing.
  • WG-44835 (Stadia) 移除了 SDK/include/AK/Tools/GGP/AkPlatformFuncs.h,以后要使用 Linux/AkPlatformFuncs.h
  • WG-45352 Soft deprecatation of AkGetSinkPluginDevices to be replaced by AK::SoundEngine::GetDeviceList implementation by plug-in registration of static functions.
  • WG-45977 Updated SetReflectionsOrder function in SpatialAudio to update reflection and diffraction paths (or not), based on a boolean argument.
  • WG-46117 针对 Windows 添加了新的声音引擎初始化设置 AkPlatformInitSettings::bEnableAvxSupport,以避免在声音引擎及插件中使用 AVX 和 AVX2。

行为改进

  • WG-40568 Seeks are now performed without a seek table in Vorbis by default. If a seek table is not provided, Wwise decodes from the start of the file to the seek point. For anything but small files, it is highly recommend to still include a seek table. A warning is displayed when performing a seek operation within larger Vorbis files without a seek table.
  • WG-41425 因为现在插件可以确定目标到底是 vc_140、vc_150 (vc_141) 还是 vc_160 (vc_142),所以在针对 Wwise 设计工具进行构建时插件开发工具需要 -x 标记。之前,目标只有 vc_140。现在,开发工具会检测具有兼容性构建工具的 Visual Studio 程序,并将其视为可用来构建插件的备选程序。
  • WG-42182 (WAAPI) Calling WAAPI functions with invalid arguments or options now provides more details in the error message, including inline documentation, and better formatting of error messages.
  • WG-42469 Changed several things regarding media asset ID assignments: Added undo-redo operations to ensure assignments remain consistent. Moved MediaIDs to their own space; value space is no longer shared with other types of assets. Changed the algorithm used for assigning MediaID values. Changed Work Unit tags for MediaID values from <ConvertedFileIDList> to <MediaIDList>.
  • WG-42853 Fixed: Previous default shortcut for View Settings did not work on "undocked" views. The default shortcut: Ctrl+Alt+V, has been changed for: Ctrl+Alt+H.
  • WG-43056 已修复:若子容器采用精确到触发率的过渡,而父容器采用精确到采样点的过渡,则前者在播放时可能会出现不同步问题。
  • WG-43643 State Group 的 None State 的 ID 不再是 0。None State 的 ID 现在在 Wwise_IDs.h 中指定。
  • WG-43897 Profiler Settings:将最大内存用量限值由 4000 MB 增大到了 32000 MB。
  • WG-44440 在发送的干声信号没有通过 HDR 总线传递的情况下,现在会针对声部禁用 HDR。
  • WG-44680 (WAAPI) "Object ID is unknown" error message now have more information about the ID or the path you where trying to find.
  • WG-44707 在 Wwise Reflect 界面内的镜像声源列表中添加了 dB 电平。
  • WG-47232 Native ambisonics decoding to stereo is now completely symmetrical regardless of whether sounds come from the front or the back. Previously, sounds coming exclusively from the back were silenced.

性能改进

  • WG-40847 Improvements to the conversion from linear to dB volumes at runtime.
  • WG-41951 (WAAPI) WAAPI now uses undo groups, which results in better performance by reducing the number of updates to the user interface.
  • WG-42619 Vorbis codec optimization, providing between 5% and 20% of additional gain.
  • WG-43026 移除了耗时的 dynamic_cast,加快了 SoundBank 生成速度。
  • WG-43631 Performance improvements to Wwise Authoring, when selecting objects in the Project Explorer.
  • WG-44449 A new cache system has been implemented for working buffers, greatly reducing the number of buffer allocations required at runtime.
  • WG-44634 现在从文件加载 SoundBank 时会根据需要触发异步读取,稍微减少了 SoundBank 加载过程中的总延迟。
  • WG-45592 提升了 3D Meter 的性能。
  • WG-46588 提升了在 Loading Layouts 阶段加载工程时的性能。

其他改进

  • WG-32483 (XBox One) 针对 Windows 和 Xbox One 消除了对 dxguid.lib 不必要的依赖。
  • WG-32511 SoundBank generation and audio file conversion can now write files with paths that exceed MAX_PATH (260 characters) on Windows 10, given that long paths are enabled on the machine. Click here for more details.
  • WG-34568 .backup 下的工程备份现在具有使用 YYYY-MM-DD-hh-mm-ss 规范命名的目录。
  • WG-40340 已修复:常规日志消息类别描述现在更加统一了。
  • WG-41520 缩短了工程加载时间。
  • WG-42408 Unicode encoded as UTF-8 is now the only supported format for text file output (SoundBank content TXT file, header file):
    • 弃用了内置宏 ContentFileFormat,现在提供的值始终为 Unicode。
    • The SoundFrame SoundBank generation setting AK::SoundFrame::SoundBankGenerationSettings::eContentTxtFileFormat is now ignored and defaults to AK::SoundFrame::SoundBankContentTxtFileFormat_UNICODE.
  • WG-43241 更改了 MIDI 文件引用的 Work Unit 格式。
  • WG-43367 Build: Migrated to the latest version of Premake5.
  • WG-43563 按子菜单的形式对 Views 菜单进行了重新组织。
  • WG-43578 The Lumin Integration Demo source code is now packaged with Wwise, when installed through the launcher.
  • WG-43935 A compile-time debugging tool has been added, in order to write Voice Inspector data to a text file in Release libraries.
  • WG-44169 (Xbox One) 现在使用 Direct3D 12 作为 Integration Demo 的渲染 API。
  • WG-44331 The Game Object 3D viewer now includes a list of game objects and its associated watches.
  • WG-45004 Added a new SoundBank Post Generation Step macro: that expands the path to the CopyStreamedFiles executable.
  • WG-45767 在加载工程时,Wwise 设计工具中不再显示 Project Launcher 窗口。
  • WG-46008 Reflect Factory Assets 现在包含现成的 Auxiliary Bus 预设和 Reflect 效果器。
  • WG-46647 降低了 3D Meter 中默认的颜色 dB 阈值。
  • WG-46699 Removed unused "Output Data" type from list, in the Profiler Settings.
  • WG-46849 The Wwise User Guide PDF has been removed. You can find the same content online and in the Help CHM.

漏洞修复

  • WG-18324 Fixed: Markers were dropped when sounds were sent to virtual voices.
  • WG-31209 已修复:倘若 Event 带有注册的标记回调,在发送时可能会发生崩溃。
  • WG-37436 Fixed: A -6dB drop would occur in directional ambisonic channels with 3D spatialization of multiple game object positions in MultiDirection mode.
  • WG-38048 Fixed: Incorrect value reported in the Capture Log when running out of memory for monitoring notifications.
  • WG-39283 Fixed: Sliders and faders did not work correctly when using a touch screen or over remote desktop.
  • WG-40719 已修复:可能会同时打开多个 New Project 菜单。
  • WG-41122 已修复:为了解决不一致问题并共享代码,对 Dark、Light 和 Classic 皮肤进行了重新设计。
  • WG-41801 Fixed: In the Source Editor, the Delete Marker and Edit Marker Label... options no longer appear when right-clicking on a cue or the play cursor.
  • WG-41932 Fixed: Sound Engine Query functions: GetState, GetSwitch, and GetRTPCValue now return Ak_IDNotFound when the provided ID doesn't exist.
  • WG-42061 Fixed: Tool-tips did not always appear when moving the mouse over the Voice Graph nodes in the Advanced Profiler.
  • WG-42110 已修复:在 Capture Log 中使用 Context Menu 执行复制粘贴操作时,各行的顺序混乱。
  • WG-42489 Fixed: Crashes or corrupted audio when initializing certain output types, such as Pad_Output, with incompatible speaker configurations.
  • WG-42538 已修复:Log Settings 对话框现在使用更加直观的忽略机制。
  • WG-42604 Fixed: Flashing window when converting audio files no longer occurs.
  • WG-42990 已修复:Ambisonics 编码的高度声道(x.x.2 和 x.x.4)不准确。
  • WG-43022 Fixed: Max Attenuation was reported in the SoundbankInfo file, for objects that did not have any active attenuation.
  • WG-43028 已修复:IncrementalSoundBankData.xml 中的有些语言使用了负的 ID 值。
  • WG-43093 已修复:在调整大小时,视图和对话框中的分隔条有时会出现异常行为。
  • WG-43414 已修复:有些 Spread/Focus 值会导致声场无法准确集中。
  • WG-43436 Fixed: The JSON metadata file for SoundBanks is now properly formatted.
  • WG-43441 Fixed: Timing issues in Wwise Authoring could occur when a sound was playing while the sound engine was reinitialized.
  • WG-43535 已修复:对于 Custom Commands,Keyboard Shortcuts 冲突警告现在更加统一了。
  • WG-43539 已修复:在播放包含无效 Music Transition 的 Music Container 时,Wwise 发生罕见崩溃。
  • WG-43547 Fixed: AkThreadProperties::dwAffinityMask was ignored on Linux.
  • WG-43704 Fixed: Sound is not properly reset when inspecting Blend Containers, while in-game.
  • WG-43782 Fixed: The static properties: User Send Volume and Game Send Volume, were ignoring the Override checkbox.
  • WG-43790 已修复:在执行窗口布局操作时可能会发生崩溃。
  • WG-43867 已修复:倘若在 Performance Monitor 中单击 Settings 图标后马上按下 ESC,窗口可能会消失。
  • WG-43884 Fixed: The view sizes in certain factory layouts could cause important warning messages to be hidden in the user interface.
  • WG-43916 Fixed: In the light skin user interface, the contrast of waveforms has been improved in the Source Editor.
  • WG-43982 已修复:倘若队列中留有绘图事件,Wwise 设计工具可能会发生崩溃。
  • WG-44081 已修复:在添加新的平台时,有时会将非预期的 MediaID 添加到媒体素材。
  • WG-44188 Fixed: A crash could occur when dragging an object from the list in the Advanced Profiler / Voices tab to the object filter in the Voices tab.
  • WG-44348 已修复:在 SetRTPCValue 中添加了 FLT_MAX 检查项(仅在 Debug 模式下或在定义了 CHECK_VALID_INPUT 时适用)。
  • WG-44489 Fixed: Possible assertion in AddPowerVbap2d, when an emitter was exactly on top of a listener.
  • WG-44503 已修复:在 macOS 上,Wwise 设计工具中没有正确显示有些 Notes 字段。
  • WG-44891 Fixed: A Probability slider was active for a non-existing dialog.  
  • WG-45002 已修复:在编辑播放曲线时可能会发生崩溃。
  • WG-45158 Fixed: On rare occasions, several consecutive Pause All and Resume All Events could lead to stuck MIDI notes.
  • WG-45415 Fixed: An IR display issue could occur in Wwise Convolution Reverb.
  • WG-45621 Fixed: A performance issue could occur when resizing the Game Object 3D Viewer.
  • WG-45631 Fixed: When playing multiple instances of the same sound, the secondary play heads were not displayed correctly in the Source Editor.
  • WG-45648 已修复:在将新的平台添加到工程时,对于带有已取消链接的属性的对象,有时会为链接的平台指派错误的值。
  • WG-45729 已修复:WwiseCLI 中没有报告有关 wsources 文件的 External Sources Conversion 错误。
  • WG-45748 Fixed: A channel configuration display issue could occur in the 3D Meter.
  • WG-45800 已修复:在从 2017.1.x 或较早版本迁移时无法正确迁移有些 Query 结构。
  • WG-45956 Fixed: Playback issues related to buffer length could occur on nonstandard audio system configurations.
  • WG-46038 Fixed: Loading a Work Unit after loading a project would tag the other Work Units in the Project as dirty.
  • WG-46101 已修复:在加载较大的 Wwise 工程时,标题栏可能会闪烁不定。
  • WG-46116 已修复:对于在 Windows 中配置为四声道的设备,倘若在初始化 XAudio2 或 DirectSound Sink 时没有提供 channelconfig,会创建 5.1 音频输出而非 4.0 音频输出。
  • WG-46222 Fixed: (WAAPI) When using WAAPI over HTTP, the % character in return values would cause data corruption.
  • WG-46231 Fixed: Crashes and assertions could occur while loading a project, minimizing a window or when disconnecting a remote desktop session with an active 3D Viewer.
  • WG-46318 Fixed: A crash could occur in AK::SoundEngine::RegisterResourceMonitorCallback when AK::MemoryMgr was not initialized.
  • WG-46560 Fixed: Memory consumption was prohibitive when using the Game Object 3D Viewer.
  • WG-46658 已修复:现在将编译时常量用作所需大小时始终按照 16 字节来对齐 AkAllocaSIMD。
  • WG-46752 Fixed: Framerate drop issues could occur in 3D Meter.
  • WG-46911 Fixed: The 3D Spherical Meters could not initialize correctly if multiple Meters views were active.
  • WG-46912 Fixed: Flickering could occur in the Property Editor when navigating from a Folder to a Container.
  • WG-46985 A freeze loop could occur when performing seek operations in very long Opus files.
  • WG-47113 Fixed: Rare crash when profiling in Wwise Authoring with Voice inspector data enabled.
  • WG-47141 Rare crash with States modifying plugin properties.
  • WG-47142 Rare crash when using 3D Busses and unloading all SoundBanks.
  • WG-47181 Fixed: (Stadia) Some plug-ins were not working when using dynamic libraries.


参见