refactor: concentrate playback transition ownership

2026-10-11 23:20:26 +02:00
parent cc99a2a4f8
commit 8eba97579f
6 changed files with 559 additions and 238 deletions
@@ -0,0 +1,20 @@
+# Terebi playback
+
+Terebi plays local media and YouTube videos. These terms distinguish a playback request from the state the player has actually reached.
+
+## Language
+
+**Playback transition**:
+A requested change of media, playback state, position, or quality that may still be awaiting completion. Acceptance of a request does not mean playback has reached the requested state.
+
+**Playback intent**:
+The user's latest requested playing or paused state, which can differ from the state playback has acknowledged.
+
+**Acknowledged position**:
+The playback position confirmed by the player after any pending seek or restoration has completed. A seek target or slider preview is not an acknowledged position.
+
+**Restoration**:
+Resuming a video's saved position, or preserving position and playing or paused state while changing its quality.
+
+**Media identity**:
+The identity of the video being played, independent of its selected quality or extracted stream address. For a YouTube video, this is its canonical video webpage URL.