MediaKeySession: generateRequest() Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2019.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Die Methode generateRequest() der MediaKeySession-Schnittstelle gibt ein Promise zurück, nachdem eine Lizenzanforderung basierend auf Initialisierungsdaten erstellt wurde.

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 wird. Es ist eine Instanz eines der folgenden Typen:

Rückgabewert

Ein Promise.

Ausnahmen

TypeError: Wirft einen Fehler, 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.
DOMException NotSupportedError: Wird ausgelöst, wenn die Schlüssel-System-Implementierung, die mit dem MediaKeySession-Objekt verbunden ist, den bereitgestellten initDataType nicht unterstützt, wenn die bereinigten Initialisierungsdaten leer sind, oder wenn die bereinigten Initialisierungsdaten vom Content Decryption Module (CDM) nicht unterstützt werden.
DOMException QuotaExceededError: Wird ausgelöst, wenn der Vorgang aufgrund von Ressourcennot auf dem Benutzeragenten oder CDM fehlschlägt.
DOMException InvalidStateError: Wird ausgelöst, wenn sich das MediaKeySession-Objekt in einem closing- oder closed-Zustand befindet oder wenn es bereits initialisiert wurde.

Spezifikationen

Specification
Encrypted Media Extensions # dom-mediakeysession-generaterequest