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