RTSP

ExoPlayer est compatible avec RTSP en direct et à la demande. Vous trouverez ci-dessous des exemples de formats et de types de réseaux compatibles.

Exemples de formats acceptés

• H264 (la description multimédia SDP doit inclure des données SPS/PPS dans l'attribut fmtp pour l'initialisation du décodeur).
• AAC (avec flux de bits ADTS)
• AC3.

Types de réseaux compatibles

• RTP sur UDP unicast (le multicast n'est pas pris en charge).
• RTSP entrelacé, RTP sur RTSP via TCP.

Utiliser MediaItem

Pour lire un flux RTSP, vous devez dépendre du module RTSP.

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

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

Vous pouvez ensuite créer un MediaItem pour un URI RTSP et le transmettre au lecteur.

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

Authentification

ExoPlayer est compatible avec la lecture avec authentification RTSP BASIC et DIGEST. Pour lire du contenu RTSP protégé, l'URI de MediaItem doit être configuré avec les informations d'authentification. Plus précisément, l'URI doit être au format rtsp://<username>:<password>@<host address>.

Utiliser RtspMediaSource

Pour plus d'options de personnalisation, vous pouvez créer un RtspMediaSource et le transmettre directement au lecteur au lieu d'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();

Utiliser RTSP derrière un NAT (prise en charge de RTP/TCP)

ExoPlayer utilise UDP comme protocole par défaut pour le transport RTP.

Lors du streaming RTSP derrière une couche NAT, le NAT peut ne pas être en mesure de transférer les paquets RTP/UDP entrants vers l'appareil. Cela se produit si le NAT ne dispose pas du mappage de port UDP nécessaire. Si ExoPlayer détecte qu'il n'y a pas eu de paquets RTP entrants depuis un certain temps et que la lecture n'a pas encore commencé, il arrête la session de lecture RTSP en cours et réessaie la lecture à l'aide de RTP sur RTSP (transmission de paquets RTP à l'aide de la connexion TCP ouverte pour RTSP).

Le délai avant expiration de la nouvelle tentative avec TCP peut être personnalisé en appelant la méthode RtspMediaSource.Factory.setTimeoutMs(). Par exemple, si le délai avant expiration est défini sur quatre secondes, le joueur réessayera avec TCP au bout de quatre secondes d'inactivité UDP.

Le délai d'inactivité affecte également la logique de détection de la fin de flux. Autrement dit, ExoPlayer indiquera que la lecture est terminée si rien n'est reçu pendant la durée du délai avant expiration défini. Si vous définissez cette valeur trop faible, un signal de fin de flux peut être envoyé trop tôt en cas de mauvaises conditions réseau.

RTP/TCP offre une meilleure compatibilité dans certaines configurations réseau. Vous pouvez configurer ExoPlayer pour qu'il utilise RTP/TCP par défaut avec RtspMediaSource.Factory.setForceUseRtpTcp().

Transmettre un SocketFactory personnalisé

Les instances SocketFactory personnalisées peuvent être utiles lorsqu'un routage particulier est requis (par exemple, lorsque le trafic RTSP doit passer par une interface spécifique ou que le socket a besoin d'indicateurs de connectivité supplémentaires).

Par défaut, RtspMediaSource utilise la fabrique de sockets standard de Java (SocketFactory.getDefault()) pour créer des connexions aux points de terminaison distants. Ce comportement peut être remplacé à l'aide de 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));