このページは Cloud Translation API によって翻訳されました。

空間オーディオ

空間オーディオは、臨場感あふれるオーディオ体験で、臨場感あふれるリアルなサウンドが実現します。音は "空間化"サラウンドのようなマルチスピーカー効果をヘッドフォンで設定してください。

たとえば映画では、車の音がユーザーの後ろから始まり、遠くまで追いつくことができますビデオチャットでは、スピーカーを簡単に識別できるようにしています。

サポートされている音声形式をコンテンツで使用している場合は、 Android 13（API レベル 33）以降のアプリで利用できます。

機能をクエリする

Spatializer クラスを使用して以下を行います。デバイスの空間化機能と動作をクエリできます。まず取得 Spatializer のインスタンス AudioManager:

Kotlin

val spatializer = audioManager.spatializer

Java

Spatializer spatializer = AudioManager.getSpatializer();

Spatializer が表示されたら、満たすべき 4 つの条件を確認します。 true に設定すると、空間化された音声が出力されます。

条件	確認
デバイスは空間化に対応していますか？	`getImmersiveAudioLevel()` は `SPATIALIZER_IMMERSIVE_LEVEL_NONE` に一致しない
立体化は可能ですか？ご利用いただけるかどうかは、現在のオーディオ出力ルーティングとの互換性によって異なります。	`isAvailable()` は `true` です
空間化は有効になっていますか？	`isEnabled()` は `true` です
指定されたパラメータを持つ音声トラックを空間化できますか？	`canBeSpatialized()` は `true` です

空間化が利用できない場合などは、これらの条件が満たされない可能性があります音声出力デバイスで完全に無効にすることもできます。

ヘッドトラッキング

プラットフォームは、サポートされているヘッドセットを使用して、ユーザーの頭の位置に基づいて空間化します。ヘッドトラッカーが現在のオーディオ出力ルーティングで利用できない場合は、 isHeadTrackerAvailable()。

互換性のあるコンテンツ

Spatializer.canBeSpatialized() 指定されたプロパティを持つ音声をルーティングする。このメソッドは AudioAttributes を受け取ります。 AudioFormat があります。どちらも以下で詳しく説明します。

`AudioAttributes`

AudioAttributes オブジェクトリソースの使用方法を音声ストリーム（ゲーム音声など）または標準のメディア）、その再生動作やコンテンツタイプが表示されます。

canBeSpatialized() を呼び出すときは、同じ Player に設定された AudioAttributes インスタンス。たとえば Jetpack Media3 ライブラリを使用しており、 AudioAttributes、AudioAttributes.DEFAULT を使用してください。

空間オーディオを無効にする

コンテンツがすでに空間化されていることを示すには、 setIsContentSpatialized(true) 二重処理が行われないようにする必要がありますまたは、次の呼び出しによって、空間化を完全に無効にします。 setSpatializationBehavior(AudioAttributes.SPATIALIZATION_BEHAVIOR_NEVER)。

`AudioFormat`

AudioFormat オブジェクトは、音声トラックの形式とチャンネル設定に関する詳細。

canBeSpatialized() に渡す AudioFormat をインスタンス化する場合: encoding を設定します。デコーダから期待される出力形式と同じになるように変換します。さらに、チャンネルマスクコンテンツのチャンネル設定と一致するようにしてください。詳しくは、デフォルトの空間化動作セクションのガイダンス指定することもできます。

`Spatializer` の変更をリッスンする

Spatializer の状態の変化をリッスンするために、リスナーを追加して、 Spatializer.addOnSpatializerStateChangedListener() に置き換えます。同様に、ヘッドトラッカーの可用性の変化をリッスンするには、 Spatializer.addOnHeadTrackerAvailableListener() を呼び出します。

これは、再生中にトラックの選択を調整する場合に便利です。リスナーのコールバックを使用します。たとえば、ユーザーがインターネットからヘッドセットをデバイスから離すと、onSpatializerAvailableChanged コールバックは、新しいスペースでスペイシャライザーエフェクトを使用できるかどうかを示します。ルーティングできますこのタイミングで、プレーヤーのゲームコンテンツの更新をデバイスの新機能に合わせて選択ロジックを追跡します。詳細については、 ExoPlayer のトラック選択動作については、ExoPlayer と空間オーディオをご覧ください。。

ExoPlayer と空間オーディオ

ExoPlayer の最近のリリースで、空間オーディオの導入が簡単になりました。以下をご使用の場合: スタンドアロンの ExoPlayer ライブラリ（パッケージ名 com.google.android.exoplayer2）バージョン 2.17 では、空間化された音声を出力するようにプラットフォームが設定されます。 2.18 では、音声チャンネル数の制約が導入されています。 Media3 ライブラリの ExoPlayer モジュールを使用する場合（パッケージ名 androidx.media3）、バージョン 1.0.0-beta01 同じ更新が加えられます

ExoPlayer の依存関係を最新リリースに更新すると、アプリは空間化できるコンテンツが必要です

音声チャンネル数の制約

空間オーディオの 4 つの条件をすべて満たしている場合、ExoPlayer は以下を選択します。マルチチャンネルオーディオトラックです。そうでない場合、ExoPlayer は代わりにステレオトラックを選択します。 Spatializer プロパティが変更された場合、ExoPlayer 新しいトラック選択がトリガーされ、確認します。なお、この新しいトラックを選択すると、再バッファリング期間内です。

音声チャンネル数の制約を無効にするには、トラック選択パラメータを設定します次のようにプレーヤーに表示されます。

