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