- Decision
- ADR-125
- Date
- 2026-10-02
- Status
- ProposedProposed (2026-10-04: device evidence for
AIR-131toAIR-135,AIR-137,AIR-140andAIR-149; still Open:AIR-136(a call),AIR-138(a second peer),AIR-139(probable only),AIR-142toAIR-145(skipped by the owner),AIR-147andAIR-148(live case value, moved to Plan 7B). Accepted only when every row has evidence) - Part
- AirPods
- Mentions
- ADR-117, ADR-127
- Mentioned by
- ADR-126, ADR-127, ADR-134, ADR-154, ADR-172, 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
Ear detection is a host function. The app acts on the AirPods' placement report (EarState, opcode 0x0006): one pod out pauses and putting it back resumes only what it paused; both out (a pod in the case counts as out) stops playback, never resumes by itself, and takes the AirPods out of the active A2DP/HFP slots so audio and calls go to the phone; the switch off disables all of it.
The slot change is made by one narrow @SystemApi call, BluetoothDevice#setAirPodsAudioRoute(boolean) (patch 0007), behind MANAGE_AIRPODS_IDENTITY, for a bonded and registered device only, which undoes only what it did and is undone on disconnect, unbond, adapter off, caller death and session end. The app does not receive MODIFY_AUDIO_ROUTING. The session also starts after boot (RECEIVE_BOOT_COMPLETED, normal permission).
Conversation awareness is a host function too: the AirPods' speech signal (opcode 0x4B, captured on the owner's pair) lowers the music stream volume to the level the owner chose on the page (20, 35, 50 or 70 percent of the current volume, default 50) and gives it back when the signal says the conversation is over, only if the owner did not change the volume meanwhile; it needs no permission.
The case battery keeps its last reported value (per device, app-private storage) so the ring is shown at all times.
Updated 2026-10-04: the sentence that conversation awareness "needs no permission" is superseded by ADR-127 (the audio hardening ignores the app's own volume calls); the end of a conversation is the level 04, 06 (in the source, not in image 2026100210), 08 or 09, or 1 s after a 0B or 8 s after any other level with nothing following (AIR-155, AIR-158).
2Why and evidence
Evidence: AIR-126 log of the 2026-10-02 session (six EarState frames, zero AVRCP pass-through); Apple Support on Automatic Ear Detection; MODIFY_AUDIO_ROUTING carries 53 AudioManager APIs (core/res/AndroidManifest.xml:7595), so a narrow call in the Bluetooth module (the ADR-117/119 pattern) is the only option that does not widen the app. Alternatives rejected: MODIFY_AUDIO_ROUTING for the app (reduces security), BluetoothAdapter#setActiveDevice (needs BLUETOOTH_PRIVILEGED, rejected in ADR-117), pausing only (does not meet "exactly like an iPhone"). Plan: docs/superpowers/plans/2026-10-02-airpods-plan7a2-ear-detection.md.
Read from docs/governance/decision-log.md, entry ADR-125.