MediaKeyStatusMap: get() 方法

安全上下文:此功能仅在安全上下文(HTTPS)中,以及在某些或所有支持的浏览器中可用。

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 表仅在浏览器中加载