Kotlin

exoPlayer.trackSelectionParameters = DefaultTrackSelector.Parameters.Builder(context)
  .setConstrainAudioChannelCountToDeviceCapabilities(false)
  .build()

Java

exoPlayer.setTrackSelectionParameters(
  new DefaultTrackSelector.Parameters.Builder(context)
    .setConstrainAudioChannelCountToDeviceCapabilities(false)
    .build()
);

同様に、既存のトラックセレクタのパラメータを更新して、無効にすることもできます。次のような音声チャンネル数の制約があります。

Kotlin

val trackSelector = DefaultTrackSelector(context)
...
trackSelector.parameters = trackSelector.buildUponParameters()
  .setConstrainAudioChannelCountToDeviceCapabilities(false)
  .build()

Java

DefaultTrackSelector trackSelector = new DefaultTrackSelector(context);
...
trackSelector.setParameters(
  trackSelector
    .buildUponParameters()
    .setConstrainAudioChannelCountToDeviceCapabilities(false)
    .build()
);

音声チャンネル数の制約を無効にして、コンテンツに複数の音声が含まれている場合 ExoPlayer は最初にチャンネル数が最も多いトラックを選択し、デバイスから再生できることを確認します。たとえば、コンテンツにマルチチャンネル音声トラックとステレオ音声トラックがあり、デバイスは両方の再生で、ExoPlayer はマルチチャンネルトラックを選択します。詳しくは、この動作をカスタマイズする方法について詳しくは、音声トラックの選択をご覧ください。

音声トラックの選択

ExoPlayer のオーディオチャンネル数の制約動作が無効の場合、ExoPlayer は音声トラックを自動的に選択しません。これは、デバイスのスペイシャライザーのプロパティと一致するものです。代わりにトラック選択を設定して、ExoPlayer のトラック選択ロジックをカスタマイズするパラメータを指定します。デフォルトでは、ExoPlayer はオーディオ MIME タイプに関する最初のトラックと同じトラック。（エンコード）、チャンネル数、サンプルレートがあります。

トラック選択パラメータの変更

ExoPlayer のトラック選択パラメータを変更するには、次のコマンドを使用します。 Player.setTrackSelectionParameters()。同様に、ExoPlayer の現在のパラメータは、次のコマンドで取得できます。 Player.getTrackSelectionParameters()。たとえば、再生中にステレオ音声トラックを選択するには、次のようにします。

Kotlin

exoPlayer.trackSelectionParameters = exoPlayer.trackSelectionParameters
  .buildUpon()
  .setMaxAudioChannelCount(2)
  .build()

Java

exoPlayer.setTrackSelectionParameters(
  exoPlayer.getTrackSelectionParameters()
    .buildUpon()
    .setMaxAudioChannelCount(2)
    .build()
);

なお、再生中にトラック選択パラメータを変更すると、発生します。プレーヤーのトラックの調整に関する詳細選択パラメータはトラック選択セクションをご覧ください。

デフォルトの空間化動作

Android のデフォルトの空間化動作には、次の動作が含まれます。次のようなタイプがあります。

ステレオコンテンツではなく、マルチチャンネルコンテンツのみが空間化されます。マルチチャネルの形式に応じて、ExoPlayer を使用しない場合設定しなければならない場合は、必要に応じてチャンネルの最大数と音声デコーダで出力できます。これによりプラットフォームが空間化するためのマルチチャンネル PCM を出力します。
Kotlin
```
val mediaFormat = MediaFormat()
mediaFormat.setInteger(MediaFormat.KEY_MAX_OUTPUT_CHANNEL_COUNT, 99)
```
Java
```
MediaFormat mediaFormat = new MediaFormat();
mediaFormat.setInteger(MediaFormat.KEY_MAX_OUTPUT_CHANNEL_COUNT, 99);
```
実際の例については、ExoPlayer の MediaCodecAudioRenderer.java をご覧ください。OEM に関係なく、自分で空間化をオフにするにはカスタマイズについては、空間オーディオを無効にするをご覧ください。
AudioAttributes: 音声は空間化に対応しています usage の場合 USAGE_MEDIA に設定されているまたは USAGE_GAME を使用します。
AudioFormat: 少なくとも次の値を含むチャンネルマスクを使用します。 AudioFormat.CHANNEL_OUT_QUAD 音声チャンネル（前面-左、前-右、左、右の背面）から音声を空間化の対象になります。以下の例では、AudioFormat.CHANNEL_OUT_5POINT1 を使用します。 5.1 オーディオトラックの場合。ステレオ音声トラックの場合は、AudioFormat.CHANNEL_OUT_STEREO を使用します。

Media3 を使用している場合は、Util.getAudioTrackChannelConfig(int channelCount) を使用できます。を使用して、チャンネル数をチャンネルマスクに変換します。

さらに、エンコードを AudioFormat.ENCODING_PCM_16BIT に設定します。デコーダでマルチチャンネル PCM を出力するよう設定している場合。
Kotlin
```
val audioFormat = AudioFormat.Builder()
  .setEncoding(AudioFormat.ENCODING_PCM_16BIT)
  .setChannelMask(AudioFormat.CHANNEL_OUT_5POINT1)
  .build()
```
Java
```
AudioFormat audioFormat = new AudioFormat.Builder()
  .setEncoding(AudioFormat.ENCODING_PCM_16BIT)
  .setChannelMask(AudioFormat.CHANNEL_OUT_5POINT1)
  .build();
```