Skip to content

Android 17 ringer mode - background audio hardening documentation - #1365

Open
chriss158 wants to merge 4 commits into
home-assistant:masterfrom
chriss158:android17-ringer-mode
Open

Android 17 ringer mode - background audio hardening documentation#1365
chriss158 wants to merge 4 commits into
home-assistant:masterfrom
chriss158:android17-ringer-mode

Conversation

@chriss158

@chriss158 chriss158 commented Jun 28, 2026

Copy link
Copy Markdown
Contributor

Proposed change

This PR adds a short troubleshooting note for Android 17 ringer mode notification commands.

Starting with Android 17, Android may block background audio interactions due to the new Background Audio Hardening behavior. This can cause ringer mode commands to silently fail when they are executed in the background, even when the required notification policy access permission is granted.

The added documentation explains why this can happen, links to the official Android documentation, and shows the ADB commands to temporarily disable or re-enable this hardening behavior.

grafik

Type of change

  • Document existing features within Home Assistant Companion App
  • Document new or changing features for which there is an existing pull request elsewhere
  • Spelling or grammatical corrections, or rewording for improved clarity
  • Changes to the backend of this documentation
  • Remove stale or deprecated documentation

Checklist

  • I have read and followed the documentation guidelines.
  • I have verified that my changes render correctly in the documentation.

Additional information

This PR fixes or closes issue: Fixes #
Link to relevant existing code or pull request:

Android documentation: https://developer.android.com/about/versions/17/changes/bg-audio

@chriss158 chriss158 changed the title Android17 ringer mode Android 17 ringer mode - background audio hardening documentation Jun 28, 2026
@chriss158
chriss158 marked this pull request as draft July 1, 2026 12:54
@chriss158
chriss158 force-pushed the android17-ringer-mode branch from 6194323 to 3449ba5 Compare July 1, 2026 16:41
@chriss158
chriss158 marked this pull request as ready for review July 1, 2026 16:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant