Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Proposal] "Remove" manifestUpdateUrl loadVideo option for the v4 #1276

Merged
merged 1 commit into from
Sep 22, 2023

Conversation

peaBerberian
Copy link
Collaborator

@peaBerberian peaBerberian commented Sep 12, 2023

This PR un-documents the manifestUpdateUrl API, so it is effectively not part of the official API anymore, even if its behavior stays for now (renamed as __priv_manifestUpdateUrl).

The manifestUpdateUrl was an advanced DASH optimization where it was possible to update a dynamic MPD through a shorter version of it, thus much faster.
This was a clever solution for a real issue we had for a long time at Canal+, but it relied on complex and easy-to-break logic to perform updates.

Now, we prefer other solutions, which are either standard (e.g. DASH packaging techniques to reduce the size of the MPD) or purely based on code optimizations (WebAssembly-based parsers, advanced parsing modes) - thus not relying on special URL like it was with this.

As It is not needed at Canal+ anymore, it is not standard in any way, we didn't hear of any other person using this feature and as removing it does not break playback (it only make it less efficient if the feature was relied on before), I propose we profit from the v4 still being in beta to remove it before an official v4.

Though this PR does not really remove the corresponding logic yet, it only moves it as an undocumented API.
This is because we may want to still keep that logic maintained for some months in case its need ever seems to make a comeback.

@peaBerberian peaBerberian added the proposal This Pull Request or Issue is only a proposal for a change with the expectation of a debate on it label Sep 12, 2023
@peaBerberian peaBerberian added this to the 4.0.0 milestone Sep 12, 2023
This commit undocument the `manifestUpdateUrl` API, so it is effictevely
not part of the official API anymore, even if its behavior stays for now
(renamed as `__priv_manifestUpdateUrl`).

The `manifestUpdateUrl` was an advanced DASH optimization where it was
possible to update a dynamic MPD through a shorter version of it, thus
much faster.
This was a clever solution for a real issue we had for a long time at
Canal+, but it relied on complex and easy-to-break logic to perform
updates.

Now, we prefer other solutions, which are either standard (e.g. DASH
packaging techniques to reduce the size of the MPD) or purely based on
code optimizations (WebAssembly-based parsers, advanced parsing modes) -
thus not relying on special URL like it was with this.

As It is not needed at Canal+ anymore, it is not standard in any way,
we didn't hear of any other person using this feature and as removing
it does not break playback (it only make it less efficient if the
feature was relied on before), I propose we profit from the v4 still
being in beta to remove it before an official v4.

Though this commit does not really remove the corresponding logic yet,
it only moves it as an undocumented API.
This is because we may want to still keep that logic maintained for
some months in case its need ever seems to make a comeback.
@peaBerberian peaBerberian merged commit 11e26d4 into next-v4 Sep 22, 2023
3 checks passed
peaBerberian added a commit that referenced this pull request Sep 22, 2023
[Proposal] "Remove" `manifestUpdateUrl` loadVideo option for the v4
peaBerberian added a commit that referenced this pull request Sep 26, 2023
As we're going to probably remove it from the v4 (#1276), it makes sense
to prepare its removal by first deprecating in the v3.
peaBerberian added a commit that referenced this pull request Sep 26, 2023
[Proposal] "Remove" `manifestUpdateUrl` loadVideo option for the v4
peaBerberian added a commit that referenced this pull request Sep 26, 2023
[Proposal] "Remove" `manifestUpdateUrl` loadVideo option for the v4
peaBerberian added a commit that referenced this pull request Sep 27, 2023
[Proposal] "Remove" `manifestUpdateUrl` loadVideo option for the v4
peaBerberian added a commit that referenced this pull request Sep 27, 2023
[Proposal] "Remove" `manifestUpdateUrl` loadVideo option for the v4
peaBerberian added a commit that referenced this pull request Sep 27, 2023
[Proposal] "Remove" `manifestUpdateUrl` loadVideo option for the v4
peaBerberian added a commit that referenced this pull request Sep 29, 2023
[Proposal] "Remove" `manifestUpdateUrl` loadVideo option for the v4
peaBerberian added a commit that referenced this pull request Oct 12, 2023
As we're going to probably remove it from the v4 (#1276), it makes sense
to prepare its removal by first deprecating in the v3.
peaBerberian added a commit that referenced this pull request Oct 13, 2023
[Proposal] "Remove" `manifestUpdateUrl` loadVideo option for the v4
peaBerberian added a commit that referenced this pull request Oct 13, 2023
[Proposal] "Remove" `manifestUpdateUrl` loadVideo option for the v4
peaBerberian added a commit that referenced this pull request Oct 13, 2023
[Proposal] "Remove" `manifestUpdateUrl` loadVideo option for the v4
peaBerberian added a commit that referenced this pull request Oct 19, 2023
[Proposal] "Remove" `manifestUpdateUrl` loadVideo option for the v4
peaBerberian added a commit that referenced this pull request Oct 26, 2023
[Proposal] "Remove" `manifestUpdateUrl` loadVideo option for the v4
@peaBerberian peaBerberian deleted the misc/remove-manifestUpdateUrlDoc branch February 7, 2024 16:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
proposal This Pull Request or Issue is only a proposal for a change with the expectation of a debate on it
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant