MediaKeyStatusMap: get() Methode
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Die get()
-Methode der MediaKeyStatusMap
Schnittstelle gibt den Statuswert zurück, der dem angegebenen Schlüssel zugeordnet ist, oder undefined
, wenn keiner vorhanden ist.
Der Statuswert zeigt an, ob der spezifische Schlüssel für die Entschlüsselung verwendet werden kann oder nicht.
Syntax
get(key)
Parameter
key
-
Der Schlüssel, dessen Wert Sie zurückgeben möchten.
Rückgabewert
Ein String, der den Statuswert angibt, der dem angegebenen Schlüssel zugeordnet ist, oder undefined
.
Die folgenden Statuswerte sind erlaubt:
usable
-
Der Schlüssel kann derzeit zur Entschlüsselung verwendet werden.
expired
-
Der Schlüssel kann nicht mehr zur Entschlüsselung verwendet werden, da seine Ablaufzeit abgelaufen ist.
released
-
Der Schlüssel wurde freigegeben und ist für das CDM nicht mehr verfügbar. Informationen über den Schlüssel sind jedoch weiterhin verfügbar, z. B. ein Nachweis der Lizenzvernichtung.
output-restricted
-
Mit dem Schlüssel sind, basierend auf der festgelegten Richtlinie, Ausgabbeschränkungen verbunden. Mediendaten, die mit diesem Schlüssel entschlüsselt wurden, können von der Darstellung ausgeschlossen werden. Der Status weist darauf hin, dass die Verbindung zwischen Quelle und Ausgabe (z. B. Ihr Computer und ein externer Bildschirm) nicht vertrauenswürdig ist. Dies kann bedeuten, dass es HDCP-Versionsunterschiede zwischen der Quelle, den zwischengeschalteten Geräten und der Ausgabe gibt oder dass zwischengeschaltete Verbindungsgeräte wie HDMI-Kabel oder Video-Splitter beschädigt oder nicht konform sind. Eine Anwendung könnte sich entscheiden, eine höhere HDCP-Version, Inhalte zu verwenden, die eine so hohe Version nicht erfordern. Sie sollten auch überprüfen, ob die zwischengeschalteten Geräte und Kabel HDCP unterstützen, fest verbunden und nicht beschädigt sind.
output-downscaled
-
Mit dem Schlüssel sind, basierend auf der festgelegten Richtlinie, Ausgabbeschränkungen verbunden, diese Beschränkungen könnten jedoch gelockert werden, wenn der Inhalt in niedrigerer Qualität abgespielt wird. Wenn dieser Wert zurückgegeben wird, könnte eine Anwendung den Inhalt in geringerer Auflösung abspielen, oder sie könnte sich entscheiden, eine höhere HDCP-Version oder andere Inhalte zu verwenden, die eine so hohe HDCP-Version nicht erfordern.
usable-in-future
-
Der Schlüssel wird in Zukunft zur Entschlüsselung nutzbar sein, sobald seine Startzeit erreicht ist.
status-pending
-
Der Status des Schlüssels ist noch nicht bekannt und wird ermittelt.
internal-error
-
Der Schlüssel kann derzeit aufgrund eines Fehlers im CDM nicht zur Entschlüsselung verwendet werden. Die Anwendung kann in diesem Fall nichts unternehmen.
Spezifikationen
Specification |
---|
Encrypted Media Extensions # dom-mediakeystatusmap-get |
Browser-Kompatibilität
BCD tables only load in the browser