docs(millicast): document enableUTCInsertion publishing parameter - #783
docs(millicast): document enableUTCInsertion publishing parameter#783bcostdolby wants to merge 10 commits into
Conversation
Co-Authored-By: Brendon Costa <brendon.costa@dolby.com>
🤖 Devin AI EngineerI'll be helping with this pull request! Here's what you should know: ✅ I will automatically:
Note: I can only respond to comments from users who have write access to this repository. ⚙️ Control Options:
|
Co-Authored-By: Brendon Costa <brendon.costa@dolby.com>
…ly reference Co-Authored-By: Brendon Costa <brendon.costa@dolby.com>
…sertion Co-Authored-By: Brendon Costa <brendon.costa@dolby.com>
|
@bcostdolby can we also add a detail on how this is applied at the publishing token? |
|
Happy to add this. The row currently notes only that a token-level setting takes precedence over the URL param. Before documenting how it's applied at the token, we should confirm the customer-facing mechanism, since the @bcostdolby — is enabling |
…rtion) on frame-metadata page Co-Authored-By: Brendon Costa <brendon.costa@dolby.com>
…data link, align config surfaces/precedence Co-Authored-By: Brendon Costa <brendon.costa@dolby.com>
…nsertion Co-Authored-By: Brendon Costa <brendon.costa@dolby.com>
…page Co-Authored-By: Brendon Costa <brendon.costa@dolby.com>
… over URL param Co-Authored-By: Brendon Costa <brendon.costa@dolby.com>
… dashboard GUI Co-Authored-By: Brendon Costa <brendon.costa@dolby.com>
Summary
Documents the new
enableUTCInsertioningest option (media-server OPTI-3526) in the public Millicast docs. The feature stamps H.264 media with an unregistered SEI carrying the server's UTC receive time (Unix epoch ms), for RTMP/SRT passthrough and transcoded H.264 layers, without re-encoding, and only when the ingest doesn't already provide anonFi/AMF sender time.Two files change:
1.
millicast/broadcast/publishing-parameters.md— newenableUTCInsertionrow in the parameters table (alphabetical, afteraudioOnly). Covers: what it does, H.264-only + RTMP/SRT scope (not WebRTC ingest passthrough, not H.265), theonFi/AMF preservation + mixed-clock caveat,seiKeyFrameOnlyinteraction (passthrough limited to keyframes; transcoded layers always per-frame), and configuration surfaces/precedence (URL param > publishing-token setting > account-level default). Links to the frame-metadata page for the consumer/verification path.2.
millicast/playback/frame-metadata.md— new "Server-Inserted UTC Timecode" section under Timecode Metadata. Explains that the SEI reuses the same UUID asonFi(9a21f3be-…) so players parse it identically (no player-side change), and documents behavior across the three processing modes:seiKeyFrameOnly=false)seiKeyFrameOnly=trueAlso covers transcode-with-a-passthrough-layer (mix of the two), the per-frame fresh timestamp value, and the
onFi/AMF non-overwrite guarantee.The parameters-table column padding was re-flowed by
prettier(repo version) because the new row is the widest cell — hence whitespace-only churn on surrounding rows.prettier --checkpasses.Notes for reviewers
RtmpValidator.js,H264Packetizer.cpp,rtmppacketizer.cpp,h264encoder.cpp). The admin feature flag (highest priority in the media server) is internal-only and intentionally omitted from customer docs.Link to Devin session: https://dolby.devinenterprise.com/sessions/b635c9bf3add4fd393c2280136e1c01f
Requested by: @bcostdolby