擷取影片影格

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