Skip to content

Commit 9984f89

Browse files
Update Video Frame Metadata registration requirements (#924)
SHA: d10c7d0 Reason: push, by Djuffin Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
1 parent bd89952 commit 9984f89

1 file changed

Lines changed: 63 additions & 42 deletions

File tree

video_frame_metadata_registry.html

Lines changed: 63 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -5,9 +5,9 @@
55
<title>WebCodecs VideoFrame Metadata Registry</title>
66
<meta content="ED" name="w3c-status">
77
<link href="https://www.w3.org/StyleSheets/TR/2021/W3C-ED" rel="stylesheet">
8-
<meta content="Bikeshed version 9a7a6709a, updated Tue May 27 16:45:34 2025 -0700" name="generator">
8+
<meta content="Bikeshed version 0ef803fdf, updated Tue Jan 6 11:59:39 2026 -0800" name="generator">
99
<link href="https://www.w3.org/TR/webcodecs-video-frame-metadata-registry/" rel="canonical">
10-
<meta content="2fcb55883a2ed677f80e203633658835bd4be2e2" name="revision">
10+
<meta content="d10c7d08460c11c3968ce87efdf679a43a74d585" name="revision">
1111
<meta content="dark light" name="color-scheme">
1212
<link href="https://www.w3.org/StyleSheets/TR/2021/dark.css" media="(prefers-color-scheme: dark)" rel="stylesheet" type="text/css">
1313
<style>/* Boilerplate: style-autolinks */
@@ -320,7 +320,7 @@
320320
}
321321
.invalid.example:not(.no-marker)::before,
322322
.illegal.example:not(.no-marker)::before {
323-
content: "Invalid Example" counter(example);
323+
content: "Invalid Example " counter(example);
324324
}
325325

