Bilder

ExoPlayer unterstützt die folgenden Bildformate. Unter Bibliotheken zum Laden von Bildern erfahren Sie, wie Sie externe Bibliotheken einbinden, die möglicherweise Unterstützung für andere Formate bieten.

Bildformat Unterstützt Hinweise
BMP JA
GIF NEIN Keine Unterstützung für Extractor
JPEG JA
JPEG-Bewegungsfoto JA Unterstützung von Standbildern und Videos
JPEG Ultra HDR JA Fällt vor Android 14 oder auf Nicht-HDR-Displays auf SDR zurück
PNG JA
WebP JA
HEIF/HEIC JA
HEIC-Foto mit Bewegtbild Teilweise Nur Standbilder werden unterstützt*
AVIF (Baseline) JA Nur auf Geräten mit Android 14 oder höher decodiert

* Der Videoteil von HEIC-Fotos mit Bewegtbild kann mit MetadataRetriever abgerufen und als eigenständige Datei wiedergegeben werden.

MediaItem verwenden

Wenn Sie ein Bild als Teil einer Playlist abspielen möchten, erstellen Sie ein MediaItem mit dem Bild-URI und übergeben Sie es an den Player. Für die MediaItem muss ein imageDurationMs angegeben werden, um festzulegen, wie lange das Bild angezeigt werden soll.

Kotlin

// Create a player instance.
val player = ExoPlayer.Builder(context).build()
// Set the media item to be played with the desired duration.
player.setMediaItem(
    MediaItem.Builder().setUri(imageUri).setImageDurationMs(2000).build())
// Prepare the player.
player.prepare()

Java

// Create a player instance.
ExoPlayer player = new ExoPlayer.Builder(context).build();
// Set the media item to be played with the desired duration.
player.setMediaItem(
    new MediaItem.Builder().setUri(imageUri).setImageDurationMs(2000).build());
// Prepare the player.
player.prepare();

Fotos mit Bewegtbild

Fotos mit Bewegtbild sind Dateien, die ein Standbild mit einem kurzen Video kombinieren.

  • Wenn die Bilddauer mit setImageDuration definiert ist, wird das Foto mit Bewegtbild für die angegebene Dauer als Standbild angezeigt.
  • Wenn die Bilddauer nicht definiert ist, wird das Bewegtbild als Video wiedergegeben.

ProgressiveMediaSource verwenden

Wenn Sie mehr Anpassungsoptionen benötigen, können Sie ein ProgressiveMediaSource erstellen und es anstelle eines MediaItem direkt an den Player übergeben.

Kotlin

// Create a data source factory.
val dataSourceFactory = DefaultHttpDataSource.Factory()
// Create a media item with the image URI and the desired duration.
val mediaItem =
    MediaItem.Builder().setUri(imageUri).setImageDurationMs(2000).build()
// Create a progressive media source for this media item.
val mediaSource =
    ProgressiveMediaSource.Factory(dataSourceFactory)
        .createMediaSource(mediaItem)
// 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 media item with the image URI and the desired duration.
MediaItem mediaItem =
    new MediaItem.Builder().setUri(imageUri).setImageDurationMs(2000).build();
// Create a progressive media source for this media item.
MediaSource mediaSource =
    new ProgressiveMediaSource.Factory(dataSourceFactory)
        .createMediaSource(mediaItem);
// 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();

Wiedergabe anpassen

ExoPlayer bietet mehrere Möglichkeiten, die Wiedergabe an die Anforderungen Ihrer App anzupassen. Beispiele finden Sie auf der Seite „Anpassung“.

Bibliotheken zum Laden von Bildern

Bilder werden häufig von externen Bildladebibliotheken wie Glide oder Coil verwaltet.

Die Integration dieser Bibliotheken in die Wiedergabepipeline umfasst drei Schritte:

  1. Definieren Sie ein MediaItem mit dem MIME-Typ APPLICATION_EXTERNALLY_LOADED_IMAGE.
  2. Stellen Sie einen Bilddecoder bereit, um ein Bitmap aus der Bibliothek zum Laden von Bildern abzurufen.
  3. Stellen Sie ein externes Ladeprogramm bereit, um das Caching und Vorladen auszulösen.

MediaItem mit extern geladenem Bild-MIME-Typ

