开发

设置 Wwise 版 Oculus 声场定位器（已停用）

更新时间: 2026年4月15日

End-of-Life Notice for Oculus Spatializer Plugin

Oculus 声场定位器插件已被 Meta XR 音频 SDK 取代，现已进入停止服务阶段。除了该插件的 v47，我们将不会为其提供任何进一步的支持。我们强烈建议您不要使用它。请根据您使用的引擎导航至相应的 Meta XR 音频 SDK 文档：
- Unity 原生版 Meta XR 音频 SDK
- Unity 和 FMOD 版 Meta XR 音频 SDK
- Wwise 和 Unity 版 Meta XR 音频 SDK
- Unreal 原生版 Meta XR 音频 SDK
- FMOD 和 Unreal 版 Meta XR 音频 SDK
- Wwise 和 Unreal 版 Meta XR 音频 SDK

此文档将不再更新，并且可能会被删除。

Oculus 声场定位器插件 (OSP) 是 Audiokinetic Wwise 的混音器插件，支持单声道声源在相对于用户头部位置的 3D 空间中进行定位。本集成指南描述了如何在 Wwise 应用和最终用户应用中安装和使用 OSP。

前提条件

下载 Audiokinetic Wwise Launcher⁠。

启动 Wwise Launcher 应用。在“Wwise”选项卡下，安装最新或所需 Wwise 版本。

下载声场定位器程序包

下载 Oculus Spatializer Wwise 程序包。

程序包内容

下载程序包包含以下文件夹，其中标明了文件应该使用的 Wwise 版本。

Wwise2022.1

Wwise2021.1

Unity

不支持 2021.1 以前的 Wwise 版本。

在每个 Wwise 文件夹中，您会找到以下子文件夹：

Android - Android 应用的库文件。

Include - 包含 OculusSpatializer.h，用于将 Wwise 集成到 Windows 应用中。它包含应用在 Wwise 中注册 OSP 必须使用的重要注册值。此外，它包含用于向 Wwise 运行时注册插件的代码。有关更多信息，请参阅在应用中集成 Oculus 声场定位器。

Mac64 - macOS 应用的库文件。

Win32 - 32 位 Windows Wwise 编写工具和应用的库文件。

x64 - 64 位 Windows Wwise 编写工具和应用的库文件。

Unity 文件夹包含一个 C# 脚本文件。

设置 Wwise 版声场定位器插件

以下步骤概述了如何将 Oculus 声场定位器作为 Wwise 混音器插件与声音库一起使用。

在 Windows 上设置

导航至与所需 Wwise 版本匹配的下载程序包文件夹。

如果在 64 位 Windows 上安装，将 \x64\bin\plugins 的内容复制/粘贴到 Audiokinetic\Wwise {version}\Authoring\x64\Release\bin\plugins

如果在 32 位 Windows 上安装，将 \Win32\bin\plugins 的内容复制/粘贴到 Audiokinetic\Wwise {version}\Authoring\Win32\Release\bin\plugins

在 macOS 上设置

导航至与所需 Wwise 版本匹配的下载程序包文件夹。

将 /x64/bin/plugins 的内容复制/粘贴到 Macintosh HD/Library/Application Support/Audiokinetic/Wwise {version}/Authoring/x64/Release/bin/Plugins

更新声场定位器

要迁移到 Wwise 版 Oculus 声场定位器插件的新版本，请遵循以下步骤：

删除 OculusSpatializer.dll 和 OculusSpatializer.xml 的任何现有版本。

将 OculusSpatializerWwise.dll 和 OculusSpatializerWwise.xml（32 位或 64 位）的新版本从 Oculus Audio SDK 复制到 Wwise 编写工具安装目录中覆盖现有版本。

将 OculusSpatializerWwise.dll（32 位或 64 位）的新版本复制到应用目录中覆盖现有版本。

打开 Wwise 编写工具，生成声音库。

启动应用，加载新生成的声音库。

使用 Wwise 设置 Unreal 项目

您也可以设置 Wwise 与 Unreal 项目一起使用。这些说明是用 Unreal 版本 4.25 和 Wwise 版本 2019.2.2 编写的。如果您使用的 Unreal 或 Wwise 的其他版本，您看到的 UI 元素和文件夹可能略有不同。

安装最新版 Wwise Launcher⁠。

在 Wwise Launcher 中，导航到 Unreal 选项卡，选择要集成的 Unreal 项目。下图展示了一个示例。 Wwise launcher - Unreal tab

点击 Integrate Wwise into Project…（将 Wwise 集成到项目…），按照说明操作，可指定项目路径等信息，然后点击Integrate（集成）。有关更多信息，请参阅 Audiokinetic 网站上的在 Unreal 中使用 Wwise 空间音频⁠。

在 Wwise 项目中打开插件文件夹。切换到 Wwise Launcher 的 Wwise 选项卡，点击您使用的 Wwise 版本旁边的扳手图标，选择 Open Containing Folder（打开包含此文件的文件夹），导航到 Wwise{version}\Authoring\x64\Release\bin\plugins

在单独的文件资源管理器中，将 Oculus Wwise 声场定位器二进制和 XML 文件（OculusSpatializerWwise.dll 和 OculusSpatializerWwise.xml）从 [download dir]\Wwise\Wwise{version}\x64\bin\plugins\ 复制并粘贴到您在上一步中打开的 Wwise{version}\Authoring\x64\Release\bin\plugins 文件夹。

您还必须将每个平台的 Oculus 声场定位器共享库文件（例如包含扩展名 .so 和 .dll 的文件）复制到 Unreal 项目的插件 > Wwise > 第三方目录中的正确位置。将指定声场定位器文件夹中的文件复制并粘贴到下表中指定的父文件夹下的 Release, Profile and Debug 目录的 bin 文件夹。

Oculus 声场定位器平台文件夹	相应的 Release/Profile/Debug 父文件夹
`WindowsNoEditor/Win32/bin/plugins`	`Win32_vc150`
`Windows/NoEditor/x64/bin/plugins`	`x64_vc150`
`android/artmeabi-v7a`	`Android_armeabi-v7a`
`android/android64`	`Android_arm64-v8a`