326326
figcaption {
@@ -567,9 +567,13 @@
567567
</style>
568568
<body class="h-entry">
569569
<div class="head">
570-
<p data-fill-with="logo"><a class="logo" href="https://www.w3.org/"> <img alt="W3C" height="48" src="https://www.w3.org/StyleSheets/TR/2021/logos/W3C" width="72"> </a> </p>
571-
<h1 class="p-name no-ref" id="title">WebCodecs VideoFrame Metadata Registry</h1>
572-
<p id="w3c-state"><a href="https://www.w3.org/standards/types/#ED">Editor’s Draft</a>, <time class="dt-updated" datetime="2025-06-09">9 June 2025</time></p>
570+
<p data-fill-with="logo"><a class="logo" href="https://www.w3.org/">
571+
<img alt="W3C" height="48" src="https://www.w3.org/StyleSheets/TR/2021/logos/W3C" width="72">
572+
</a>
573+
</p>
574+
<h1 class="no-ref p-name" id="title">WebCodecs VideoFrame Metadata Registry</h1>
575+
<p id="w3c-state"><a href="https://www.w3.org/standards/types/#ED">Editor’s Draft</a>,
576+
<time class="dt-updated" datetime="2026-04-14">14 April 2026</time></p>
573577
<details open>
574578
<summary>More details about this document</summary>
575579
<div data-fill-with="spec-metadata">
@@ -581,7 +585,7 @@ <h1 class="p-name no-ref" id="title">WebCodecs VideoFrame Metadata Registry</h1>
581585
<dt>Feedback:
582586
<dd><a href="https://github.com/w3c/webcodecs/issues/">GitHub</a>
583587
<dt class="editor">Editor:
584-
<dd class="editor p-author h-card vcard" data-editor-id="96458"><a class="p-name fn u-email email" href="mailto:youenn@apple.com">Youenn Fablet</a> (<span class="p-org org">Apple Inc.</span>)
588+
<dd class="editor h-card p-author vcard" data-editor-id="96458"><a class="email fn p-name u-email" href="mailto:youenn@apple.com">Youenn Fablet</a> (<span class="org p-org">Apple Inc.</span>)
585589
<dt>Participate:
586590
<dd><a href="https://github.com/w3c/webcodecs">Git Repository.</a>
587591
<dd><a href="https://github.com/w3c/webcodecs/issues/new">File an issue.</a>
@@ -591,31 +595,47 @@ <h1 class="p-name no-ref" id="title">WebCodecs VideoFrame Metadata Registry</h1>
591595
</div>
592596
</details>
593597
<div data-fill-with="warning"></div>
594-
<p class="copyright" data-fill-with="copyright"><a href="https://www.w3.org/policies/#copyright">Copyright</a> © 2025 <a href="https://www.w3.org/">World Wide Web Consortium</a>. <abbr title="World Wide Web Consortium">W3C</abbr><sup>®</sup> <a href="https://www.w3.org/policies/#Legal_Disclaimer">liability</a>, <a href="https://www.w3.org/policies/#W3C_Trademarks">trademark</a> and <a href="https://www.w3.org/copyright/software-license/" rel="license" title="W3C Software and Document License">permissive document license</a> rules apply. </p>
598+
<p class="copyright" data-fill-with="copyright"><a href="https://www.w3.org/policies/#copyright">Copyright</a> © 2026 <a href="https://www.w3.org/">World Wide Web Consortium</a>. <abbr title="World Wide Web Consortium">W3C</abbr><sup>®</sup> <a href="https://www.w3.org/policies/#Legal_Disclaimer">liability</a>, <a href="https://www.w3.org/policies/#W3C_Trademarks">trademark</a> and <a href="https://www.w3.org/copyright/software-license/" rel="license" title="W3C Software and Document License">permissive document license</a> rules apply.
599+
</p>
595600
<hr title="Separator for header">
596601
</div>
597602
<div class="p-summary" data-fill-with="abstract">
598-
<h2 class="no-num no-toc no-ref heading settled" id="abstract"><span class="content">Abstract</span></h2>
603+
<h2 class="heading no-num no-ref no-toc settled" id="abstract"><span class="content">Abstract</span></h2>
599604
<p>This registry is intended to enumerate the metadata fields that can be attached
600605
to <code class="idl"><a data-link-type="idl" href="https://w3c.github.io/webcodecs/#videoframe" id="ref-for-videoframe">VideoFrame</a></code> objects via the <code class="idl"><a data-link-type="idl" href="https://w3c.github.io/webcodecs/#dictdef-videoframemetadata" id="ref-for-dictdef-videoframemetadata">VideoFrameMetadata</a></code> dictionary.</p>
601606
</div>
602-
<h2 class="no-num no-toc no-ref heading settled" id="sotd"><span class="content">Status of this document</span></h2>
607+
<h2 class="heading no-num no-ref no-toc settled" id="sotd"><span class="content">Status of this document</span></h2>
603608
<div data-fill-with="status">
604-
<p> <em>This section describes the status of this document at the time of its publication. A list of current <abbr title="World Wide Web Consortium">W3C</abbr> publications and the latest revision of this technical report can be found in the <a href="https://www.w3.org/TR/"><abbr title="World Wide Web Consortium">W3C</abbr> standards and drafts index</a> at https://www.w3.org/TR/.</em> </p>
605-
<p> Feedback and comments on this specification are welcome. <a href="https://github.com/w3c/webcodecs/issues">GitHub Issues</a> are preferred for discussion on this specification. Alternatively, you can send comments to the Media Working Group’s mailing-list, <a href="mailto:public-media-wg@w3.org">public-media-wg@w3.org</a> (<a href="https://lists.w3.org/Archives/Public/public-media-wg/">archives</a>).
609+
<p>
610+
<em>This section describes the status of this document at the time of its publication. A list of current <abbr title="World Wide Web Consortium">W3C</abbr> publications and the latest revision of this technical report can be found in the <a href="https://www.w3.org/TR/"><abbr title="World Wide Web Consortium">W3C</abbr> standards and drafts index</a>.</em>
611+
</p>
612+
<p>
613+
Feedback and comments on this specification are welcome.
614+
<a href="https://github.com/w3c/webcodecs/issues">GitHub Issues</a> are preferred for discussion on this specification. Alternatively, you can send comments to the Media Working Group’s mailing-list, <a href="mailto:public-media-wg@w3.org">public-media-wg@w3.org</a> (<a href="https://lists.w3.org/Archives/Public/public-media-wg/">archives</a>).
606615
This draft highlights some of the pending issues that are still to be discussed in the working group.
607-
No decision has been taken on the outcome of these issues including whether they are valid. </p>
608-
<p> This document was published by the <a href="https://www.w3.org/groups/wg/media/">Media Working Group</a> as an Editor’s Draft.
609-
This document is intended to become a <abbr title="World Wide Web Consortium">W3C</abbr> Recommendation. </p>
610-
<p> Publication as an Editor’s Draft does not imply endorsement by <abbr title="World Wide Web Consortium">W3C</abbr> and its Members. </p>
611-
<p> This document was produced by a group operating under the <a class="css" data-link-type="property" href="https://www.w3.org/policies/patent-policy/" id="sotd_patent">W3C Patent Policy</a>. <abbr title="World Wide Web Consortium">W3C</abbr> maintains a <a href="https://www.w3.org/groups/wg/media/ipr" rel="disclosure">public list of any patent disclosures</a> made in connection with the deliverables of the group; that page also includes instructions for disclosing a patent. An individual who has actual knowledge of a patent which the individual believes contains <a href="https://www.w3.org/policies/patent-policy/#def-essential">Essential Claim(s)</a> must disclose the information in accordance with <a href="https://www.w3.org/policies/patent-policy/#sec-Disclosure">section 6 of the <abbr title="World Wide Web Consortium">W3C</abbr> Patent Policy</a>. </p>
612-
<p> This document is governed by the <a href="https://www.w3.org/policies/process/20231103/" id="w3c_process_revision">03 November 2023 W3C Process Document</a>. </p>
616+
No decision has been taken on the outcome of these issues including whether they are valid.
617+
</p>
618+
<p>
619+
This document was published by the <a href="https://www.w3.org/groups/wg/media/">Media Working Group</a> as an Editor’s Draft.
620+
This document is intended to become a <abbr title="World Wide Web Consortium">W3C</abbr> Recommendation.
621+
</p>
622+
<p>
623+
Publication as an Editor’s Draft does not imply endorsement by
624+
<abbr title="World Wide Web Consortium">W3C</abbr> and its Members.
625+
</p>
626+
<p>
627+
This document was produced by a group operating under the <a class="css" data-link-type="property" href="https://www.w3.org/policies/patent-policy/" id="sotd_patent">W3C Patent Policy</a>.
628+
<abbr title="World Wide Web Consortium">W3C</abbr> maintains a <a href="https://www.w3.org/groups/wg/media/ipr" rel="disclosure">public list of any patent disclosures</a> made in connection with the deliverables of the group; that page also includes instructions for disclosing a patent. An individual who has actual knowledge of a patent that the individual believes contains <a href="https://www.w3.org/policies/patent-policy/#def-essential">Essential Claim(s)</a> must disclose the information in accordance with <a href="https://www.w3.org/policies/patent-policy/#sec-Disclosure">section 6 of the <abbr title="World Wide Web Consortium">W3C</abbr> Patent Policy</a>.
629+
</p>
630+
<p>
631+
This document is governed by the <a href="https://www.w3.org/policies/process/20250818/" id="w3c_process_revision">18 August 2025 W3C Process Document</a>.
632+
</p>
613633
<p></p>
614634
</div>
615635
<div data-fill-with="at-risk"></div>
616636
<nav data-fill-with="table-of-contents" id="toc">
617-
<h2 class="no-num no-toc no-ref" id="contents">Table of Contents</h2>
618-
<ol class="toc" role="directory">
637+
<h2 class="no-num no-ref no-toc" id="contents">Table of Contents</h2>
638+
<ol class="toc">
619639
<li><a href="#registration-entry-requirements"><span class="secno">1</span> <span class="content">Registration Entry Requirements</span></a>
620640
<li><a href="#videoframemetadata-members"><span class="secno">2</span> <span class="content">VideoFrameMetadata members</span></a>
621641
<li><a href="#privacy-considerations"><span class="secno">3</span> <span class="content">Privacy Considerations</span></a>
@@ -634,11 +654,20 @@ <h2 class="no-num no-toc no-ref" id="contents">Table of Contents</h2>
634654
</nav>
635655
<main>
636656
<h2 class="heading settled" data-level="1" id="registration-entry-requirements"><span class="secno">1. </span><span class="content">Registration Entry Requirements</span><a class="self-link" href="#registration-entry-requirements"></a></h2>
637-
<p>A registration entry is a document describing one or several metadata entries,
638-
and has the following requirements:</p>
657+
<p>To register an entry, file an issue in the
658+
<a href="https://github.com/w3c/webcodecs/issues/">WebCodecs GitHub issue tracker</a>
659+
so it can be discussed and evaluated for compliance before being added to
660+
the registry.</p>
661+
<p>For the entry to be included, there needs to be interest from at least
662+
one implementer in either the Media Working Group or the Working Group that
663+
originated the registration entry specification. If the Media Working Group
664+
reaches consensus to accept the candidate entry, send a pull request
665+
(either by editors or by the party requesting the candidate registration)
666+
that meets the following requirements:</p>
639667
<ol>
640668
<li data-md>
641-
<p>Each metadata entry is defined as a separate <code class="idl"><a data-link-type="idl" href="https://w3c.github.io/webcodecs/#dictdef-videoframemetadata" id="ref-for-dictdef-videoframemetadata①">VideoFrameMetadata</a></code> dictionary member.</p>
669+
<p>Each metadata entry is defined as a separate <code class="idl"><a data-link-type="idl" href="https://w3c.github.io/webcodecs/#dictdef-videoframemetadata" id="ref-for-dictdef-videoframemetadata①">VideoFrameMetadata</a></code>
670+
dictionary member.</p>
642671
<li data-md>
643672
<p>Each metadata entry must be serializable.</p>
644673
<li data-md>
@@ -648,23 +677,15 @@ <h2 class="heading settled" data-level="1" id="registration-entry-requirements">
648677
<p>The specification defining each metadata entry must provide clearly defined
649678
semantics. In particular, interactions with the media processing pipeline
650679
(encoders, decoders, renderers, etc.) should be well defined.</p>
651-
<li data-md>
652-
<p>A candidate registration entry must be announced by filing an issue in the
653-
WebCodecs GitHub issue tracker so they can be discussed and evaluated for
654-
compliance before being added to the registry. If the Media Working Group
655-
reaches consensus to accept the candidate, a pull request should be drafted
656-
(either by editors or by the party requesting the candidate registration)
657-
to register the candidate. The registry editors will review and merge the
658-
pull request.</p>
659-
<li data-md>
660-
<p>Existing entries may be changed after being published, through the same
661-
process as candidate entries. Possible changes include modification of
662-
the link to the public specification.</p>
663-
<li data-md>
664-
<p>Existing entries may be deprecated. This requires Media Working Group
680+
</ol>
681+
<p>Once consensus is reached by the Media Working Group, the registry editors
682+
will review and merge the pull request.</p>
683+
<p>Existing entries may be changed after being published, through the same
684+
process as candidate entries. Possible changes include modification of the
685+
link to the public specification.</p>
686+
<p>Existing entries may be deprecated. This requires Media Working Group
665687
consensus, and if still active, consensus of the Working Group that
666688
originated the registration entry specification.</p>
667-
</ol>
668689
<h2 class="heading settled" data-level="2" id="videoframemetadata-members"><span class="secno">2. </span><span class="content">VideoFrameMetadata members</span><a class="self-link" href="#videoframemetadata-members"></a></h2>
669690
<table class="data">
670691
<tbody>
@@ -698,8 +719,8 @@ <h2 class="heading settled" data-level="4" id="security-considerations"><span cl
698719
Considerations</a> in <a data-link-type="biblio" href="#biblio-webcodecs" title="WebCodecs">[WEBCODECS]</a>.</p>
699720
</main>
700721
<script src="https://www.w3.org/scripts/TR/2021/fixup.js"></script>
701-
<h2 class="no-num no-ref heading settled" id="index"><span class="content">Index</span><a class="self-link" href="#index"></a></h2>
702-
<h3 class="no-num no-ref heading settled" id="index-defined-elsewhere"><span class="content">Terms defined by reference</span><a class="self-link" href="#index-defined-elsewhere"></a></h3>
722+
<h2 class="heading no-num no-ref settled" id="index"><span class="content">Index</span><a class="self-link" href="#index"></a></h2>
723+
<h3 class="heading no-num no-ref settled" id="index-defined-elsewhere"><span class="content">Terms defined by reference</span><a class="self-link" href="#index-defined-elsewhere"></a></h3>
703724
<ul class="index">
704725
<li>
705726
<a data-link-type="biblio">[WEBCODECS]</a> defines the following terms:
@@ -708,8 +729,8 @@ <h3 class="no-num no-ref heading settled" id="index-defined-elsewhere"><span cla
708729
<li><span class="dfn-paneled" id="40ca5e8e">VideoFrameMetadata</span>
709730
</ul>
710731
</ul>
711-
<h2 class="no-num no-ref heading settled" id="references"><span class="content">References</span><a class="self-link" href="#references"></a></h2>
712-
<h3 class="no-num no-ref heading settled" id="normative"><span class="content">Normative References</span><a class="self-link" href="#normative"></a></h3>
732+
<h2 class="heading no-num no-ref settled" id="references"><span class="content">References</span><a class="self-link" href="#references"></a></h2>
733+
<h3 class="heading no-num no-ref settled" id="normative"><span class="content">Normative References</span><a class="self-link" href="#normative"></a></h3>
713734
<dl>
714735
<dt id="biblio-webcodecs">[WEBCODECS]
715736
<dd>Paul Adenot; Eugene Zemtsov. <a href="https://w3c.github.io/webcodecs/"><cite>WebCodecs</cite></a>. URL: <a href="https://w3c.github.io/webcodecs/">https://w3c.github.io/webcodecs/</a>

0 commit comments

Comments
 (0)