MediaKeySession: generateRequest()-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 generateRequest()-Methode des MediaKeySession-Interfaces gibt ein Promise zurück, nachdem eine Lizenzanfrage basierend auf Initialisierungsdaten generiert wurde.

In diesem Artikel

Syntax

generateRequest(initDataType, initData)

Parameter

initDataType

Ein String, der das Format des initData-Parameters angibt. Dies muss einer der folgenden Werte sein:

"cenc": Der initData-Parameter verwendet das "cenc"-Format.
"keyids": Der initData-Parameter verwendet das "keyids"-Format.
"webm": Der initData-Parameter verwendet das "webm"-Format.

initData

Initialisierungsdaten für die Anfrage, im Format, das durch initDataType spezifiziert ist. Es ist eine Instanz eines der folgenden Typen:

Ausnahmen

TypeError

Wird ausgelöst, wenn initDataType ein leerer String ist, wenn initData ein leeres Array ist oder wenn die bereitgestellten initData nicht gültig gemäß dem angegebenen initDataType sind.

NotSupportedError DOMException

Wird ausgelöst, wenn die mit dem MediaKeySession-Objekt assoziierte Key-System-Implementierung den bereitgestellten initDataType nicht unterstützt, wenn die bereinigten Initialisierungsdaten leer sind oder wenn die bereinigten Initialisierungsdaten nicht vom Inhaltsentschlüsselungsmodul (CDM) unterstützt werden.

QuotaExceededError

Wird ausgelöst, wenn die Operation aufgrund eines Ressourcenmangels des User-Agents oder CDM fehlschlägt.

InvalidStateError DOMException

Wird ausgelöst, wenn sich das MediaKeySession-Objekt in einem closing- oder closed-Zustand befindet, oder wenn es bereits initialisiert wurde.