HTMLMediaElement: setMediaKeys() 方法

安全上下文：此功能仅在安全上下文（HTTPS）中可用，在一些或所有支持的浏览器中可用。

setMediaKeys() 方法是 HTMLMediaElement 接口的方法，它设置 MediaKeys，这些键将在播放期间用于解密媒体。

它返回一个 Promise，如果成功设置新密钥，则该 Promise 将完成，如果无法设置密钥，则该 Promise 将拒绝。

语法

js
setMediaKeys(mediaKeys)

参数

mediaKeys

一个 MediaKeys 对象，HTMLMediaElement 可以使用它在播放期间解密媒体数据。

返回值

一个 Promise，它使用 undefined 完成。

异常

返回的 Promise 可能拒绝错误

InvalidStateError DOMException

媒体密钥正在被附加，或者之前的密钥无法在当前时间被移除（例如，因为特定的实现不允许在播放期间移除）。

QuotaExceededError DOMException

传递的密钥已在另一个元素中使用，或者浏览器由于其他原因无法将其用于此元素。

NotSupportedError DOMException

当前与媒体关联的媒体密钥无法分离，因为 CDM 或浏览器不支持此操作。

规范

规范
加密媒体扩展
# dom-htmlmediaelement-setmediakeys

浏览器兼容性

BCD 表格仅在浏览器中加载