- Decision
- ADR-127
- Date
- 2026-10-03
- Status
- ProposedProposed (2026-10-04:
AIR-141,AIR-153andAIR-154Pass for lowering, restoring at the04frame and the death restore;AIR-142toAIR-145Open (skipped by the owner); the 1 s and 8 s silence timeouts are in image2026100210and not yet tried. Accepted only when every row has evidence) - Mentions
- ADR-125
- Mentioned by
- ADR-125, ADR-268
Shown as written
This entry has 5 columns where the log has seven, because a cell holds the separator of the table or a column is missing. The cells follow in their order, under the label of their place.
1Decision
The music volume is lowered and restored by one narrow Bluetooth call, not by the app's own volume API. On the device (2026-10-03, image 2026100206) the audio hardening of this OS ignored every AudioManager.setStreamVolume of org.sovereignos.airpods (AS.HardeningEnforcer: AudioHardening volume control for api 100 ignored ... level: full ... exemption: 0); the plan's assumption that these calls need no permission was wrong for this OS.
The call is BluetoothDevice#setAirPodsMusicDuck(boolean duck, int percent) (@SystemApi, patch 0009) behind MANAGE_AIRPODS_IDENTITY: only for a bonded, registered device that is the active A2DP device; percent is one of 20, 35, 50, 70; it lowers STREAM_MUSIC to that share of the current volume (never below the stream minimum, never raising it) and restores only if the volume is still the value it set; it also restores when the caller dies, the device disconnects or is unbonded, or Bluetooth turns off.
The Bluetooth process is exempt from the hardening by its uid; the hardening is unchanged for every other app. The app gets no new permission.
2Why and evidence
Alternatives rejected: MODIFY_AUDIO_SETTINGS_PRIVILEGED for the app (lets it change any volume and the ringer, which is what the hardening forbids, and breaks the rule of no new permission); a lower targetSdk so the hardening falls to its partial level (a regression of a mitigation); audio focus MAY_DUCK (the owner's chosen level cannot be honoured and the focus request is hardened as well).
Evidence: AIR-153, source frameworks/base/services/core/java/com/android/server/audio/HardeningEnforcer.java blockVolumeMethod (exempt: MODIFY_AUDIO_SETTINGS_PRIVILEGED, MODIFY_AUDIO_ROUTING, MODIFY_PHONE_STATE, uid below 10000, exact alarm). Supersedes the sentence of ADR-125 that conversation awareness needs no permission.
Read from docs/governance/decision-log.md, entry ADR-127.