search

mdn / content

The content behind MDN Web Docs
https://developer.mozilla.org
Other
8.97k stars 22.45k forks source link

DASH Adaptive Streaming for HTML 5 Video: missing usage notes #1217

Open zvolsky opened 3 years ago

zvolsky commented 3 years ago

MDN URL: https://developer.mozilla.org/en-US/docs/Web/Media/DASH_Adaptive_Streaming_for_HTML_5_Video

What information was incorrect, unhelpful, or incomplete?

1) I think is required, but not mentioned in "Using DASH - Client Side" section 2) I think that it could be mentioned, that if server is not configured to serve with the mimetype, it is enough to add the mimetype explicitly into

Specific section or headline?

1) "Using DASH - Client Side" section 2) "Using DASH - Client Side" section in line with .mpd, or at the end of "Using DASH - Server Side" section

What did you expect to see?

Did you test this? If so, how?

I see that I have not server configured for proper mimetype as mentioned at the end of "Using DASH - Server Side" section. I can make things working when I add both changes 1) /link dash.js/ and 2) /explicite type= in the source tag/

MDN Content page report details * Folder: `en-us/web/media/dash_adaptive_streaming_for_html_5_video` * MDN URL: https://developer.mozilla.org/en-US/docs/Web/Media/DASH_Adaptive_Streaming_for_HTML_5_Video * GitHub URL: https://github.com/mdn/content/blob/master/files/en-us/web/media/dash_adaptive_streaming_for_html_5_video/index.html * Report started: 2021-01-12T09:33:14.009Z
dscotese commented 1 year ago

It looks to me like dash.js is currently expected by its devs to be used in a server written in Javascript, and packaged and published through npm publish. They seem to have done a good job providing information on how to do this, so I think that the "Client Side" section of this page should simply direct readers to the Dynamic Adaptive Streaming for HTML 5. If anyone in this thread seconds this suggestion, I will make it so.

I didn't look very hard for instructions at that link for creating the mpd file and the requisite video files, and I suspect that the devs for dash.js assume the user/coder interested in their work already has the different video files and the mpd file. For that reason, I like that this page explains how a video can be made into something that dash.js can stream adaptively. Still, the client side stuff is heavily dependent on dash.js itself and so readers should be directed there. Otherwise, do we copy all the instructions from the other repo to this page? Then it will be outdated as soon as they change something important.