RTSP,

ExoPlayer obsługuje RTSP na żywo i na żądanie. Poniżej znajdziesz listę obsługiwanych formatów i typów sieci.

Obsługiwane formaty próbek

  • H264 (opis mediów SDP musi zawierać dane SPS/PPS w atrybucie fmtp na potrzeby inicjowania dekodera).
  • AAC (z strumieniem bitów ADTS).
  • AC3.

Obsługiwane typy sieci

  • Transmisja pojedyncza RTP przez UDP (multicast nie jest obsługiwany).
  • Przeplatany RTSP, RTP przez RTSP przy użyciu TCP.

Korzystanie z MediaItem

Aby odtworzyć strumień RTSP, musisz polegać na module RTSP.

KotlinOdlotowe
implementation("androidx.media3:media3-exoplayer-rtsp:1.5.1")
 
implementation "androidx.media3:media3-exoplayer-rtsp:1.5.1"

Następnie możesz utworzyć MediaItem dla URI RTSP i przekazać go do odtwarzacza.

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

Uwierzytelnianie

ExoPlayer obsługuje odtwarzanie z uwierzytelnianiem RTSP BASIC i DIGEST. Aby można było odtwarzać chronione treści RTSP, identyfikator URI elementu MediaItem musi być skonfigurowany za pomocą danych uwierzytelniających. Identyfikator URI powinien mieć postać rtsp://<username>:<password>@<host address>.

Korzystanie z RtspMediaSource

Aby uzyskać więcej opcji dostosowywania, możesz utworzyć element RtspMediaSource i przekazać go bezpośrednio do odtwarzacza zamiast do MediaItem.

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

Używanie RTSP za NAT (obsługa RTP/TCP)

ExoPlayer używa protokołu UDP jako domyślnego protokołu do przesyłania RTP.

Podczas strumieniowego przesyłania danych RTSP za warstwę NAT serwer NAT może nie być w stanie przekazać przychodzących pakietów RTP/UDP do urządzenia. Dzieje się tak, gdy NAT nie ma wymaganego mapowania portów UDP. Jeśli ExoPlayer wykryje, że od jakiegoś czasu nie napływają pakiety RTP, a odtwarzanie jeszcze się nie rozpoczęło, ExoPlayer przerywa bieżącą sesję odtwarzania RTSP i próbuje ponownie odtworzyć materiał za pomocą RTP-over-RTSP (przesyłając pakiety RTP za pomocą połączenia TCP otwartego dla RTSP).

Czas oczekiwania na ponowne próby z TCP można dostosować, wywołując metodę RtspMediaSource.Factory.setTimeoutMs(). Jeśli na przykład ustawisz limit czasu na 4 sekundy, odtwarzacz spróbuje ponownie użyć protokołu TCP po 4 sekundach braku aktywności w przypadku protokołu UDP.

Ustawienie limitu czasu wpływa też na logikę wykrywania końca transmisji. Oznacza to, że ExoPlayer zgłosi, że odtwarzanie zostało zakończone, jeśli w czasie ustawionego limitu czasu nie zostanie odebrana żadna transmisja. Zbyt mała wartość może spowodować, że w słabych warunkach połączenia sieciowego sygnał dobiegnie końca.

RTP/TCP zapewnia lepszą kompatybilność w przypadku niektórych konfiguracji sieci. Możesz skonfigurować ExoPlayer tak, aby domyślnie używał RTP/TCP z RtspMediaSource.Factory.setForceUseRtpTcp().

Przekazywanie niestandardowego SocketFactory

Niestandardowe instancje SocketFactory mogą być przydatne, gdy wymagane jest określone kierowanie (np. gdy ruch RTSP musi przechodzić przez określony interfejs lub gdy gniazdo potrzebuje dodatkowych flag połączeń).

Domyślnie RtspMediaSource używa standardowej fabryki gniazd (SocketFactory.getDefault()) w języku Java do tworzenia połączeń z odległymi punktami końcowymi. To zachowanie można zastąpić za pomocą elementu RtspMediaSource.Factory.setSocketFactory().

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