トラックの選択

メディア アイテムに複数のトラックが含まれている場合、トラック選択は、再生に選択されるトラックを決定するプロセスです。トラック選択プロセスは TrackSelectionParameters によって構成されます。これにより、トラック選択に影響するさまざまな制約とオーバーライドを指定できます。

使用可能なトラックのクエリ

Player.Listener.onTracksChanged をリッスンすると、次のようなトラックの変更に関する通知を受け取ることができます。

  • 再生中のメディア アイテムの準備が完了すると、利用可能なトラックが判明します。プレーヤーは、含まれるトラックを知るためにメディア アイテムを準備する必要があります。
  • 再生がメディア アイテムから別のアイテムに移行したために、使用可能なトラックが変更された。
  • 選択したトラックに対する変更。

Kotlin

player.addListener(
  object : Player.Listener {
    override fun onTracksChanged(tracks: Tracks) {
      // Update UI using current tracks.
    }
  }
)

Java

player.addListener(
    new Player.Listener() {
      @Override
      public void onTracksChanged(Tracks tracks) {
        // Update UI using current tracks.
      }
    });

player.getCurrentTracks() を呼び出して、現在のトラックをクエリすることもできます。返された Tracks には、Tracks.Group オブジェクトのリストが含まれます。1 つの Group 内のトラックは、同じコンテンツを異なる形式で表します。

トラックをグループ化する方法の例として、メインの動画フィードが 5 つのビットレートで提供され、代替の動画フィード（スポーツの試合の別のカメラアングルなど）が 2 つのビットレートで提供される適応型再生について考えてみましょう。この場合、2 つの動画トラック グループが作成されます。1 つは 5 つのトラックを含むメインの動画フィードに対応し、もう 1 つは 2 つのトラックを含む代替の動画フィードに対応します。

言語が異なる音声トラックはグループ化されません。これは、異なる言語のコンテンツは同じと見なされないためです。逆に、ビットレート、サンプリング レート、チャンネル数などのプロパティのみが異なる同じ言語の音声トラックはグループ化できます。これはテキスト トラックにも適用されます。

各 Group をクエリして、再生がサポートされているトラック、現在選択されているトラック、各トラックで使用されている Format を特定できます。

Kotlin

for (trackGroup in tracks.groups) {
  // Group level information.
  val trackType = trackGroup.type
  val trackInGroupIsSelected = trackGroup.isSelected
  val trackInGroupIsSupported = trackGroup.isSupported
  for (i in 0 until trackGroup.length) {
    // Individual track information.
    val isSupported = trackGroup.isTrackSupported(i)
    val isSelected = trackGroup.isTrackSelected(i)
    val trackFormat = trackGroup.getTrackFormat(i)
  }
}

Java

for (Tracks.Group trackGroup : tracks.getGroups()) {
  // Group level information.
  @C.TrackType int trackType = trackGroup.getType();
  boolean trackInGroupIsSelected = trackGroup.isSelected();
  boolean trackInGroupIsSupported = trackGroup.isSupported();
  for (int i = 0; i < trackGroup.length; i++) {
    // Individual track information.
    boolean isSupported = trackGroup.isTrackSupported(i);
    boolean isSelected = trackGroup.isTrackSelected(i);
    Format trackFormat = trackGroup.getTrackFormat(i);
  }
}

  • Player がサンプルをデコードしてレンダリングできる場合、トラックはサポートされています。同じタイプの複数のトラック グループ（複数の音声トラック グループなど）がサポートされている場合でも、個別にサポートされているだけであり、プレーヤーがそれらを同時に再生できるとは限りません。
  • トラックが選択されている場合、現在の TrackSelectionParameters に基づいて再生用に選択されています。1 つのトラック グループ内の複数のトラックが選択されている場合、プレーヤーはこれらのトラックをアダプティブ再生に使用します（ビットレートが異なる複数の動画トラックなど）。なお、これらのトラックは一度に 1 つだけ再生されます。

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

トラック選択プロセスは Player.setTrackSelectionParameters を使用して設定できます。これは、再生前と再生中の両方で行えます。次の例は、プレーヤーから現在の TrackSelectionParameters を取得し、変更して、変更した結果で Player を更新する方法を示しています。

Kotlin

player.trackSelectionParameters =
  player.trackSelectionParameters
    .buildUpon()
    .setMaxVideoSizeSd()
    .setPreferredAudioLanguage("hu")
    .build()

Java

player.setTrackSelectionParameters(
    player
        .getTrackSelectionParameters()
        .buildUpon()
        .setMaxVideoSizeSd()
        .setPreferredAudioLanguage("hu")
        .build());

制約ベースのトラック選択

TrackSelectionParameters のほとんどのオプションでは、実際に使用可能なトラックとは独立した制約を指定できます。使用可能な制約には次のものがあります。

  • 動画の最大および最小の幅、高さ、フレームレート、ビットレートを指定します。
  • 最大音声チャンネル数とビットレート。
  • 動画と音声の優先 MIME タイプ。
  • 優先する音声言語とロールフラグ。
  • 優先するテキスト言語とロールフラグ。

ExoPlayer では、動画の解像度をディスプレイ サイズに制限したり、ユーザーのシステムのロケール設定に一致する音声言語を優先したりするなど、これらの制約に適切なデフォルト値が使用されます。

