MediaSource: readyState-Eigenschaft

Hinweis: Diese Funktion ist in Dedicated Web Workers verfügbar.

Die schreibgeschützte Eigenschaft readyState der MediaSource-Schnittstelle gibt ein Enum zurück, das den Zustand des aktuellen MediaSource darstellt. Die drei möglichen Werte sind:

  • closed: Die Quelle ist derzeit nicht an ein Medienelement angehängt.
  • open: Die Quelle ist an ein Medienelement angehängt und bereit, SourceBuffer-Objekte zu empfangen.
  • ended: Die Quelle ist an ein Medienelement angehängt, aber der Stream wurde durch einen Aufruf von MediaSource.endOfStream() beendet.

Wert

Ein String.

Beispiele

Das folgende Beispiel stammt von Nick Desaulniers (ansehen des vollständigen Demos live, oder herunterladen der Quelle für weitere Untersuchungen). Die Funktion getMediaSource(), die hier nicht definiert ist, gibt eine MediaSource zurück.

js
let mediaSource;

if ("MediaSource" in window && MediaSource.isTypeSupported(mimeCodec)) {
  mediaSource = getMediaSource();
  console.log(mediaSource.readyState); // closed
  video.src = URL.createObjectURL(mediaSource);
  mediaSource.addEventListener("sourceopen", sourceOpen);
} 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

Specification
Media Source Extensions™
# dom-mediasource-readystate

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch