docs(player): correct the stale "native video defaults to off" comments

DR-161 made `experimentalNativeVideo` default to on, but three comments still
described the pre-flip world and one of them was load-bearing:

- `nativeVideo.ts` labelled the store "Default off" directly above a `load()`
  that returns true when nothing is stored.
- The two PiP comments explained themselves as "what makes PiP work in the
  shipping configuration", which stopped being true when Android started
  shrinking the real ExoPlayer surface. They still describe the Linux path and
  the flag-off case, so they say that instead.
- `video_audio_codecs` justified its narrow codec list with "video does not play
  through ExoPlayer", which is no longer so on Android. The narrow list is still
  right, for a different reason now recorded: the flag is a user setting and a
  download outlives it, so only the intersection holds on both sides of the
  switch. DR-171 carries the same caveat.

No behaviour change.
This commit is contained in:
2026-08-16 00:00:10 +02:00
parent ac4fccd499
commit 7387f35c7e
5 changed files with 31 additions and 13 deletions
+5 -1
View File
@@ -73,7 +73,11 @@ function createExperimentalNativeVideoStore() {
};
}
/** User opt-in for the native Android video path. Default off. */
/**
* User opt-out for the native Android video path. **Defaults to on** since
* DR-161 — see `load()`. The name still says "experimental" because the flag
* remains a suppressor of Rust's backend choice, not a promoter of it.
*/
export const experimentalNativeVideo = createExperimentalNativeVideoStore();
function createNativeVideoActiveStore() {