|
Wwise SDK 2024.1.0
|
以下のページには、Android 対応 Wwise SDK の使用に特定の情報が含まれています。
プラットフォーム要件
To use the Wwise SDK with the Android platform, you must install the Android SDK, Android SDK Tools, and Android NDK. For the required versions, refer to the appropriate version of the Androidリリースノート.
 | 注釈:
Androidライブラリをビルドするには、スクリプトBuildAllAndroid.cmdを使い、希望するプラットフォームと、コンフィギュレーションで（つまりBuildAllAndroid.cmd armeabi-v7a debug）、windowsで、SDK/source/SoundEngineフォルダにビルドします。これにより適切なパラメータでndk-buildをコールします。 このスクリプトがターゲットできるのは、サポートされている4つのアーキテクチャ (v7a, x86, v8a-64, x86_64) の、3つのコンフィギュレーション (debug, profile, release)です。 |
Using the "Fast Audio Path" (low-latency)
In recent OS versions, Google introduced the "Fast Audio Path". これにより、いくつかの条件が満たされた場合に内部処理の一部がバイパスされ、OSおよびハードウェア処理の待ち時間が大幅に短縮されます。詳細は、次のページを参照してください: Androidでのレイテンシーのコントロール 。
SoundBankの実装とロード
Androidでは、3種類のサウンドバンクの実装とロード方法があります:
- Android application package (APK)の一部としてサウンドバンクを実装する。
アプリケーションのデバイス実装前に、サウンドバンクをAndroid NDKプロジェクトの"assets"サブフォルダに入れて、APKで通常通りにパッケージする（または、他のツールで同等の処理をする）必要があります。APKからバンクファイルを読み込むには、APKアーカイブ内の、"assets"標準ディレクトリのバンクの相対パスを指定しなければなりません。方法は、CAkDefaultIOHookDeferred::SetBasePath()をコールします。自動的には行われません。 - Android Application Split Binaryの一部として SoundBanks を実装します (またはOBB). OBBからサウンドバンクを読み込むには、OBB内のバンクの相対パスと、メインAPK内のバンクの相対パスが、同一である必要があります。
- サウンドバンクを Android デバイスのファイルシステムディレクトリに直接実装する。 SoundBankは、デバイスのファイルシステムのどこにでも展開できます。追加できるディレクトリ数に制限はなく、追加するには、
CAkDefaultIOHookDeferred::AddBasePath()を使います。
$<Wwise>/SDK/samples/SoundEngine/Android にあるデフォルトの低レベルの実装では、APK、OBB ならびに POSIX ファイルにアクセスできます。You must call the function CAkDefaultIOHookDeferred::InitAndroidIO with a JavaVM and the android.app.Activity to initialize both APK and OBB readers.
| 注釈: デフォルトのLow Level IOが正しく作動するには、OBBアーカイブが暗号化されていない状態（unencrypted）である必要があります。そうでなければ、独自のIOを書く必要があります。 |
| 注釈: OBB の読み込みはlibzipを使って行います。 Libzip 下にあるライセンスを確認してください。。ライセンスを承諾しない場合には、コンピレーションフラグで "REMOVE_LIBZIP" シンボルを指定して、 LibZip の使用を無効にしてください。そうした場合、OBBを読み込むために独自のIOを書くか、使用前にOBBの圧縮を解除する必要があります。 |
IO システムは、与えられたパスによって、逆順、最後に追加したものを最初に、APK コンテンツを最後にファイル検索します。これによりDLC コンテンツが APK コンテンツに取って代わることが可能です。
低レベルI/O サブモジュールの実装方法についての詳細は、 低レベル I/O を参照してください。
Android ライブラリ フレーバー
Wwise SDK のプリコンパイル ライブラリは、このフレーバーでコンパイルされています:
- armeabi-v7a と NEON
- x86 と SSE
- arm64-v8a とNEON
- x86_64 と SSE
Android Audio APIs
Wwise supports the following audio APIs on Android:
3D Audio Support
Wwise 3D Audio is supported on Android. 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 objects are not supported.
Android OS versions 13 and higher have Spatial Audio user preferences for wired and wireless headphones. Therefore, the 3D Audio pipeline in Wwise is always activated when the following requirements are met:
- The Audio Device property Allow 3D Audio is enabled in the Wwise project.
- 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).
We recommend that you allow the user to choose whether to use 3D Audio through an in-game setting, and swap between two Audio Device sharesets based on this setting.
| 注釈: Enabling Android Spatial Audio disables the low-latency "Fast Audio Path" feature. Using the "Fast Audio Path" (low-latency) を参照してください。 |
Using 3D Audio with AAudio
Upon initialization, when using AAudio with 3D Audio 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 for use with AAudio:
- 5.1
- 5.1.2
- 7.1
- 7.1.2
- 7.1.4 (recommended)
Using 3D Audio with OpenSL ES
Upon initialization, when using OpenSL ES with 3D Audio activated, the main mix is configured as 5.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 for use with OpenSL ES:
- 5.1
- 5.1.2
- 5.1.4 (recommended)
- 7.1
- 7.1.4
A main mix channel configuration of 5.1.4 or 7.1.4 is downmixed to 5.1.2 on supported devices. If a request for an output channel configuration cannot be fulfilled by a device, the main mix and output configurations are changed to stereo.
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 |
|