menu
版本
2023.1.13.8732
2024.1.5.8803
2023.1.13.8732
2022.1.19.8584
2021.1.14.8108
2019.2.15.7667
2019.1.11.7296
2018.1.11.6987
2017.2.10.6745
2017.1.9.6501
2016.2.6.6153
2015.1.9.5624
menu_open
目标平台:
|
Wwise SDK 2023.1.13
|
针对 Android 的相关信息
本页包含有关将 Wwise SDK 用于 Android 平台的特定信息。
平台要求
若要结合 Android 平台使用 Wwise SDK，必须安装 Android SDK、Android SDK Tools 和 Android NDK。
使用 Fast Audio Path（低延迟）
在最近的操作系统版本中，Google 引入了 Fast Audio Path 功能。如果满足一些条件，这样做会旁通一些内部处理，极大地减少操作系统和硬件处理的延迟。请参阅 控制Android上的延迟 了解更多详情。
部署和加载 SoundBank
在 Android 中部署和加载 SoundBank 有三种方式：
- 将 SoundBank 当作 Android 应用程序包（APK）的一部分进行部署。
在将应用程序部署至设备前，必须将 SoundBank 放入 Android NDK 工程的 assets 子文件夹，并通过 APK（或其他工具的等效过程）正常打包。为了从 APK 读取音频包文件，必须指定音频包相对于 APK 存档内标准 assets 目录的路径。为此，请调用CAkDefaultIOHookDeferred::SetBasePath()。此操作不会自动完成。 - 将 SoundBank 装入 Android Application Split Binary（又称为OBB）进行部署。 为了从 OBB 读取 SoundBank，必须确保音频包在 OBB 内的相对路径与主 APK 中的设置相同。
- 将 SoundBank 直接部署到 Android 设备文件系统中。 SoundBank 可部署到设备文件系统中的任何位置。您可以通过
CAkDefaultIOHookDeferred::AddBasePath()添加任意数量的目录。
位于 $<Wwise>/SDK/samples/SoundEngine/Android 中的底层 I/O 的默认实现可访问 APK、OBB 和 POSIX 文件。您必须通过 JavaVM 和 android.app.Activity 调用 CAkDefaultIOHookDeferred::InitAndroidIO 函数来对 APK 和 OBB 解析器进行初始化。
IO 系统将在给定路径中逆序查找文件，先添加最新内容，最后添加 APK 内容。这样 DLC 内容便可替换 APK 内容了。
请参阅 Low-Level I/O 了解有关如何实现 Low-level I/O 子模块的信息。
Android 库特点
安装包中的 Wwise SDK 库采用以下编译方式：
- 在 armeabi-v7a 架构上支持 NEON 指令集
- 在 x86 架构上支持 SSE 指令集
- 在 arm64-v8a 架构上支持 NEON 指令集
- 在 x86_64 架构上支持 SSE 指令集
3D Audio 支持
现在 Android 提供对 Wwise 3D Audio 的支持。该功能专为耳机输出设计并通过 Android 的 Spatial Audio 技术（有别于 Wwise Spatial Audio）实现。它支持 Spatialized Bed 和 Passthrough Mix。不过，不支持 System Audio Object。
Android 13 及更高版本的操作系统针对有线和无线耳机提供有 Spatial Audio 用户偏好设置。 因此，只要满足以下要求就会在 Wwise 中激活 3D Audio 管线：
- 在 Wwise 工程中启用了 Audio Device 属性 Allow 3D Audio。
- 在设备上为耳机启用了 Spatial Audio。对于无线耳机，可在 Bluetooth 设置中予以启用。
- 未设置输出设备声道配置，或使用了受支持的声道配置（参见下文的 Main Mix Configuration）。
建议允许用户通过游戏设置选择是否使用 3D Audio，并根据此设置来自由选用两个 Audio Device 共享集。
在初始化时，若已激活 3D Audio，则会将 Main Mix 配置为 7.1.4 PCM（默认），除非将 Audio Device 的 Main Mix Configuration 属性设为不同的值。 以下为受支持的 Main Mix PCM 声道配置：
- 5.1
- 5.1.2
- 7.1
- 7.1.2
- 7.1.4（推荐）
在 Unreal 中配置 3D Audio
若要使用 Wwise Unreal Integration，则须在 Unreal 工程中设置多个选项来启用 3D Audio。不同的扬声器配置（7.1.4、5.1 等）要做不同的配置。
在 Unreal 中配置 Android 3D Audio 选项： #- 在 Unreal 工程中，依次选择 Edit > Project Settings，并在 Wwise 分区选择 Android。这时会打开 Wwise - Android 设置页面。 #- 依次转到 Common Settings > Main Output Settings。 #- 将 Panning Rule 设为 Headphones。 #- 将 Channel Config Type 设为 Standard。 #- 根据所需扬声器配置来设置 Channel Mask 选项（如下表所示）：
| 扬声器配置 | Channel Mask 设置 |
|---|---|
| 5.1 |
|
| 5.1.2 |
|
| 7.1 |
|
| 7.1.2 |
|
| 7.1.4 |
|