|
Wwise SDK 2025.1.3
|
The following sections list and describe the changes to Wwise between version 2022.1.8 and version 2023.1.0.
此处提供了有关平台的特定信息:
有关早期版本的信息,请参阅 过往版本的发行说明 章节。
AK::SpatialAudio::SetGameObjectInRoom API 将 Game Object 指派给 Room。现在只要使用 AkRoomParams::GeometryInstanceID 为各个 Room 指派了几何构造就可自动执行这种计算。若要覆盖内部 Room 几何包含关系检测计算值,请调用 AK::SpatialAudio::SetGameObjectInRoom。Wwise 会停止针对给定 Game Object 自动更新 Room。在此之后,可调用 AK::SpatialAudio::UnsetGameObjectInRoom 来恢复内部 Room 几何包含关系检测计算。同时,向 AkRoomParams 添加了新的成员:AkRoomParams::RoomPriority。在 Game Object 实际处于两个 Room 内时(比如某个 Room 处在另一 Room 内),内部 Room 几何包含关系检测算法会使用其来决定要向哪个 Room 指派 Game Object。在这种情况下,会指派给具有更高优先级的 Room。SetGameObjectInRoom 来覆盖自动指派的 Room,并通过调用 UnsetGameObjectInRoom 来重新予以启用。AK::SpatialAudio::SetReverbZone 和 AK::SpatialAudio::RemoveReverbZone。AK::Wwise::Plugin::Host 服务添加了 GetProjectLicenseID。该服务已更新到版本 2。AkSpeakerVolumeMatrixCallbackInfo 移除了 IAkMixerInputContext。OutputSearchedPaths 由 AK::StreamMgr::IAkFileLocationResolver 移到了 AK::StreamMgr::IAkLowLevelIOHook。EstimateHFDamping() 的返回值由 AKRESULT 改为了 AkReal32。现在会直接返回 HF Damping 值。移除了参数 __ AkReal32 out_hfDamping。AkSpatialAudioInitSettings::uMaxEmitterRoomAuxSends 来限制单个发声体可生成的 Game-defined Auxiliary Sends 的最大数量。AkMemSettings::bUseDeviceMemAlways,代之以新的设置 AkMemSettings::bEnableSeparateDeviceHeap。AkMemSettings::bEnableSeparateDeviceHeap 方便仅使用一个通用的内存堆。若已将 AkMemSettings::bUseDeviceMemAlways 设为 true,则应将 AkMemSettings::bEnableSeparateDeviceHeap 设为 false;若已为 AkMemSettings::AllocDeviceVM 和 AkMemSettings::FreeDeviceVM 设置自定义内存挂钩,则应为 AkMemSettings::AllocVM 和 AkMemSettings::FreeVM 做相应设置。AkGeometryParams::EnableTriangles,将其替换为了 AkGeometryInstanceParams::UseForReflectionAndDiffraction。AK::StreamMgr::IAkLowLevelIOHook 接口:AkGeometryInstanceParams::RoomID。在未来版本中会移除该参数。建议不要使用 RoomID,最好保留为默认值 (-1)。AK::SoundEngine::IsPluginRegistered。AKPLATFORM::AllocVM 和 AKPLATFORM::FreeVM 的示例函数及其他一些虚拟内存相关函数和定义由 AkPlatformFuncs.h 移到了 AkMemoryMgrFuncs.h。鉴于这些改动,可能需要在代码中修改或添加某些头文件内容来解决编译器错误。AkMarkerCallbackInfo 添加了 size 成员;向 AddOutputCaptureMarker 添加了 size 参数;对 Wwise Wave Viewer 中同时显示的标记点做了修复。AkSimd.h 移到了 AkSimdTypes.h。对此,可能需要修改代码中的某些头文件内容来解决编译错误。project 参数。SetObjectObstructionAndOcclusion() 时,现在只会将声障值和声笼值发送到直达路径。CAkLEngine::ReleaseBuffersAndFeedbackAsync 期间清理混音总线的音频缓冲区。这样可以消除 CAkLEngine::ReleaseBuffersAndFeedbackAsync 的大部分成本。WwiseAuthoringAPI.json。该文件之前存放在安装目录 <Wwise>\Authoring\Data\Schemas 下。现在其被拆分成了多个文件并全部存放在目录 <Wwise>\Authoring\Data\Schemas\WAAPI 下。AK_DISABLE_OPTIMIZATIONS 和 AK_ENABLE_OPTIMIZATIONS 以便有选择性地禁用和启用对部分 Wwise 代码内容的优化。这在调试某些问题时可能会很有用。Tools(如 FilePackager)目录下的二进制文件。NudgeToShadowZone() 触发断言。EstimateHFDamping() 函数给出的值不正确,跟 HF Damping 的定义不一致。CAkSrcMedia::PrepareNextBuffer 触发断言。AK::SoundEngine::ReplaceOutput 调用触发断言。AK::SoundEngine::ReplaceOutput 锁定。Wwise_IDs.h 文件。AK::SoundEngine::TryUnsetMedia 无法处理活跃的 MIDI 文件。