MediaKeys

MediaKeys对象代表一组密钥，关联的HTMLMediaElement可以在播放期间使用这些密钥解密媒体数据。它还代表一个CDM实例。

有关更多信息，请参阅https://www.w3.org/TR/encrypted-media/#mediakeys-interface。

方法

createSession()

createSession(sessionType?: MediaKeySessionType | undefined): MediaKeySession

创建一个新的MediaKeySession对象。

有关更多信息，请参阅https://www.w3.org/TR/encrypted-media/#dom-mediakeys-createsession。

参数

sessionType?

MediaKeySessionType | undefined

要创建的会话的类型。会话类型会影响返回对象的行为。

返回值

MediaKeySession

---

setServerCertificate()

setServerCertificate(serverCertificate: ArrayBuffer): Promise<boolean>

提供服务器证书，用于加密发往许可证服务器的消息。

有关更多信息，请参阅https://www.w3.org/TR/encrypted-media/#dom-mediakeys-setservercertificate。

参数

serverCertificate

ArrayBuffer

服务器证书。内容专门针对密钥系统。它不得包含可执行代码。Promise 当成功设置证书时解析。如果失败则拒绝。

返回值

Promise<boolean>

---

getStatusForPolicy()

getStatusForPolicy(policy?: MediaKeysPolicy | undefined): Promise<MediaKeyStatus>

返回给定MediaKeysPolicy的MediaKeyStatus。

有关更多信息，请参阅https://www.w3.org/TR/encrypted-media/#dom-mediakeys-getstatusforpolicy。

参数

policy?

MediaKeysPolicy | undefined

返回值

Promise<MediaKeyStatus>

---

Last updated: 2026年7月22日