동영상 프레임 추출

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

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

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

개요

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

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

Kotlin

suspend fun extractFrame(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) {
        Log.e(TAG, "Exception: $e")
    }
}

Java

public void extractFrame(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<>() {
            @Override
            public void onSuccess(List<Object> result) {
                handleFrame(Futures.getUnchecked(frameFuture), Futures.getUnchecked(thumbnailFuture));
            }

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