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 weergegeven via de One Pro-bril. Dit hostapparaatmodel is het belangrijkste dat ontwikkelaars moeten begrijpen voordat ze beginnen.
De installatie volgt een duidelijke workflow: bereid Beam Pro voor, installeer Unity en Android-ondersteuning, voeg de XREAL SDK toe, open en test het HelloMR-voorbeeld, bouw de APK, installeer die met ADB op Beam Pro, sluit de One Pro aan en start de app via MyGlasses. Voor bedrijven maakt deze architectuur het eenvoudiger om eigen XREAL-workflows te ontwikkelen en te testen met vertrouwde Android- en Unity-tools, terwijl de applicatielogica op een apart hostapparaat blijft dat beheerd, bijgewerkt en geïntegreerd kan worden met bestaande bedrijfssystemen.
De fout die je 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 op het Android-hostapparaat geïnstalleerd.
Wat is XREAL One Pro?
XREAL One Pro is een bekabelde AR-weergave met een gezichtsveld van 57 graden, Sony Micro-OLED-schermen en XREAL's X1-chip voor ruimtelijke verwerking. De X1-chip zorgt voor native 3DoF, zodat het scherm op zijn plaats blijft wanneer je je hoofd draait, en sinds SDK 3.1.0 ondersteunt de One-serie na een firmware-update ook 6DoF-headtracking met de optionele XREAL Eye-camera. Niets hiervan maakt van de bril een zelfstandige Android-computer.
Bij eigen ontwikkeling met de XREAL SDK neemt de aangesloten Android-host de applicatie voor zijn rekening. De One Pro is het draagbare scherm en het trackingeindpunt.
Wat je nodig hebt voor deze gids
· Een Windows- of macOS-computer.
· XREAL Beam Pro, of een Samsung-vlaggenschiptoestel dat 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. Beam Pro is de host die in de hoofdstappen wordt gebruikt.
· Een USB-C-kabel om One Pro met Beam Pro te verbinden.
· Unity Hub en een ondersteunde Unity LTS-versie met Android Build Support. (Uitleg in het artikel)
· De actuele XREAL SDK voor Unity van de downloadpagina voor ontwikkelaars van XREAL. (Uitleg in het artikel)
· Android Debug Bridge (ADB) om de APK op Beam Pro te installeren. (Uitleg in het artikel)
Zo ontwikkel je je eerste XREAL One Pro-app
Stap 1: Bereid Beam Pro voor, het apparaat waarop de app zal draaien
Begin met Beam Pro, want daarop wordt de afgewerkte Android-app geïnstalleerd. Beam Pro is een fysiek handtoestel, niet iets wat je downloadt.
1. Schaf XREAL Beam Pro aan. Koop de Beam Pro-hardware bij XREAL of een erkende verkoper. Hij staat los van de One Pro-bril.
2. Zet hem aan en verbind hem met wifi. Doorloop op Beam Pro de gewone eerste configuratie van Android/nebulaOS.
3. Open MyGlasses op Beam Pro. MyGlasses is de app van XREAL voor het beheer van de bril die op Beam Pro wordt gebruikt.
4. Werk Beam Pro en MyGlasses bij als daarom gevraagd wordt. SDK 3.1.0 hoort bij MyGlasses 1.11.0. Volgens de release note van XREAL werk je eerst MyGlasses bij en sluit je daarna de bril aan, waarna de firmware-update van de bril automatisch start. Beam Pro draait nebulaOS op Android 14, dus de Android 16-waarschuwing van XREAL geldt voor telefoons, niet voor Beam Pro.
5. Verbind One Pro één keer met Beam Pro. Gebruik de USB-C-kabel van de bril. Verschijnt er een firmware-update voor de bril, voer die dan uit voordat je begint te 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 je Unity Editor installeert.
3. Meld je aan of maak een Unity-account aan als daarom gevraagd wordt. Zo krijgt Unity Hub toegang tot de installatie van de editor en de licentieprocedure
Stap 3: Installeer een Unity Editor-versie met Android-ondersteuning
De XREAL SDK draait binnen Unity, dus Unity Editor moet geïnstalleerd zijn voordat je 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 XREAL-documentatie staat.
3. Selecteer Android Build Support. XREAL vereist minimaal Android SDK API-level 31 (Android 12) of hoger, wat de meegeleverde SDK dekt.
4. Rond de installatie af. Wacht tot Unity Hub de editor onder Installs toont.
Ga naar stap 4 wanneer: Unity Editor geïnstalleerd is en Android Build Support erbij zit.
Stap 4: Download de XREAL SDK naar de computer
De XREAL SDK is een bestand dat je later in Unity importeert. Probeer het niet op Beam Pro of op de bril te installeren.
1. Open de downloadpagina voor ontwikkelaars van XREAL. Ga op de ontwikkelcomputer naar developer.xreal.com/download.
2. Zoek XREAL SDK for Unity. Aanvaard de XREAL API-voorwaarden en download de actuele SDK.
3. Bewaar het gedownloade bestand. Het pakket wordt geleverd als een bestand zoals com.xreal.xr.tar.gz.
Ga naar stap 5 wanneer: het XREAL SDK-bestand op de computer is opgeslagen. Open het tar.gz-bestand niet handmatig.
Stap 5: Maak het Unity-project aan
Gebruik nu Unity Hub om het project aan te maken dat later de Android-app wordt die op Beam Pro geïnstalleerd wordt.
1. Open Unity Hub > Projects. Selecteer New project.
2. Kies een gewone 3D-template. Geef het project een eenvoudige naam zoals XREAL-One-Pro-Test en kies waar je 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 het menu is dat je ziet.
Ga naar stap 6 wanneer: Android het actieve buildplatform in Unity is.
Stap 6: Installeer het Unity-pakket dat XREAL nodig heeft
Blijf in Unity Editor. De volgende tools worden aan ditzelfde project toegevoegd.
1. Open Window > Package Manager. Stel in het venster Package Manager de pakketbron in op Unity Registry. Zo zie je de pakketten die Unity aanbiedt.
2. Zoek XR Interaction Toolkit. Selecteer het en klik op Install. XREAL vermeldt de versies 2.5.x en 3.0.x als ondersteund; als Package Manager een nieuwere versie installeert en het voorbeeld niet goed werkt, kies dan 3.0.x in de versielijst.
3. Open het tabblad Samples ervan. Zoek Starter Assets en klik op Import, en importeer daarna ook Hands Interaction Demo. Volgens de troubleshootingpagina van XREAL toont HelloMR zonder deze demo ontbrekende prefabs.
Stap 7: Importeer de XREAL SDK in hetzelfde Unity-project
Je zit nog altijd in Unity. Gebruik nu het XREAL SDK-bestand dat je in stap 4 hebt gedownload.
1. Blijf in Window > Package Manager. Klik op de knop + linksboven. Selecteer daarna: “Add package from tarball”.
2. Zoek het XREAL SDK-bestand dat je eerder hebt gedownload. Ga naar je 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 toe aan je project.
3. Open XREAL XR Plugin in Package Manager > Samples. Importeer Interaction Basics. Zo wordt de kant-en-klare HelloMR-voorbeeldscène toegevoegd waarmee je controleert of de XREAL-installatie werkt.
Stap 8: Schakel XREAL in het project in
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. Daarmee schakel je 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 al de rest op de standaardwaarden staan tot het voorbeeld werkt.
Ga naar stap 9 wanneer: Project Validation geen openstaande vereiste XREAL-instellingen meer toont.
Stap 9: Open het HelloMR-voorbeeld van XREAL
Gebruik het voorbeeld van XREAL voordat je je eigen app schrijft. Zo bevestig je dat Unity, de XREAL SDK, Beam Pro en de bril samen kunnen werken.
1. Open het Project-paneel in Unity. Ga naar Assets > Samples > XREAL XR Plugin > [je SDK-versie] > Interaction Basics.
2. Zoek HelloMR.unity. Dubbelklik op de scène om ze te openen.
3. Pas ze nog niet aan. Bouw eerst het ongewijzigde voorbeeld, zodat je 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 daarna op Build, kies een map op je 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 je een Android-app installeert. In deze workflow 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 je Android-apps op Beam Pro of een telefoon installeert en test.
De app is gebouwd. In de volgende stap breng je die APK over van de computer naar Beam Pro.
1. Verbind Beam Pro via USB-C met 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 je Developer options en USB debugging op de host moet inschakelen; op Android betekent dat dat je onder ‘Over’ zeven keer op ‘Buildnummer’ tikt om de ontwikkelaarsopties te ontgrendelen en daar vervolgens USB-foutopsporing aanzet. Toont Beam Pro een melding met de vraag of USB-foutopsporing vanaf deze computer toegestaan mag worden, selecteer dan Toestaan.
4. Controleer of de computer Beam Pro ziet. Typ in PowerShell:
adb devices
Verschijnt Beam Pro als device, dan werkt de verbinding en kun je verder.
5. Installeer de APK. Zoek eerst het bestand XREAL-HelloMR.apk op je computer. Als je het bijvoorbeeld hebt opgeslagen in een map met de naam XREAL Test op je bureaublad, 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 je APK en druk daarna op Enter.
6. Wacht op Success. Wanneer ADB Success meldt, is de applicatie op Beam Pro geïnstalleerd.
Ga naar stap 12 wanneer: de APK-installatie op de computer Success meldt.:
Stap 12: Verbind One Pro met Beam Pro en open de app
De Android-app staat nu op Beam Pro. Pas nu verplaats je de USB-C-verbinding van de computer naar de bril.
1. Koppel Beam Pro los van de computer.
2. Verbind [XREAL One Pro](https://ai.vr-expert.com/en/ai-glasses/xreal-one-pro) met Beam Pro. Gebruik de USB-C-kabel van XREAL.
3. Open MyGlasses op Beam Pro. Dit is de XREAL-omgeving waarmee je de aangesloten bril beheert en XREAL-3D-applicaties start.
4. Zoek je app in MyGlasses. Ze staat in de lijst onder de Product Name uit Player Settings, niet onder de bestandsnaam van de APK. Selecteer ze en open ze. Ontbreekt ze, of meldt MyGlasses dat de app niet ondersteund wordt op dit apparaat, tik dan met losgekoppelde bril tien keer op het brilpictogram linksboven in MyGlasses om de ontwikkelaarsmodus te openen, en kies ze vervolgens via 'select other MR App'.
5. Keur machtigingen goed als daarom gevraagd wordt.
6. Kijk door de One Pro. De HelloMR-scène zou nu in de bril moeten verschijnen terwijl Beam Pro de applicatie uitvoert.
Stap 13: Voer de eerste kleine eigen aanpassing door
Zodra het ongewijzigde HelloMR-voorbeeld werkt, ga je terug naar Unity en verander je één ding. Zo vermijd je dat je je eigen code debugt voordat de basisinstallatie van XREAL bewezen is.
1. Ga terug naar Unity op de computer. Open de HelloMR-scène. Open het tabblad Scene. Hier bouw je de interface en positioneer je de objecten die zichtbaar worden via de XREAL One Pro.
2. Voeg een Cube toe. Kies GameObject > 3D Object > Cube en plaats hem ongeveer een meter voor de camera. Tekst, knoppen, panelen en geïmporteerde modellen voeg je later op dezelfde manier toe. (HelloMR bevat geen Cube; het voorbeeld van XREAL toont zijn logo-object, dus de Cube uit punt 6 en 7 moet je hier aanmaken.)
3. Selecteer een object in de Hierarchy. Gebruik de Inspector om de positie, grootte, rotatie en andere instellingen ervan te wijzigen.
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 er eigen gedrag nodig is. Om objecten te plaatsen en vorm te geven heb je geen code nodig. Maak alleen een script aan onder Assets > Scripts wanneer 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 12. De Cube zou moeten draaien wanneer de app op Beam Pro draait en via One Pro wordt weergegeven.
Wat dit aantoont: je eigen C#-code wordt uitgevoerd door de Android-applicatie op Beam Pro. De bril toont het resultaat.
Als je een Android-telefoon wilt gebruiken in plaats van Beam Pro
Dezelfde algemene architectuur geldt, maar de host wordt een ondersteunde Android-telefoon. Voor deze route gebruik je MyGlasses niet.
· Gebruik een telefoon die XREAL heeft goedgekeurd. SDK 3.1.0 vermeldt de Samsung Galaxy S25 met Android 15; de compatibiliteitspagina van XREAL vermeldt ook de Galaxy S24 met Android 14 en zegt dat alleen Samsung-vlaggenschepen ondersteund worden. Controleer de Android-versie van de telefoon voordat je hem koopt of bijwerkt: XREAL vraagt ontwikkelaars hun ontwikkeltoestellen niet naar Android 16 bij te werken, en Samsung levert sinds september 2025 Android 16 (One UI 8) voor beide modellen. Schakel Samsung DeX uit tijdens het ontwikkelen.
· Installeer de APK op de telefoon in plaats van op Beam Pro.
· Verbind XREAL One Pro via USB-C met de telefoon.
· Open ControlGlasses, zoek de geïnstalleerde XREAL-app en start ze.
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 hem op Beam Pro of op 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 gebruik je in plaats daarvan ControlGlasses.
- Met eigen code beginnen voordat HelloMR werkt: voer eerst het ongewijzigde voorbeeld uit en pas daarna aan.
- Beam Pro met de computer verbonden laten wanneer je de bril probeert te gebruiken: koppel Beam Pro na het installeren van de APK los van de computer en verbind One Pro met Beam Pro.
Conclusie
Ontwikkelen voor XREAL One Pro begint met het onderscheiden van de drie onderdelen van het systeem: op de computer maak je het Unity-project, op Beam Pro of een ondersteunde Android-telefoon draait de Android-APK effectief, en XREAL One Pro is het draagbare weergave- en trackingapparaat. Met Beam Pro als duidelijkste route richt je eerst de fysieke Beam Pro in, installeer je Unity Hub en een ondersteunde Unity Editor op de computer, download en importeer je de XREAL SDK, schakel je de XREAL-plug-in in, open je het HelloMR-voorbeeld, bouw je een APK, installeer je die APK met ADB op Beam Pro, koppel je Beam Pro daarna los van de computer, sluit je de One Pro aan en start je de app via MyGlasses. Voor bedrijven helpt het begrijpen van deze architectuur vóór de start van de ontwikkeling om het juiste hardware-, beveiligings- en uitrolplan te bepalen, maakt het pilots makkelijker te troubleshooten en voorkomt het dat teams tijd steken in bouwen voor een model met zelfstandige brillen dat de One Pro niet gebruikt.
Plan je een applicatie voor XREAL One Pro? Begin met één Beam Pro, één One Pro en het HelloMR-voorbeeld, bewijs eerst de workflow van host naar bril en voeg daarna alleen de Unity-functies toe die de zakelijke use case vereist.
























