MediaKeySession

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

MediaKeySession接口是加密媒体扩展 API的一部分,它表示与内容解密模块(CDM)交换消息的上下文。

EventTarget MediaKeySession

实例属性

MediaKeySession.closed 只读

返回一个Promise,该承诺在MediaKeySession关闭时发出信号。此承诺只能被履行,永远不会被拒绝。关闭会话意味着与之关联的许可证和密钥不再对解密媒体数据有效。

MediaKeySession.expiration 只读

当前会话中的密钥不再可用于解密媒体数据的时间,或者如果不存在此类时间,则为NaN。此值由 CDM 确定,以自 1970 年 1 月 1 日 UTC 以来的毫秒数为单位测量。此值可能会在会话生命周期内发生变化,例如,当某个操作触发窗口启动时。

MediaKeySession.keyStatuses 只读

包含对当前会话的密钥及其状态的只读MediaKeyStatusMap的引用。

MediaKeySession.sessionId 只读

包含 CDM 为当前媒体对象及其关联的密钥或许可证生成的唯一字符串。

事件

keystatuseschange

当会话中的密钥或其状态发生变化时触发。

message

当内容解密模块为会话生成消息时触发。

实例方法

MediaKeySession.close()

在通知当前媒体会话不再需要以及 CDM 应该释放与该对象关联的任何资源并将其关闭后返回一个Promise

MediaKeySession.generateRequest()

在根据初始化数据生成媒体请求后返回一个Promise

MediaKeySession.load()

在加载指定会话对象的 data 后返回一个Promise,该承诺解析为布尔值。

MediaKeySession.remove()

在删除与当前对象关联的任何会话数据后返回一个Promise

MediaKeySession.update()

在将消息和许可证加载到 CDM 后返回一个Promise

示例

js
// TBD

规范

规范
加密媒体扩展
# mediakeysession-interface

浏览器兼容性

BCD 表格仅在浏览器中加载