Install the XRI Hand Demo APK
A prebuilt APK of the XR Interaction Toolkit Hands Interaction Demo with Hapbeat haptic feedback added is being distributed. You can try it without opening Unity.
To reproduce or modify it in your own Unity project, see Add Haptics to the XRI Hand Demo.
What you need
Section titled “What you need”- Meta Quest — verified on Quest 3 / 3S. Hand-tracking-capable Quest 2 / Quest Pro are also covered by the distribution (unverified)
- A Hapbeat device — on the same Wi-Fi as the Quest
Which route to pick
Section titled “Which route to pick”| Route | Requires | Getting the APK | |
|---|---|---|---|
| A | Release channel | A Meta account | Not needed |
| B | CLI (adb) | PC, USB cable, developer mode | Needed |
| C | App (SideQuest) | Same as B + SideQuest | Needed |
If you are not a registered developer, A is the easiest. It installs from the store like any other app.
A. Release channel
Section titled “A. Release channel”You are invited to the ALPHA channel on the Meta Horizon Store. No APK download and no USB connection — all you need is a Meta account. Neither developer registration nor developer mode is required.
Invitations are sent individually, so get in touch via Contact.
-
Receive the invitation and accept it
- Accepting is done entirely in a browser
-
Install it from the headset library
- Apps on invite-only channels do not appear in store search. They show up in your library
Downloading the APK (for B / C)
Section titled “Downloading the APK (for B / C)”Download hapbeat-handdemo_all.apk
Past builds are on the hapbeat-demos Releases page. Run the commands below in the directory where you put this APK.
B. CLI (adb)
Section titled “B. CLI (adb)”-
Enable developer mode
- For the procedure, see Meta official: Set up development environment
- If Build and Run already works in Unity it is already enabled, so you can skip this
-
Connect the Quest to your PC over USB-C and allow USB debugging inside the headset
- The dialog only appears inside the headset. Put it on and choose Always allow from this computer
-
Run this in the directory where you put the APK
adb install -r hapbeat-handdemo_all.apkadbships with the Android SDK Platform Tools. If you have Unity’s Android Build Support installed, it is also at<Unity install dir>/Editor/Data/PlaybackEngines/AndroidPlayer/SDK/platform-tools/- For command details, see the official adb documentation
- If you get
INSTALL_FAILED_UPDATE_INCOMPATIBLE(signature mismatch), runadb uninstall com.Hapbeat.HapticHandDemofirst
-
Launch it from Unknown Sources in the library
- It does not appear under the default filter. You have to switch it
C. App (SideQuest)
Section titled “C. App (SideQuest)”-
Enable developer mode
- For the procedure, see Meta official: Set up development environment
-
Install SideQuest on your PC
- SideQuest official: Get SideQuest (Advanced Installer edition)
-
Connect the Quest over USB and confirm the SideQuest connection indicator turns green
-
Drag and drop the APK onto the SideQuest window
-
Launch it from Unknown Sources in the library
When it doesn’t work
Section titled “When it doesn’t work”- Check that the Hapbeat and the Quest are on the same Wi-Fi (same subnet)
- This build does not pin an address, so every Hapbeat on the same network fires. There is no setting to narrow it down to a single unit
- If that does not resolve it, see the connectivity entries in Q&A and Troubleshooting
License notice
Section titled “License notice”This demo includes sample assets from Unity’s XR Interaction Toolkit.
- XR Interaction Toolkit copyright © Unity Technologies
- License: Unity Companion License