直播

ExoPlayer 可开箱即用地播放大多数自适应直播，无需任何特殊配置。如需了解详情，请参阅支持的格式页面。

自适应直播提供一个可用的媒体窗口，该窗口会定期更新，以适应当前的实时状态。这意味着播放位置始终位于此窗口中的某个位置，在大多数情况下，该位置接近于生成视频流的当前实时时间。当前实时时间和播放位置之间的差称为直播偏移量。

检测和监控实时播放

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

实时窗口

  • Player.isCurrentWindowLive 表示当前播放的媒体项是否为直播。即使直播已结束，此值仍为 true。
  • Player.isCurrentWindowDynamic 表示当前播放的媒体项是否仍在更新。对于尚未结束的直播，通常是这种情况。请注意，在某些情况下，此标志对于非直播视频也为 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 搜索到默认位置。

直播播放界面

ExoPlayer 的默认界面组件会显示直播窗口的时长以及当前播放位置。这意味着，每次更新直播窗口时，位置都会向后跳跃。如果您需要不同的行为，例如显示 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)
LiveStreaming.kt

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);
LiveStreaming.java

可用的配置值包括：

  • 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()
LiveStreaming.kt

Java

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

DefaultLivePlaybackSpeedControl 的相关自定义参数如下：

  • fallbackMinPlaybackSpeed 和 fallbackMaxPlaybackSpeed：如果媒体和应用提供的 MediaItem 均未定义限制，则可用于调整的最小和最大播放速度。
  • proportionalControlFactor：控制速度调整的平滑程度。值越高，调整越突然且反应越快，但越有可能被听到。值越小，速度之间的过渡越平滑，但速度会更慢。
  • targetLiveOffsetIncrementOnRebufferMs：每次发生重新缓冲时，此值都会添加到目标直播偏移量，以便更谨慎地继续播放。 将值设置为 0 即可停用此功能。
  • minPossibleLiveOffsetSmoothingFactor：一种指数平滑系数，用于根据当前缓冲的媒体内容跟踪可能的最小直播偏移量。值越接近 1，表示估计越谨慎，可能需要更长时间才能适应改善的网络状况；而值越低，表示估计会更快地调整，但出现重新缓冲的风险也更高。

BehindLiveWindowException 和 ERROR_CODE_BEHIND_LIVE_WINDOW

播放位置可能会落后于直播窗口，例如，如果播放器暂停或缓冲的时间足够长，就会出现这种情况。如果发生这种情况，播放将失败，并且会通过 Player.Listener.onPlayerError 报告错误代码为 ERROR_CODE_BEHIND_LIVE_WINDOW 的异常。应用代码可能希望通过在默认位置恢复播放来处理此类错误。演示版应用的 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
  }
}
LiveStreaming.kt

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
  }
}
LiveStreaming.java