MediaKeyStatusMap: get() 方法
MediaKeyStatusMap
接口的 get()
方法返回与给定键关联的状态值,如果不存在则返回 undefined
。
状态值指示特定密钥是否可用于解密。
语法
js
get(key)
参数
key
-
您要返回其值的密钥。
返回值
一个字符串,指定与给定键关联的状态值,或 undefined
。
以下状态值是允许的
usable
-
密钥当前可用于解密。
expired
-
密钥不再可用于解密,因为其到期时间已过。
released
-
密钥已释放,不再可供 CDM 使用。但是,有关密钥的信息(如许可证销毁记录)仍然可用。
output-restricted
-
根据指定的策略,密钥存在输出限制。使用此密钥解密的媒体数据可能被阻止呈现。状态表明源与输出(例如,您的计算机和外部显示器)之间的连接不可信。这可能表示源、中间设备和输出之间存在 HDCP 版本不匹配,或者中间连接设备(如 HDMI 电缆或视频分配器)已损坏或不符合标准。应用程序可以选择使用更高版本的 HDCP、不需要如此高版本的内容。您还应检查中间设备和电缆是否支持 HDCP、连接牢固且没有损坏。
output-downscaled
-
根据指定的策略,密钥存在输出限制,但是如果内容以较低质量播放,则这些限制可能会放宽。如果返回此值,应用程序可能会以较低分辨率播放内容,或者可以选择使用更高版本的 HDCP,或者使用不需要如此高版本的 HDCP 的其他内容。
usable-in-future
-
一旦达到密钥的开始时间,密钥将在将来可用于解密。
status-pending
-
密钥的状态尚不清楚,正在确定中。
internal-error
-
由于 CDM 中的错误,密钥当前不可用于解密。应用程序无法执行任何操作来处理这种情况。
规范
规范 |
---|
加密媒体扩展 # dom-mediakeystatusmap-get |
浏览器兼容性
BCD 表仅在浏览器中加载