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:
parent
9b7ebb4bb1
commit
59fe7f9efc
|
|
@ -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
25
task.md
|
|
@ -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 |
|
||||
|
|
|
|||
Loading…
Reference in New Issue