Documentation
AR glasses and headsets
To see your AR Works projects on AR glasses or a headset, you need the AREngine app. A link or QR code on its own is not enough.
Why a link is not enough
An AR Works link opens in a web browser. On a phone that works, but a browser on glasses or a headset cannot use the device's cameras and sensors the way the AREngine app can.
- A headset's browser gives a web page no camera picture, so picture tracking and hand tracking cannot run there.
- The web viewer has an AR mode for headsets, called WebXR, but it has never been run on a headset.
AREngine plays your project from a .arengine file that you download from AR Works, not from a link.
Which device needs which app
There are three kinds of device, and each needs AREngine in a different place.
Display glasses that plug into a phone
XREAL One, One Pro and XREAL Air glasses, VITURE, Rokid Max and RayNeo Air plug into a phone with a cable. They have no camera that an app can use.
- Install AREngine on your Android phone, not on the glasses.
- Open a project in AREngine and plug the glasses in. Glasses the app knows show the project by themselves. If yours do not, choose Show on glasses in the player's menu.
- The phone then becomes a touchpad: drag to move the pointer, a small circle on the glasses, and tap to select. Over something that reacts to a tap, the circle becomes a larger gold dot. Tap with two fingers to open a menu on the glasses.
- On XREAL glasses AREngine tries to turn the scene as you turn your head. VITURE, Rokid Max and RayNeo Air glasses show a fixed 3D view instead: drag on the phone to look round it.
- No camera sees your printed picture, so a project that starts on one is shown without it.
Testers are now trying AREngine on their AR glasses. The first to run it used XREAL One Pro glasses, with phones on Android 12 and on the latest Android. AREngine 0.1.8 fixes what they found: on XREAL One, One Pro and 1S glasses every scene was upside down. In 0.1.8 a room project also starts by itself in front of you.
Android glasses with their own camera
INMO Air 3, Rokid Glasses, RayNeo X3 Pro and Vuzix Blade 2 glasses are small Android computers with a camera of their own.
- Install AREngine on the glasses themselves. AREngine follows printed pictures, the room and your hands with the glasses' camera, as on a phone.
- You see the real world through the clear lenses, and the project is drawn over it.
- Choose Line up with the real world in the player's menu. Hold a print of the project's picture in front of you and move the outline until it sits on the print.
- On glasses without a touch screen, copy the project's .arengine file into the app's own folder on the glasses. The app's Home screen then lists it.
Headsets
Meta Quest 3 and 3S, Samsung Galaxy XR, XREAL Aura, PICO 4 Ultra and other OpenXR headsets need a separate build of the app, called AREngine XR.
- AREngine XR is not in an app store. Download it from the AREngine page, in the AREngine ZIP with the setup guide, and install it on the headset by hand. It sits beside the ordinary AREngine app and does not replace it.
- The headset's own tracking places a world scene, and your hands come from the headset's own hand tracking. Pinch, or press a controller's trigger, to select.
- A project that starts on a printed picture is shown without its picture.
Help us test it
If you have AR glasses or a headset, a device report from it helps us make AREngine work there. The report holds nothing personal.
- Open AREngine on the glasses or headset, or on the phone your glasses plug into.
- Open About, then Device report.
- Press Send to AR Works. Your browser opens a page on ar.works that shows the report, and nothing is sent until you press Send there.
Get the app
The AREngine app for Android is on the AREngine page. Play it in the AREngine app says how to make a .arengine file from your project.