RTSP

ExoPlayer admite RTSP en vivo y a pedido. A continuación, se indican los formatos de muestra y los tipos de redes compatibles.

Formatos de muestra admitidos

• H264 (la descripción de medios del SDP debe incluir datos SPS/PPS en el atributo fmtp para la inicialización del decodificador)
• AAC (con flujo de bits ADTS)
• AC3

Tipos de red compatibles

• RTP a través de unicast UDP (no se admite la multidifusión).
• RTSP, RTP intercalado en RTSP mediante TCP.

Cómo usar MediaItem

Para reproducir una transmisión RTSP, necesitas depender del módulo RTSP.

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

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

Luego, puedes crear un MediaItem para un URI de RTSP y pasarlo al reproductor.

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

Autenticación

ExoPlayer admite la reproducción con autenticación RTSP BASIC y DIGEST. Para reproducir contenido RTSP protegido, el URI de MediaItem debe configurarse con la información de autenticación. Específicamente, el URI debe tener el formato rtsp://<username>:<password>@<host address>.

Usa RtspMediaSource

Para obtener más opciones de personalización, puedes crear un RtspMediaSource y pasarlo directamente al reproductor, en lugar de un 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();

Usa RTSP detrás de una NAT (compatibilidad con RTP y TCP)

ExoPlayer usa UDP como protocolo predeterminado para el transporte de RTP.

Cuando se transmite RTSP detrás de una capa de NAT, es posible que la NAT no pueda reenviar los paquetes RTP/UDP entrantes al dispositivo. Esto ocurre si la NAT no tiene la asignación de puertos UDP necesaria. Si ExoPlayer detecta que no hubo paquetes RTP entrantes durante un tiempo y la reproducción aún no se inició, ExoPlayer quita la sesión de reproducción de RTSP actual y vuelve a intentar la reproducción usando RTP-over-RTSP (la transmisión de paquetes RTP mediante la conexión TCP abierta para RTSP).

El tiempo de espera para los reintentos con TCP se puede personalizar mediante una llamada al método RtspMediaSource.Factory.setTimeoutMs(). Por ejemplo, si el tiempo de espera se configura en cuatro segundos, el jugador volverá a intentar con TCP después de cuatro segundos de inactividad de UDP.

Configurar el tiempo de espera también afecta la lógica de detección del final de la transmisión. Es decir, ExoPlayer informará que finalizó la reproducción si no se recibe nada durante el tiempo de espera establecido. Establecer este valor demasiado bajo puede generar una señal de fin de transmisión temprana en condiciones de red deficientes.

RTP/TCP ofrece mejor compatibilidad con algunas configuraciones de red. Puedes configurar ExoPlayer para usar RTP/TCP de forma predeterminada con RtspMediaSource.Factory.setForceUseRtpTcp().

Pasa una SocketFactory personalizada

Las instancias SocketFactory personalizadas pueden ser útiles cuando se requiere un enrutamiento particular (por ejemplo, cuando el tráfico RTSP necesita pasar una interfaz específica o el socket necesita marcas de conectividad adicionales).

De forma predeterminada, RtspMediaSource usará la fábrica de sockets estándar de Java (SocketFactory.getDefault()) para crear conexiones a los extremos remotos. Este comportamiento se puede anular con 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));