RTSP

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

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

  • H264（SDP メディア記述には、デコーダの初期化用に fmtp 属性に SPS/PPS データが含まれている必要があります）。
  • AAC（ADTS ビットストリームあり）。
  • AC3。

サポートされているネットワーク タイプ

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

MediaItem の使用

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

Kotlin

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

Groovy

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

次に、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 を使用する

より多くのカスタマイズ オプションを使用するには、MediaItem ではなく RtspMediaSource を作成してプレーヤーに直接渡します。

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 は、RTP 転送のデフォルト プロトコルとして UDP を使用します。

NAT レイヤの背後で RTSP をストリーミングする場合、NAT が受信した RTP/UDP パケットをデバイスに転送できないことがあります。これは、NAT に必要な UDP ポート マッピングがない場合に発生します。ExoPlayer は、しばらくの間 RTP パケットを受信しておらず、再生がまだ開始されていないことを検出した場合、現在の 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() を使用してオーバーライドできます。

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