轨道选择

当媒体项包含多个轨道时，轨道选择是确定其中哪些轨道用于播放的过程。轨道选择过程由 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 对象列表，其中单个 Group 中的轨道呈现相同内容但格式不同。

举例说明轨道如何分组：考虑自适应播放，其中主视频源以五种比特率提供，而替代视频源（例如，体育比赛中不同的摄像机角度）以两种比特率提供。在这种情况下，将有两个视频轨道组，一个对应于包含五个轨道的主视频源，第二个对应于包含两个轨道的替代视频源。

语言不同的音频轨道不分组，因为不同语言的内容不被认为是相同的。相反，相同语言的音频轨道，如果仅在比特率、采样率、声道数等属性上有所不同，则可以分组。这同样适用于文本轨道。

每个 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 选择用于播放，则轨道是选定状态。如果一个轨道组中有多个轨道被选中，播放器将使用这些轨道进行自适应播放（例如，具有不同比特率的多个视频轨道）。请注意，在任何给定时间，这些轨道中只有一个会被播放。

修改轨道选择参数

轨道选择过程可以使用 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 的媒体项。因此，如果后续媒体项包含不同的轨道，则覆盖可能不适用。

禁用轨道类型或组

轨道类型（如视频、音频或文本）可以使用 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());
);