RTSP

ExoPlayer 支持直播和点播 RTSP。下面列出了支持的示例格式和网络类型。

支持的示例格式

  • H264(SDP 媒体说明必须在 fmtp 属性中包含 SPS/PPS 数据以进行解码器初始化)。
  • AAC(使用 ADTS 比特流)。
  • AC3。

支持的网络类型

  • 基于 UDP 单播的 RTP(不支持多播)。
  • 交错 RTSP,即使用 TCP 基于 RTSP 的 RTP。

使用 MediaItem

要播放 RTSP 流,您需要依赖于 RTSP 模块。

Kotlin

implementation("androidx.media3:media3-exoplayer-rtsp:1.3.0")

Groovy

implementation "androidx.media3:media3-exoplayer-rtsp:1.3.0"

然后,您可以为 RTSP URI 创建 MediaItem,并将其传递给播放器。

Kotlin

// Create a player instance.
val player = ExoPlayer.Builder(context).build()
// Set the media item to be played.
player.setMediaItem(MediaItem.fromUri(rtspUri))
// Prepare the player.
player.prepare()

Java

// Create a player instance.
ExoPlayer player = new ExoPlayer.Builder(context).build();
// Set the media item to be played.
player.setMediaItem(MediaItem.fromUri(rtspUri));
// Prepare the player.
player.prepare();

身份验证

ExoPlayer 支持通过 RTSP BASIC 和 DIGEST 身份验证进行播放。如需播放受保护的 RTSP 内容,必须使用身份验证信息配置 MediaItem 的 URI。具体而言,该 URI 应采用 rtsp://<username>:<password>@<host address> 格式。

使用 RtspMediaSource

如需使用更多自定义选项,您可以创建 RtspMediaSource 并将其直接传递给播放器,而不是 MediaItem

Kotlin

// Create an RTSP media source pointing to an RTSP uri.
val mediaSource: MediaSource =
RtspMediaSource.Factory().createMediaSource(MediaItem.fromUri(rtspUri))
// Create a player instance.
val player = ExoPlayer.Builder(context).build()
// Set the media source to be played.
player.setMediaSource(mediaSource)
// Prepare the player.
player.prepare()

Java

// Create an RTSP media source pointing to an RTSP uri.
MediaSource mediaSource =
    new RtspMediaSource.Factory().createMediaSource(MediaItem.fromUri(rtspUri));
// Create a player instance.
ExoPlayer player = new ExoPlayer.Builder(context).build();
// Set the media source to be played.
player.setMediaSource(mediaSource);
// Prepare the player.
player.prepare();

在 NAT 后面使用 RTSP(支持 RTP/TCP)

ExoPlayer 使用 UDP 作为 RTP 传输的默认协议。

在 NAT 层后流式传输 RTSP 时,NAT 可能无法将传入的 RTP/UDP 数据包转发到设备。如果 NAT 缺少必要的 UDP 端口映射,则会发生这种情况。如果 ExoPlayer 检测到有一段时间没有传入的 RTP 数据包,并且播放尚未开始,ExoPlayer 会删除当前的 RTSP 播放会话,然后使用 RTP-over-RTSP(使用为 RTSP 打开的 TCP 连接传输 RTP 数据包)重试播放。

使用 TCP 重试的超时可通过调用 RtspMediaSource.Factory.setTimeoutMs() 方法来自定义。例如,如果超时设置为 4 秒,玩家将在 UDP 处于非活动状态 4 秒后使用 TCP 重试。

设置超时还会影响视频流结束检测逻辑。也就是说,如果在设置的超时时间内未收到任何数据,ExoPlayer 会报告播放已结束。如果将此值设置得太小,则可能会导致在网络条件不佳的情况下,出现流式传输提前结束信号。

在某些网络设置中,RTP/TCP 可以提供更好的兼容性。您可以通过 RtspMediaSource.Factory.setForceUseRtpTcp() 配置 ExoPlayer 以默认使用 RTP/TCP。

传递自定义 SocketFactory

当需要特定路由时(例如,当 RTSP 流量需要传递特定接口,或者套接字需要额外的连接标志时),自定义 SocketFactory 实例会非常有用。

默认情况下,RtspMediaSource 将使用 Java 的标准套接字工厂 (SocketFactory.getDefault()) 创建与远程端点的连接。可使用 RtspMediaSource.Factory.setSocketFactory() 替换此行为。

Kotlin

// Create an RTSP media source pointing to an RTSP uri and override the socket
// factory.
val mediaSource: MediaSource =
RtspMediaSource.Factory()
    .setSocketFactory(...)
    .createMediaSource(MediaItem.fromUri(rtspUri))

Java

// Create an RTSP media source pointing to an RTSP uri and override the socket
// factory.
MediaSource mediaSource =
    new RtspMediaSource.Factory()
        .setSocketFactory(...)
        .createMediaSource(MediaItem.fromUri(rtspUri));