[video_player_web] Document video scrubbing and range requests. (#6128)
diff --git a/packages/video_player/video_player_web/CHANGELOG.md b/packages/video_player/video_player_web/CHANGELOG.md
index 603f296..3ea526e 100644
--- a/packages/video_player/video_player_web/CHANGELOG.md
+++ b/packages/video_player/video_player_web/CHANGELOG.md
@@ -1,3 +1,10 @@
+## 2.0.12
+
+* Updates the `README` with:
+ * Information about a common known issue: "Some videos restart when using the
+ seek bar/progress bar/scrubber" (Issue [#49630](https://github.com/flutter/flutter/issues/49360))
+ * Links to the Autoplay information of all major browsers (Chrome/Edge, Firefox, Safari).
+
## 2.0.11
* Improves handling of videos with `Infinity` duration.
diff --git a/packages/video_player/video_player_web/README.md b/packages/video_player/video_player_web/README.md
index 85e55eb..ce5d472 100644
--- a/packages/video_player/video_player_web/README.md
+++ b/packages/video_player/video_player_web/README.md
@@ -5,20 +5,56 @@
## Usage
This package is [endorsed](https://flutter.dev/docs/development/packages-and-plugins/developing-packages#endorsed-federated-plugin),
-which means you can simply use `video_player`
-normally. This package will be automatically included in your app when you do.
+which means you can simply use `video_player` normally. This package will be
+automatically included in your app when you do.
-## dart:io
+## Limitations on the Web platform
-The Web platform does **not** suppport `dart:io`, so attempts to create a `VideoPlayerController.file` will throw an `UnimplementedError`.
+Video playback on the Web platform has some limitations that might surprise developers
+more familiar with mobile/desktop targets.
-## Autoplay
-Playing videos without prior interaction with the site might be prohibited
-by the browser and lead to runtime errors. See also: https://goo.gl/xX8pDD.
+In no particular order:
-## Mixing audio with other audio sources
+### dart:io
-The `VideoPlayerOptions.mixWithOthers` option can't be implemented in web, at least at the moment. If you use this option it will be silently ignored.
+The web platform does **not** suppport `dart:io`, so attempts to create a `VideoPlayerController.file`
+will throw an `UnimplementedError`.
+
+### Autoplay
+
+Attempts to start playing videos with an audio track (or not muted) without user
+interaction with the site ("user activation") will be prohibited by the browser
+and cause runtime errors in JS.
+
+See also:
+
+* [Autoplay policy in Chrome](https://developer.chrome.com/blog/autoplay/)
+* MDN > [Autoplay guide for media and Web Audio APIs](https://developer.mozilla.org/en-US/docs/Web/Media/Autoplay_guide)
+* Delivering Video Content for Safari > [Enable Video Autoplay](https://developer.apple.com/documentation/webkit/delivering_video_content_for_safari#3030251)
+* More info about "user activation", in general:
+ * [Making user activation consistent across APIs](https://developer.chrome.com/blog/user-activation)
+ * HTML Spec: [Tracking user activation](https://html.spec.whatwg.org/multipage/interaction.html#sticky-activation)
+
+### Some videos restart when using the seek bar/progress bar/scrubber
+
+Certain videos will rewind to the beginning when users attempt to `seekTo` (change
+the progress/scrub to) another position, instead of jumping to the desired position.
+Once the video is fully stored in the browser cache, seeking will work fine after
+a full page reload.
+
+The most common explanation for this issue is that the server where the video is
+stored doesn't support [HTTP range requests](https://developer.mozilla.org/en-US/docs/Web/HTTP/Range_requests).
+
+> **NOTE:** Flutter web's local server (the one that powers `flutter run`) **DOES NOT** support
+> range requests, so all video **assets** in `debug` mode will exhibit this behavior.
+
+See [Issue #49360](https://github.com/flutter/flutter/issues/49360) for more information
+on how to diagnose if a server supports range requests or not.
+
+### Mixing audio with other audio sources
+
+The `VideoPlayerOptions.mixWithOthers` option can't be implemented in web, at least
+at the moment. If you use this option it will be silently ignored.
## Supported Formats
@@ -26,28 +62,35 @@
### Video codecs?
-Check MDN's [**Web video codec guide**](https://developer.mozilla.org/en-US/docs/Web/Media/Formats/Video_codecs) to learn more about the pros and cons of each video codec.
+Check MDN's [**Web video codec guide**](https://developer.mozilla.org/en-US/docs/Web/Media/Formats/Video_codecs)
+to learn more about the pros and cons of each video codec.
### What codecs are supported?
-Visit [**caniuse.com: 'video format'**](https://caniuse.com/#search=video%20format) for a breakdown of which browsers support what codecs. You can customize charts there for the users of your particular website(s).
+Visit [**caniuse.com: 'video format'**](https://caniuse.com/#search=video%20format)
+for a breakdown of which browsers support what codecs. You can customize charts
+there for the users of your particular website(s).
Here's an abridged version of the data from caniuse, for a Global audience:
#### MPEG-4/H.264
+
[](https://caniuse.com/#feat=mpeg4)
#### WebM
+
[](https://caniuse.com/#feat=webm)
#### Ogg/Theora
+
[](https://caniuse.com/#feat=ogv)
#### AV1
+
[](https://caniuse.com/#feat=av1)
#### HEVC/H.265
-[](https://caniuse.com/#feat=hevc)
+[](https://caniuse.com/#feat=hevc)
[1]: ../video_player
diff --git a/packages/video_player/video_player_web/pubspec.yaml b/packages/video_player/video_player_web/pubspec.yaml
index 4083341..e3cbbab 100644
--- a/packages/video_player/video_player_web/pubspec.yaml
+++ b/packages/video_player/video_player_web/pubspec.yaml
@@ -2,7 +2,7 @@
description: Web platform implementation of video_player.
repository: https://github.com/flutter/plugins/tree/main/packages/video_player/video_player_web
issue_tracker: https://github.com/flutter/flutter/issues?q=is%3Aissue+is%3Aopen+label%3A%22p%3A+video_player%22
-version: 2.0.11
+version: 2.0.12
environment:
sdk: ">=2.12.0 <3.0.0"
