คลาส FrameExtractor เป็นวิธีที่มีประสิทธิภาพในการแยกเฟรมที่ถอดรหัสแล้ว
จาก MediaItem
Use Case ที่พบบ่อยมีดังนี้
- การสร้างภาพปก: การสร้างภาพปกคุณภาพสูงสำหรับแกลเลอรีวิดีโอหรือแถบเลื่อน
- ตัวอย่างการตัดต่อวิดีโอ: แสดงตัวอย่างเฟรมที่แม่นยำในไทม์ไลน์ของโปรแกรมตัดต่อ เพื่อให้ผู้ใช้เลื่อนดูเนื้อหาและเห็นภาพเฟรมได้อย่างถูกต้อง
- ใช้การเปลี่ยนรูปแบบ เช่น การปรับขนาด การครอบตัด หรือการหมุนโดยตรง ในระหว่างการแยก เพื่อหลีกเลี่ยงขั้นตอนการประมวลผลภายหลังแยกต่างหาก
- การวิเคราะห์เนื้อหา: แยกเฟรมเป็นช่วงๆ เพื่อส่งไปยังไปป์ไลน์การวิเคราะห์สำหรับงานต่างๆ เช่น การตรวจหาฉาก การจดจำออบเจ็กต์ หรือการควบคุมคุณภาพ
ภาพรวม
การใช้ FrameExtractor มี 2 ขั้นตอน ดังนี้
- สร้างโปรแกรมแยก: สร้างอินสแตนซ์โดยใช้
FrameExtractor.Builderส่งContextและMediaItemที่ต้องการตรวจสอบไปยัง Builder นอกจากนี้ คุณยังเชื่อมโยงวิธีการกำหนดค่าในBuilderสำหรับ การตั้งค่าขั้นสูงได้ด้วย - แยกเฟรม: เรียกใช้
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) } }
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()); } }