MediaKeys: Methode getStatusForPolicy()
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Mit der Methode getStatusForPolicy() der Schnittstelle MediaKeys lässt sich prüfen, ob das Content Decryption Module (CDM) die Wiedergabe verschlüsselter Mediendaten mit den Schlüsseln unter den angegebenen Richtlinienanforderungen zulassen würde.
Die Methode gibt ein Promise zurück, das mit einem String aufgelöst wird, der den Status des Schlüssels im Hinblick auf alle angegebenen Richtlinienanforderungen angibt. Wird es mit dem Wert "usable" aufgelöst, können die Inhalte entschlüsselt und in der vorgesehenen Qualität wiedergegeben werden. Andere Werte geben an, warum die Schlüssel nicht zur Wiedergabe der Inhalte verwendet werden können. In manchen Fällen weisen sie auf Ausweichmöglichkeiten hin, etwa die Wiedergabe in geringerer Qualität.
Die Richtlinienbeschränkungen umfassen derzeit nur eine Anforderung an die mindestens unterstützte HDCP-Version.
Beachten Sie, dass die Methode einen „hypothetischen Schlüssel“ anhand der Beschränkungen prüft. Die Anwendung muss nicht zuerst mit MediaKeySession einen echten Schlüssel erstellen und eine echte Lizenz abrufen. MediaKeys muss nicht einmal mit Audio- oder Videoelementen verbunden sein.
Syntax
getStatusForPolicy(policy)
Parameter
policyOptional-
Ein Objekt mit den folgenden optionalen Eigenschaften:
minHdcpVersionOptional-
Ein String, der die semantische Version der mindestens erforderlichen HDCP-Version angibt, auf deren Verwendbarkeit geprüft werden soll, beispielsweise
1.0,1.4,2.2oder2.3.
Hinweis:
Es muss mindestens eine Richtlinienbeschränkung angegeben werden. Daher ist minHdcpVersion nur „technisch“ optional.
Rückgabewert
Ein Promise, das mit einem String aufgelöst wird, der angibt, ob der Schlüssel unter der angegebenen Richtlinie zur Entschlüsselung verwendet werden kann.
Der String kann einen der folgenden Werte haben:
usable-
Der Schlüssel kann derzeit zur Entschlüsselung verwendet werden.
expired-
Der Schlüssel kann nicht mehr zur Entschlüsselung verwendet werden, weil seine Gültigkeitsdauer abgelaufen ist.
released-
Der Schlüssel wurde freigegeben und steht dem CDM nicht mehr zur Verfügung. Informationen über den Schlüssel sind jedoch noch verfügbar, beispielsweise ein Nachweis über die Vernichtung der Lizenz.
output-restricted-
Aufgrund der angegebenen Richtlinie gelten für den Schlüssel Ausgabebeschränkungen. Die Wiedergabe von Mediendaten, die mit diesem Schlüssel entschlüsselt wurden, kann blockiert werden. Der Status zeigt an, dass die Verbindung zwischen Quelle und Ausgabegerät (beispielsweise Ihrem Computer und einem externen Bildschirm) nicht als vertrauenswürdig gilt. Dies könnte darauf hindeuten, dass die HDCP-Versionen von Quelle, zwischengeschalteten Geräten und Ausgabegerät nicht übereinstimmen oder dass zwischengeschaltete Verbindungskomponenten wie HDMI-Kabel oder Video-Splitter beschädigt sind oder die Anforderungen nicht erfüllen. Eine Anwendung könnte stattdessen Inhalte verwenden, die keine so hohe HDCP-Version erfordern. Prüfen Sie außerdem, ob zwischengeschaltete Geräte und Kabel HDCP unterstützen, fest angeschlossen und nicht beschädigt sind.
output-downscaled-
Aufgrund der angegebenen Richtlinie gelten für den Schlüssel Ausgabebeschränkungen. Diese könnten jedoch gelockert werden, wenn die Inhalte in geringerer Qualität wiedergegeben werden. Wird dieser Wert zurückgegeben, könnte eine Anwendung die Inhalte mit geringerer Auflösung wiedergeben, eine höhere HDCP-Version verwenden oder andere Inhalte nutzen, die keine so hohe HDCP-Version erfordern.
usable-in-future-
Der Schlüssel kann künftig zur Entschlüsselung verwendet werden, sobald sein Startzeitpunkt 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 diesen Fall nicht selbst beheben.
Ausnahmen
TypeError-
Für
policysind keine Eigenschaften (Richtlinienbeschränkungen) definiert, oder ein Eigenschaftsschlüssel ist ungültig. NotSupportedErrorDOMException-
Das CDM kann den Status für eine oder mehrere der Richtlinienbeschränkungen nicht ermitteln.
Beispiele
Prüfen, ob Schlüssel mit einer HDCP-Beschränkung verwendbar sind
Dieses Beispiel prüft, ob Schlüssel zur Entschlüsselung eines bestimmten Videoformats verwendet werden können, wenn eine HDCP-Version von mindestens 2.2 erforderlich ist.
Hinweis:
Der Status output-restricted kann bei Verwendung eines externen Bildschirms durch Inkompatibilitäten der Hardware mit HDCP verursacht werden.
Wenn Sie einen Laptop verwenden, können Sie das Problem möglicherweise beheben, indem Sie den externen Bildschirm trennen.
HTML
<pre id="log"></pre>
JavaScript
const config = [
{
videoCapabilities: [
{
contentType: 'video/mp4; codecs="avc1.640028"',
encryptionScheme: "cenc",
robustness: "SW_SECURE_DECODE", // Widevine L3
},
],
},
];
getMediaStatus(config);
async function getMediaStatus(config) {
try {
const mediaKeySystemAccess = await navigator.requestMediaKeySystemAccess(
"com.widevine.alpha",
config,
);
const mediaKeys = await mediaKeySystemAccess.createMediaKeys();
const mediaStatus = await mediaKeys.getStatusForPolicy({
minHdcpVersion: "2.2",
});
log(mediaStatus);
// Get the content or fallback to an alternative if the
// keys are not usable
if (mediaStatus === "usable") {
console.log("HDCP 2.2 can be enforced.");
// Fetch the high resolution protected content
} else {
log("HDCP 2.2 cannot be enforced");
// Fallback other content, get license, etc.
}
} catch (error) {
log(error);
}
}
Ergebnisse
Spezifikationen
| Spezifikation |
|---|
| Encrypted Media Extensions # dom-mediakeys-getstatusforpolicy |