MediaKeySession
此项代表媒体密钥会话。
有关更多信息，请参阅https://www.w3.org/TR/encrypted-media/#mediakeysession-interface。
扩展
属性
closed
readonlyclosed:Promise<void>
当对象因运行会话关闭算法而关闭时发出信号。
有关更多信息，请参阅https://www.w3.org/TR/encrypted-media/#dom-mediakeysession-closed。
expiration
readonlyexpiration:number
会话中所有密钥的到期时间，或者如果不存在此类时间或许可证明确声明永不过期，则为NaN，由CDM确定。
有关更多信息，请参阅https://www.w3.org/TR/encrypted-media/#dom-mediakeysession-expiration。
keyStatuses
readonlykeyStatuses:MediaKeyStatusMap
对于会话已知的密钥ID到关联密钥当前状态的只读映射的引用。每个条目都有唯一的密钥ID。
有关更多信息，请参阅https://www.w3.org/TR/encrypted-media/#dom-mediakeysession-keystatuses。
onkeystatuseschange()
onkeystatuseschange: (
this,ev) =>any
“keystatuseschange”事件的事件处理程序。
有关更多信息，请参阅https://www.w3.org/TR/encrypted-media/#dom-mediakeysession-onkeystatuseschange。
参数
this
ev
Event
返回值
any
onmessage()
onmessage: (
this,ev) =>any
“message”事件的事件处理程序。
有关更多信息，请参阅https://www.w3.org/TR/encrypted-media/#dom-mediakeysession-onmessage。
参数
this
ev
返回值
any
sessionId
readonlysessionId:string
此对象的会话ID以及相关的密钥或许可证。
有关更多信息，请参阅https://www.w3.org/TR/encrypted-media/#dom-mediakeysession-sessionid。
方法
addEventListener()
调用签名
addEventListener<
K>(type,listener,options?):void
添加事件侦听器。
类型参数
• K extends keyof MediaKeySessionEventMap
参数
type
K
事件的类型。
listener
(this, ev) => any
事件处理程序。
options?
忽略。
boolean |
AddEventListenerOptions |
返回值
void
覆盖
调用签名
addEventListener(
type,listener,options?):void
添加事件侦听器。
参数
type
string
事件的类型。
listener
事件处理程序。
options?
忽略。
boolean |
AddEventListenerOptions |
返回值
void
覆盖
EventTarget.addEventListener
close()
close():
Promise<void>
表示应用不再需要会话，CDM应释放与该会话相关的所有资源并将其关闭。保留的数据不会被释放或清除。
有关更多信息，请参阅https://www.w3.org/TR/encrypted-media/#dom-mediakeysession-close。
返回值
Promise<void>
dispatchEvent()?
optionaldispatchEvent(event):boolean
向目标分发事件
参数
event
发出事件信号的事件。
返回值
boolean
待办事项
在实现中添加和定义，暂时将其保留为可选。
继承自
generateRequest()
generateRequest(
initDataType,initData):Promise<void>
根据initData生成许可证请求。如果算法成功且promise得到解析，则类型为“license-request”或“individualization-request”的消息将始终排在队列中。
有关更多信息，请参阅https://www.w3.org/TR/encrypted-media/#dom-mediakeysession-generaterequest。
参数
initDataType
string
initData的初始化数据类型。
initData
ArrayBuffer
初始化数据。
返回值
Promise<void>
load()
load(
sessionId):Promise<boolean>
将为指定会话存储的数据加载到此对象中。
有关更多信息，请参阅https://www.w3.org/TR/encrypted-media/#dom-mediakeysession-load。
参数
sessionId
string
要加载的会话的会话ID。
返回值
Promise<boolean>
remove()
remove():
Promise<void>
删除与会话关联的所有许可证和密钥。对于持久会话类型，update() 处理了发布消息确认之后，将按照针对每种会话类型的定义清除其他会话数据。
有关更多信息，请参阅https://www.w3.org/TR/encrypted-media/#dom-mediakeysession-remove。
返回值
Promise<void>
removeEventListener()
removeEventListener(
type,listener,options?):void
删除事件侦听器。
参数
type
string
要侦听的事件。
listener
要删除的事件处理程序函数。
options?
忽略。
boolean |
EventListenerOptions |
返回值
void
继承自
EventTarget.removeEventListener
update()
update(
response):Promise<void>
向CDM提供消息，包括许可证。
有关更多信息，请参阅https://www.w3.org/TR/encrypted-media/#dom-mediakeysession-update。
参数
response
ArrayBuffer
将向CDM提供的消息。
返回值
Promise<void>
当方法成功执行时将履行的Promise<void>。
Last updated: 2025年10月2日
