Samenvatting
XREAL One Pro voert de eigen applicatie niet zelf uit. De app wordt in Unity op een computer gemaakt, als Android-APK geïnstalleerd op XREAL Beam Pro of een ander ondersteund Android-hostapparaat en vervolgens via de One Pro-bril weergegeven. Dit hostapparaatmodel is het belangrijkste wat ontwikkelaars moeten begrijpen voordat ze beginnen.
De installatie volgt een duidelijk stappenplan: Beam Pro voorbereiden, Unity en Android-ondersteuning installeren, de XREAL SDK toevoegen, het HelloMR-voorbeeld openen en testen, de APK bouwen, die met ADB op Beam Pro installeren, de One Pro aansluiten en de app via MyGlasses starten. Voor bedrijven maakt deze architectuur het eenvoudiger om eigen XREAL-werkprocessen te ontwikkelen en te testen met vertrouwde Android- en Unity-tools. De applicatielogica blijft daarbij op een apart hostapparaat dat u kunt beheren, bijwerken en koppelen aan bestaande bedrijfssystemen.
De fout die u moet vermijden: plan geen project waarbij de APK rechtstreeks op [XREAL One Pro](https://ai.vr-expert.com/en/ai-glasses/xreal-one-pro) wordt geïnstalleerd. De APK wordt geïnstalleerd op het Android-hostapparaat.
Wat is XREAL One Pro?
XREAL One Pro is een tethered AR-display met een field of view van 57 graden, Sony Micro-OLED-displays en de X1-chip van XREAL voor ruimtelijke verwerking. De X1-chip biedt native 3DoF, zodat het scherm op zijn plaats blijft als u uw hoofd draait. Sinds SDK 3.1.0 ondersteunt de One-serie na een firmware-update ook 6DoF-headtracking met de optionele XREAL Eye-camera. Dat maakt de bril echter nog geen standalone Android-computer.
Bij ontwikkeling op maat met de XREAL SDK verwerkt de aangesloten Android-host de applicatie. De One Pro is het draagbare display en het eindpunt voor tracking.
Wat u nodig hebt voor deze handleiding
· Een Windows- of macOS-computer.
· XREAL Beam Pro, of een Samsung-vlaggenschiptelefoon die XREAL heeft getest: de Galaxy S24 met Android 14 of de Galaxy S25 met Android 15. XREAL ondersteunt alleen Samsung-vlaggenschepen en vraagt ontwikkelaars geen telefoons te gebruiken die naar Android 16 zijn bijgewerkt, zolang de compatibiliteitsmelding van kracht is. In de hoofdstappen wordt Beam Pro als host gebruikt.
· Een USB-C-kabel om de One Pro op Beam Pro aan te sluiten.
· Unity Hub en een ondersteunde Unity LTS-versie met Android Build Support. (Instructies in het artikel)
· De actuele XREAL SDK for Unity van de downloadpagina voor ontwikkelaars van XREAL. (Instructies in het artikel)
· Android Debug Bridge (ADB) om de APK op Beam Pro te installeren. (Instructies in het artikel)
Zo ontwikkelt u uw eerste XREAL One Pro-app
Stap 1: bereid Beam Pro voor, het apparaat waarop de app draait
Begin met Beam Pro, want daarop wordt de uiteindelijke Android-app geïnstalleerd. Beam Pro is een fysiek handheld apparaat, niet iets wat u downloadt.
1. Schaf XREAL Beam Pro aan. Koop de Beam Pro-hardware bij XREAL of een geautoriseerde reseller. Het is een apart apparaat, los van de One Pro-bril.
2. Zet het apparaat aan en verbind het met Wi-Fi. Doorloop op Beam Pro de gebruikelijke eerste installatie van Android/nebulaOS.
3. Open MyGlasses op Beam Pro. MyGlasses is de XREAL-app voor het beheer van de bril op Beam Pro.
4. Werk Beam Pro en MyGlasses bij als daarom wordt gevraagd. SDK 3.1.0 hoort bij MyGlasses 1.11.0. Volgens de release notes van XREAL werkt u eerst MyGlasses bij en sluit u daarna de bril aan; dat start automatisch de firmware-update van de bril. Beam Pro draait nebulaOS op Android 14, dus de Android 16-waarschuwing van XREAL geldt voor telefoons, niet voor Beam Pro.
5. Sluit de One Pro eenmalig aan op Beam Pro. Gebruik de USB-C-kabel van de bril. Verschijnt er een firmware-update voor de bril, voer die dan uit voordat u gaat ontwikkelen.
****
Stap 2: installeer Unity Hub op de ontwikkelcomputer
1. Open de website van Unity op de computer. Download Unity Hub voor Windows of macOS.
2. Installeer en open Unity Hub. Unity Hub is een apart desktopprogramma waarmee u Unity Editor installeert.
3. Meld u aan of maak een Unity-account aan als daarom wordt gevraagd. Zo krijgt Unity Hub toegang tot de installatie van de editor en het licentieproces
Stap 3: installeer een Unity Editor-versie met Android-ondersteuning
De XREAL SDK draait binnen Unity, dus Unity Editor moet geïnstalleerd zijn voordat u de SDK kunt importeren.
1. Open Unity Hub > Installs. Selecteer Install Editor.
2. Kies een ondersteunde LTS-versie. XREAL ondersteunt Unity 2021.3.X, 2022.3.X en 6000.0.X LTS. Gebruik een ondersteunde versie die in de actuele documentatie van XREAL staat.
3. Selecteer Android Build Support. XREAL vereist minimaal Android SDK API-level 31 (Android 12) of hoger; de meegeleverde SDK voldoet daaraan.
4. Rond de installatie af. Wacht tot Unity Hub de editor onder Installs toont.
Ga door naar stap 4 als: Unity Editor is geïnstalleerd, inclusief Android Build Support.
Stap 4: download de XREAL SDK naar de computer
De XREAL SDK is een bestand dat u later in Unity importeert. Probeer het niet op Beam Pro of de bril te installeren.
1. Open de pagina XREAL Developer Download. Ga op de ontwikkelcomputer naar developer.xreal.com/download.
2. Zoek XREAL SDK for Unity. Accepteer de API-voorwaarden van XREAL en download de actuele SDK.
3. Bewaar het gedownloade bestand. Het pakket wordt geleverd als een bestand zoals com.xreal.xr.tar.gz.
Ga door naar stap 5 als: het XREAL SDK-bestand op de computer is opgeslagen. Open het tar.gz-bestand niet handmatig.
Stap 5: maak het Unity-project aan
Maak nu in Unity Hub het project aan dat later de Android-app wordt die op Beam Pro wordt geïnstalleerd.
1. Open Unity Hub > Projects. Selecteer New project.
2. Kies een standaard 3D-template. Geef het project een eenvoudige naam, zoals XREAL-One-Pro-Test, en kies waar u het opslaat.
3. Maak het project aan. Wacht tot Unity Editor opent.
4. Zet het project om naar Android. Open in Unity Editor File > Build Settings. Selecteer Android en klik op Switch Platform. Gebruik in Unity 6 File > Build Profiles als dat menu wordt getoond.
Ga door naar stap 6 als: Android het actieve buildplatform in Unity is.
Stap 6: installeer het Unity-pakket dat XREAL nodig heeft
Blijf in Unity Editor. De volgende tools voegt u aan hetzelfde project toe.
1. Open Window > Package Manager. Stel in het venster Package Manager de pakketbron in op Unity Registry. Dan ziet u de pakketten die Unity aanbiedt.
2. Zoek XR Interaction Toolkit. Selecteer het pakket en klik op Install. XREAL noemt versie 2.5.x en 3.0.x als ondersteund. Installeert de Package Manager een nieuwere versie en werkt het voorbeeld niet goed, kies dan 3.0.x uit de versielijst.
3. Open het tabblad Samples. Zoek Starter Assets en klik op Import. Importeer daarna ook Hands Interaction Demo. Volgens de troubleshootingpagina van XREAL toont HelloMR zonder dit onderdeel ontbrekende prefabs.
Stap 7: importeer de XREAL SDK in hetzelfde Unity-project
U werkt nog steeds in Unity. Gebruik nu het XREAL SDK-bestand dat u in stap 4 hebt gedownload.
1. Blijf in Window > Package Manager. Klik linksboven op de knop +. Selecteer daarna: “Add package from tarball”.
2. Zoek het XREAL SDK-bestand dat u eerder hebt gedownload. Ga naar de map Downloads, selecteer het bestand met een naam als com.xreal.xr.tar.gz en klik op Open. Unity voegt nu de XREAL XR Plugin aan uw project toe.
3. Open XREAL XR Plugin in Package Manager > Samples. Importeer Interaction Basics. Daarmee voegt u de kant-en-klare HelloMR-voorbeeldscène toe waarmee u controleert of de XREAL-installatie werkt.
Stap 8: schakel XREAL in voor het project
De SDK is aanwezig, maar Unity moet nog weten dat dit Android-project de XREAL-plug-in moet gebruiken.
1. Open Edit > Project Settings > XR Plug-in Management. Selecteer het tabblad Android.
2. Vink XREAL aan. Hiermee schakelt u de XREAL XR-provider in voor de Android-build.
3. Open Project Validation. Klik op Fix All voor alle vereiste XREAL-wijzigingen.
4. Open XR Plug-in Management > XREAL. Stel voor een One Pro zonder XREAL Eye Initial Tracking Type in op MODE_3DOF, Initial Input Source op Controller (Beam Pro of de telefoon fungeert als 3DoF-controller) en Support Devices op XREAL_DEVICE_CATEGORY_VISION, de categorie van XREAL voor 3DoF-brillen zoals de One-serie. Laat alle andere instellingen op de standaardwaarde staan tot het voorbeeld werkt.
Ga door naar stap 9 als: Project Validation geen onopgeloste vereiste XREAL-instellingen meer toont.
Stap 9: open het HelloMR-voorbeeld van XREAL
Gebruik het voorbeeld van XREAL voordat u uw eigen app schrijft. Zo bevestigt u dat Unity, de XREAL SDK, Beam Pro en de bril samenwerken.
1. Open het Project-paneel in Unity. Ga naar Assets > Samples > XREAL XR Plugin > [uw SDK-versie] > Interaction Basics.
2. Zoek HelloMR.unity. Dubbelklik op de scène om die te openen.
3. Pas het nog niet aan. Bouw eerst het ongewijzigde voorbeeld, zodat u weet dat de ontwikkelomgeving werkt.
Stap 10: bouw de Android-APK op de computer
Unity zet het HelloMR-project nu om in een Android-appbestand. Dat bestand heet een APK.
1. Open File > Build Settings of Build Profiles. Selecteer Add Open Scenes, zodat HelloMR wordt meegenomen.
2. Controleer of Android actief is. Is dat niet zo, schakel dan over naar Android.
3. Klik op Build. Stel de Player Settings in en bouw daarna. Vul in Player Settings Company Name en Product Name in (MyGlasses toont de Product Name, dus gebruik XREAL-HelloMR) en controleer of Scripting Backend op IL2CPP staat met ARM64 als doelarchitectuur; XREAL vereist beide. Klik vervolgens op Build, kies een map op uw computer en sla het bestand op als XREAL-HelloMR.apk
4. Wacht tot de build klaar is. De APK staat nu op de computer, maar nog niet op Beam Pro.
Wat een APK is: een APK is het bestand waarmee u een Android-app installeert. In dit werkproces komt de APK op Beam Pro terecht, niet op [XREAL One Pro](https://ai.vr-expert.com/en/ai-glasses/xreal-one-pro).
Stap 11: installeer de APK op Beam Pro
ADB: Android Debug Bridge, een computertool waarmee u Android-apps op Beam Pro of een telefoon installeert en test.
De app is gebouwd. In de volgende stap zet u die APK van de computer over naar Beam Pro.
1. Sluit Beam Pro via USB-C aan op de computer.
2. Open Terminal of PowerShell op de computer.
3. Schakel USB-foutopsporing in op Beam Pro. De handleiding van XREAL zegt alleen dat u Ontwikkelaarsopties en USB-foutopsporing op de host moet inschakelen. Op Android betekent dat: tik onder “Over” zeven keer op “Buildnummer” om Ontwikkelaarsopties te ontgrendelen en zet daar vervolgens USB-foutopsporing aan. Vraagt Beam Pro of USB-foutopsporing vanaf deze computer is toegestaan, kies dan Toestaan.
4. Controleer of de computer Beam Pro ziet. Typ in PowerShell:
adb devices
Staat Beam Pro in de lijst als device, dan werkt de verbinding en kunt u verder.
5. Installeer de APK. Zoek eerst het bestand XREAL-HelloMR.apk op uw computer. Hebt u het bijvoorbeeld opgeslagen in een map met de naam XREAL Test op uw bureaublad, dan kan het Windows-pad er zo uitzien:
C:\Users\YourName\Desktop\XREAL Test\XREAL-HelloMR.apk
Typ in PowerShell:
adb install -r "C:\Users\YourName\Desktop\XREAL Test\XREAL-HelloMR.apk"
Vervang het voorbeeldpad door de werkelijke locatie van uw APK en druk op Enter.
6. Wacht op Success. Meldt ADB Success, dan is de applicatie op Beam Pro geïnstalleerd.
Ga door naar stap 12 als: de APK-installatie op de computer Success meldt.
Stap 12: sluit de One Pro aan op Beam Pro en open de app
De Android-app staat nu op Beam Pro. Pas nu verplaatst u de USB-C-verbinding van de computer naar de bril.
1. Koppel Beam Pro los van de computer.
2. Sluit [XREAL One Pro](https://ai.vr-expert.com/en/ai-glasses/xreal-one-pro) aan op Beam Pro. Gebruik de USB-C-kabel van XREAL.
3. Open MyGlasses op Beam Pro. Dit is de XREAL-omgeving waarmee u de aangesloten bril beheert en XREAL-3D-applicaties start.
4. Zoek uw app in MyGlasses. De app staat vermeld onder de Product Name uit Player Settings, niet onder de bestandsnaam van de APK. Selecteer en open de app. Ontbreekt de app, of meldt MyGlasses dat de app niet op dit apparaat wordt ondersteund? Tik dan, met de bril losgekoppeld, tien keer op het brilpictogram linksboven in MyGlasses om de ontwikkelaarsmodus te openen. Kies de app vervolgens via 'select other MR App'.
5. Geef toestemmingen als daarom wordt gevraagd.
6. Kijk door de One Pro. De HelloMR-scène hoort nu in de bril te verschijnen, terwijl Beam Pro de applicatie uitvoert.
Stap 13: breng de eerste kleine eigen wijziging aan
Werkt het ongewijzigde HelloMR-voorbeeld, ga dan terug naar Unity en wijzig één ding. Zo voorkomt u dat u uw eigen code debugt voordat bewezen is dat de basisinstallatie van XREAL werkt.
1. Ga terug naar Unity op de computer. Open de HelloMR-scène. Open het tabblad Scene. Hier bouwt u de interface en positioneert u de objecten die via de XREAL One Pro zichtbaar worden.
2. Voeg een Cube toe. Kies GameObject > 3D Object > Cube en plaats de kubus ongeveer een meter voor de camera. Tekst, knoppen, panelen en geïmporteerde modellen voegt u later op dezelfde manier toe. (HelloMR bevat geen Cube; het voorbeeld van XREAL toont een logo-object, dus de Cube uit punt 6 en 7 moet u hier aanmaken.)
3. Selecteer een object in de Hierarchy. Wijzig in de Inspector de positie, grootte, rotatie en andere instellingen.
4. Richt de lay-out van de applicatie in. Bouw de interface die het project nodig heeft, zoals instructies, een productmodel, een statuspaneel of een knop Start Inspection.
5. Voeg alleen C#-code toe als u eigen gedrag nodig hebt. Voor het plaatsen en vormgeven van objecten is geen code nodig. Maak alleen een script aan onder Assets > Scripts als een object moet bewegen, op invoer moet reageren, informatie moet wijzigen of verbinding moet maken met externe data.
Dit optionele script laat bijvoorbeeld een object draaien:
using UnityEngine;
public class SpinObject : MonoBehaviour
{
public float speed = 30f;
void Update()
{
transform.Rotate(0f, speed * Time.deltaTime, 0f);
}
}
6. Koppel het script aan de Cube. Sleep SpinObject vanuit Assets > Scripts naar de Cube in de Hierarchy.
7. Bouw en installeer opnieuw. Herhaal stap 10 tot en met 12. De Cube hoort te draaien wanneer de app op Beam Pro draait en via de One Pro wordt weergegeven.
Wat dit laat zien: uw eigen C#-code wordt uitgevoerd door de Android-applicatie op Beam Pro. De bril toont het resultaat.
Als u een Android-telefoon wilt gebruiken in plaats van Beam Pro
Dezelfde architectuur blijft gelden, maar de host is dan een ondersteunde Android-telefoon. Voor deze route gebruikt u MyGlasses niet.
· Gebruik een telefoon die XREAL heeft goedgekeurd. SDK 3.1.0 noemt de Samsung Galaxy S25 met Android 15; de compatibiliteitspagina van XREAL noemt ook de Galaxy S24 met Android 14 en vermeldt dat alleen Samsung-vlaggenschepen worden ondersteund. Controleer de Android-versie van de telefoon voordat u die koopt of bijwerkt: XREAL vraagt ontwikkelaars ontwikkelapparaten niet naar Android 16 bij te werken, en Samsung levert Android 16 (One UI 8) sinds september 2025 voor beide modellen uit. Schakel Samsung DeX uit tijdens het ontwikkelen.
· Installeer de APK op de telefoon in plaats van op Beam Pro.
· Sluit XREAL One Pro via USB-C aan op de telefoon.
· Open ControlGlasses, zoek de geïnstalleerde XREAL-app en start die.
Haal de twee routes niet door elkaar: Beam Pro gebruikt MyGlasses. Een ondersteunde Android-telefoon gebruikt ControlGlasses.
Veelgemaakte fouten bij het ontwikkelen
- De APK op de bril proberen te installeren: installeer de APK op Beam Pro of de ondersteunde Android-telefoon.
- Denken dat Beam Pro een app is: Beam Pro is aparte fysieke hardware. MyGlasses is de XREAL-app die op Beam Pro wordt gebruikt.
- MyGlasses gebruiken op een gewone Android-telefoon: bij ontwikkeling op een telefoon gebruikt u in plaats daarvan ControlGlasses.
- Met eigen code beginnen voordat HelloMR werkt: voer eerst het ongewijzigde voorbeeld uit en pas het daarna aan.
- Beam Pro aangesloten laten op de computer terwijl u de bril wilt gebruiken: koppel Beam Pro na het installeren van de APK los van de computer en sluit de One Pro aan op Beam Pro.
Conclusie
Ontwikkelen voor XREAL One Pro begint met het onderscheiden van de drie onderdelen van het systeem: op de computer maakt u het Unity-project, op Beam Pro of een ondersteunde Android-telefoon draait de Android-APK daadwerkelijk, en XREAL One Pro is het draagbare display- en trackingapparaat. Met Beam Pro als duidelijkste route richt u eerst de fysieke Beam Pro in, installeert u Unity Hub en een ondersteunde Unity Editor op de computer, downloadt en importeert u de XREAL SDK, schakelt u de XREAL-plug-in in en opent u het HelloMR-voorbeeld. Daarna bouwt u een APK, installeert u die met ADB op Beam Pro, koppelt u Beam Pro los van de computer, sluit u de One Pro aan en start u de app via MyGlasses. Voor bedrijven geldt: wie deze architectuur begrijpt voordat de ontwikkeling start, kan het juiste plan voor hardware, beveiliging en uitrol opstellen. Problemen in pilots zijn dan eenvoudiger op te sporen, en teams verspillen geen tijd aan ontwikkelen voor een standalone-brilmodel dat de One Pro niet gebruikt.
Plant u een applicatie voor XREAL One Pro? Begin met één Beam Pro, één One Pro en het HelloMR-voorbeeld, toon eerst aan dat het werkproces van host naar bril werkt en voeg daarna alleen de Unity-functies toe die de zakelijke toepassing vereist.
