الصور

يتيح ExoPlayer تنسيقات الصور التالية. يمكنك الاطّلاع على مكتبات تحميل الصور لمعرفة كيفية الدمج مع المكتبات الخارجية التي قد توفّر إمكانية استخدام مجموعة مختلفة من التنسيقات.

تنسيق الصورة متاح ملاحظات
BMP نعم
GIF لا لا يتوفّر دعم لأداة الاستخراج
JPEG نعم
صورة حيّة بتنسيق JPEG نعم تتوفّر إمكانية التقاط الصور الثابتة والفيديوهات
JPEG Ultra HDR نعم يتم الرجوع إلى النطاق العادي الديناميكية (SDR) قبل الإصدار Android 14 أو على الشاشات التي لا تتوافق مع النطاق العالي الديناميكية (HDR)
PNG نعم
تنسيق WebP نعم
HEIF/HEIC نعم
صورة حيّة بتنسيق HEIC نعم
AVIF (الأساسي) نعم يتم فك ترميزها على أجهزة Android 14 والإصدارات الأحدث فقط

تشغيل الصور في قائمة تشغيل

لتشغيل صورة كجزء من قائمة تشغيل، أنشِئ MediaItem باستخدام معرّف الموارد المنتظم (URI) للصورة وأرسِله إلى المشغّل. يجب أن يتضمّن العنصر MediaItem السمة imageDurationMs لتحديد مدة عرض الصورة.

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

تشغيل الصور الحيّة

الصور المتحركة هي ملفات تجمع بين صورة ثابتة وفيديو قصير.

  • إذا تم تحديد مدة الصورة باستخدام السمة setImageDuration، يتم عرض الصورة الحيّة كصورة ثابتة للمدة المحددة.
  • إذا لم تكن مدة الصورة محدّدة، يتم تشغيل الصورة الحيّة كفيديو.

تخصيص تحميل الصور باستخدام مصدر وسائط

لمزيد من خيارات التخصيص، يمكنك إنشاء ProgressiveMediaSource وتمريره مباشرةً إلى المشغّل بدلاً من MediaItem.

Kotlin

// Create a data source factory.
val dataSourceFactory: DataSource.Factory = 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();

تخصيص التشغيل

يوفّر ExoPlayer طرقًا متعددة لتخصيص تجربة التشغيل بما يتناسب مع احتياجات تطبيقك. يمكنك الاطّلاع على صفحة التخصيص للحصول على أمثلة.

دمج مكتبات تحميل الصور الخارجية

غالبًا ما تتم إدارة الصور من خلال مكتبات خارجية لتحميل الصور، مثل Glide أو Coil.

يتطلّب دمج هذه المكتبات في مسار التشغيل 3 خطوات:

  1. حدِّد MediaItem بنوع MIME‏ APPLICATION_EXTERNALLY_LOADED_IMAGE.
  2. يجب توفير أداة فك ترميز الصور لاسترداد Bitmap من مكتبة تحميل الصور.
  3. يجب توفير أداة تحميل خارجية لتفعيل التخزين المؤقت والتحميل المُسبق.

ضبط ملفات الوسائط للتحميل الخارجي

يجب أن يحدّد عنصر MediaItem المُضاف إلى Player نوع MIME‏ APPLICATION_EXTERNALLY_LOADED_IMAGE بشكل صريح لاستخدام المسارات البرمجية لمكتبة تحميل الصور:

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

فك ترميز الصور باستخدام مكتبة خارجية

يحتاج عارض الصور إلى ExternallyLoadedImageDecoder لاسترداد Bitmap من Uri. يمكن توفير برنامج فك الترميز هذا من خلال إلغاء DefaultRenderersFactory.getImageDecoderFactory.

يستخدم المثال التالي Glide لتحميل صورة، ما يحدّ من الناتج إلى حجم العرض لتجنُّب إنشاء عناصر Bitmap كبيرة جدًا:

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

تحميل الصور مسبقًا باستخدام مكتبة خارجية

أثناء التشغيل، يطلب المشغّل تحميل الصورة التالية مسبقًا بعد تحميل العنصر السابق في قائمة التشغيل بالكامل. عند استخدام مكتبة خارجية لتحميل الصور، يجب تحديد ExternalLoader لتفعيل هذا التحميل المُسبق. إذا لم يكن التحميل المُسبق ممكنًا أو مطلوبًا، يجب توفير هذا المُحمِّل، ولكن لا يمكنه تنفيذ أي إجراء.

يستخدم المثال التالي Glide لضمان تحميل الصورة المطلوبة مسبقًا على القرص:

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