forked from w3c/encrypted-media
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathkeyids-format-respec.html
121 lines (99 loc) · 5.3 KB
/
keyids-format-respec.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Key IDs Initialization Data</title>
<script src="https://www.w3.org/Tools/respec/respec-w3c-common" class="remove"></script>
<script src="encrypted-media.js" class="remove"></script>
<script class="remove">
var respecConfig = {
// specification status (e.g. WD, LCWD, NOTE, etc.). If in doubt use ED.
specStatus: "ED",
// the specification's short name, as in http://www.w3.org/TR/short-name/
shortName: "encrypted-media", <!-- The registry does not have its own short name. -->
// if there a publicly available Editor's Draft, this is the link
edDraftURI: "https://w3c.github.io/encrypted-media/keyids-format.html",
// if this is a LCWD, uncomment and set the end of its review period
// lcEnd: "2009-08-05",
// editors, add as many as you like
// only "name" is required
editors: [
{ name: "David Dorwin", url: "",
company: "Google Inc.", companyURL: "https://www.google.com/" },
{ name: "Adrian Bateman", url: "",
company: "Microsoft Corporation", companyURL: "https://www.microsoft.com/" },
{ name: "Mark Watson", url: "",
company: "Netflix Inc.", companyURL: "https://www.netflix.com/" },
],
otherLinks: [
{ key: "Repository",
href: "https://github.com/w3c/encrypted-media/"}
],
emeDefGroupName: "keyids-format",
emeUnusedGroupNameExcludeList: ["encrypted-media",
"eme-references-from-registry"
],
// name of the WG
wg: "HTML Working Group",
// URI of the public WG page
wgURI: "http://www.w3.org/html/wg/",
// name (without the @w3c.org) of the public mailing to which comments are due
wgPublicList: "public-html-media",
// URI of the patent status for this WG, for Rec-track documents
// !!!! IMPORTANT !!!!
// This is important for Rec-track documents, do not copy a patent URI from a random
// document unless you know what you're doing. If in doubt ask your friendly neighbourhood
// Team Contact.
wgPatentURI: "https://www.w3.org/2004/01/pp-impl/40318/status",
noIDLIn: true,
scheme: "https",
preProcess: [ encryptedMediaPreProcessor ],
// Empty definitions for objects declared in the document are here to
// prevent error messages from being displayed for references to these objects.
definitionMap: {},
postProcess: [ encryptedMediaPostProcessor ],
};
</script>
<!-- script to register bugs -->
<script src="https://w3c.github.io/webcomponents/assets/scripts/bug-assist.js"></script>
<meta name="bug.product" content="HTML WG">
<meta name="bug.component" content="Encrypted Media Extensions">
<link rel="stylesheet" href="eme.css">
</head>
<body>
<section id="abstract">
<p>This specification defines a container-independent initialization data format for specifying a list of <a def-id="key-id"></a>(s) to the <a def-id="createSession"></a> method defined by the <a def-id="eme-spec"></a>.
This type can be used by applications to directly provide information necessary to generate a license request without using media data or constructing container-specific formats.
</p>
<p>Unlike other similar specifications, this one does not document a stream format or behavior related to processing media data. This type and format are not used in the <a def-id="initdata-encountered-algorithm"></a>.</p>
</section>
<section id="sotd">
<p>The Working Group maintains <a href="https://www.w3.org/brief/MjY5"> a list of all bug reports that the editors have not yet tried to address</a>.</p>
<p>Implementors should be aware that this specification is not stable. <strong>Implementors who are not taking part in the discussions are likely to find the specification changing out from under them in incompatible ways.</strong> Vendors interested in implementing this specification before it eventually reaches the Candidate Recommendation stage should join the mailing list mentioned below and take part in the discussions.</p>
</section>
<section id="init-data">
<h2>Initialization Data Format</h2>
<p>The format is a JSON object containing the following member:</p>
<dl>
<dt>"kids"</dt>
<dd>An array of <a def-id="key-id"></a>(s). Each element of the array is the base64url encoding of the octet sequence containing the key ID value.</dd>
</dl>
<p class="note">See <a def-id="using-base64url"></a>.</p>
<p>When passed to the <a def-id="update"></a> method as the Uint8Array <var>response</var> parameter, the JSON string must be encoded in UTF-8 as specified in the Encoding specification [[!encoding]].
Applications may encode the JSON string using the <a def-id="interface-textencoder"></a> [[!encoding]].
</p>
<section class="informative">
<h2>Example</h2>
<p>The following example will generate a license request for two <a def-id="key-id"></a>(s). (Line breaks are for readability only.)</p>
<pre class="example">
{
"kids":
[
"67ef0gd8pvfd0",
"77ef0gd8pvfd0"
],
}</pre>
</section>
</section>
</body>
</html>