HTMLMediaElement: setMediaKeys() 方法

Baseline 已广泛支持

此功能已成熟，并可在多种设备和浏览器版本上运行。自 2019 年 3 月以来，它已在所有浏览器中可用。

安全上下文： 此功能仅在安全上下文（HTTPS）中可用，且支持此功能的浏览器数量有限。

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

它返回一个 Promise，如果成功设置了新密钥，则该 Promise 会 fulfilled，如果无法设置密钥，则会 rejected。

语法

setMediaKeys(mediaKeys)

一个 Promise，它 fulfilled 为 undefined。

返回的 Promise 可能会因以下原因而 rejection：

InvalidStateError DOMException: 媒体密钥已在附加过程中，或者无法在当前时间移除之前的密钥（例如，因为特定实现不允许在播放期间移除）。
QuotaExceededError: 传入的密钥已被另一个元素使用，或者浏览器由于其他原因无法将其与此元素一起使用。
NotSupportedError DOMException: 当前与媒体关联的媒体密钥无法解除关联，因为 CDM 或浏览器不支持此操作。

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

此页面最后修改于 2025年8月19日，作者为 MDN 贡献者。