MediaKeyStatusMap: get() 方法

Baseline 已廣泛支援

此功能已成熟,並可在多種裝置和瀏覽器版本上執行。自 2019 年 3 月以來,它已在所有瀏覽器中可用。

安全上下文: 此功能僅在安全上下文(HTTPS)中可用,且支援此功能的瀏覽器數量有限。

get() 方法是 MediaKeyStatusMap 介面的一部分,它返回與給定金鑰關聯的狀態值,如果不存在則返回 undefined

狀態值指示特定金鑰是否可用於解密。

語法

js
get(key)

引數

key

你想返回其值的金鑰。

返回值

一個字串,指定與給定金鑰關聯的狀態值,或者 undefined

允許的狀態值如下:

usable

當前金鑰可用於解密。

expired

金鑰由於已過有效期而不再可用於解密。

released

金鑰已釋放,不再可供 CDM 使用。但金鑰的相關資訊仍然可用,例如許可證銷燬記錄。

output-restricted

基於指定的策略,金鑰存在輸出限制。使用此金鑰解密的媒體資料可能會被阻止顯示。該狀態表明源與輸出(例如,您的計算機和外部顯示器)之間的連線不受信任。這可能表明源、中間裝置和輸出之間存在 HDCP 版本不匹配,或者 HDMI 線纜或影片分配器等中間連線裝置已損壞或不合規。應用程式可以選擇使用更高版本的 HDCP,或使用不需要那麼高版本 HDCP 的內容。您還應檢查中間裝置和線纜是否支援 HDCP、連線是否牢固以及是否損壞。

output-downscaled

基於指定的策略,金鑰存在輸出限制,但如果內容以較低的質量播放,則這些限制可能會放寬。如果返回此值,應用程式可以較低的解析度播放內容,或者可以選擇使用更高版本的 HDCP,或者使用其他不需要那麼高 HDCP 版本的內容。

usable-in-future

一旦達到開始時間,金鑰將變得可用於將來的解密。

status-pending

金鑰的狀態尚未確定,正在評估中。

internal-error

由於 CDM 內部錯誤,金鑰當前不可用於解密。應用程式無法處理此情況。

規範

規範
加密媒體擴充套件
# dom-mediakeystatusmap-get

瀏覽器相容性