ObliviOS Developer portal Project site

Home / Decisions / ADR-125

Ear detection is a host function.

Proposed, recorded 2 October 2026.

Decision
ADR-125
Date
2026-10-02
Status
ProposedProposed (2026-10-04: device evidence for AIR-131 to AIR-135, AIR-137, AIR-140 and AIR-149; still Open: AIR-136 (a call), AIR-138 (a second peer), AIR-139 (probable only), AIR-142 to AIR-145 (skipped by the owner), AIR-147 and AIR-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.