Wwise SDK 2019.2.15
|
Wwise 声音引擎的所有模块都通过 AK::MemoryMgr 接口访问内存。声音引擎的客户程序负责此接口的初始化和终止。
SDK 以 静态库 (AkMemoryMgr.lib)的方式提供了一个默认实现。为了使用此库,客户端需要包含 AkModule.h 头文件并调用 AK::MemoryMgr::Init 初始化函数。
请参阅 构建配置 了解有关 AkMemoryMgr.lib 和其它库的使用的更多信息。
在默认实现中,可使用 AK::MemoryMgr::GetDefaultSettings 获取默认初始化设置。
使用以下设置来限制 Memory Manager(内存管理器)所分配的虚拟内存和设备内存总量:
使用以下设置来监控专门为调试分配的内存池(Release 配置中并不会使用这些内存池):
上述调试函数并不能替代下面的实际分配函数;它们只是针对各个内存分配事件的通知回调。
使用以下设置来通过自定义分配器改写默认实现所用的 rpmalloc:
在设置 AkMemType_Device 位后,上述分配函数必须通过返回设备内存来与该位协调一致。设备内存分配仅适用于部分平台,且必须与特定参数协调一致(详见平台特定章节)。
在 PS5 上,必须返回采用附加标记保护的设备内存页。有关如何在 PS5 上正确实现设备内存分配函数的详细信息,请参阅 内存映射要求 章节。
在 Xbox One 上,必须使用 APU 函数返回所分配的内存页。有关如何在 Xbox One 上正确实现设备内存分配函数的详细信息,请参阅 APU 内存 章节。
在 Xbox Series X 上,必须使用 APU 函数返回所分配的内存页。有关如何在 Xbox Series X 上正确实现设备内存分配函数的详细信息,请参阅 APU 内存 章节。
使用以下设置来改写页面分配机制底层 rpmalloc:
在将自定义分配器配置为改写 rpmalloc 时,不会调用上述函数。设备内存分配仅适用于部分平台,且必须与特定参数协调一致(详见平台特定章节)。若所返回内存的对齐与平台的自然对齐(比如在 Windows 上为 64KB)不一致,则须在 uVMPageSize and uDevicePageSize 中指定该自定义对齐。
请参阅 示例 了解例程和有关在游戏中初始化内存管理器的更多信息。
有关 SoundBank 内存用量的详细信息,请参阅 加载 SoundBank 。
有关如何优化内存分配的信息,请参阅 优化内存分配 。
客户端可提供 AK::MemoryMgr 接口的自定义实现。AkMemoryMgr.h 中定义的所有函数全部都要实现。AkModule.h 在 AK::MemoryMgr 命名空间中定义的函数不必实现,因为它们只针对内存管理器的默认实现。
跟在改写 AkMemSettings 的各个分配函数时一样,要想编写新的 AK::MemoryMgr 实现,必须注意在设置 AkMemType_Device 位后通过返回设备内存来与该位协调一致。设备内存分配仅适用于部分平台,且必须与特定参数协调一致(详见平台特定章节)。