แยกเฟรมวิดีโอ

คลาส FrameExtractor เป็นวิธีที่มีประสิทธิภาพในการแยกเฟรมที่ถอดรหัสแล้ว จาก MediaItem

Use Case ทั่วไปมีดังนี้

  • การสร้างภาพปก: การสร้างภาพปกคุณภาพสูงสำหรับแกลเลอรีวิดีโอหรือแถบเลื่อน
  • ตัวอย่างการตัดต่อวิดีโอ: แสดงตัวอย่างเฟรมที่แม่นยำในไทม์ไลน์ของโปรแกรมตัดต่อ เพื่อให้ผู้ใช้ค้นหาเนื้อหาและเห็นภาพเฟรมได้อย่างถูกต้อง
  • ใช้การเปลี่ยนรูปแบบ เช่น การปรับขนาด การครอบตัด หรือการหมุนโดยตรง ในระหว่างการแยก เพื่อหลีกเลี่ยงขั้นตอนการประมวลผลภายหลังแยกต่างหาก
  • การวิเคราะห์เนื้อหา: การแยกเฟรมเป็นช่วงๆ เพื่อส่งไปยังไปป์ไลน์การวิเคราะห์สำหรับงานต่างๆ เช่น การตรวจหาฉาก การจดจำออบเจ็กต์ หรือการควบคุมคุณภาพ

ภาพรวม

การใช้ FrameExtractor มี 2 ขั้นตอน ดังนี้

  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());
    }
}