Automatic Handoff away from the Device #108

New issue

Closed

opened 2026-10-24 11:03:46 +02:00 by SBDeveloper · 1 comment

SBDeveloper commented

2026-10-24 11:03:46 +02:00

Owner

What to build

The Automatic Handoff away from the Device (see glossary, ADR 0026). While Armed, the Device watches its Bridge:

Weak signal prepares. A weak signal starts the Armed Paired Device resolving and buffering the current Track, without stopping anything. Recovery cancels that silently. This needs the Handoff's "ready before stop" split into a prepare step that can be cancelled and a commit.
Link loss or sustained weakness commits. The Bridge losing the headset, or a weak signal held long enough, completes the Handoff and releases the Bridge.
A failed Automatic Handoff pauses the handing Device (unlike a manual Handoff, which keeps playing), since nobody would hear it.
A receiver not playing to a headset (the headset was switched off at the desk) takes over paused.
Nothing playing: no Handoff, the Bridge is only released, and claimed again once it has the headset back.

The signal threshold and wait times are an advanced setting in the Bridge Plugin view, with defaults tuned on a Sony WH-1000XM4.

Acceptance criteria

Armed and playing, Bridge loses the headset: playback continues on the phone at the same position and the PC stops
Weak signal then recovery: no Handoff, no visible change, the phone drops what it prepared
Weak signal held past the wait time: Handoff commits
Receiver not ready in time: the PC pauses at its position, and both Devices show a notice where they can
Receiver not playing to a headset: it takes over paused
Not playing: only RELEASE, then CLAIM when the headset returns
Not Armed (toggle off, network Output, link down): nothing happens
Threshold and wait times can be changed in the Bridge Plugin view
Core tests cover these cases with a fixture Bridge and two Devices

## What to build The **Automatic Handoff** away from the Device (see glossary, ADR 0026). While Armed, the Device watches its Bridge: - **Weak signal prepares.** A weak signal starts the Armed Paired Device resolving and buffering the current Track, without stopping anything. Recovery cancels that silently. This needs the Handoff's "ready before stop" split into a prepare step that can be cancelled and a commit. - **Link loss or sustained weakness commits.** The Bridge losing the headset, or a weak signal held long enough, completes the Handoff and releases the Bridge. - **A failed Automatic Handoff pauses** the handing Device (unlike a manual Handoff, which keeps playing), since nobody would hear it. - **A receiver not playing to a headset** (the headset was switched off at the desk) takes over paused. - **Nothing playing:** no Handoff, the Bridge is only released, and claimed again once it has the headset back. The signal threshold and wait times are an advanced setting in the Bridge Plugin view, with defaults tuned on a Sony WH-1000XM4. ## Acceptance criteria - [ ] Armed and playing, Bridge loses the headset: playback continues on the phone at the same position and the PC stops - [ ] Weak signal then recovery: no Handoff, no visible change, the phone drops what it prepared - [ ] Weak signal held past the wait time: Handoff commits - [ ] Receiver not ready in time: the PC pauses at its position, and both Devices show a notice where they can - [ ] Receiver not playing to a headset: it takes over paused - [ ] Not playing: only `RELEASE`, then `CLAIM` when the headset returns - [ ] Not Armed (toggle off, network Output, link down): nothing happens - [ ] Threshold and wait times can be changed in the Bridge Plugin view - [ ] Core tests cover these cases with a fixture Bridge and two Devices

SBDeveloper added the

ready-for-agent

label

2026-10-24 11:03:46 +02:00

SBDeveloper added a new dependency

2026-10-24 11:03:52 +02:00

#107 Bridge follows every Handoff (RELEASE / CLAIM)

SBDeveloper added a new dependency

2026-10-24 11:03:52 +02:00

#106 Armed state between Paired Devices

SBDeveloper added a new dependency

2026-10-24 11:03:57 +02:00

#109 Automatic return to the Device when the headset is back

SBDeveloper referenced this issue

2026-10-24 14:34:24 +02:00

Low-battery notification for the Bridge's headset #110

SBDeveloper commented

2026-10-24 19:27:45 +02:00

Author

Owner

Implemented on integration branch automatic-handoff (merge 2749fc6), with code-review fixes in merge fcc0d8d. Lands on main when that branch is pushed and merged.

Implemented on integration branch `automatic-handoff` (merge 2749fc6), with code-review fixes in merge fcc0d8d. Lands on main when that branch is pushed and merged.

SBDeveloper closed this issue

2026-10-24 19:27:45 +02:00

SBDeveloper referenced this issue from a commit

2026-10-24 19:57:35 +02:00

Automatic Handoff away from the Device on the Bridge's signal (#108)

SBDeveloper referenced this issue from a commit

2026-10-24 19:57:35 +02:00

Bridge 0.6.0: Automatic Handoff settings in its view (#108)

SBDeveloper referenced this issue from a commit

2026-10-24 19:57:35 +02:00

Notice on both Devices when an Automatic Handoff fails (#108)

SBDeveloper referenced this issue from a commit