直播流

ExoPlayer 可开箱即用地播放大多数自适应直播流，无需任何特殊配置。有关更多详细信息，请参阅支持的格式页面。

自适应直播流提供了一个可用的媒体窗口，该窗口会定期更新以跟随当前实时情况。这意味着播放位置始终位于此窗口内，在大多数情况下靠近正在产生流的当前实时时间。当前实时时间和播放位置之间的差异称为实时偏移量。

检测和监控直播播放

每次更新直播窗口时，已注册的Player.Listener实例都会收到onTimelineChanged事件。您可以通过查询各种Player和Timeline.Window方法来检索有关当前直播播放的详细信息，如下所示以及下图所示。

Live window

Player.isCurrentWindowLive指示当前播放的媒体项目是否为直播流。即使直播流已结束，此值仍然为 true。
Player.isCurrentWindowDynamic指示当前播放的媒体项目是否仍在更新。对于尚未结束的直播流，这通常为 true。请注意，在某些情况下，此标志对于非直播流也为 true。
Player.getCurrentLiveOffset返回当前实时时间和播放位置之间的偏移量（如果可用）。
Player.getDuration返回当前直播窗口的长度。
Player.getCurrentPosition返回相对于直播窗口开始的播放位置。
Player.getCurrentMediaItem返回当前媒体项目，其中MediaItem.liveConfiguration包含应用提供的目标实时偏移量和实时偏移量调整参数的覆盖。
Player.getCurrentTimeline以Timeline的形式返回当前媒体结构。可以使用Player.getCurrentMediaItemIndex和Timeline.getWindow从Timeline中检索当前的Timeline.Window。在Window中
- Window.liveConfiguration包含目标实时偏移量和实时偏移量调整参数。这些值基于媒体中的信息以及在MediaItem.liveConfiguration中设置的任何应用提供的覆盖。
- Window.windowStartTimeMs是从 Unix 纪元开始的直播窗口开始的时间。
- Window.getCurrentUnixTimeMs是从 Unix 纪元开始的当前实时时间。此值可能会根据服务器和客户端之间已知的时钟差异进行校正。
- Window.getDefaultPositionMs是播放器默认情况下开始播放的直播窗口中的位置。

在直播流中进行跳转

您可以使用Player.seekTo跳转到直播窗口内的任意位置。传递的跳转位置相对于直播窗口的开始位置。例如，seekTo(0)将跳转到直播窗口的开头。跳转后，播放器将尝试保持与跳转位置相同的实时偏移量。

直播窗口还具有一个默认位置，播放应该从该位置开始。此位置通常位于直播边缘附近。您可以通过调用Player.seekToDefaultPosition跳转到默认位置。

直播播放 UI

ExoPlayer 的默认 UI 组件显示直播窗口的持续时间以及其中的当前播放位置。这意味着每次更新直播窗口时，位置似乎都会向后跳跃。如果您需要不同的行为，例如显示 Unix 时间或当前实时偏移量，您可以复制PlayerControlView并修改它以满足您的需求。

配置直播播放参数

ExoPlayer 使用一些参数来控制播放位置与直播边缘的偏移量，以及可以用来调整此偏移量的播放速度范围。

ExoPlayer 从三个位置获取这些参数的值，优先级从高到低（使用找到的第一个值）：

传递给MediaItem.Builder.setLiveConfiguration的每个MediaItem值。
在DefaultMediaSourceFactory上设置的全局默认值。
直接从媒体读取的值。

Kotlin

// Global settings.
val player =
  ExoPlayer.Builder(context)
    .setMediaSourceFactory(DefaultMediaSourceFactory(context).setLiveTargetOffsetMs(5000))
    .build()

// Per MediaItem settings.
val mediaItem =
  MediaItem.Builder()
    .setUri(mediaUri)
    .setLiveConfiguration(
      MediaItem.LiveConfiguration.Builder().setMaxPlaybackSpeed(1.02f).build()
    )
    .build()
player.setMediaItem(mediaItem)

Java

// Global settings.
ExoPlayer player =
    new ExoPlayer.Builder(context)
        .setMediaSourceFactory(
            new DefaultMediaSourceFactory(context).setLiveTargetOffsetMs(5000))
        .build();

// Per MediaItem settings.
MediaItem mediaItem =
    new MediaItem.Builder()
        .setUri(mediaUri)
        .setLiveConfiguration(
            new MediaItem.LiveConfiguration.Builder().setMaxPlaybackSpeed(1.02f).build())
        .build();
