Skip to content

Adapt the main screen to Meta Quest headsets - #3

Merged
RangelReale merged 2 commits into
masterfrom
feature/quest-support
Nov 12, 2026
Merged

RangelReale merged 2 commits into
masterfrom
feature/quest-support

Conversation

@RangelReale

Copy link
Copy Markdown
Contributor

What changed

The app now detects a Meta Quest headset and adapts its main screen:

  • Detection. A device counts as a Quest when it reports the oculus.hardware.standalone_vr system feature, which every Quest model has. The logic is in data/DevicePlatform.kt, free of Android framework calls, with unit tests in DevicePlatformTest.
  • Stay awake and Keep screen on are hidden on a Quest. A short note explains why.
  • The "Developer options are off" warning is hidden on a Quest.
  • Setup step 1 tells Quest users to turn on developer mode in the Meta Horizon app.
  • README gains a "Meta Quest" section.

Phones behave exactly as before.

Why

Testing on a Quest 3 (Horizon OS, Android 14) showed:

  • USB debugging and wireless debugging work. Turning on wireless debugging opens the Quest's own dialog, and the app finds the address over mDNS.
  • The proximity sensor puts the headset to sleep about 20 seconds after it is taken off, even with stay_on_while_plugged_in set to 7 and a SCREEN_BRIGHT_WAKE_LOCK held. So the two keep-awake features have no effect.
  • development_settings_enabled is never set on a Quest, so the warning always showed, and its advice ("tap Build number") does not apply.
  • The Quest's system UI does not respond to cmd statusbar, so Quick Settings tiles cannot be used. The tiles stay in the manifest; they cause no harm.

Testing

  • ./gradlew testDebugUnitTest lintDebug assembleDebug passes.
  • On a Quest 3, the main screen shows the debugging switches and the note, with no warning card.
  • Not seen on the headset: the Quest text in the setup card, which only shows without the permission.

🤖 Generated with Claude Code

RangelReale and others added 2 commits November 12, 2026 15:32
On a Quest 3, the proximity sensor puts the headset to sleep when it is
taken off, so Stay awake and Keep screen on have no effect. The Quest also
never sets development_settings_enabled, so the Developer options warning
always showed.

Detect a Quest by the oculus.hardware.standalone_vr system feature. On a
Quest, hide the two keep-awake features with a note that says why, hide the
Developer options warning, and point the setup steps at the Meta Horizon app.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@RangelReale
RangelReale merged commit a2343d1 into master Nov 12, 2026
1 check passed
@RangelReale
RangelReale deleted the feature/quest-support branch November 12, 2026 18:48
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