در حین پخش
فراداده رسانه را می توان در حین پخش به روش های مختلف بازیابی کرد. ساده ترین کار گوش دادن به رویداد 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
برای استخراج فراداده کارآمدتر است، زیرا از ایجاد و آماده سازی یک پخش کننده جلوگیری می کند.
کاتلین
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) } }
جاوا
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
را در بر میگیرد.
کاتلین
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); } } }