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 MediaKeySession Interface der Encrypted Media Extensions API repräsentiert einen Kontext für den Nachrichtenaustausch mit einem Content Decryption Module (CDM).

Instanzeigenschaften

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 mit ihr verknüpft sind, nicht mehr zum Entschlüsseln von Mediendaten gültig sind.
MediaKeySession.expiration Schreibgeschützt: Die Zeit, nach der die Schlüssel in der aktuellen Sitzung nicht mehr zur Entschlüsselung von Mediendaten verwendet werden können, oder NaN, wenn es keine solche Zeit gibt. Dieser Wert wird vom CDM festgelegt und in Millisekunden seit dem 1. Januar 1970, UTC, gemessen. Dieser Wert kann sich während der Lebensdauer einer Sitzung ändern, zum Beispiel wenn eine Aktion den Beginn eines Zeitfensters auslöst.
MediaKeySession.keyStatuses Schreibgeschützt: Enthält eine Referenz auf eine schreibgeschützte MediaKeyStatusMap der Schlüssel der aktuellen Sitzung und ihrer Status.
MediaKeySession.sessionId Schreibgeschützt: Enthält eine vom CDM generierte eindeutige Zeichenfolge für das aktuelle Medienobjekt und seine zugehörigen Schlüssel oder Lizenzen.

Ereignisse

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

Instanzmethoden

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

Beispiele

// TBD

Spezifikationen

Specification
Encrypted Media Extensions # mediakeysession-interface