ExoPlayer est compatible avec SmoothStreaming au format de conteneur FMP4. Flux multimédias doivent être démuxés, c'est-à-dire que la vidéo, l'audio et le texte doivent être définis dans des Éléments StreamIndex dans le fichier manifeste SmoothStreaming. Le contenu audio et formats d'échantillon vidéo doivent également être acceptés (consultez les exemples de formats).
Fonctionnalité | Compatible | Commentaires |
---|---|---|
Conteneurs | ||
FMP4 | OUI | Flux démultiplexés uniquement |
Sous-titres | ||
TML | OUI | Intégré à FMP4 |
Protection du contenu | ||
PlayReady SL2000 | OUI | Android TV uniquement |
Lecture en direct | ||
Lecture en direct régulière | OUI | |
Common Media Client Data (CMCD) | OUI | Guide d'intégration |
Utilisation de MediaItem
Pour lire un flux SmoothStreaming, vous devez dépendre du mode SmoothStreaming. de ce module.
Kotlin
implementation("androidx.media3:media3-exoplayer-smoothstreaming:1.4.1")
Groovy
implementation "androidx.media3:media3-exoplayer-smoothstreaming:1.4.1"
Vous pouvez ensuite créer un MediaItem
pour un URI de fichier manifeste SmoothStreaming 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(ssUri)) // 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(ssUri)); // Prepare the player. player.prepare();
Si votre URI ne se termine pas par .ism/Manifest
, vous pouvez transmettre
MimeTypes.APPLICATION_SS
à setMimeType
sur MediaItem.Builder
pour indiquer explicitement
indiquer le type de contenu.
ExoPlayer s'adapte automatiquement entre les représentations définies dans le en tenant compte à la fois de la bande passante disponible et des capacités de l'appareil.
Utiliser SsMediaSource
Pour plus d'options de personnalisation, vous pouvez créer un SsMediaSource
et le transmettre
directement au lecteur au lieu d'une MediaItem
.
Kotlin
// Create a data source factory. val dataSourceFactory: DataSource.Factory = DefaultHttpDataSource.Factory() // Create a SmoothStreaming media source pointing to a manifest uri. val mediaSource: MediaSource = SsMediaSource.Factory(dataSourceFactory).createMediaSource(MediaItem.fromUri(ssUri)) // 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 a data source factory. DataSource.Factory dataSourceFactory = new DefaultHttpDataSource.Factory(); // Create a SmoothStreaming media source pointing to a manifest uri. MediaSource mediaSource = new SsMediaSource.Factory(dataSourceFactory).createMediaSource(MediaItem.fromUri(ssUri)); // 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();
Accéder au fichier manifeste
Vous pouvez récupérer le fichier manifeste actuel en appelant Player.getCurrentManifest
.
Pour SmoothStreaming, vous devez caster l'objet renvoyé sur SsManifest
. La
Le rappel onTimelineChanged
de Player.Listener
est également appelé chaque fois
le fichier manifeste est chargé. Cela se produira une fois pour
les contenus à la demande et
peut-être plusieurs fois
pour le contenu en direct. L'extrait de code suivant montre comment une application
peut faire quelque chose
dès que le fichier manifeste est chargé.
Kotlin
player.addListener( object : Player.Listener { override fun onTimelineChanged(timeline: Timeline, @TimelineChangeReason reason: Int) { val manifest = player.currentManifest if (manifest is SsManifest) { // Do something with the manifest. } } } )
Java
player.addListener( new Player.Listener() { @Override public void onTimelineChanged( Timeline timeline, @Player.TimelineChangeReason int reason) { Object manifest = player.getCurrentManifest(); if (manifest != null) { SsManifest ssManifest = (SsManifest) manifest; // Do something with the manifest. } } });
Personnaliser la lecture
ExoPlayer vous propose plusieurs façons d'adapter l'expérience de lecture à votre besoins de votre application. Consultez la page Personnalisation pour obtenir des exemples.