HTMLMediaElement: setMediaKeys()-Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit März 2019 browserübergreifend verfügbar.
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 setzt die MediaKeys, die zum Entschlüsseln von Medien während der Wiedergabe verwendet werden.
Sie gibt ein Promise zurück, das sich erfüllt, 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 dasHTMLMediaElementzur Entschlüsselung von Mediendaten während der Wiedergabe verwenden kann.
Rückgabewert
Ausnahmen
Das zurückgegebene Promise kann einen Fehler ablehnen:
InvalidStateErrorDOMException-
Medienschlüssel sind bereits im Prozess des Anbindens, oder die vorherigen Schlüssel können momentan nicht entfernt werden (zum Beispiel, weil die besondere Implementierung dies während der Wiedergabe nicht erlaubt).
QuotaExceededError-
Die übergebenen Schlüssel werden bereits von einem anderen Element verwendet, oder der Browser kann sie aus anderen Gründen mit diesem Element nicht verwenden.
NotSupportedErrorDOMException-
Die Medienschlüssel, die derzeit mit den Medien verbunden sind, können nicht disassoziiert werden, weil dies weder vom CDM noch vom Browser unterstützt wird.
Spezifikationen
| Spezifikation |
|---|
| Encrypted Media Extensions # dom-htmlmediaelement-setmediakeys |