MediaKeySession
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).
Instanzeigenschaften
MediaKeySession.closed
Nur lesbar-
Gibt ein
Promise
zurück, das signalisiert, wann eineMediaKeySession
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
Nur lesbar-
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
Nur lesbar-
Enthält eine Referenz auf eine schreibgeschützte
MediaKeyStatusMap
der Schlüssel der aktuellen Sitzung und deren Status. MediaKeySession.sessionId
Nur lesbar-
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
// TBD
Spezifikationen
Specification |
---|
Encrypted Media Extensions # mediakeysession-interface |
Browser-Kompatibilität
BCD tables only load in the browser