|
Wwise SDK 2023.1.14
|
本页包含有关将 Wwise SDK 用于 Android 平台的特定信息。
平台要求
若要结合 Android 平台使用 Wwise SDK，必须安装 Android SDK、Android SDK Tools 和 Android NDK。
 | 备注:
You can build the Android libraries using the script BuildAllAndroid.cmd with the desired platform and configuration (i.e. BuildAllAndroid.cmd armeabi-v7a debug) on Windows in the SDK/source/SoundEngine folder. This will call CMake with the appropriate parameters. This script can target the 4 supported architectures (armeabi-v7a, x86, arm64-v8a and x86_64) in 3 configurations (Debug, Profile, Release). |
使用 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 解析器进行初始化。
| 备注: OBB 包必须解密，之后默认 Low-Level I/O 才能正常工作。否则需要编写自己的 IO。 |
| 备注: OBB 读取操作通过 libzip 执行，请检查 Libzip 下的授权。如果您不接受该授权，则可通过在编译选项中定义“REMOVE_LIBZIP”符号来禁用 LibZip。在这种情况下，您需要编写自己的 I/O hook 来读取 OBB 或在使用前解压 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 的支持。It is implemented through Android's Spatial Audio technology (distinct from Wwise Spatial Audio), and is designed for headphone output. It supports a spatialized bed and a passthrough mix. 不过，不支持 System Audio Object。
Android 13 及更高版本的操作系统针对有线和无线耳机提供有 Spatial Audio 用户偏好设置。 Therefore, the 3D Audio pipeline in Wwise is always activated when the following requirements are met:
- 在 Wwise 工程中启用了 Audio Device 属性 Allow 3D Audio。
- Spatial Audio is enabled on the device for headphones. For wireless headphones, it can be enabled in the Bluetooth settings.
- The output device channel configuration is not set or a supported channel configuration is used (see Main Mix Configuration below).
建议允许用户通过游戏设置选择是否使用 3D Audio，并根据此设置来自由选用两个 Audio Device 共享集。
Upon initialization, if 3D Audio is activated, the main mix is configured as 7.1.4 PCM (default), unless the Main Mix Configuration property of the Audio Device is set to a different value. These are the supported main mix PCM channel configurations:
- 5.1
- 5.1.2
- 7.1
- 7.1.2
- 7.1.4（推荐）
| 备注: Enabling Android Spatial Audio disables the low-latency "Fast Audio Path" feature. Refer to 使用 Fast Audio Path（低延迟） |
Configuring 3D Audio in Unreal
If you are using the Wwise Unreal Integration, you must set several options in the Unreal project to enable 3D Audio. Different speaker configurations (7.1.4, 5.1, and so on) require different configurations.
To configure Android 3D Audio options in Unreal: #- In the Unreal project, select Edit > Project Settings and in the Wwise section, select Android. The Wwise - Android settings page opens. #- Open Common Settings > Main Output Settings. #- Set the Panning Rule to Headphones. #- Set the Channel Config Type to Standard. #- Set the Channel Mask options according to the desired speaker configuration, listed in the following table:
| Speaker configuration | Channel Mask settings |
|---|---|
| 5.1 |
|
| 5.1.2 |
|
| 7.1 |
|
| 7.1.2 |
|
| 7.1.4 |
|