MediaSource: Methode addSourceBuffer()

Syntax

addSourceBuffer(mimeType)

Parameter

mimeType

Ein String, der den MIME-Typ des zu erstellenden und hinzuzufügenden SourceBuffer zur MediaSource angibt.

Rückgabewert

Ein SourceBuffer-Objekt, das den neuen Quellpuffer darstellt, der erstellt und zur Medienquelle hinzugefügt wurde.

Ausnahmen

InvalidAccessError DOMException

Wird ausgelöst, wenn der für mimeType angegebene Wert ein leerer String anstelle eines gültigen MIME-Typs ist.

InvalidStateError DOMException

Wird ausgelöst, wenn die MediaSource nicht im Status "open" readyState ist.

NotSupportedError DOMException

Wird ausgelöst, wenn der angegebene mimeType vom User-Agent nicht unterstützt wird oder nicht mit den MIME-Typen anderer SourceBuffer-Objekte kompatibel ist, die bereits in der Liste sourceBuffers der Medienquelle enthalten sind.

QuotaExceededError

Wird ausgelöst, wenn der User-Agent keine weiteren SourceBuffer-Objekte verarbeiten kann oder das Erstellen eines neuen SourceBuffer mit dem gegebenen mimeType zu einer nicht unterstützten Konfiguration von SourceBuffers führen würde.

Beispiele

Der folgende Ausschnitt stammt aus einem Beispiel von Nick Desaulniers (sehen Sie sich das vollständige Demo live an oder laden Sie den Quellcode herunter für weitere Untersuchungen). Die Funktion getMediaSource(), die hier nicht definiert ist, gibt eine MediaSource zurück.

const assetURL = "frag_bunny.mp4";
// Need to be specific for Blink regarding codecs
// ./mp4info frag_bunny.mp4 | grep Codec
const mimeCodec = 'video/mp4; codecs="avc1.42E01E, mp4a.40.2"';
const mediaSource = getMediaSource();

if ("MediaSource" in window && MediaSource.isTypeSupported(mimeCodec)) {
  console.log(mediaSource.readyState); // closed
  mediaSource.addEventListener("sourceopen", sourceOpen);
  video.src = URL.createObjectURL(mediaSource);
} else {
  console.error("Unsupported MIME type or codec: ", mimeCodec);
}

function sourceOpen() {
  console.log(this.readyState); // open
  const sourceBuffer = mediaSource.addSourceBuffer(mimeCodec);
  fetchAB(assetURL, (buf) => {
    sourceBuffer.addEventListener("updateend", () => {
      mediaSource.endOfStream();
      video.play();
      console.log(mediaSource.readyState); // ended
    });
    sourceBuffer.appendBuffer(buf);
  });
}

Spezifikationen

Browser-Kompatibilität

Siehe auch

• SourceBuffer
• SourceBufferList