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.
Instanzeigenschaften
MediaKeySession.closedSchreibgeschützt-
Gibt ein
Promisezurück, das signalisiert, wann eineMediaKeySessiongeschlossen 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.expirationSchreibgeschü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.keyStatusesSchreibgeschützt-
Enthält eine Referenz auf eine schreibgeschützte
MediaKeyStatusMapmit den Schlüsseln der aktuellen Sitzung und deren Status. MediaKeySession.sessionIdSchreibgeschü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
Promisezurü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
Promisezurück, nachdem anhand von Initialisierungsdaten eine Lizenzanfrage erzeugt wurde. MediaKeySession.load()-
Gibt ein
Promisezurück, das nach dem Laden der Daten für ein angegebenes Sitzungsobjekt mit einem booleschen Wert erfüllt wird. MediaKeySession.remove()-
Gibt ein
Promisezurück, nachdem alle dem aktuellen Objekt zugeordneten Sitzungsdaten entfernt wurden. MediaKeySession.update()-
Gibt ein
Promisezurü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
// TBD
Spezifikationen
| Spezifikation |
|---|
| Encrypted Media Extensions> # mediakeysession-interface> |