RTSP

ExoPlayer は、ライブとオンデマンドの両方の RTSP をサポートしています。サポートされているサンプル形式とネットワーク タイプを以下に示します。

サポートされているサンプル形式

• H264（SDP メディアの説明では、デコーダを初期化するには fmtp 属性に SPS/PPS データを含める必要があります）。
• AAC（ADTS ビットストリームを使用）。
• AC3.

サポートされているネットワークの種類

• RTP over UDP ユニキャスト（マルチキャストはサポートされていません）。
• Interleaved RTSP、RTP over RTSP（TCP を使用）。

MediaItem の使用

RTSP ストリームを再生するには、RTSP モジュールに依存する必要があります。

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

implementation "androidx.media3:media3-exoplayer-rtsp:1.3.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 は、RTP トランスポートのデフォルト プロトコルとして UDP を使用します。

NAT レイヤの背後に RTSP をストリーミングする場合、NAT が受信 RTP/UDP パケットをデバイスに転送できないことがあります。これは、NAT に必要な UDP ポート マッピングがない場合に発生します。しばらくの間 RTP パケットを受信しておらず、再生がまだ開始されていない場合、ExoPlayer は現在の RTSP 再生セッションを破棄し、RTP-over-RTSP（RTSP 用に開いた TCP 接続を使用して RTP パケットを送信）を使用して再生を再試行します。

TCP で再試行する際のタイムアウトは、メソッド RtspMediaSource.Factory.setTimeoutMs() を呼び出すことでカスタマイズできます。たとえば、タイムアウトが 4 秒に設定されている場合、プレーヤーは UDP が 4 秒間非アクティブになると TCP で再試行します。

タイムアウトを設定すると、配信終了の検出ロジックにも影響します。つまり、設定されているタイムアウトの間に何も受信されない場合、ExoPlayer は再生が終了したと報告します。この値が小さすぎると、ネットワーク状況が不安定な場合、早期のストリーミング終了信号が発生する可能性があります。

RTP/TCP は、一部のネットワーク設定で優れた互換性を提供します。RtspMediaSource.Factory.setForceUseRtpTcp() で、デフォルトで RTP/TCP を使用するように ExoPlayer を構成できます。

カスタムの 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));