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

浏览器兼容性