جارٍ استرداد البيانات الوصفية

أثناء التشغيل

يمكن استرداد البيانات الوصفية للوسائط أثناء التشغيل بطرق متعددة. تشير رسالة الأشكال البيانية الأكثر وضوحًا هو الاستماع إلى حدث واحد (Player.Listener#onMediaMetadataChanged) سيوفر ذلك كائن MediaMetadata للاستخدام، ويحتوي على حقول مثل title albumArtist بدلاً من ذلك، يؤدي الاتصال بالرقم Player#getMediaMetadata إلى إرجاع النتيجة نفسها الخاص بك.

Kotlin

override fun onMediaMetadataChanged(mediaMetadata: MediaMetadata) {
  mediaMetadata.title?.let(::handleTitle)
}

Java

@Override
public void onMediaMetadataChanged(MediaMetadata mediaMetadata) {
  if (mediaMetadata.title != null) {
    handleTitle(mediaMetadata.title);
  }
}

إذا كان تطبيقك يحتاج إلى الوصول إلى عناصر Metadata.Entry محدَّدة، يجب عندها يجب أن يتم الاستماع إلى Player.Listener#onMetadata (للبيانات الوصفية الديناميكية التي يتم إرسالها أثناء التشغيل). بدلاً من ذلك، إذا كانت هناك حاجة إلى إلقاء نظرة على بيانات التعريف الثابتة، يمكن الوصول إليه من خلال TrackSelections#getFormat. تتم تعبئة Player#getMediaMetadata من كلا المصدرَين.

بدون تشغيل

إذا لم تكن هناك حاجة إلى التشغيل، فمن الأفضل استخدام MetadataRetriever لاستخراج البيانات الوصفية لتجنُّب الحاجة إلى إنشاء لاعب وإعداده.

Kotlin

suspend fun retrievingMetadataRetrieveMetadataWithoutPlayback(
  context: Context,
  mediaItem: MediaItem,
) {
  try {
    MetadataRetriever.Builder(context, mediaItem).build().use { metadataRetriever ->
      val trackGroups = metadataRetriever.retrieveTrackGroups().await()
      val timeline = metadataRetriever.retrieveTimeline().await()
      val durationUs = metadataRetriever.retrieveDurationUs().await()
      handleMetadata(trackGroups, timeline, durationUs)
    }
  } catch (e: IOException) {
    handleFailure(e)
  }
}

Java

try (MetadataRetriever metadataRetriever =
    new MetadataRetriever.Builder(context, mediaItem).build()) {
  ListenableFuture<TrackGroupArray> trackGroupsFuture = metadataRetriever.retrieveTrackGroups();
  ListenableFuture<Timeline> timelineFuture = metadataRetriever.retrieveTimeline();
  ListenableFuture<Long> durationUsFuture = metadataRetriever.retrieveDurationUs();
  ListenableFuture<List<Object>> allFutures =
      Futures.allAsList(trackGroupsFuture, timelineFuture, durationUsFuture);
  Futures.addCallback(
      allFutures,
      new FutureCallback<List<Object>>() {
        @Override
        public void onSuccess(List<Object> result) {
            handleMetadata(
                Futures.getUnchecked(trackGroupsFuture),
                Futures.getUnchecked(timelineFuture),
                Futures.getUnchecked(durationUsFuture));
        }

        @Override
        public void onFailure(Throwable t) {
          handleFailure(t);
        }
      },
      executor);
}

الصور الحيّة

ومن الممكن أيضًا استخراج البيانات الوصفية للصور الحيّة، بما في ذلك الإزاحة أطوال الصورة وأجزاء الفيديو في الملف.

بالنسبة إلى الصور الحيّة، تمّ الحصول على TrackGroupArray من خلال MetadataRetriever. يحتوي على TrackGroup مع Format واحد يشتمل على إدخال البيانات الوصفية لـ MotionPhotoMetadata

Kotlin

0.until(trackGroups.length)
  .asSequence()
  .mapNotNull { trackGroups[it].getFormat(0).metadata }
  .filter { metadata -> metadata.length() == 1 }
  .map { metadata -> metadata[0] }
  .filterIsInstance<MotionPhotoMetadata>()
  .forEach(::handleMotionPhotoMetadata)

Java

for (int i = 0; i < trackGroups.length; i++) {
  TrackGroup trackGroup = trackGroups.get(i);
  Metadata metadata = trackGroup.getFormat(0).metadata;
  if (metadata != null && metadata.length() == 1) {
    Metadata.Entry metadataEntry = metadata.get(0);
    if (metadataEntry instanceof MotionPhotoMetadata) {
      MotionPhotoMetadata motionPhotoMetadata = (MotionPhotoMetadata) metadataEntry;
      handleMotionPhotoMetadata(motionPhotoMetadata);
    }
  }
}