MediaKeySession

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.

Das Interface MediaKeySession der Encrypted Media Extensions API repräsentiert einen Kontext für den Nachrichtenaustausch mit einem Content Decryption Module (CDM).

Instanz-Eigenschaften

MediaKeySession.closed Schreibgeschützt: Gibt ein Promise zurück, das signalisiert, wann eine MediaKeySession geschlossen wird. Dieses Promise kann nur erfüllt und nie abgelehnt werden. Das Schließen einer Sitzung bedeutet, dass Lizenzen und Schlüssel, die damit verbunden sind, nicht mehr zum Entschlüsseln von Mediendaten gültig sind.
MediaKeySession.expiration Schreibgeschützt: Der Zeitpunkt, nach dem die Schlüssel in der aktuellen Sitzung nicht mehr zur Entschlüsselung von Mediendaten verwendet werden können, oder NaN, wenn keine solche Zeit existiert. Dieser Wert wird vom CDM bestimmt und in Millisekunden seit dem 1. Januar 1970, UTC gemessen. Dieser Wert kann sich während der Laufzeit einer Sitzung ändern, z.B. wenn eine Aktion den Beginn eines Zeitfensters auslöst.
MediaKeySession.keyStatuses Schreibgeschützt: Enthält eine Referenz zu einer schreibgeschützten MediaKeyStatusMap der Schlüssel der aktuellen Sitzung und deren Status.
MediaKeySession.sessionId Schreibgeschützt: Enthält eine vom CDM generierte eindeutige Zeichenfolge für das aktuelle Medienobjekt und dessen zugehörige Schlüssel oder Lizenzen.

Ereignisse

keystatuseschange: Wird ausgelöst, wenn es eine Änderung bei den Schlüsseln in einer Sitzung oder deren Status gegeben hat.
message: Wird ausgelöst, wenn das Content Decryption Module eine Nachricht für die Sitzung generiert hat.

Instanz-Methoden

MediaKeySession.close(): Gibt ein Promise zurück, nachdem die aktuelle Mediensitzung als nicht mehr benötigt gemeldet wurde und das CDM alle mit diesem Objekt verbundenen Ressourcen freigeben und es schließen sollte.
MediaKeySession.generateRequest(): Gibt ein Promise zurück, nachdem eine Lizenzanfrage basierend auf Initialisierungsdaten generiert wurde.
MediaKeySession.load(): Gibt ein Promise zurück, das zu einem booleschen Wert aufgelöst wird, nachdem Daten für ein angegebenes Sitzungsobjekt geladen wurden.
MediaKeySession.remove(): Gibt ein Promise zurück, nachdem alle Sitzungsdaten, die mit dem aktuellen Objekt verbunden sind, entfernt wurden.
MediaKeySession.update(): Gibt ein Promise zurück, nachdem Nachrichten und Lizenzen an das CDM geladen wurden.

Beispiele

// TBD

Spezifikationen

Specification
Encrypted Media Extensions # mediakeysession-interface