RTSP

ExoPlayer mendukung RTSP live dan on demand. Contoh format dan jenis jaringan yang didukung tercantum di bawah ini.

Contoh format yang didukung

• H264 (deskripsi media SDP harus menyertakan data SPS/PPS dalam atribut fmt'>{}</p untuk inisialisasi decoder).
• AAC (dengan bitstream ADTS).
• AC3.

Jenis jaringan yang didukung

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

Menggunakan MediaItem

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

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

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

Anda kemudian 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 belakang 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 porta UDP yang diperlukan. Jika ExoPlayer mendeteksi belum ada paket RTP masuk untuk sementara waktu dan pemutaran belum dimulai, ExoPlayer akan merusak sesi pemutaran RTSP saat ini, dan mencoba kembali pemutaran menggunakan RTP-over-RTSP (mengirimkan paket RTP menggunakan koneksi TCP yang dibuka untuk RTSP).

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

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

RTP/TCP menawarkan kompatibilitas yang lebih baik dalam beberapa pengaturan 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, ketika 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));