Skip to content

Commit 6d66b0f

Browse files
committed
Silence Bikeshed warnings
1 parent ff612a0 commit 6d66b0f

File tree

3 files changed

+154
-1281
lines changed

3 files changed

+154
-1281
lines changed

Makefile

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,5 @@
11
index.html: index.bs
22
curl https://api.csswg.org/bikeshed/ -F [email protected] > index.html
3+
4+
check: index.bs
5+
curl https://api.csswg.org/bikeshed/ -F [email protected] -F output=err

index.bs

Lines changed: 34 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -2,23 +2,30 @@
22
Title: WebRTC Insertable Media using Streams
33
Shortname: webrtc-media-streams
44
Level: 1
5-
Status: ED
5+
Status: DREAM
66
Group: webrtc
77
Repository: alvestrand/webrtc-media-streams/
88
URL: https://alvestrand.github.io/webrtc-media-streams/
99
Editor: Harald Alvestrand, Google https://google.com, [email protected]
1010
Abstract: This API defines an API surface for manipulating the bits on
1111
Abstract: MediaStreamTracks being sent via an RTCPeerConnection.
12-
Markup Shorthands: css no
12+
Markup Shorthands: css no, markdown yes
1313
</pre>
1414
<pre class='anchors'>
1515
spec: WEBRTC; urlPrefix: https://w3c.github.io/webrtc-pc/
1616
type: interface
17-
for: RTCRtpEncodingParameters; text: RTCRtpEncodingParameters; url: #dom-rtcrtpencodingparameters
18-
type: enum
19-
text: RTCPriorityType; url: #dom-rtcprioritytype
20-
type: attribute
21-
for: RTCRtpEncodingParameters; text: priority; url: #dom-rtcrtpencodingparameters-priority
17+
text: RTCPeerConnection; url: #dom-rtcpeerconnection
18+
type: dictionary
19+
text: RTCConfiguration; url: #dom-rtcconfiguration
20+
spec: WEB-CODECS; urlPrefix: https://github.com/WICG/web-codecs/
21+
type: interface
22+
text: AudioEncoder; url: #dom-audioencoder
23+
type: interface
24+
text: AudioDecoder; url: #dom-audiodecoder
25+
type: interface
26+
text: VideoEncoder; url: #dom-videoencoder
27+
type: interface
28+
text: VideoDecoder; url: #dom-videodecoder
2229
</pre>
2330
<pre class=biblio>
2431
{
@@ -30,7 +37,7 @@ spec: WEBRTC; urlPrefix: https://w3c.github.io/webrtc-pc/
3037
}
3138
</pre>
3239

33-
# Introduction
40+
# Introduction {#introduction}
3441

3542
The [[WEBRTC-NV-USE-CASES]] document describes several functions that
3643
can only be achieved by access to media (requirements N20-N22),
@@ -50,26 +57,39 @@ This specification gives an interface that builds on [[WEB-CODECS]] to
5057
provide access to such functionality while retaining the setup flow of
5158
RTCPeerConnection.
5259

60+
# Terminology {#terminology}
5361

54-
# IDL specification
62+
<p noexport>
63+
The IDL terms <dfn type="idl-name">AudioEncoder</dfn>, <dfn>VideoEncoder</dfn>,
64+
<dfn>AudioDecoder</dfn>, <dfn>VideoDecoder</dfn> are defined in [[WEB-CODECS]].
65+
</p>
66+
67+
# Specification {#specification}
5568

5669
The Streams definition doesn't use WebIDL much, but the WebRTC spec does.
5770
This specification shows the IDL extensions for WebRTC.
5871

72+
It uses an extension to RTCConfiguration in order to pass the extra
73+
decorators for encoder and decoder initialization to an {{RTCPeerConnection}}.
74+
5975
<pre class='idl'>
6076
typedef (AudioEncoder or VideoEncoder) Encoder;
6177
typedef (AudioDecoder or VideoDecoder) Decoder;
6278

63-
callback EncoderDecorator = Encoder(Encoder encoder, Config config);
64-
callback DecoderDecorator = Decoder(Decoder encoder, Config config);
79+
dictionary Config {
80+
// To Be Defined
81+
};
82+
83+
callback EncoderDecorator = Encoder(Encoder encoder, optional Config config);
84+
callback DecoderDecorator = Decoder(Decoder encoder, optional Config config);
6585

6686
partial dictionary RTCConfiguration {
6787
EncoderDecorator encoderFactory;
6888
DecoderDecorator decoderFactory;
6989
};
7090
</pre>
7191

72-
## Extension operation
92+
## Extension operation {#operation}
7393
At creation of an RTCPeerConnection, the following steps are added to
7494
the creation algorithm:
7595

@@ -94,7 +114,7 @@ the following steps:
94114

95115
The media will then be processed according to the rules of [[WEB-CODECS]].
96116

97-
# Privacy and security considerations
117+
# Privacy and security considerations {#privacy}
98118

99119
This API gives Javascript access to the content of media streams. This
100120
is also available from other sources, such as Canvas and WebAudio.
@@ -104,6 +124,6 @@ However, streams that are isolated (as specified in
104124
accessed using this API, since that would break the isolation rule.
105125

106126

107-
# Examples
127+
# Examples {#examples}
108128

109129

0 commit comments

Comments
 (0)