MediaParser 類別

定義

[Android.Runtime.Register("android/media/MediaParser", ApiSince=30, DoNotGenerateAcw=true)]
public sealed class MediaParser : Java.Lang.Object

[<Android.Runtime.Register("android/media/MediaParser", ApiSince=30, DoNotGenerateAcw=true)>]
type MediaParser = class
    inherit Object

繼承

Object

JavaObject

Object

MediaParser

屬性

RegisterAttribute

備註

解析包含媒體樣本與元資料的媒體容器格式與擷取。

此類別提供一系列低階媒體容器解析器。 此類別的每個實例都對應於特定的媒體解析器實作，適合從特定媒體容器格式擷取。 媒體解析器的實作指派取決於用於建立實例的工廠方法（參見 #create 和 #createByName）。

使用者必須實作以下條件才能使用此類別。

<ul><li>InputReader：提供媒體容器的位元組以供解析。 <LI>OutputConsumer：提供所有擷取資料和元資料的匯流。 </ul>

以下程式碼片段包含一個使用範例：

MyOutputConsumer myOutputConsumer = new MyOutputConsumer();
            MyInputReader myInputReader = new MyInputReader("www.example.com");
            MediaParser mediaParser = MediaParser.create(myOutputConsumer);

            while (mediaParser.advance(myInputReader)) {}

            mediaParser.release();
            mediaParser = null;

以下程式碼片段提供一個簡易 OutputConsumer 的範例實作，可擷取並發布所有影片範例：

class VideoOutputConsumer implements MediaParser.OutputConsumer {

                private byte[] sampleDataBuffer = new byte[4096];
                private byte[] discardedDataBuffer = new byte[4096];
                private int videoTrackIndex = -1;
                private int bytesWrittenCount = 0;

                @Override
                public void onSeekMapFound(int i, @NonNull MediaFormat mediaFormat) {
                  // Do nothing.
                }

                @Override
                public void onTrackDataFound(int i, @NonNull TrackData trackData) {
                  MediaFormat mediaFormat = trackData.mediaFormat;
                  if (videoTrackIndex == -1 &&
                      mediaFormat
                          .getString(MediaFormat.KEY_MIME, /* defaultValue= */ "")
                          .startsWith("video/")) {
                    videoTrackIndex = i;
                  }
                }

                @Override
                public void onSampleDataFound(int trackIndex, @NonNull InputReader inputReader)
                    throws IOException {
                  int numberOfBytesToRead = (int) inputReader.getLength();
                  if (videoTrackIndex != trackIndex) {
                    // Discard contents.
                    inputReader.read(
                        discardedDataBuffer,
                        /* offset= */ 0,
                        Math.min(discardDataBuffer.length, numberOfBytesToRead));
                  } else {
                    ensureSpaceInBuffer(numberOfBytesToRead);
                    int bytesRead = inputReader.read(
                        sampleDataBuffer, bytesWrittenCount, numberOfBytesToRead);
                    bytesWrittenCount += bytesRead;
                  }
                }

                @Override
                public void onSampleCompleted(
                    int trackIndex,
                    long timeMicros,
                    int flags,
                    int size,
                    int offset,
                    @Nullable CryptoInfo cryptoData) {
                  if (videoTrackIndex != trackIndex) {
                    return; // It's not the video track. Ignore.
                  }
                  byte[] sampleData = new byte[size];
                  int sampleStartOffset = bytesWrittenCount - size - offset;
                  System.arraycopy(
                      sampleDataBuffer,
                      sampleStartOffset,
                      sampleData,
                      /* destPos= */ 0,
                      size);
                  // Place trailing bytes at the start of the buffer.
                  System.arraycopy(
                      sampleDataBuffer,
                      bytesWrittenCount - offset,
                      sampleDataBuffer,
                      /* destPos= */ 0,
                      /* size= */ offset);
                  bytesWrittenCount = bytesWrittenCount - offset;
                  publishSample(sampleData, timeMicros, flags);
                }

               private void ensureSpaceInBuffer(int numberOfBytesToRead) {
                 int requiredLength = bytesWrittenCount + numberOfBytesToRead;
                 if (requiredLength > sampleDataBuffer.length) {
                   sampleDataBuffer = Arrays.copyOf(sampleDataBuffer, requiredLength);
                 }
               }

              }

Java 文件 android.media.MediaParser。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。