MediaKeySystemAccess: getConfiguration() Methode
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 getConfiguration() Methode der Schnittstelle MediaKeySystemAccess gibt ein Objekt mit der unterstützten Kombination der folgenden Konfigurationsoptionen zurück:
labelSchreibgeschützt-
Ein String, der die Konfiguration identifiziert und unverändert aus der an
Navigator.requestMediaKeySystemAccess()übergebenen Konfiguration übernommen wird. Standardmäßig ist dies der leere String (""). initDataTypesSchreibgeschützt-
Gibt eine Liste der unterstützten Initialisierungsdatentypnamen zurück. Ein Initialisierungsdatentyp ist ein String, der das Format der Initialisierungsdaten angibt.
audioCapabilitiesSchreibgeschützt-
Gibt eine Liste unterstützter Audio-Typ- und Fähigkeits-Paare zurück.
videoCapabilitiesSchreibgeschützt-
Gibt eine Liste unterstützter Video-Typ- und Fähigkeits-Paare zurück.
distinctiveIdentifierSchreibgeschützt-
Gibt an, ob ein persistenter, unterscheidbarer Identifikator erforderlich ist.
persistentStateSchreibgeschützt-
Gibt an, ob die Möglichkeit, den Zustand zu speichern, erforderlich ist.
sessionTypesSchreibgeschützt-
Ein Array von Strings, das die Sitzungstypen angibt, die von der Konfiguration unterstützt werden.
Zulässige Werte sind unter anderem:
temporary-
Eine Sitzung, für die das Lizenzierungs-, Schlüssel- und Sitzungsprotokoll oder -daten nicht gespeichert werden. Die Anwendung muss diese Speicherung nicht verwalten. Implementierungen müssen diese Option unterstützen, und sie ist die Standardeinstellung.
persistent-license-
Eine Sitzung, für die die Lizenz (und möglicherweise andere mit der Sitzung verbundene Daten) gespeichert werden. Ein Eintrag der Lizenz und der zugehörigen Schlüssel bleibt auch dann bestehen, wenn die Lizenz gelöscht wird, was eine Bescheinigung darstellt, dass die Lizenz und die enthaltenen Schlüssel vom Client nicht mehr verwendet werden können.
Syntax
getConfiguration()
Parameter
Keine.
Rückgabewert
Ein Objekt.
Spezifikationen
| Spezifikation |
|---|
| Encrypted Media Extensions> # dom-mediakeysystemaccess-getconfiguration> |