Repository navigation
docs(spf): document moq publisher requirements - #51
Conversation
Codex Review SummaryThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
📦 Bundle Size Report🎨 @videojs/html — no changesPresets (7)
Media (20)
Players (5)
Skins (37)
UI Components (49)
⚛️ @videojs/react — no changesPresets (7)
Media (23)
Players (5)
Skins (26)
UI Components (39)
🧩 @videojs/core — no changesEntries (76)
🏷️ @videojs/element — no changesEntries (2)
📦 @videojs/store — no changesEntries (3)
🔧 @videojs/utils — no changesEntries (13)
📦 @videojs/media
Entries (21)
📦 @videojs/spf — no changesEntries (11)
ℹ️ How to interpretEach entry is independently bundled, minified, and brotli-compressed. Initial size includes its static import graph; lazy dynamic chunks are reported separately. Entries are not additive because their dependency graphs overlap. Preset rows represent realistic combined bundles. Changes of 300 B or less across initial, lazy, and total size are collapsed, not discarded. Run |
There was a problem hiding this comment.
All reported issues were addressed across 3 files
Reply with feedback, questions, or to request a fix.
Re-trigger cubic
Brings the publisher stack onto mmcc/moq at 2fefce4 (PRs #47, #50, #51): subscriber location framing for moq-relay 0.14.17, isolated subscription recovery attempts with preserved retry backoff, and the moq publishing guide under packages/spf/docs. No publisher-side ports were needed. The LARGEST_OBJECT bare-Location codec change from PR #47 was already on this branch via PR #48, so control-messages.ts and its tests merge to the existing content.
Summary
Publishers currently have to infer v10's MoQ stream requirements from implementation comments, tests, and protocol drafts. Add a practical publisher guide with a complete camera-resolution ladder, separate screen-share track, and audio catalog, linked from the SPF README and MoQ spec index.
Explain alternate versus render groups, LOC payloads, decoder initialization, timestamps, keyframe alignment, late joins, and live catalog updates. Document the current player limitations and the loopback catalog's missing
altGroup, so readers can distinguish a valid stream from functionality not yet exposed by the controls.Targets
mmcc/moq; this PR changes documentation only.Testing
git diff --check.Summary by cubic
Adds a publisher guide for the experimental MoQ player so publishers no longer have to infer v10's stream requirements from implementation comments, tests, and protocol drafts. The guide covers catalog structure, encoding rules, and update flows, and is linked from the SPF README and MoQ spec index. It also documents current player limitations and the loopback catalog's missing
altGroupso readers can tell a valid stream from functionality not yet exposed.Written for commit 25dc309. Summary will update on new commits.