RTSP.

O ExoPlayer oferece suporte a RTSP ao vivo e sob demanda. Formatos de amostra e tipos de rede estão listados abaixo.

Formatos de amostra compatíveis

  • H264 (a descrição de mídia SDP deve incluir dados SPS/PPS no fmtp atributo para inicialização do decodificador).
  • AAC (com bitstream ADTS).
  • AC3.
.

Tipos de rede compatíveis

  • RTP sobre unicast UDP (multicast não é compatível).
  • RTSP intercalado, RTP sobre RTSP usando TCP.

Como usar o MediaItem

Para reproduzir um stream RTSP, você precisa depender do módulo RTSP.

Kotlin

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

Groovy

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

Em seguida, você pode criar um MediaItem para um URI do RTSP e passá-lo para o jogador.

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

Autenticação

O ExoPlayer oferece suporte à reprodução com autenticação RTSP BASIC e DIGEST. Para jogar conteúdo RTSP protegido, o URI do MediaItem deve ser configurado com o informações de autenticação. Especificamente, o URI deve estar no formato rtsp://<username>:<password>@<host address>.

Como usar RtspMediaSource

Para mais opções de personalização, você pode criar um RtspMediaSource e transmiti-lo diretamente ao player em vez de um MediaItem.

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

Usar o RTSP atrás de um NAT (suporte a RTP/TCP)

O ExoPlayer usa o UDP como protocolo padrão para o transporte RTP.

Ao transmitir RTSP atrás de uma camada NAT, o NAT pode não conseguir encaminhar o pacotes RTP/UDP de entrada para o dispositivo. Isso ocorre se o NAT não tiver a o mapeamento de porta UDP necessário. Se o ExoPlayer detectar que não houve entrada Pacotes RTP por um tempo e a reprodução ainda não começou, rupturas do ExoPlayer a sessão de reprodução RTSP atual e tenta a reprodução usando RTP sobre RTSP (transmitindo pacotes RTP usando a conexão TCP aberta para RTSP).

O tempo limite para novas tentativas com TCP pode ser personalizado chamando o método RtspMediaSource.Factory.setTimeoutMs(): Por exemplo, se o tempo limite estiver definido como quatro segundos, o player tentará novamente com TCP após quatro segundos de UDP inatividade.

A definição do tempo limite também afeta a lógica de detecção de fim de stream. Ou seja, O ExoPlayer informará que a reprodução terminou se nada for recebido para o do tempo limite definido. Definir um valor muito baixo pode gerar uma de fim de transmissão em condições de rede ruins.

O RTP/TCP oferece melhor compatibilidade em algumas configurações de rede. É possível configurar ExoPlayer para usar RTP/TCP por padrão com RtspMediaSource.Factory.setForceUseRtpTcp():

Como transmitir um SocketFactory personalizado

Instâncias SocketFactory personalizadas podem ser úteis quando um roteamento específico é necessário (por exemplo, quando o tráfego RTSP precisa passar por uma interface específica, ou o socket precisa de sinalizações de conectividade adicionais).

Por padrão, RtspMediaSource usará a fábrica de soquete padrão do Java. (SocketFactory.getDefault()) para criar conexões com os endpoints remotos. Esse comportamento pode ser substituído usando 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));