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).

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

BCD tables only load in the browser