SourceBuffer: changeType()-Methode

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

Die changeType()-Methode des SourceBuffer-Interfaces legt den MIME-Typ fest, den zukünftige Aufrufe von appendBuffer() erwarten sollen, um neue Mediendaten zu verarbeiten, die diesem Typ entsprechen. Dies ermöglicht es, Codecs oder den Containertyp während der Übertragung zu ändern.

Ein Szenario, in dem dies hilfreich ist, besteht darin, die Medienquelle an die sich ändernde Bandbreitenverfügbarkeit anzupassen, indem man von einem Codec zu einem anderen wechselt, wenn sich die Ressourcenbeschränkungen ändern.

Syntax

js
changeType(type)

Parameter

type

Ein Zeichenstring, der den MIME-Typ angibt, dem die zukünftigen Puffer entsprechen werden.

Rückgabewert

Keiner (undefined).

Ausnahmen

TypeError

Wird ausgelöst, wenn der angegebene String leer ist, anstatt einen gültigen MIME-Typ anzugeben.

InvalidStateError DOMException

Wird ausgelöst, wenn der SourceBuffer kein Mitglied der sourceBuffers-Liste der übergeordneten Medienquelle ist, oder wenn die updating-Eigenschaft des Puffers anzeigt, dass ein zuvor eingereihtes appendBuffer() oder remove() noch verarbeitet wird.

NotSupportedError DOMException

Wird ausgelöst, wenn der angegebene MIME-Typ nicht unterstützt wird oder nicht mit den Arten von SourceBuffer-Objekten unterstützt wird, die in der MediaSource.sourceBuffers-Liste vorhanden sind.

Nutzungshinweise

Wenn die readyState-Eigenschaft der übergeordneten MediaSource auf "ended" gesetzt ist, wird durch den Aufruf von changeType() die readyState-Eigenschaft auf "open" gesetzt und ein einfaches Ereignis namens sourceopen bei der übergeordneten Medienquelle ausgelöst.

Spezifikationen

Specification
Media Source Extensions™
# dom-sourcebuffer-changetype

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch