Cette page a été traduite par l'API Cloud Translation.

RTSP

ExoPlayer est compatible avec RTSP en direct et à la demande. Les formats d'exemple et les types de réseaux compatibles sont listés ci-dessous.

Exemples de formats compatibles

H264 (la description du contenu 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

Unicast RTP sur UDP (la multidiffusion n'est pas prise en charge).
Entrelacement RTSP, RTP sur RTSP via TCP

Utilisation de MediaItem

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

Kotlin

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

Groovy

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

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

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

Authentification

ExoPlayer prend en charge la lecture avec l'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 se présenter 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.

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

Utiliser RTSP derrière un NAT (compatible avec RTP/TCP)

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

Lors de la diffusion de RTSP derrière une couche NAT, il est possible que la NAT ne puisse pas transférer les paquets RTP/UDP entrants à l'appareil. Cela se produit si la 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é, ExoPlayer interrompt la session de lecture RTSP en cours et relance la lecture à l'aide du protocole RTP-over-RTSP (transmission de paquets RTP via la connexion TCP ouverte pour RTSP).

Vous pouvez personnaliser le délai avant expiration des nouvelles tentatives avec TCP en appelant la méthode RtspMediaSource.Factory.setTimeoutMs(). Par exemple, si le délai avant expiration est défini sur quatre secondes, le joueur effectue une nouvelle tentative avec TCP après quatre secondes d'inactivité UDP.

Le délai avant expiration affecte également la logique de détection de fin de diffusion. Autrement dit, ExoPlayer indique que la lecture est terminée si rien n'est reçu pendant la durée du délai avant expiration défini. Si cette valeur est trop faible, le signal de fin de flux risque d'être émis au début dans des conditions de réseau mauvaises.

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

Transmettre une SocketFactory personnalisée

Les instances SocketFactory personnalisées peuvent être utiles lorsqu'un routage particulier est requis (par exemple, lorsque le trafic RTSP doit transmettre une interface spécifique ou que le socket nécessite des 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 ignoré à l'aide de 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));