Skip to content

Commit b9d4a17

Browse files
MoQ known issue: extra subgroup header field
Document inadvertent divergence from draft-ietf-moq-transport-07
1 parent 79cc8b2 commit b9d4a17

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+
```
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+
```
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. Thanks to [@yuki-uchida](https://github.com/yuki-uchida) for reporting!

0 commit comments

Comments
 (0)