Add support for the original XREAL Beam
Summary
This work adds an experimental NoAPI backend path for the original XREAL Beam
(eva, Android 11). It provides 3DoF head tracking, Beam controller input, and
immersive 180/360 stereoscopic video playback.
Motivation
The original Beam has no Android OpenXR runtime. Wolvic's generic NoAPI build can
run on the device, but it normally has a fixed view and Rockchip hardware-decoded
video may render as audio with a black frame.
Implementation
- optional legacy XREAL/NRSDK head-tracking adapter loaded at runtime
- USB permission launcher with fixed-view fallback
- direct video surface handoff to Gecko's isolated media process
- Rockchip MediaCodec RGB bridge for AVC and HEVC
- automatic immersive entry after playback and decoded-frame confirmation
- controller, seek bar, projection-menu, hover, and safe-exit fixes
The implementation is site-independent and does not contain URL-specific rules.
Dependency and licensing status
No proprietary XREAL files are included in the proposed source changes. The
legacy runtime is supplied only through a gitignored local build setting. XREAL
has been contacted to request an authorized redistributable runtime or another
supported integration path before any public APK is released.
The GeckoView bridge source is provided separately because it changes GeckoView,
not Wolvic itself.
Validation
Validated on an original XREAL Beam with Android 11:
- browser startup and Beam input
- 3DoF head rotation
- AVC and HEVC playback
- mono and stereoscopic 180/360 projection
- repeated entry and exit from immersive video
The Wolvic build also compiles without the optional local XREAL runtime, falling
back to a fixed view.
Source preview
Add support for the original XREAL Beam
Summary
This work adds an experimental NoAPI backend path for the original XREAL Beam
(
eva, Android 11). It provides 3DoF head tracking, Beam controller input, andimmersive 180/360 stereoscopic video playback.
Motivation
The original Beam has no Android OpenXR runtime. Wolvic's generic NoAPI build can
run on the device, but it normally has a fixed view and Rockchip hardware-decoded
video may render as audio with a black frame.
Implementation
The implementation is site-independent and does not contain URL-specific rules.
Dependency and licensing status
No proprietary XREAL files are included in the proposed source changes. The
legacy runtime is supplied only through a gitignored local build setting. XREAL
has been contacted to request an authorized redistributable runtime or another
supported integration path before any public APK is released.
The GeckoView bridge source is provided separately because it changes GeckoView,
not Wolvic itself.
Validation
Validated on an original XREAL Beam with Android 11:
The Wolvic build also compiles without the optional local XREAL runtime, falling
back to a fixed view.
Source preview