동영상 프레임 추출

FrameExtractor 클래스는 MediaItem에서 디코딩된 프레임을 추출하는 효율적인 방법을 제공합니다.

일반적인 사용 사례는 다음과 같습니다.

  • 썸네일 생성: 동영상 갤러리 또는 탐색 막대에 사용할 고품질 썸네일을 만듭니다.
  • 동영상 편집 미리보기: 편집기 타임라인에 정확한 프레임 미리보기를 표시하여 사용자가 콘텐츠를 탐색하고 프레임을 정확하게 시각화할 수 있습니다.
  • 추출 중에 직접 크기 조절, 자르기, 회전과 같은 변환 적용으로 별도의 후처리 단계를 방지합니다.
  • 콘텐츠 분석: 장면 감지, 객체 인식, 품질 관리와 같은 작업을 위해 분석 파이프라인으로 전송할 프레임을 일정한 간격으로 추출합니다.

개요

FrameExtractor 사용은 두 단계로 이루어집니다.

  1. 추출기 빌드: FrameExtractor.Builder를 사용하여 인스턴스를 만듭니다. 검사하려는 Context 및 MediaItem을 빌더에 전달합니다. 고급 설정을 위해 Builder에서 구성 메서드를 연결할 수도 있습니다.
  2. 프레임 추출: getFrame()를 호출하여 특정 타임스탬프에서 프레임을 추출하거나 getThumbnail()를 호출하여 대표 썸네일을 요청합니다. 이러한 메서드는 비동기식이며 ListenableFuture를 반환합니다. 따라서 복잡한 디코딩 작업이 기본 스레드를 차단하지 않습니다.

Kotlin

suspend fun extractFrames(context: Context, mediaItem: MediaItem) {
  try {
    // 1. Build the frame extractor.
    // `FrameExtractor` implements `AutoCloseable`, so wrap it in
    // a Kotlin `.use` block, which calls `close()` automatically.
    FrameExtractor.Builder(context, mediaItem).build().use { extractor ->
      // 2. Extract frames asynchronously.
      val frame = extractor.getFrame(5000L).await()
      val thumbnail = extractor.thumbnail.await()
      handleFrame(frame, thumbnail)
    }
  } catch (e: Exception) {
    handleFailure(e)
  }
}

ExtractFrames.kt

Java

public void extractFrames(Context context, MediaItem mediaItem) {
  // 1. Build the frame extractor.
  // `FrameExtractor` implements `AutoCloseable`, so use try-with-resources
  // so that the resources are automatically released.
  try (FrameExtractor frameExtractor = new FrameExtractor.Builder(context, mediaItem).build()) {
    // 2. Extract frames asynchronously.
    ListenableFuture<FrameExtractor.Frame> frameFuture = frameExtractor.getFrame(5000L);
    ListenableFuture<FrameExtractor.Frame> thumbnailFuture = frameExtractor.getThumbnail();

    ListenableFuture<List<Object>> allFutures = Futures.allAsList(frameFuture, thumbnailFuture);
    Futures.addCallback(
        allFutures,
        new FutureCallback<List<Object>>() {
          @Override
          public void onSuccess(List<Object> result) {
            handleFrame(Futures.getUnchecked(frameFuture), Futures.getUnchecked(thumbnailFuture));
          }

          @Override
          public void onFailure(Throwable t) {
            handleFailure(t);
          }
        },
        directExecutor());
  }
}

ExtractFrames.java