[BW-GARMIN-01] Add Garmin fēnix 8 BookWave companion controls #28
Loading…
Reference in a new issue
No description provided.
Delete branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Classification
Planned cross-device integration. Blocked on #23. No watch-side audiobook download in v1.
Product intent
Support a Garmin fēnix 8 as a lightweight BookWave remote and information surface for playback on the Android phone.
Target experience:
Important baseline first
The fēnix 8 already provides Garmin's built-in Control Phone media mode. Before writing a custom Connect IQ companion, test BookWave's existing Android
MediaSessionthrough that surface.Stage 0 — built-in Garmin media-control acceptance
Verify on a real fēnix 8:
Control Phone;If built-in Control Phone already satisfies the desired controls, keep it. Do not build a custom watch app merely to recreate Garmin's buttons.
Proceed to the custom companion because BookWave-specific audiobook information or actions are missing — especially chapter, book progress, series/sequence, explicit Continue, or future sleep controls.
Feasibility for custom companion
Garmin Connect IQ supports phone-app messaging over BLE and lists fēnix 8 models among supported devices. Garmin also provides a Connect IQ Mobile SDK for Android; wireless companion communication routes through Garmin Connect Mobile.
That makes a phone companion architecture the recommended custom implementation rather than an Audio Content Provider that downloads audiobook files to the watch.
Architecture if Stage 0 is insufficient
Android BookWave app:
GarminPlaybackSnapshotfrom existing BookWave state;Garmin Connect IQ app/glance:
V1 information model
Where profile/privacy permits:
Do not continuously stream second-by-second position over BLE. Send meaningful snapshots and let the watch interpolate/display coarse progress where appropriate.
V1 controls
Possible later controls:
Explicitly out of scope
Dependencies
Storage / migration
No Android database migration expected. Garmin-side preferences may store only presentation/configuration state. Playback truth stays on the phone.
Privacy / security
BookWave — profile lockedstate and stop receiving title/chapter metadata.Automated tests
Android custom adapter:
Connect IQ custom app:
Device acceptance
Required on a real fēnix 8 + Android phone:
Estimated effort
Stage 0: Small test.
Custom companion: Medium-Large because it introduces a second SDK/runtime and watch app.
Risk
Stage 0: Low.
Custom companion: Medium. Main risks are BLE/message lifecycle, Garmin Connect dependency and stale private metadata.
Sequence
Run Stage 0 early. Build custom companion after #23 only for the gaps the built-in Garmin surface cannot satisfy.
Acceptance criteria
Control Phonealready gives BookWave.