Im MediaItem, das dem Player hinzugefügt wird, muss der MIME-Typ APPLICATION_EXTERNALLY_LOADED_IMAGE explizit definiert werden, damit die Code-Pfade der Bibliothek zum Laden von Bildern verwendet werden können:

Kotlin

val mediaItem =
  MediaItem.Builder()
    .setUri(imageUri)
    .setMimeType(MimeTypes.APPLICATION_EXTERNALLY_LOADED_IMAGE)
    .build()

Java

MediaItem mediaItem =
    new MediaItem.Builder()
        .setUri(imageUri)
        .setMimeType(MimeTypes.APPLICATION_EXTERNALLY_LOADED_IMAGE)
        .build();

Bilddecoder mit einer Bibliothek zum Laden von Bildern

Der Bild-Renderer benötigt eine ExternallyLoadedImageDecoder, um die Bitmap aus der Uri abzurufen. Dieser Decoder kann durch Überschreiben von DefaultRenderersFactory.getImageDecoderFactory bereitgestellt werden.

Im folgenden Beispiel wird mit Glide ein Bild geladen und die Ausgabe auf die Displaygröße beschränkt, um die Erstellung sehr großer Bitmap-Objekte zu vermeiden:

Kotlin

val glideImageDecoderFactory: ImageDecoder.Factory =
  ExternallyLoadedImageDecoder.Factory { request: ExternalImageRequest ->
    val displaySize = Util.getCurrentDisplayModeSize(context)
    GlideFutures.submit(
      Glide.with(context)
        .asBitmap()
        .load(request.uri)
        .override(max(displaySize.x, displaySize.y)))
  }
val player: Player =
  ExoPlayer.Builder(context)
    .setRenderersFactory(
      object : DefaultRenderersFactory(context) {
        override fun getImageDecoderFactory(context: Context): ImageDecoder.Factory {
          return glideImageDecoderFactory
        }
      }
    )
    .build()

Java

ImageDecoder.Factory glideImageDecoderFactory =
    new ExternallyLoadedImageDecoder.Factory(
        request -> {
          Point displaySize = Util.getCurrentDisplayModeSize(context);
          return GlideFutures.submit(
            Glide.with(context)
                .asBitmap()
                .load(request.uri)
                .override(max(displaySize.x, displaySize.y)));
            });
Player player =
    new ExoPlayer.Builder(context)
        .setRenderersFactory(
            new DefaultRenderersFactory(context) {
              @Override
              protected ImageDecoder.Factory getImageDecoderFactory(Context context) {
                return glideImageDecoderFactory;
              }
            })
        .build();

Bilder mit einer Bibliothek zum Laden von Bildern vorab laden

Während der Wiedergabe fordert der Player an, das nächste Bild vorzuladen, sobald das vorherige Element in der Playlist vollständig geladen wurde. Wenn Sie eine externe Bibliothek zum Laden von Bildern verwenden, müssen Sie ein ExternalLoader angeben, um das Vorabladen auszulösen. Wenn kein Preloading möglich oder erforderlich ist, muss dieser Loader trotzdem bereitgestellt werden, kann aber nichts tun.

Im folgenden Beispiel wird Glide verwendet, um sicherzustellen, dass das angeforderte Bild auf die Festplatte vorgeladen wird:

Kotlin

val glidePreloader = ExternalLoader { request: LoadRequest ->
  GlideFutures.submit(
    Glide.with(context)
      .asFile()
      .apply(
        RequestOptions.diskCacheStrategyOf(DiskCacheStrategy.DATA)
          .priority(Priority.HIGH)
          .skipMemoryCache(true)
      )
      .load(request.uri)
  )
}
val player =
    ExoPlayer.Builder(context)
      .setMediaSourceFactory(DefaultMediaSourceFactory(context)
        .setExternalImageLoader(glidePreloader))
      .build()

Java

ExternalLoader glidePreloader =
    request ->
        GlideFutures.submit(
            Glide.with(context)
                .asFile()
                .apply(
                    diskCacheStrategyOf(DiskCacheStrategy.DATA)
                        .priority(Priority.HIGH)
                        .skipMemoryCache(true))
                .load(request.uri));
Player player =
    new ExoPlayer.Builder(context)
        .setMediaSourceFactory(new DefaultMediaSourceFactory(context)
            .setExternalImageLoader(glidePreloader))
        .build();