Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

MediaKeySession

Baseline
Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit März 2019 browserübergreifend verfügbar.

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

Die Schnittstelle MediaKeySession der Encrypted Media Extensions API stellt einen Kontext für den Nachrichtenaustausch mit einem Content Decryption Module (CDM) dar.

EventTarget MediaKeySession

Instanzeigenschaften

MediaKeySession.closed Schreibgeschützt

Gibt ein Promise zurück, das signalisiert, wann eine MediaKeySession geschlossen wird. Dieses Promise kann nur erfüllt und niemals zurückgewiesen werden. Das Schließen einer Sitzung bedeutet, dass die zugehörigen Lizenzen und Schlüssel nicht mehr zum Entschlüsseln von Mediendaten gültig sind.

MediaKeySession.expiration Schreibgeschützt

Der Zeitpunkt, nach dem die Schlüssel der aktuellen Sitzung nicht mehr zum Entschlüsseln von Mediendaten verwendet werden können, oder NaN, wenn es keinen solchen Zeitpunkt gibt. Dieser Wert wird vom CDM bestimmt und in Millisekunden seit dem 1. Januar 1970, 00:00 Uhr UTC, gemessen. Er kann sich während der Laufzeit einer Sitzung ändern, etwa wenn eine Aktion den Beginn eines Zeitfensters auslöst.

MediaKeySession.keyStatuses Schreibgeschützt

Enthält eine Referenz auf eine schreibgeschützte MediaKeyStatusMap mit den Schlüsseln der aktuellen Sitzung und deren Status.

MediaKeySession.sessionId Schreibgeschützt

Enthält eine eindeutige Zeichenfolge, die vom CDM für das aktuelle Medienobjekt und die zugehörigen Schlüssel oder Lizenzen erzeugt wird.

Instanzmethoden

MediaKeySession.close()

Gibt ein Promise zurück, nachdem mitgeteilt wurde, dass die aktuelle Mediensitzung nicht mehr benötigt wird und das CDM alle mit diesem Objekt verbundenen Ressourcen freigeben und es schließen soll.

MediaKeySession.generateRequest()

Gibt ein Promise zurück, nachdem anhand von Initialisierungsdaten eine Lizenzanfrage erzeugt wurde.

MediaKeySession.load()

Gibt ein Promise zurück, das nach dem Laden der Daten für ein angegebenes Sitzungsobjekt mit einem booleschen Wert erfüllt wird.

MediaKeySession.remove()

Gibt ein Promise zurück, nachdem alle dem aktuellen Objekt zugeordneten Sitzungsdaten entfernt wurden.

MediaKeySession.update()

Gibt ein Promise zurück, nachdem Nachrichten und Lizenzen an das CDM übergeben wurden.

Ereignisse

keystatuseschange

Wird ausgelöst, wenn sich die Schlüssel einer Sitzung oder deren Status ändern.

message

Wird ausgelöst, wenn das Content Decryption Module eine Nachricht für die Sitzung erzeugt hat.

Beispiele

js
// TBD

Spezifikationen

Spezifikation
Encrypted Media Extensions
# mediakeysession-interface

Browser-Kompatibilität