HTMLMediaElement: setMediaKeys()-Methode

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 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 das HTMLMediaElement zur Entschlüsselung von Mediendaten während der Wiedergabe verwenden kann.

Rückgabewert

Ein Promise, das mit undefined erfüllt wird.

Ausnahmen

Das zurückgegebene Promise kann einen Fehler ablehnen:

InvalidStateError DOMException: Medien-Schlüssel sind bereits im Prozess des Anhängens, oder die vorherigen Schlüssel können momentan nicht entfernt werden (zum Beispiel, weil die spezielle Implementierung eine Entfernung während der Wiedergabe nicht erlaubt).
QuotaExceededError DOMException: Die übergebenen Schlüssel werden bereits von einem anderen Element verwendet, oder der Browser kann sie aus anderen Gründen nicht mit diesem Element verwenden.
NotSupportedError DOMException: Die derzeit mit dem Medium verknüpften Medien-Schlüssel können nicht getrennt werden, da dies entweder vom CDM oder dem Browser nicht unterstützt wird.

Spezifikationen

Specification
Encrypted Media Extensions # dom-htmlmediaelement-setmediakeys

Browser-Kompatibilität

BCD tables only load in the browser