再生中
再生中にメディアのメタデータは、複数の方法で取得できます。最も簡単な方法は、Player.Listener#onMediaMetadataChanged
イベントをリッスンすることです。これにより、title
や albumArtist
などのフィールドを持つ MediaMetadata
オブジェクトが提供されます。または、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);
モーション フォト
画像や動画のオフセットや長さなどを含むモーション フォトのメタデータを抽出することもできます。サポートされる形式は次のとおりです。
- Google Pixel と Samsung のカメラアプリで録画された JPEG モーション フォト。この形式は ExoPlayer で再生できるため、関連するメタデータはプレーヤーで、または
MetadataRetriever
を使用して取得できます。 - Google Pixel と Samsung のカメラアプリで記録された HEIC モーション フォト。この形式は現在 ExoPlayer では再生できないため、関連するメタデータは
MetadataRetriever
を使用して取得する必要があります。
モーション フォトの場合、MetadataRetriever
で取得される TrackGroupArray
には、MotionPhotoMetadata
メタデータ エントリを囲む単一の Format
を持つ TrackGroup
が含まれます。
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); } } }