对会话 已知 的 密钥 ID 到关联密钥当前状态的只读映射的引用。每个条目 必须（MUST）具有唯一的密钥 ID。
注
映射条目及其值可能会在每次事件循环旋转时更新。该映射 不得（MUST NOT）出现不一致或部分更新的情况，但如果在两次访问之间事件循环发生了旋转，它在访问之间可能会发生变化。密钥 ID 可能会因 load() 或 update() 的调用而添加。密钥 ID 可能会因删除了现有密钥知识（或用新集合替换现有密钥集合）的 update() 调用而移除。密钥 ID 不得（MUST NOT）因不可用（如由于过期）而被移除。相反，此类密钥 必须（MUST）被赋予适当的状态，如 "expired"。
注
某些较旧的平台可能包含不暴露密钥 ID 的 Key System 实现，使得无法提供符合规范的用户代理实现。在这种情况下，为了最大限度地提高互操作性，映射会填充一个包含单字节密钥 ID 0 和该对象在存在非空列表时最适合聚合状态的 MediaKeyStatus 的对（例如，当该对象表示的 密钥会话 可以包含 密钥 时）。
要迭代的键值对是所有 已知密钥 的 密钥 ID 和关联的 MediaKeyStatus 值所组成的对集合的一个快照，按 密钥 ID 排序。密钥 ID 的比较方式如下：对于长度为 m 的密钥 ID A 和长度为 n 的密钥 ID B（假设 m <= n），当且仅当 A 的 m 个八位字节在字典序中小于 B 的前 m 个八位字节，或者这些八位字节相等且 m < n 时，定义 A < B。
应用辅助个性化是在 CDM 与应用程序（包括应用程序选择的服务器）之间执行的，并产生一个特定于源的标识符。该过程必须通过本规范定义的 API 执行，且不得涉及其他通信方法。与其他 API 的使用方式一样，该过程可以使用一个或多个特征性标识符，但不得使用特征性永久标识符 或非特定于源的值，即使是加密形式。如果该过程 使用了特征性标识符，则结果标识符根据定义也是一个 特征性标识符。
<script>var licenseUrl;
var serverCertificate;
var mediaKeys;
// See the previous example for implementations of these functions.functioncreateSupportedKeySystem() { ... }
functionmakeNewRequest(mediaKeys, initDataType, initData) { ... }
functionlicenseRequestReady(event) { ... }
functionhandleInitData(event) {
makeNewRequest(mediaKeys, event.initDataType, event.initData);
}
createSupportedKeySystem().then(
function(createdMediaKeys) {
mediaKeys = createdMediaKeys;
var video = document.getElementById("v");
video.src = 'foo.webm';
if (serverCertificate)
mediaKeys.setServerCertificate(serverCertificate);
return video.setMediaKeys(mediaKeys);
}
).catch(
console.error.bind(console, 'Failed to create and initialize a MediaKeys object')
);
</script><videoid="v"autoplayonencrypted='handleInitData(event)'></video>
<script>var licenseUrl;
var serverCertificate;
var mediaKeys;
// See the previous examples for implementations of these functions.// createSupportedKeySystem() additionally sets persistentState: "required" in each options dictionary.functioncreateSupportedKeySystem() { ... }
functionsendMessage(message, keySession) { ... }
functionhandleMessage(event) { ... }
// Called if the application does not have a stored sessionId for the media resource.functionmakeNewRequest(mediaKeys, initDataType, initData) {
var keySession = mediaKeys.createSession("persistent-license");
keySession.addEventListener('message', handleMessage, false);
keySession.closed.then(
function(reason) {
console.log('Session', this.sessionId, 'closed, reason', reason);
}.bind(keySession)
);
keySession.generateRequest(initDataType, initData).then(
function() {
// Store this.sessionId in the application.
}.bind(keySession)
).catch(
console.error.bind(console, 'Unable to request a persistent license')
);
}
// Called if the application has a stored sessionId for the media resource.functionloadStoredSession(mediaKeys, sessionId) {
var keySession = mediaKeys.createSession("persistent-license");
keySession.addEventListener('message', handleMessage, false);
keySession.closed.then(
function(reason) {
console.log('Session', this.sessionId, 'closed, reason', reason);
}.bind(keySession)
);
keySession.load(sessionId).then(
function(loaded) {
if (!loaded) {
console.error('No stored session with the ID ' + sessionId + ' was found.');
// The application should remove its record of |sessionId|.return;
}
}
).catch(
console.error.bind(console, 'Unable to load or initialize the stored session with the ID ' + sessionId)
);
}
// Called when the application wants to stop using the session without removing the stored license.functioncloseSession(keySession) {
keySession.close();
}
// Called when the application wants to remove the stored license.// The stored session data has not been completely removed until the promise returned by remove() is fulfilled.// The remove() call may initiate a series of messages to/from the server that must be completed before this occurs.functionremoveStoredSession(keySession) {
keySession.remove().then(
function() {
console.log('Session ' + this.sessionId + ' removed');
// The application should remove its record of this.sessionId.
}.bind(keySession)
).catch(
console.error.bind(console, 'Failed to remove the session')
);
}
// This replaces the implementation in the previous example.functionhandleMessageResponse(keySession, response) {
var license = newUint8Array(response);
keySession.update(license).then(
function() {
// If this was the last required message from the server, the license is// now stored. Update the application state as appropriate.
}
).catch(
console.error.bind(console, 'update() failed')
);
}
createSupportedKeySystem().then(
function(createdMediaKeys) {
mediaKeys = createdMediaKeys;
var video = document.getElementById("v");
if (serverCertificate)
mediaKeys.setServerCertificate(serverCertificate);
return video.setMediaKeys(mediaKeys);
}
).catch(
console.error.bind(console, 'Failed to create and initialize a MediaKeys object')
);
</script><videoid='v'src='foo.webm'autoplay></video>
HTML 标准. Anne van Kesteren; Domenic Denicola; Dominic Farolino; Ian Hickson; Philip Jägenstedt; Simon Pieters. WHATWG. 活标准. URL: https://html.whatwg.cn/multipage/
