메타데이터 가져오기

재생 중

미디어의 메타데이터는 재생 중에 여러 가지 방법으로 가져올 수 있습니다. 가장 간단한 방법은 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 및 삼성 카메라 앱에서 녹화한 JPEG 모션 사진입니다. 이 형식은 ExoPlayer에서 재생할 수 있으므로 연결된 메타데이터는 플레이어를 사용하거나 MetadataRetriever를 사용하여 가져올 수 있습니다.
• Google Pixel 및 삼성 카메라 앱에서 촬영한 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);
    }
  }
}