播放期間
播放媒體時,可透過多種方式擷取媒體中繼資料。最簡單的方法是監聽 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);
動態相片
您也可以擷取動態相片中繼資料,包括檔案圖片和影片部分的偏移量和長度。
針對動態相片,透過 MetadataRetriever
取得的 TrackGroupArray
包含 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);
}
}
}