RTSP

ExoPlayer mendukung RTSP live dan on demand. Format contoh dan jenis jaringan yang didukung tercantum di bawah.

Format contoh yang didukung

• H264 (deskripsi media SDP harus menyertakan data SPS/PPS dalam atribut fmtp untuk inisialisasi dekoder).
• AAC (dengan bitstream ADTS).
• AC3.

Jenis jaringan yang didukung

• RTP melalui unicast UDP (multicast tidak didukung).
• RTSP yang diselingi, RTP melalui RTSP menggunakan TCP.

Menggunakan MediaItem

Untuk memutar streaming RTSP, Anda harus bergantung pada modul RTSP.

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

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

Kemudian, Anda dapat membuat MediaItem untuk URI RTSP dan meneruskannya ke pemutar.

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

Autentikasi

ExoPlayer mendukung pemutaran dengan autentikasi RTSP BASIC dan DIGEST. Untuk memutar konten RTSP yang dilindungi, URI MediaItem harus dikonfigurasi dengan info autentikasi. Secara khusus, URI harus dalam bentuk rtsp://<username>:<password>@<host address>.

Menggunakan RtspMediaSource

Untuk opsi penyesuaian lainnya, Anda dapat membuat RtspMediaSource dan meneruskannya langsung ke pemutar, bukan 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();

Menggunakan RTSP di balik NAT (dukungan RTP/TCP)

ExoPlayer menggunakan UDP sebagai protokol default untuk transpor RTP.

Saat melakukan streaming RTSP di belakang lapisan NAT, NAT mungkin tidak dapat meneruskan paket RTP/UDP yang masuk ke perangkat. Hal ini terjadi jika NAT tidak memiliki pemetaan port UDP yang diperlukan. Jika ExoPlayer mendeteksi bahwa tidak ada paket RTP yang masuk selama beberapa waktu dan pemutaran belum dimulai, ExoPlayer akan menghentikan sesi pemutaran RTSP saat ini, dan mencoba lagi pemutaran menggunakan RTP-over-RTSP (mengirim paket RTP menggunakan koneksi TCP yang dibuka untuk RTSP).

Waktu tunggu untuk mencoba lagi dengan TCP dapat disesuaikan dengan memanggil metode RtspMediaSource.Factory.setTimeoutMs(). Misalnya, jika waktu tunggu disetel ke empat detik, pemutar akan mencoba lagi dengan TCP setelah empat detik UDP tidak aktif.

Menyetel waktu tunggu juga memengaruhi logika deteksi akhir streaming. Artinya, ExoPlayer akan melaporkan bahwa pemutaran telah berakhir jika tidak ada yang diterima selama durasi waktu tunggu yang ditetapkan. Menetapkan nilai ini terlalu kecil dapat menyebabkan sinyal akhir streaming yang terlalu awal dalam kondisi jaringan yang buruk.

RTP/TCP menawarkan kompatibilitas yang lebih baik dalam beberapa penyiapan jaringan. Anda dapat mengonfigurasi ExoPlayer untuk menggunakan RTP/TCP secara default dengan RtspMediaSource.Factory.setForceUseRtpTcp().

Meneruskan SocketFactory kustom

Instance SocketFactory kustom dapat berguna saat perutean tertentu diperlukan (misalnya, saat traffic RTSP perlu meneruskan antarmuka tertentu, atau soket memerlukan flag konektivitas tambahan).

Secara default, RtspMediaSource akan menggunakan factory soket standar Java (SocketFactory.getDefault()) untuk membuat koneksi ke endpoint jarak jauh. Perilaku ini dapat diganti menggunakan 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));