המחלקות MediaExtractorCompat הן תחליף מוכן לשימוש למחלקות MediaExtractor של הפלטפורמה, והן מספקות ממשקי API ופונקציונליות זהים. הוא מאפשר חילוץ של נתוני מדיה מפוענחים, בדרך כלל מקודדים, ממקור נתונים.
הוא מפריד קובץ מאגר (כמו MP4 או MKV) לטראקים נפרדים, כמו וידאו, אודיו וכתוביות. לאחר מכן, כלי החילוץ קורא את הנתונים המקודדים הגולמיים מהרצועות האלה כרצף של דגימות (לדוגמה, פריים דחוס יחיד של סרטון או בלוק של אודיו) לפני שהם נשלחים למפענח.
תרחישים נפוצים לדוגמה:
- טרנסקוד או Remuxing: קריאת דוגמאות מקודדות מטראק כדי לשנות את הקודק (טרנסקוד) או לארוז מחדש את הסטרימינג למאגר חדש (remuxing), למשל המרת קובץ MP4 ל-MKV.
- חילוץ סלקטיבי של תוכן: בידוד ושמירה של טראק יחיד, כמו חילוץ של אודיו מקובץ וידאו.
- ניפוי באגים ברמה נמוכה: בדיקת דוגמאות ספציפיות כדי לנפות באגים בקובץ, בעיות בחותמת הזמן או בעיות אחרות.
- יצירת נגנים בהתאמה אישית: לתרחישי שימוש נישתיים, אפשר ליצור נגן בהתאמה אישית עם שליטה מלאה בצינור המדיה.
סקירה כללית
בדוגמת הקוד הבאה אפשר לראות איך משתמשים בפרמטר MediaExtractorCompat:
Kotlin
fun extractSamples(context: Context, mediaPath: String) { val extractor = MediaExtractorCompat(context) try { // 1. Setup the extractor extractor.setDataSource(mediaPath) // Find and select available tracks for (i in 0 until extractor.trackCount) { val format = extractor.getTrackFormat(i) extractor.selectTrack(i) } // 2. Process samples val buffer = ByteBuffer.allocate(10 * 1024 * 1024) while (true) { // Read an encoded sample into the buffer. val bytesRead = extractor.readSampleData(buffer, 0) if (bytesRead < 0) break // Access sample metadata val trackIndex = extractor.sampleTrackIndex val presentationTimeUs = extractor.sampleTime val sampleSize = extractor.sampleSize extractor.advance() } } catch (e: IOException) { handleFailure(e) } finally { // 3. Release the extractor extractor.release() } }
Java
public void extractSamples(Context context, String mediaPath) { MediaExtractorCompat extractor = new MediaExtractorCompat(context); try { // 1. Setup the extractor extractor.setDataSource(mediaPath); // Find and select available tracks for (int i = 0; i < extractor.getTrackCount(); i++) { MediaFormat format = extractor.getTrackFormat(i); extractor.selectTrack(i); } // 2. Process samples ByteBuffer buffer = ByteBuffer.allocate(10 * 1024 * 1024); while (true) { // Read an encoded sample into the buffer. int bytesRead = extractor.readSampleData(buffer, 0); if (bytesRead < 0) { break; } // Access sample metadata int trackIndex = extractor.getSampleTrackIndex(); long presentationTimeUs = extractor.getSampleTime(); long sampleSize = extractor.getSampleSize(); extractor.advance(); } } catch (IOException e) { handleFailure(e); } finally { // 3. Release the extractor extractor.release(); } }