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.

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

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 abgelehnt werden. Das Schließen einer Sitzung bedeutet, dass Lizenzen und Schlüssel, die damit verbunden sind, nicht mehr zum Entschlüsseln von Mediendaten verwendet werden können.

MediaKeySession.expiration Schreibgeschützt

Die Zeit, nach der die Schlüssel in der aktuellen Sitzung nicht mehr zum Entschlüsseln von Mediendaten verwendet werden können, oder NaN, wenn eine solche Zeit nicht existiert. Dieser Wert wird durch das CDM bestimmt und in Millisekunden seit dem 1. Januar 1970, UTC, gemessen. Dieser Wert kann sich während der Lebensdauer einer Sitzung ändern, z. B. 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 deren Status.

MediaKeySession.sessionId Schreibgeschützt

Enthält eine eindeutige Zeichenkette, die vom CDM für das aktuelle Medienobjekt und die damit verbundenen Schlüssel oder Lizenzen generiert wurde.

Ereignisse

keystatuseschange

Wird ausgelöst, wenn es eine Änderung in den Schlüsseln einer Sitzung oder deren 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 mitgeteilt wurde, dass die aktuelle Mediensitzung nicht mehr benötigt wird und dass das CDM alle mit diesem Objekt verbundenen Ressourcen freigeben und es schließen sollte.

MediaKeySession.generateRequest()

Gibt ein Promise zurück, nachdem ein Medienantrag auf Grundlage von Initialisierungsdaten generiert wurde.

MediaKeySession.load()

Gibt ein Promise zurück, das nach dem Laden von Daten für ein bestimmtes Sitzungsobjekt zu einem booleschen Wert führt.

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

js
// TBD

Spezifikationen

Specification
Encrypted Media Extensions
# mediakeysession-interface

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
MediaKeySession
close
closed
expiration
generateRequest
keyStatuses
keystatuseschange event
load
message event
remove
sessionId
update

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
Has more compatibility info.