RTSP

ExoPlayer 支持实时和按需 RTSP。支持的样本格式和网络类型列出如下。

支持的样本格式

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

支持的网络类型

• RTP 通过 UDP 单播（不支持多播）。
• 交织 RTSP，通过 TCP 使用 RTSP 上的 RTP。

使用 MediaItem

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

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

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

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

// 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()

// 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。

// 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()

// 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 数据包）重新播放。

可以通过调用方法 RtspMediaSource.Factory.setTimeoutMs() 自定义使用 TCP 重试的超时时间。例如，如果将超时时间设置为 4 秒，播放器将在 UDP 不活动 4 秒后尝试使用 TCP。

设置超时时间也会影响流结束检测逻辑。也就是说，如果在设置的超时时间内未收到任何数据，ExoPlayer 会报告播放已结束。如果在网络状况不佳的情况下将此值设置得太小，可能会导致过早的流结束信号。

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

传递自定义 SocketFactory

当需要特定路由时，自定义 SocketFactory 实例很有用（例如，当 RTSP 流量需要通过特定接口或套接字需要额外的连接标志时）。

默认情况下，RtspMediaSource 会使用 Java 的标准套接字工厂 (SocketFactory.getDefault()) 来创建与远程端点的连接。可以使用 RtspMediaSource.Factory.setSocketFactory() 覆盖此行为。

// 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))

// 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));