MediaKeys: getStatusForPolicy()-Methode

policy Optional

Ein Objekt mit den folgenden optionalen Eigenschaften:

minHdcpVersion Optional

Ein String, der die semantische Version der minimalen HDCP-Version angibt, die auf Gebrauchstauglichkeit geprüft werden soll, wie z.B. 1.0, 1.4, 2.2, 2.3.

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 ist momentan für die Entschlüsselung verwendbar.

expired

Der Schlüssel ist nicht mehr für die Entschlüsselung verwendbar, da seine Ablaufzeit überschritten ist.

released

Der Schlüssel wurde freigegeben und steht dem CDM nicht mehr zur Verfügung. Informationen über den Schlüssel sind jedoch verfügbar, wie z.B. ein Protokoll der Lizenzvernichtung.

output-restricted

Es gibt Ausgabebeschränkungen, die mit dem Schlüssel verbunden sind, basierend auf der spezifizierten Richtlinie. Mediendaten, die mit diesem Schlüssel entschlüsselt wurden, könnten von der Wiedergabe ausgeschlossen werden. Der Status zeigt an, dass die Verbindung zwischen Quelle und Ausgabe (zum Beispiel Ihr Computer und ein externer Bildschirm) nicht vertrauenswürdig ist. Dies könnte auf HDCP-Versionsunterschiede zwischen Quelle, Zwischen- und Ausgabegeräten hinweisen oder darauf, dass Zwischenverbindungsvorrichtungen wie HDMI-Kabel oder Video-Splitter beschädigt oder nicht konform sind. Eine Anwendung könnte sich dafür entscheiden, eine höhere HDCP-Version zu verwenden oder Inhalte zu wählen, die keine so hohe Version erfordern. Sie sollten auch überprüfen, ob Zwischenkomponenten und Kabel HDCP unterstützen, fest verbunden und unbeschädigt sind.

output-downscaled

Es gibt Ausgabebeschränkungen, die mit dem Schlüssel verbunden sind, basierend auf der spezifizierten Richtlinie, aber diese Beschränkungen könnten gelockert werden, wenn der Inhalt in geringerer Qualität wiedergegeben wird. Wenn dieser Wert zurückgegeben wird, könnte eine Anwendung den Inhalt in geringerer Auflösung wiedergeben oder eine höhere HDCP-Version nutzen oder andere Inhalte verwenden, die keine so hohe HDCP-Version erfordern.

usable-in-future

Der Schlüssel wird in Zukunft für die Entschlüsselung verwendbar 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 ist momentan nicht für die Entschlüsselung verwendbar aufgrund eines Fehlers im CDM. Die Anwendung kann nichts tun, um diesen Fall zu lösen.

TypeError

Die policy hat keine definierten Eigenschaften (Richtlinienbeschränkungen), oder ein Eigenschaftsschlüssel ist nicht gültig.

NotSupportedError

Das CDM kann den Status für eine oder alle der Richtlinienbeschränkungen nicht bestimmen.

Dieses Beispiel überprüft, ob Schlüssel zur Entschlüsselung eines bestimmten Videoformats verwendbar sind, wenn eine minimale HDCP-Version von 2.2 verwendet wird.

HTML

<pre id="log"></pre>

#log {
  height: 100px;
  overflow: scroll;
  padding: 0.5rem;
  border: 1px solid black;
}

JavaScript

const logElement = document.querySelector("#log");
function log(text) {
  logElement.innerText = `${logElement.innerText}${text}\n`;
  logElement.scrollTop = logElement.scrollHeight;
}

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

• MediaKeyStatusMap.get()