המחלקות FrameExtractor מספקות דרך יעילה לחילוץ פריים מפוענח מ-MediaItem.
תרחישים נפוצים לדוגמה:
- יצירת תמונות ממוזערות: יצירת תמונות ממוזערות באיכות גבוהה לגלריית סרטונים או לסרגל ההתקדמות.
- תצוגות מקדימות של עריכת סרטונים: הצגת תצוגות מקדימות מדויקות של פריימים בציר זמן של כלי עריכה, שמאפשרות למשתמשים לדלג בין חלקי התוכן ולראות את הפריימים בצורה מדויקת.
- החלת טרנספורמציות כמו שינוי גודל, חיתוך או סיבוב ישירות במהלך החילוץ, כדי להימנע משלב נפרד של עיבוד שלאחר החילוץ.
- ניתוח תוכן: חילוץ פריימים במרווחי זמן כדי לשלוח אותם לצינור ניתוח למשימות כמו זיהוי סצנות, זיהוי אובייקטים או בקרת איכות.
סקירה כללית
השימוש ב-FrameExtractor כולל שני שלבים:
- בונים את כלי החילוץ: יוצרים מופע באמצעות
FrameExtractor.Builder. מעבירים אתContextואתMediaItemשרוצים לבדוק אל ה-builder. אפשר גם לשרשר שיטות הגדרה ב-Builderלהגדרות מתקדמות. - חילוץ פריימים: כדי לחלץ פריימים בחותמת זמן ספציפית, מתקשרים אל
getFrame(). כדי לבקש תמונה ממוזערת מייצגת, מתקשרים אלgetThumbnail(). השיטות האלה הן אסינכרוניות ומחזירותListenableFuture. לכן, פעולת הפענוח המורכבת לא חוסמת את ה-thread הראשי.
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()); } }