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 | The player itself does not use any data in it (although some builtin scripts may). | 3549 | The player itself does not use any data in it (although some builtin scripts may). |
| 3550 | The property is not preserved across player restarts. | 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 | Sub-paths can be accessed directly; e.g. ``user-data/my-script/state/a`` can be | 3558 | Sub-paths can be accessed directly; e.g. ``user-data/my-script/state/a`` can be |
| 3553 | read, written, or observed. | 3559 | read, written, or observed. |
| 3554 | 3560 | ||