HTMLMediaElement: setMediaKeys() Methode
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since März 2019.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Die setMediaKeys()
Methode des HTMLMediaElement
Interfaces legt die MediaKeys
fest, die zur Entschlüsselung von Medien während der Wiedergabe verwendet werden.
Sie gibt ein Promise
zurück, das erfüllt wird, wenn die neuen Schlüssel erfolgreich gesetzt werden, oder abgelehnt wird, wenn die Schlüssel nicht gesetzt werden können.
Syntax
setMediaKeys(mediaKeys)
Parameter
mediaKeys
-
Ein
MediaKeys
Objekt, das dasHTMLMediaElement
für die Entschlüsselung von Mediendaten während der Wiedergabe verwenden kann.
Rückgabewert
Ausnahmen
Das zurückgegebene Promise kann einen Fehler ablehnen:
InvalidStateError
DOMException
-
Medien-Schlüssel befinden sich bereits im Prozess der Befestigung, oder die vorherigen Schlüssel können derzeit nicht entfernt werden (zum Beispiel, weil die spezielle Implementierung die Entfernung während der Wiedergabe nicht zulässt).
QuotaExceededError
-
Die übergebenen Schlüssel werden bereits von einem anderen Element verwendet, oder der Browser kann es aus anderen Gründen nicht mit diesem Element verwenden.
NotSupportedError
DOMException
-
Die Medien-Schlüssel, die derzeit mit dem Medium verbunden sind, können nicht getrennt werden, da dies von entweder dem CDM oder dem Browser nicht unterstützt wird.
Spezifikationen
Specification |
---|
Encrypted Media Extensions> # dom-htmlmediaelement-setmediakeys> |
Browser-Kompatibilität
Loading…