Skip to content

Commit 286e97d

Browse files
Document MoQ known issue: extra subgroup header field (cloudflare#25132)
* MoQ known issue: extra subgroup header field Document inadvertent divergence from draft-ietf-moq-transport-07 * Update index.mdx minor style updates
1 parent d7cd3bf commit 286e97d

File tree

1 file changed

+30
-0
lines changed

1 file changed

+30
-0
lines changed

src/content/docs/moq/index.mdx

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,3 +24,33 @@ For the most up-to-date documentation on the protocol, please visit the IETF wor
2424
Safari does not yet have fully functional WebTransport support. Apple never publicly commits to timelines for new features like this. However, Apple has indicated their [intent to support WebTransport](https://github.com/WebKit/standards-positions/issues/18#issuecomment-1495890122). An Apple employee is even a co-author of the [WebTransport over HTTP/3](https://datatracker.ietf.org/doc/draft-ietf-webtrans-http3/) draft. Since Safari 18.4 (2025-03-31), an early (not yet fully functional) implementation of the WebTransport API has been available for testing behind a developer-mode / advanced settings feature flag (including on iOS).
2525

2626
Until Safari has a fully functional WebTransport implementation, some MoQ use cases may require a fallback to WebRTC, or, in some cases, WebSockets.
27+
28+
## Known Issues
29+
30+
* Extra Subgroup header field
31+
32+
The current implementation includes a `subscribe_id` field in Subgroup Headers which [`draft-ietf-moq-transport-07`](https://datatracker.ietf.org/doc/html/draft-ietf-moq-transport-07) omits.
33+
34+
In section 7.3.1, `draft-ietf-moq-transport-07` [specifies](https://www.ietf.org/archive/id/draft-ietf-moq-transport-07.html#section-7.3.1):
35+
36+
```txt
37+
STREAM_HEADER_SUBGROUP Message {
38+
Track Alias (i),
39+
Group ID (i),
40+
Subgroup ID (i),
41+
Publisher Priority (8),
42+
}
43+
```
44+
45+
Whereas our implementation expects and produces:
46+
```txt
47+
STREAM_HEADER_SUBGROUP Message {
48+
Subscribe ID (i),
49+
Track Alias (i),
50+
Group ID (i),
51+
Subgroup ID (i),
52+
Publisher Priority (8),
53+
}
54+
```
55+
56+
This was erroroneously left over from a previous draft version and will be fixed in a future release. Thank you to [@yuki-uchida](https://github.com/yuki-uchida) for reporting.

0 commit comments

Comments
 (0)