חילוץ פריימים מסרטון

המחלקות FrameExtractor מספקות דרך יעילה לחילוץ פריים מפוענח מ-MediaItem.

תרחישים נפוצים לדוגמה:

  • יצירת תמונות ממוזערות: יצירת תמונות ממוזערות באיכות גבוהה לגלריית סרטונים או לסרגל ההתקדמות.
  • תצוגות מקדימות של עריכת סרטונים: הצגת תצוגות מקדימות מדויקות של פריימים בציר זמן של כלי עריכה, שמאפשרות למשתמשים לדלג בין חלקי התוכן ולראות את הפריימים בצורה מדויקת.
  • החלת טרנספורמציות כמו שינוי גודל, חיתוך או סיבוב ישירות במהלך החילוץ, כדי להימנע משלב נפרד של עיבוד שלאחר החילוץ.
  • ניתוח תוכן: חילוץ פריימים במרווחי זמן כדי לשלוח אותם לצינור ניתוח למשימות כמו זיהוי סצנות, זיהוי אובייקטים או בקרת איכות.

סקירה כללית

השימוש ב-FrameExtractor כולל שני שלבים:

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