From c715b4dcfc09e615e6116bca0e2ed53fb4de7ae7 Mon Sep 17 00:00:00 2001 From: Henry Date: Wed, 22 Jan 2025 15:58:10 -0500 Subject: [PATCH 1/3] Document prefer_mms query param --- README.md | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index f25f07bc5..451642569 100644 --- a/README.md +++ b/README.md @@ -17,12 +17,12 @@ Alternatively, you can reference an up‐to‐date version on our CDN: ``` -**Warning:** when used with RequireJS it's required to load the script dynamically via the RequireJS load system. +**Warning:** when used with RequireJS it is required to load the script dynamically via the RequireJS load system. https://requirejs.org/docs/api.html#jsfiles ## Getting Started -In order to control the Vimeo player, you need a player to control. There are a +In order to control the Vimeo Player, you need a player to control. There are a few ways to get a player: ### Pre-existing player @@ -251,7 +251,7 @@ it will also import the Player constructor directly: + [remoteplaybackdisconnect](#remoteplaybackdisconnect) + [interactivehotspotclicked](#interactivehotspotclicked) + [interactiveoverlaypanelclicked](#interactiveoverlaypanelclicked) - +* [Dev Options](#dev-options) ## Create a Player @@ -1815,3 +1815,9 @@ Triggered when the overlay panel (buttons or images) within the interactive over panelId: 'c47193a0-8320-4572-9bcd-8425851b36e9' } ``` + +## Dev Options + +The Vimeo Player uses [ManagedMediaSource](https://developer.apple.com/videos/play/wwdc2023/10122/?time=762) (MMS) where available for MSE-powered playback on iOS devices. + +Unfortunately, there are [known issues](https://bugs.webkit.org/show_bug.cgi?id=266764) with ManagedMediaSource in certain versions of the Xcode iOS Simulator. Therefore, we have added a query parameter to disable MMS and force native HLS playback via: `prefer_mms=0` or `prefer_mms=false`. From 0ab23a7d5c1a641a4ef2728706b7062d7fb35650 Mon Sep 17 00:00:00 2001 From: Henry Date: Wed, 22 Jan 2025 16:25:06 -0500 Subject: [PATCH 2/3] Add prefer_mms to table of contents --- README.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 451642569..e3bc51bd7 100644 --- a/README.md +++ b/README.md @@ -252,6 +252,7 @@ it will also import the Player constructor directly: + [interactivehotspotclicked](#interactivehotspotclicked) + [interactiveoverlaypanelclicked](#interactiveoverlaypanelclicked) * [Dev Options](#dev-options) + + [prefer_mms](#prefer_mms) ## Create a Player @@ -1818,6 +1819,8 @@ Triggered when the overlay panel (buttons or images) within the interactive over ## Dev Options +### prefer_mms + The Vimeo Player uses [ManagedMediaSource](https://developer.apple.com/videos/play/wwdc2023/10122/?time=762) (MMS) where available for MSE-powered playback on iOS devices. -Unfortunately, there are [known issues](https://bugs.webkit.org/show_bug.cgi?id=266764) with ManagedMediaSource in certain versions of the Xcode iOS Simulator. Therefore, we have added a query parameter to disable MMS and force native HLS playback via: `prefer_mms=0` or `prefer_mms=false`. +Unfortunately, there are [known issues](https://bugs.webkit.org/show_bug.cgi?id=266764) with MMS in certain versions of the Xcode iOS Simulator. Therefore, we have added a query parameter to disable MMS and force native HLS playback via: `prefer_mms=0` or `prefer_mms=false`. From 1ec46d99752583b1d35854a33a3462f9817ceb9d Mon Sep 17 00:00:00 2001 From: Henry Date: Thu, 23 Jan 2025 12:42:45 -0500 Subject: [PATCH 3/3] Expand MSE acronym --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index e3bc51bd7..02177cab7 100644 --- a/README.md +++ b/README.md @@ -1821,6 +1821,6 @@ Triggered when the overlay panel (buttons or images) within the interactive over ### prefer_mms -The Vimeo Player uses [ManagedMediaSource](https://developer.apple.com/videos/play/wwdc2023/10122/?time=762) (MMS) where available for MSE-powered playback on iOS devices. +The Vimeo Player uses [Managed Media Source](https://developer.apple.com/videos/play/wwdc2023/10122/?time=762) (MMS) where available for [Media Source Extension](https://developer.mozilla.org/en-US/docs/Web/API/Media_Source_Extensions_API) powered playback on iOS devices. Unfortunately, there are [known issues](https://bugs.webkit.org/show_bug.cgi?id=266764) with MMS in certain versions of the Xcode iOS Simulator. Therefore, we have added a query parameter to disable MMS and force native HLS playback via: `prefer_mms=0` or `prefer_mms=false`.