MediaKeySession: Methode generateRequest()

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() 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 Format, das bei initDataType angegeben ist. Es handelt sich um 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 die bereitgestellten initData nicht gemäß dem angegebenen initDataType gültig sind.
DOMException NotSupportedError: Wird ausgelöst, wenn die mit dem MediaKeySession-Objekt assoziierte Schlüsselimplementierung das bereitgestellte initDataType nicht unterstützt, wenn die bereinigten Initialisierungsdaten leer sind oder wenn die bereinigten Initialisierungsdaten vom Inhaltsentschlüsselungsmodul (CDM) nicht unterstützt werden.
DOMException QuotaExceededError: Wird ausgelöst, wenn die Operation aufgrund von Ressourcenmangel beim Benutzeragenten oder CDM fehlschlägt.
DOMException InvalidStateError: Wird ausgelöst, wenn das MediaKeySession-Objekt sich in einem closing- oder closed-Zustand befindet oder wenn es bereits initialisiert wurde.

Spezifikationen

Specification
Encrypted Media Extensions # dom-mediakeysession-generaterequest