docs: document tokenId-scoped restream dedup behavior#705
docs: document tokenId-scoped restream dedup behavior#705devin-ai-integration[bot] wants to merge 3 commits into
Conversation
Co-Authored-By: zita.liao <zita.liao@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:
|
|
|
|
||
| To disable re-streaming on specific feeds add the **norestream** boolean [publishing parameter](/millicast/broadcast/publishing-parameters.md) to your configured publishing URLs. This is used to indicate which sources specifically should be used or not. For example, in a Multi-bitrate (MBR) configuration where there are multiple quality layers being ingested, you might re-stream only the highest quality layer and then add `&norestream` to any additional contribution layers. Similarly, if you have an interactive [multi-view](/millicast/playback/multi-view.md) broadcast where multiple sources are sharing the same publishing token, you can configure the URLs to only re-stream your intended source. | ||
|
|
||
| :::info Token-scoped dedup behavior |
There was a problem hiding this comment.
- make another ## tile with something like "Restrict per publish token scope"
- "publisher node" is a bit too internal for the user. Find a better way for it, and hide tech details to just mention that if user would like to restream different ingest, better to use different token to each ingest, or explicitly use norestream to disable the ingest to restream with a same publish token
…l terminology Co-Authored-By: zita.liao <zita.liao@dolby.com>
|
|
||
| ## Re-streaming scope per publish token | ||
|
|
||
| Re-streaming is scoped to the **publish token**. Only one active ingest per publish token will be re-streamed at a time. If a new ingest starts using the same publish token while another is already re-streaming, the existing re-stream is stopped and the new ingest takes over. |
There was a problem hiding this comment.
if it happens to route to different publish node, then it would not stop. So here, change "the existing re-stream is stopped" to "would be stopped". Let user knows restream with a same publish token is not suggest
There was a problem hiding this comment.
Addressed — changed "is stopped" → "would be stopped" and added a bold recommendation that re-streaming multiple ingests with the same publish token is not recommended, noting the behavior may be unpredictable.
Co-Authored-By: zita.liao <zita.liao@dolby.com>
|
|
||
| ## Re-streaming scope per publish token | ||
|
|
||
| Re-streaming is scoped to the **publish token**. Only one active ingest per publish token will be re-streamed at a time. If a new ingest starts using the same publish token while another is already re-streaming, the existing re-stream would be stopped and replaced by the new ingest. Because of this, **re-streaming multiple ingests with the same publish token is not recommended** — the behavior may be unpredictable. |
There was a problem hiding this comment.
"Only one active ingest per publish token will be re-streamed at a time. If a new ingest starts using the same publish token while another is already re-streaming, the existing re-stream would be stopped and replaced by the new ingest."
Change to (please polish)
"Only one active ingest per publish token per publish node will be re-streamed at a time. If a new ingest starts using the same publish token route to (decided by load balance strategy) a same publish node with another is already re-streaming, the existing re-stream would be stopped and replaced by the new ingest. So multiple stream with a same public token would randomly fail. In general, restream different streams with a same publish token is not full-function supported and so not suggest."
1 participant
Summary
Adds a new "Re-streaming scope per publish token" section to
millicast/distribution/re-streaming.mdxdocumenting that re-streaming is scoped per publish token — only one active ingest per token will be re-streamed at a time. Recommends using separate publish tokens for independent re-streams, or&norestreamwhen multiple ingests must share a token.Related: millicast/media-server#534 (code comments in
Restreamer.js)Link to Devin session: https://dolby.devinenterprise.com/sessions/3581ac14a78b4b269c43b4be6af6f620
Requested by: @ZitaLiao