Currently user-data/osc is used for interpolation between the osc and other internal scripts. Reserve this sub-path and also user-data/mpv to make sure external scripts can only use these values as directed. New internal uses of user-data should use user-data/mpv instead.
Unified · Split
| @@ -0,0 +1 @@ | ||
| 1 | +reserve `user-data/osc` and `user-data/mpv` sub-paths for internal use | |
| @@ -3549,6 +3549,12 @@ Property list · 3548 unmodified lines | ||
| 3549 | 3549 | The player itself does not use any data in it (although some builtin scripts may). |
| 3550 | 3550 | The property is not preserved across player restarts. |
| 3551 | 3551 | |
| 3552 | + The following sub-paths are reserved for internal uses or have special semantics: | |
| 3553 | + ``user-data/osc``, ``user-data/mpv``. Unless noted otherwise, the semantics of | |
| 3554 | + any properties under these sub-paths can change at any time and may not be relied | |
| 3555 | + upon, and writing to these properties may prevent builtin scripts from working | |
| 3556 | + properly. | |
| 3557 | + | |
| 3552 | 3558 | Sub-paths can be accessed directly; e.g. ``user-data/my-script/state/a`` can be |
| 3553 | 3559 | read, written, or observed. |
| 3554 | 3560 | |