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 generateRequest()-Methode des MediaKeySession-Interfaces gibt ein Promise zurück, nachdem eine Lizenzanfrage basierend auf den Initialisierungsdaten generiert 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 durch initDataType angegebenen Format. Es ist eine Instanz eines der folgenden Typen:

Rückgabewert

Ein Promise.

Ausnahmen

TypeError: Wird ausgelöst, wenn initDataType ein leerer String ist, wenn initData ein leeres Array ist, oder wenn das bereitgestellte initData gemäß dem angegebenen initDataType nicht gültig ist.
DOMException NotSupportedError: Wird ausgelöst, wenn die mit dem MediaKeySession-Objekt verknüpfte Key System-Implementierung 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 die Operation aufgrund eines Mangels an Ressourcen seitens des User-Agents oder des 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