バージョン
menu

ターゲットプラットフォーム:
Wwise SDK 2023.1.14
Androidに固有の情報

以下のページには、Android 対応 Wwise SDK の使用に特定の情報が含まれています。

プラットフォーム要件

Wwise SDKをAndroidプラットフォームで使用するには、Android SDK、Android SDK Tool、Android NDKをインストールする必要があります。

注釈:

  • The build scripts are dependent on the Android NDK toolchain, as pointed by NDKROOT environment variable.

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).

「高速オーディオパス」(低レイテンシ)を使用する

Googleは、最近のOSバージョンでは「高速オーディオパス」を導入しています。これにより、いくつかの条件が満たされた場合に内部処理の一部がバイパスされ、OSおよびハードウェア処理の待ち時間が大幅に短縮されます。詳細は、次のページを参照してください: Androidでのレイテンシーのコントロール

SoundBankの実装とロード

Androidでは、3種類のサウンドバンクの実装とロード方法があります:

  1. Android application package (APK)の一部としてサウンドバンクを実装する。
    アプリケーションのデバイス実装前に、サウンドバンクをAndroid NDKプロジェクトの"assets"サブフォルダに入れて、APKで通常通りにパッケージする(または、他のツールで同等の処理をする)必要があります。APKからバンクファイルを読み込むには、APKアーカイブ内の、"assets"標準ディレクトリのバンクの相対パスを指定しなければなりません。方法は、 CAkDefaultIOHookDeferred::SetBasePath() をコールします。自動的には行われません。
  2. Android Application Split Binaryの一部として SoundBanks を実装します (またはOBB). OBBからサウンドバンクを読み込むには、OBB内のバンクの相対パスと、メインAPK内のバンクの相対パスが、同一である必要があります。
  3. サウンドバンクを Android デバイスのファイルシステムディレクトリに直接実装する。 SoundBankは、デバイスのファイルシステムのどこにでも展開できます。追加できるディレクトリ数に制限はなく、追加するには、 CAkDefaultIOHookDeferred::AddBasePath() を使います。

$<Wwise>/SDK/samples/SoundEngine/Android にあるデフォルトの低レベルの実装では、APK、OBB ならびに POSIX ファイルにアクセスできます。JavaVMとandroid.app.Activityと共に CAkDefaultIOHookDeferred::InitAndroidIO 関数を呼び出し、APKおよびOBBのリーダーの両方を初期化します。

注釈: デフォルトの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

3D Audioのサポート

Wwise 3D Audioは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. システムオーディオオブジェクトには対応しません。

Android OSバージョン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を使用するかどうかをユーザがゲーム内の設定で選択できるようにし、この設定に基づき 2つの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. 「高速オーディオパス」(低レイテンシ)を使用する を参照してください。

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
  • Front Left
  • Front Right
  • Front Center
  • Low Frequency
  • Back Left
  • Back Right
5.1.2
  • Front Left
  • Front Right
  • Front Center
  • Low Frequency
  • Back Left
  • Back Right
  • Height Front Left
  • Height Front Right
7.1
  • Front Left
  • Front Right
  • Front Center
  • Low Frequency
  • Back Left
  • Back Right
  • Side Left
  • Side Right
7.1.2
  • Front Left
  • Front Right
  • Front Center
  • Low Frequency
  • Back Left
  • Back Right
  • Side Left
  • Side Right
  • Height Front Left
  • Height Front Right
7.1.4
  • Front Left
  • Front Right
  • Front Center
  • Low Frequency
  • Back Left
  • Back Right
  • Side Left
  • Side Right
  • Height Front Left
  • Height Front Right
  • Height Back Left
  • Height Back Right

Androidリリースノート


このページはお役に立ちましたか?

サポートは必要ですか?

ご質問や問題、ご不明点はございますか?お気軽にお問い合わせください。

サポートページをご確認ください

あなたのプロジェクトについて教えてください。ご不明な点はありませんか。

プロジェクトを登録していただくことで、ご利用開始のサポートをいたします。

Wwiseからはじめよう