利用可能なトラックから特定のトラックを選択するのではなく、制約ベースのトラック選択を使用すると、次のようなメリットがあります。

  • メディア アイテムが提供するトラックを確認する前に、制約を指定できます。つまり、プレーヤーがメディア アイテムを準備する前に制約を指定できますが、特定のトラックを選択するには、使用可能なトラックが判明するまでアプリケーション コードが待機する必要があります。
  • 制約は、再生リスト内のすべてのメディア アイテムに適用されます。アイテムで使用可能なトラックが異なる場合でも同様です。たとえば、優先する音声言語の制約は、その言語のトラックの Format がメディア アイテムごとに異なる場合でも、すべてのメディア アイテムに自動的に適用されます。ただし、特定のトラックを指定する場合は、次のように処理が異なります。

特定のトラックの選択

TrackSelectionParameters を使用して特定のトラックを選択できます。まず、Player.getCurrentTracks を使用して、プレーヤーで現在利用可能なトラックをクエリする必要があります。次に、選択するトラックを特定したら、TrackSelectionOverride を使用して TrackSelectionParameters に設定します。たとえば、特定の audioTrackGroup から最初のトラックを選択するには、次のようにします。

Kotlin

player.trackSelectionParameters =
  player.trackSelectionParameters
    .buildUpon()
    .setOverrideForType(
      TrackSelectionOverride(audioTrackGroup.mediaTrackGroup, /* trackIndex= */ 0)
    )
    .build()

Java

player.setTrackSelectionParameters(
    player
        .getTrackSelectionParameters()
        .buildUpon()
        .setOverrideForType(
            new TrackSelectionOverride(
                audioTrackGroup.getMediaTrackGroup(), /* trackIndex= */ 0))
        .build());

TrackSelectionOverride は、オーバーライドで指定された TrackGroup と完全に一致する TrackGroup を含むメディア アイテムにのみ適用されます。したがって、アイテムに異なるトラックが含まれている場合、オーバーライドは後続のメディア アイテムには適用されない場合があります。

トラックタイプまたはグループを無効にする

動画、音声、テキストなどのトラックタイプは、TrackSelectionParameters.Builder.setTrackTypeDisabled を使用して完全に無効にできます。無効にしたトラックタイプは、すべてのメディア アイテムで無効になります。

Kotlin

player.trackSelectionParameters =
  player.trackSelectionParameters
    .buildUpon()
    .setTrackTypeDisabled(C.TRACK_TYPE_VIDEO, /* disabled= */ true)
    .build()

Java

player.setTrackSelectionParameters(
    player
        .getTrackSelectionParameters()
        .buildUpon()
        .setTrackTypeDisabled(C.TRACK_TYPE_VIDEO, /* disabled= */ true)
        .build());

また、特定の TrackGroup からトラックが選択されないようにするには、そのグループに空のオーバーライドを指定します。

Kotlin

player.trackSelectionParameters =
  player.trackSelectionParameters
    .buildUpon()
    .addOverride(
      TrackSelectionOverride(disabledTrackGroup.mediaTrackGroup, /* trackIndices= */ listOf())
    )
    .build()

Java

player.setTrackSelectionParameters(
    player
        .getTrackSelectionParameters()
        .buildUpon()
        .addOverride(
            new TrackSelectionOverride(
                disabledTrackGroup.getMediaTrackGroup(),
                /* trackIndices= */ ImmutableList.of()))
        .build());

トラック選択ツールをカスタマイズする

トラックの選択は TrackSelector の責任です。ExoPlayer がビルドされるたびにインスタンスを提供でき、後で ExoPlayer.getTrackSelector() で取得できます。

Kotlin

val trackSelector = DefaultTrackSelector(context)
val player = ExoPlayer.Builder(context).setTrackSelector(trackSelector).build()

Java

DefaultTrackSelector trackSelector = new DefaultTrackSelector(context);
ExoPlayer player = new ExoPlayer.Builder(context).setTrackSelector(trackSelector).build();

DefaultTrackSelector は、ほとんどのユースケースに適した柔軟な TrackSelector です。Player で設定された TrackSelectionParameters を使用しますが、DefaultTrackSelector.ParametersBuilder で指定できる高度なカスタマイズ オプションも用意されています。

Kotlin

trackSelector.setParameters(
  trackSelector.buildUponParameters().setAllowVideoMixedMimeTypeAdaptiveness(true))
)

Java

trackSelector.setParameters(
    trackSelector.buildUponParameters().setAllowVideoMixedMimeTypeAdaptiveness(true));

トンネリング

レンダラと選択したトラックの組み合わせがトンネリング再生をサポートしている場合は、トンネリング再生を有効にできます。その場合は、DefaultTrackSelector.ParametersBuilder.setTunnelingEnabled(true) を使用します。

オーディオ オフロード

レンダラと選択したトラックの組み合わせがオフロード音声再生をサポートしている場合は、オフロード音声再生を有効にできます。これを行うには、TrackSelectionParameters に AudioOffloadModePreferences を指定します。

Kotlin

val audioOffloadPreferences =
  AudioOffloadPreferences.Builder()
      .setAudioOffloadMode(AudioOffloadPreferences.AUDIO_OFFLOAD_MODE_ENABLED)
      // Add additional options as needed
      .setIsGaplessSupportRequired(true)
      .build()
player.trackSelectionParameters =
  player.trackSelectionParameters
    .buildUpon()
    .setAudioOffloadPreferences(audioOffloadPreferences)
    .build()

Java

AudioOffloadPreferences audioOffloadPreferences =
  new AudioOffloadPreferences.Builder()
      .setAudioOffloadMode(AudioOffloadPreferences.AUDIO_OFFLOAD_MODE_ENABLED)
      // Add additional options as needed
      .setIsGaplessSupportRequired(true)
      .build();
player.setTrackSelectionParameters(
  player.getTrackSelectionParameters()
    .buildUpon()
    .setAudioOffloadPreferences(audioOffloadPreferences)
    .build());
);