/
/
# What does this implement/fix? When an AirPlay device briefly dropped off the network mid-playback, the server treated the lost AirPlay 2 control channel as a device problem and permanently switched that player's streaming mode to "compatibility mode". Many devices (HomePods, but also e.g. KEF speakers) reject or render silence on that mode, so a momentary Wi-Fi hiccup left the player broken until someone found the advanced setting. The PTP-clock stall had a similar automatic switch to NTP timing. The streaming mode setting is now entirely under the user's control: a failing route logs a clear warning pointing at the setting instead of changing it. - No more automatic switch to compatibility mode when the native AirPlay 2 control channel fails; a warning explains what happened and what the user can do - No more automatic switch to NTP timing (with playback restart) when a device never answers the PTP clock; the existing warning remains - One-time cleanup that returns previously auto-pinned "compatibility mode" values to Automatic, so affected players recover on their own - Docs and tests updated accordingly **Related issue (if applicable):** - user report with debug log (speakers auto-switched to a mode they reject after a network dropout) ## Types of changes <!-- Tick exactly one box. CI (.github/workflows/pr-labels.yaml) derives the label from the ticked box and applies it automatically; the release-notes generator uses that same label to slot this change into the next release notes. --> - [x] Bugfix (non-breaking change which fixes an issue) — `bugfix` - [ ] New feature (non-breaking change which adds functionality) — `new-feature` - [ ] Enhancement to an existing feature — `enhancement` - [ ] New music/player/metadata/plugin provider — `new-provider` - [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected) — `breaking-change` - [ ] Refactor (no behaviour change) — `refactor` - [ ] Documentation only — `documentation` - [ ] Maintenance / chore — `maintenance` - [ ] CI / workflow change — `ci` - [ ] Dependencies bump — `dependencies` ## Checklist - [x] The code change is tested and works locally. - [x] `pre-commit run --all-files` passes. - [x] `pytest` passes, and tests have been added/updated under `tests/` where applicable. - [ ] For changes to shared models, the companion PR in `music-assistant/models` is linked. - [ ] For changes affecting the UI, the companion PR in `music-assistant/frontend` is linked. - [x] I have read and complied with the project's [AI Policy](https://github.com/music-assistant/.github/blob/main/AI_POLICY.md) for any AI-assisted contributions. - [ ] I have [raised a PR against the documentation repository](https://github.com/music-assistant/music-assistant.io/blob/main/CONTRIBUTING.md) targeting the main or beta branch as appropriate.