播放期間
可透過多種方式在播放期間擷取媒體的中繼資料。最直接的方法就是監聽 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
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 )
Java
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);
動態相片
系統也可以擷取動態相片中繼資料,包括圖片檔和影片部分的偏移值及長度。系統支援下列動態相片容器格式:
- 部分 Android 相機應用程式錄製的 JPEG 動態相片。ExoPlayer 可播放這些檔案的影片部分。播放器也會公開相關中繼資料,且可使用
MetadataRetriever
擷取。 - 部分 Android 相機應用程式錄製的 HEIC 動態相片。ExoPlayer 無法播放這些檔案的影片部分,但可使用
MetadataRetriever
擷取相關聯的中繼資料。
針對動態相片,使用 MetadataRetriever
取得的 TrackGroupArray
會包含 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); } } }