بازیابی متادیتا

در حین پخش

فراداده رسانه را می توان در حین پخش به روش های مختلف بازیابی کرد. ساده ترین کار گوش دادن به رویداد Player.Listener#onMediaMetadataChanged است. این یک شی MediaMetadata برای استفاده فراهم می کند که دارای فیلدهایی مانند title و albumArtist است. از طرف دیگر، فراخوانی Player#getMediaMetadata همان شی را برمی گرداند.

کاتلین جاوا

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

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

اگر برنامه شما نیاز به دسترسی به اشیاء خاص Metadata.Entry دارد، باید به Player.Listener#onMetadata (برای ابرداده پویا که در حین پخش ارائه می‌شود) گوش دهد. از طرف دیگر، اگر نیاز به بررسی فراداده ایستا باشد، می توان از طریق TrackSelections#getFormat به آن دسترسی داشت. Player#getMediaMetadata از هر دوی این منابع پر شده است.

بدون پخش

اگر نیازی به پخش نیست، استفاده از MetadataRetriever برای استخراج فراداده کارآمدتر است، زیرا از ایجاد و آماده سازی یک پخش کننده جلوگیری می کند.

کاتلین جاوا

val trackGroupsFuture = MetadataRetriever.retrieveMetadata(context, mediaItem)
Futures.addCallback(
  trackGroupsFuture,
  object : FutureCallback<TrackGroupArray?> {
    override fun onSuccess(trackGroups: TrackGroupArray?) {
      if (trackGroups != null) handleMetadata(trackGroups)
    }

    override fun onFailure(t: Throwable) {
      handleFailure(t)
    }
  },
  executor
)

ListenableFuture<TrackGroupArray> trackGroupsFuture =
    MetadataRetriever.retrieveMetadata(context, mediaItem);
Futures.addCallback(
    trackGroupsFuture,
    new FutureCallback<TrackGroupArray>() {
      @Override
      public void onSuccess(TrackGroupArray trackGroups) {
        handleMetadata(trackGroups);
      }

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

عکس های حرکتی

توجه: برای پخش عکس متحرک، به موارد رسانه و برای پشتیبانی از فرمت عکس متحرک، به فرمت های پشتیبانی شده مراجعه کنید.

همچنین امکان استخراج متادیتای عکس متحرک، از جمله فاصله‌ها و طول قسمت‌های تصویر و ویدیوی فایل وجود دارد.

برای عکس‌های متحرک، TrackGroupArray به‌دست‌آمده با MetadataRetriever حاوی یک TrackGroup با یک Format است که ورودی ابرداده MotionPhotoMetadata را در بر می‌گیرد.

کاتلین جاوا

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

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