docs: expand M13 media-control acceptance criteria

Record approved discovery, UI, MIDI feedback gates and extended playback controls. Validation: git diff --check; reviewed backlog ordering and architecture consistency. No runtime behavior changed.
This commit is contained in:
Dandaedre 2026-10-18 22:17:38 +02:00
parent 9b7ebb4bb1
commit 59fe7f9efc
Signed by: Dandaedre
GPG Key ID: 440C6592E8A26D99
2 changed files with 41 additions and 0 deletions

View File

@ -158,6 +158,22 @@ remain controllable. Extend MIDI learn, capability/state reporting and TUI
editing through the server owner; use confirmed playback state for feedback.
Resolve multiple matches explicitly rather than choosing an arbitrary player.
This controls players such as QBZ directly, without synthetic keyboard input.
The approved Media tab lists configured player/control sets with stable IDs,
labels, explicit exact/regex selectors and observed state. Discovery supplies a
picker without a builtin player catalogue; manual selectors remain available.
Multiple matches are ambiguous and block commands. The server advertises session
bus availability to the client: no running players is an empty list, not a reason
to hide the tab; a later disconnect retains the tab with an unavailable status.
The scope includes Stop/Next/Previous, relative and absolute seeking, shuffle,
repeat and playlist discovery/activation, gated by player capabilities. Playlist
content editing is not included. Learn/unbind, validated editing and persisted
configuration follow the mixer conventions.
Feedback uses confirmed state, with exclusive Play/Pause/Stop indicators and
explicit device-specific colour mappings; default note output is same-note 127/0.
Global and per-fader/per-media-entry switches gate MIDI output. Global off sends
no messages (even clearing messages), so existing lights may remain lit until
feedback is re-enabled and resynchronized. These additions remain planned until
their individual M13 acceptance criteria pass.
The protocol boundary follows the
[MPRIS Player interface](https://specifications.freedesktop.org/mpris/latest/Player_Interface.html).

25
task.md
View File

@ -602,6 +602,31 @@ YouTube capture use case; no browser-name condition is needed.
saved configuration, TUI controls and confirmed playback-state feedback with
a fake D-Bus adapter before opt-in player integration checks.
Approved implementation slices for M13.3 (each independently tested/committed):
- [ ] **M13.3a Feedback switches:** persisted global MIDI-feedback gate and
per-fader/per-media-entry gates; global off overrides local settings and sends
no output, including clearing messages; re-enable resynchronizes observed state.
- [ ] **M13.3b MPRIS adapter:** session-bus discovery independent of audio streams,
bounded calls, capability reporting, owner-change handling and reconnects.
Verify dependency license, native prerequisites and Rust 1.88 compatibility.
- [ ] **M13.3c Media entries:** stable IDs, labels, exact/regex selectors on bus
name, desktop entry or identity; live picker plus manual entry; reject ambiguous
targets rather than selecting arbitrarily. Persist MIDI action bindings.
- [ ] **M13.3d Media tab:** server-advertised availability, A/E/D editing,
validated Save and exit, MIDI Learn with U to unbind; retain offline entries.
Support Play, Pause, Stop, PlayPause, Next and Previous with capability checks.
- [ ] **M13.3e Playback feedback:** confirmed Playing/Paused/Stopped exclusively
lights the corresponding transport buttons; default same-note 127/0, explicit
device-specific colour values; clear unavailable targets only when enabled.
Deduplicate and resync after reconnect; failed commands never imply success.
- [ ] **M13.3f Extended controls:** relative seeking with configurable steps and
absolute position where supported; shuffle toggle/set; repeat Off/Track/Playlist
set/cycle; discover/select/activate playlists with MIDI bindings and confirmed
feedback where reported. Playlist-content editing is outside this scope.
- [ ] **M13.3g Qualification:** document schema/UI, save/reload/restart tests,
fake-bus failures and capability changes, workspace gates, opt-in QBZ/controller
integration checks. No keyboard simulation or playerctl dependency.
## User requirement coverage
| # | Requirement | Work items |