ObliviOS Developer portal Project site

Home / Decisions / ADR-127

The music volume is lowered and restored by one narrow Bluetooth call, not by the app's own volume API.

Proposed, recorded 3 October 2026.

Decision
ADR-127
Date
2026-10-03
Status
ProposedProposed (2026-10-04: AIR-141, AIR-153 and AIR-154 Pass for lowering, restoring at the 04 frame and the death restore; AIR-142 to AIR-145 Open (skipped by the owner); the 1 s and 8 s silence timeouts are in image 2026100210 and 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.