Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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

js
setMediaKeys(mediaKeys)

Parameter

mediaKeys

Ein MediaKeys Objekt, das das HTMLMediaElement für die 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 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