player.setMediaItem(mediaItem);

可用的配置值是：

targetOffsetMs：目标实时偏移量。如果可能，播放器将尝试在播放过程中接近此实时偏移量。
minOffsetMs：允许的最小实时偏移量。即使调整偏移量以适应当前网络状况，播放器在播放过程中也不会尝试低于此偏移量。
maxOffsetMs：允许的最大实时偏移量。即使调整偏移量以适应当前网络状况，播放器在播放过程中也不会尝试高于此偏移量。
minPlaybackSpeed：播放器在尝试达到目标实时偏移量时可以使用的最小回退播放速度。
maxPlaybackSpeed：播放器在尝试达到目标实时偏移量时可以使用的最大追赶播放速度。

播放速度调整

播放低延迟直播流时，ExoPlayer 通过稍微更改播放速度来调整实时偏移量。播放器将尝试匹配媒体或应用提供的目标实时偏移量，但也会尝试对变化的网络状况做出反应。例如，如果播放过程中出现重新缓冲，播放器将稍微降低播放速度以远离直播边缘。如果网络随后变得足够稳定以支持更接近直播边缘的播放，则播放器将加快播放速度以返回目标实时偏移量。

如果不需要自动播放速度调整，可以通过将minPlaybackSpeed和maxPlaybackSpeed属性设置为1.0f来禁用它。同样，可以通过将它们显式设置为1.0f以外的值来为非低延迟直播流启用它。有关如何设置这些属性的更多详细信息，请参阅上面的配置部分。

自定义播放速度调整算法

如果启用了速度调整，则LivePlaybackSpeedControl定义了要进行哪些调整。可以实现自定义LivePlaybackSpeedControl，或者自定义默认实现DefaultLivePlaybackSpeedControl。在这两种情况下，都可以在构建播放器时设置实例。

Kotlin

val player =
  ExoPlayer.Builder(context)
    .setLivePlaybackSpeedControl(
      DefaultLivePlaybackSpeedControl.Builder().setFallbackMaxPlaybackSpeed(1.04f).build()
    )
    .build()

Java

ExoPlayer player =
    new ExoPlayer.Builder(context)
        .setLivePlaybackSpeedControl(
            new DefaultLivePlaybackSpeedControl.Builder()
                .setFallbackMaxPlaybackSpeed(1.04f)
                .build())
        .build();

DefaultLivePlaybackSpeedControl的相关自定义参数是：

fallbackMinPlaybackSpeed和fallbackMaxPlaybackSpeed：如果媒体或应用提供的MediaItem未定义限制，则可以用于调整的最小和最大播放速度。
proportionalControlFactor：控制速度调整的平滑程度。较高的值使调整更加突然和反应迅速，但也更容易被听到。较小的值会导致速度之间过渡更加平滑，但代价是速度较慢。
targetLiveOffsetIncrementOnRebufferMs：每当发生重新缓冲时，都会将此值添加到目标实时偏移量中，以便更加谨慎地进行操作。可以通过将值设置为 0 来禁用此功能。
minPossibleLiveOffsetSmoothingFactor：用于根据当前缓冲的媒体跟踪最小可能实时偏移量的指数平滑因子。非常接近 1 的值意味着估计更加谨慎，可能需要更长时间才能适应改进的网络状况，而较低的值意味着估计将更快地调整，但有更高的风险遇到重新缓冲。

BehindLiveWindowException 和 ERROR_CODE_BEHIND_LIVE_WINDOW

播放位置可能会落后于直播窗口，例如，如果播放器暂停或缓冲时间足够长。如果发生这种情况，则播放将失败，并且错误代码为ERROR_CODE_BEHIND_LIVE_WINDOW的异常将通过Player.Listener.onPlayerError报告。应用程序代码可能希望通过在默认位置恢复播放来处理此类错误。演示应用程序的PlayerActivity举例说明了这种方法。

Kotlin

override fun onPlayerError(error: PlaybackException) {
  if (error.errorCode == PlaybackException.ERROR_CODE_BEHIND_LIVE_WINDOW) {
    // Re-initialize player at the live edge.
    player.seekToDefaultPosition()
    player.prepare()
  } else {
    // Handle other errors
  }
}

Java

@Override
public void onPlayerError(PlaybackException error) {
  if (error.errorCode == PlaybackException.ERROR_CODE_BEHIND_LIVE_WINDOW) {
    // Re-initialize player at the live edge.
    player.seekToDefaultPosition();
    player.prepare();
  } else {
    // Handle other errors
  }
}