Samenvatting
Kies Unity als uw zakelijke toepassing interactieve 3D-content nodig heeft, of Android Studio als het om een native Android-interface gaat. De installatie is voltooid wanneer de benodigde tools zijn geïnstalleerd, het project de configuratiecontroles doorstaat en uw testapparaat of emulator beschikbaar is.
De instructies volgen de officiële documentatie van Android XR. Controleer Aura-specifieke ontwikkelpoorten, firmwaremenu's en machtigingen aan de hand van de onboardinginstructies die bij uw exemplaar zijn geleverd. Deze handleiding pretendeert niet dat de stappen fysiek op een Aura zijn getest.
Kies uw ontwikkelroute
Kies Unity als uw project 3D-modellen, interactieve training of simulatie gebruikt, of als uw ontwikkelaars al met Unity en C# werken. Unity biedt een visuele werkomgeving waarin u content ordent en XR-functies configureert. U kunt de omgeving inrichten zonder code te schrijven of een prototype te bouwen.
Kies Android Studio als u een zakelijke Android-app uitbreidt of native interfaces maakt, zoals werkinstructies, formulieren of taakpanelen. Deze route gebruikt Kotlin en de Jetpack XR-bibliotheken van Google. Beide routes kunnen later via een API – een vastgelegde manier waarop software informatie uitwisselt – met bedrijfssystemen koppelen. Kies de route dus op basis van de interface van de toepassing en de vaardigheden van uw team.
Belangrijkste ontwikkeleditor:
- Unity-route: Unity Editor, geïnstalleerd via Unity Hub
- Android Studio-route: Android Studio
Taal voor verdere ontwikkeling:
- Unity-route: C#
- Android Studio-route: Kotlin
Android-buildtools:
- Unity-route: Android Build Support, inclusief SDK, NDK en OpenJDK
- Android Studio-route: Android SDK-tools, geïnstalleerd via SDK Manager
XR-basisondersteuning:
- Unity-route: OpenXR Plugin, geïnstalleerd via Unity Package Manager
- Android Studio-route: Jetpack XR SDK-bibliotheken, gedownload via Gradle
Platformspecifieke XR-ondersteuning:
- Unity-route: package Unity OpenXR: Android XR
- Android Studio-route: XR-projecttemplate en de benodigde Jetpack XR-bibliotheken
Wat de XR-tools betekenen:
- Unity-route: OpenXR is een gemeenschappelijke interface tussen een XR-app en de runtime van het apparaat: de systeemsoftware die XR-functies uitvoert
- Android Studio-route: Jetpack XR SDK is de verzameling bibliotheken van Google voor native ruimtelijke interfaces en XR-functies
Verbinding en diagnose:
- Unity-route: ADB, de tool Android Debug Bridge
- Android Studio-route: ADB en Logcat in Android Studio, dat diagnostische meldingen weergeeft
Bereid uw werkstation en ontwikkeltoegang voor
Zorg voor een ondersteunde ontwikkelcomputer, een betrouwbare internetverbinding voor het downloaden van dependencies, een goedgekeurde projectmap van uw organisatie en een USB-datakabel. De systeemeisen voor de emulator verschillen van die voor de editor. Raadpleeg de hardwarepagina van Google voor de XR-emulator voordat u op een virtueel apparaat vertrouwt. Een virtueel apparaat is een softwaresimulatie van een Android-apparaat. [4]
Gebruik een Aura-exemplaar met geautoriseerde ontwikkelaarstoegang, de meegeleverde brilverbinding en de ontwikkelverbinding die XREAL documenteert. Controleer de regionale levering en de onboarding van de kit voordat u een workshopdatum vastlegt. De actuele pagina's van XREAL en regionale pagina's kunnen verschillende informatie over beschikbaarheid geven; een productvermelding alleen zegt niets over de levertermijn. [1]
Controleer voor zakelijk gebruik of uw organisatie in aanmerking komt voor de juiste Unity-licentie en welke Industry-voorwaarden van toepassing zijn voordat u Unity commercieel inzet. Gebruik versiebeheer dat uw organisatie zelf beheert, goedgekeurde packagebronnen en testdata. Android Studio en Unity zijn ontwikkeltools voor professionele toepassingen. Dat u ze installeert, betekent nog niet dat de Aura ondersteuning biedt voor zakelijk apparaatbeheer.
Route A: de Unity-ontwikkelomgeving inrichten
Met deze route installeert u Unity en de bijbehorende Android-tools, maakt u een leeg project aan en schakelt u ondersteuning voor Android XR in. Zo is de werkomgeving klaar voor verdere ontwikkeling.
Stap 1 | Installeer de Unity-editor
Unity Hub beheert uw editorinstallaties; de Unity Editor is de werkomgeving waarin u projecten configureert en later uw toepassing ontwikkelt.
Installeer Unity Hub via de officiële website van Unity en open het programma. Ga naar Installs en kies Install Editor. Kies een ondersteunde release van Unity 6.5 (of nieuwer) die compatibel is met het Android XR-package dat u gaat gebruiken. Zo krijgt u volledige ondersteuning voor input via het trackpad van de puck en voor andere functies. De installatiepagina van Google noemt momenteel 6000.0.58f2 of hoger; daarnaast gelden de eisen van nieuwere packages. [5]
Stap 2 | Voeg de Android-buildtools toe
Met deze modules zet Unity uw project om in een Android-app.
XREAL Aura draait op Android XR en heeft dus een Android-app nodig die het besturingssysteem kan installeren en uitvoeren. Uw Unity-project bevat bewerkbare bestanden voor ontwikkeling; de Android-buildtools verpakken en compileren die bestanden tot een installeerbare app, meestal een APK om op het apparaat te testen.
Selecteer bij de installatiemodules Android Build Support en de onderliggende onderdelen, klik daarna op Continue en doorloop de installatiestappen. Deze tools moeten worden geïnstalleerd:
· Android SDK (Software Development Kit)
· Android NDK (Native Development Kit): zet code op lager niveau om in een vorm die de processor van het apparaat kan uitvoeren.
· JDK (Java Development Kit)
Gebruikt u een bestaande editor? Ga dan terug naar Unity Hub > Installs, open het menu van de editor, kies Add modules, selecteer dezelfde onderdelen en klik op Installs.
Stap 3 | Maak een project aan
In een leeg project kunt u de ontwikkelomgeving voor Android XR configureren.
Open in Unity Hub Projects > New project. Selecteer de geïnstalleerde editor en kies Universal 3D. Geef het project de naam AuraDevelopmentSetup, kies een map en selecteer Create project. Universal 3D gebruikt URP, de Universal Render Pipeline die de graphics van uw toepassing tekent.
Stap 4 | Controleer de toolpaden
Unity moet weten waar de compatibele Android-buildtools zijn geïnstalleerd.
Open in de Unity Editor Edit > Preferences > External Tools (op macOS: Unity > Settings of Preferences). Laat de door Unity meegeleverde SDK (Android-platformtools), NDK (compilertools voor native code) en JDK (Java-buildtools) geselecteerd. Deze versies zijn afgestemd op uw Unity-editor, wat buildfouten helpt voorkomen. Vervang ze niet door losse toolversies uit Android Studio alleen omdat beide geïnstalleerd zijn.
Configureer uw ontwikkelomgeving voor XREAL Aura in Unity
OpenXR is een open standaard waarmee XR-toepassingen communiceren met compatibele runtimes op apparaten. Installeer in Unity de OpenXR Plugin voor de basisverbinding en Unity OpenXR: Android XR voor ondersteuning van Android XR via Package Manager. AR Foundation is de gemeenschappelijke interface van Unity voor ondersteunde AR-functies, zoals omgevingsherkenning.
Stap 1 | Selecteer Android XR als buildtarget
Het buildtarget bepaalt op welk platform de toepassing moet draaien.
Open File > Build Profiles. Voeg in Unity 6.1 of nieuwer het platformprofiel Android XR toe of selecteer het, en schakel ernaar over. Volgens de documentatie van Unity kan het compatibele Android XR-package hierbij automatisch worden geïnstalleerd. Gebruikt uw ondersteunde editor in plaats daarvan het Android-platform? Selecteer dan Android en configureer OpenXR handmatig. [7]
Stap 2 | Installeer de OpenXR-packages
Packages voegen de softwarecomponenten toe die uw Unity-scène met Android XR verbinden.
Open Window > Package Management > Package Manager, of Window > Package Manager in editors met de oudere menu-indeling. Controleer of OpenXR Plugin en Unity OpenXR: Android XR zijn geïnstalleerd. Ontbreekt het Android XR-package? Kies dan in het plusmenu Add package by name en voer com.unity.xr.androidxr-openxr in. De identifier van het OpenXR-basispackage is com.unity.xr.openxr. Laat Package Manager de compatibele dependencies oplossen. [6]
Stap 3 | Schakel de XR-provider in
Door een package te installeren wordt het beschikbaar; door de provider in te schakelen kan de toepassing het ook gebruiken.
Open Edit > Project Settings > XR Plug-in Management. Schakel OpenXR in op het tabblad Android. Open daaronder de sectie OpenXR en schakel de featuregroep Android XR in. Schakel Android XR: Session in als u functies van AR Foundation gebruikt. Schakel Android XR: AR Session in voor versie 1.0. Schakel voor deze build geen andere, niet-relevante providers in. [8]
Stap 4 | Valideer het project
Validatie spoort instellingen op die een ondersteunde XR-build in de weg zouden staan.
Open XR Plug-in Management > Project Validation en selecteer Android. Bekijk de vereiste punten, los ze op en controleer opnieuw. De validatie-eisen van het specifieke package gaan voor op instellingen die u uit een oudere tutorial hebt overgenomen.
Stap 5 | Houd de input-eisen eenvoudig
Schakel alleen functies in die uw geplande toepassing nodig heeft en die het doelapparaat ondersteunt.
Laat optionele inputfuncties liggen tot de ontwikkelfase van de toepassing, tenzij uw project of template ze vereist. Een profiel voor eye gaze of controllers inschakelen voegt die hardware niet toe aan de Aura. Controleer eventuele vereiste interactie-instellingen in Project Validation voordat u verdergaat.
Android XR Extensions for Unity van Google is een extra package met aanvullende functies. Het staat los van Unity OpenXR: Android XR. U hoeft het niet toe te voegen alleen omdat de namen op elkaar lijken; voeg het toe wanneer uw toepassing een functie nodig heeft die het levert. [9]
Controleer de rendering- en Android-buildinstellingen
Vulkan is de grafische interface die renderwerk naar de GPU stuurt. Selecteer in Edit > Project Settings > Player de optie Android > Other Settings. Is Auto Graphics API ingeschakeld? Schakel die uit en zet Vulkan bovenaan. Voor een eenvoudige URP-basisconfiguratie schakelt u HDR uit in het URP-asset en post-processing in het bijbehorende renderer-asset. Google raadt deze instellingen aan voor Android XR. [5]
Stel in dezelfde Player-instellingen een unieke package-identifier in, zoals com.yourcompany.aurapilot. Selecteer onder Configuration IL2CPP en ARM64 voor de build voor het fysieke apparaat. IL2CPP zet C#-code om in native code; ARM64 is de processorarchitectuur waarvoor de build bedoeld is. Controleer de validatie van de geïnstalleerde packages en de apparaatvereisten op eventuele extra beperkingen.
Google noemt API 24 als minimum voor de OpenXR-loader, niet als versie van het besturingssysteem van de Aura. Kies een minimaal API-niveau dat ook voldoet aan de eisen van alle geïnstalleerde packages, en een geïnstalleerde target SDK die past bij uw editor en uw distributie-eisen. Stel GameActivity in als entrypoint van de toepassing, schakel Activity uit en schakel Resizable Activity in onder Resolution and Presentation, zoals Google voorschrijft. [5]
Route B: de ontwikkelomgeving in Android Studio inrichten
Met deze route installeert u Android Studio, downloadt u de Android-ontwikkeltools en maakt u een XR-project aan op basis van de template van Google. Zo is de native Android-werkomgeving klaar voor verdere ontwikkeling van de toepassing. U kunt ook een emulator aanmaken om te controleren of het project wordt gebouwd en opstart.
Overzicht van de installatie: Android Studio installeren → Android-tools downloaden → XR-project aanmaken → dependencies controleren → testtarget voorbereiden.Android Studio is de ontwikkelomgeving van Google voor Android-apps. Kotlin is de programmeertaal die hier wordt gebruikt. Jetpack XR SDK levert bibliotheken voor native ruimtelijke UI en XR, terwijl u met Jetpack Compose interfaces in Kotlin-code beschrijft.
Stap 1 | Installeer de XR-compatibele editor
De aanbevolen versie van Android Studio bevat de XR-tools en templates die in deze route worden gebruikt.
Download de build van Android Studio die de XR-installatiepagina van Google aanbeveelt. De huidige richtlijn adviseert de nieuwste Canary-build; installeer die zo nodig naast uw gewone stabiele versie. Canary is een vroege ontwikkelrelease, dus leg vast welke versie uw team precies gebruikt. [10]
Stap 2 | Download de Android-ontwikkeltools
SDK Manager installeert de componenten die nodig zijn om uw toepassing te bouwen, uit te voeren en te inspecteren.
Open op het welkomstscherm More Actions > SDK Manager. Installeer of update onder SDK Tools de Android SDK Build-Tools, Android Emulator en Android SDK Platform-Tools, plus de versie van Layout Inspector die in de actuele instructies van Google staat. Klik op Apply en accepteer de licenties. [10]
Stap 3 | Maak het XR-project aan
Een XR-template levert een starttoepassing waarin de ruimtelijke structuur al aanwezig is.
Open New Project. Selecteer XR in de lijst met templates en kies daarna de immersieve template voor XR-headsets of bedrade XR-brillen. Selecteer geen template voor audiobrillen of displaybrillen. Klik op Next, geef het project de naam AuraBusinessPanel, stel een packagenaam van uw organisatie in als die optie er is, kies een opslagmap en klik op Finish. [11]
Stap 4 | Laat het project de dependencies downloaden
Gradle sync bereidt de bibliotheken en buildconfiguratie voor voordat u de toepassing bewerkt.
Wacht tot Gradle sync klaar is. Gradle is het buildsysteem dat dependencies downloadt en de app compileert. Open het Project-paneel en zoek app/build.gradle.kts of het Gradle-bestand van de app-module. Houd de onderling compatibele versies uit de template aan; upgrade niet willekeurig één XR-bibliotheek.
Stap 5 | Controleer de Android API-vereisten
De API-instellingen moeten voldoen aan de eisen van de template en van elke bibliotheek die u gebruikt.
Vergelijk de installatiepagina van de Jetpack XR SDK met uw template. De gepubliceerde basis is minSdk 24 en compileSdk 34 of hoger; gebruik hogere waarden als uw gekozen bibliotheken of template dat vereisen. compileSdk is de Android API die bij het compileren wordt gebruikt; minSdk bepaalt de oudste ondersteunde Android API. [12]
De SDK-installatiepagina noemt dependencies voor Runtime, SceneCore, Compose for XR, Material Design for XR en ARCore for Jetpack XR. Voeg alleen toe wat de toepassing gebruikt. SceneCore beheert ruimtelijke content; ARCore for Jetpack XR levert ondersteunde perceptiefuncties. Previewversies kunnen veranderen. Gebruik daarom de template en de release notes samen, in plaats van een oud dependency-blok te plakken.
Voegt uw template de XR-basisbibliotheken niet automatisch toe? Zorg dan dat uw app/build.gradle.kts de volgende basisdependencies bevat:
android {
compileSdk = 34 // of een hogere waarde die uw template instelt
defaultConfig {
minSdk = 24
}
}
dependencies {
// Kerndependencies van de Jetpack XR SDK
implementation("androidx.xr.runtime:runtime:1.1.0-alpha02")
implementation("androidx.xr.scenecore:scenecore:1.1.0-alpha01")
implementation("androidx.xr.compose:compose:1.0.0-beta02")
implementation("androidx.xr.compose.material3:material3:1.0.0-alpha17")
}
Op de onderzoeksdatum vereist Compose for XR 1.0.0-beta02 (21-10-2026) Kotlin 2.2. Volgens de release notes is het afhankelijk van SceneCore 1.0.0-rc01, dat een bekend geheugenlek heeft. De workaround is om zelf SceneCore 1.0.0 of nieuwer te declareren, wat het dependency-blok hierboven al doet. Dit is een van de redenen om de volledige set dependencies vast te leggen, in plaats van een willekeurige nieuwste installatie als productieklaar te beschouwen. [13]
Draai op een XR-emulator zolang er nog geen hardware is
Stap 1 | Maak een virtueel XR-apparaat aan
Met de emulator controleert u de software voordat een fysieke Aura beschikbaar is.
Open Tools > Device Manager en kies Add a new device > Create Virtual Device. Selecteer XR als formfactor en kies XR Glasses voor de workflow met bedrade brillen. [4]
Stap 2 | Installeer de vereiste system image
De system image levert de Android XR-besturingsomgeving voor het virtuele apparaat.
Kies de preview-system image die de handleiding van Google voor XR Glasses voorschrijft, download die als daarom wordt gevraagd en rond het aanmaken van het virtuele apparaat af. Start het vanuit Device Manager.
Stap 3 | Voer de toepassing uit
Android Studio bouwt het project en installeert het op het geselecteerde virtuele apparaat.
Kies in de bovenste werkbalk van Android Studio de run-configuratie van de app en het draaiende virtuele XR-apparaat. Klik op Run. Laat Android Studio de ongewijzigde template bouwen en installeren. Voor deze controle van de omgeving hoeft u de interface niet aan te passen.
Stap 4 | Controleer het resultaat
Een geslaagde build en start bevestigen dat de geïnstalleerde tools de template kunnen verwerken.
Controleer of de template opent zonder build- of startfout. Dit valideert de basisinstallatie van de software, niet de optiek, fysieke tracking, prestaties of productiegereedheid van de Aura.
Verbind de XREAL Aura met de ontwikkelcomputer
Met ADB, kort voor Android Debug Bridge, kan een ontwikkelcomputer apps installeren op een Android-apparaat en er diagnostische logs van uitlezen. Zowel Unity als Android Studio kan ADB gebruiken.
Volgens de FAQ van XREAL over de Aura ondersteunen beide USB-C-poorten op de compute puck standaard ADB-debugging met Android Studio. De specificatietabel vermeldt volledige ADB-ondersteuning echter alleen bij de Glasses Port, dus gebruik bij voorkeur die poort. Houd de bril aangesloten volgens de instructies. DisplayPort-mirroring en een geautoriseerde ADB-verbinding zijn verschillende functies: dat u een laptopscherm in de bril ziet, bewijst niet dat de ontwikkelverbinding werkt.
Stap 1 | Schakel geautoriseerde debugging in
Met debugging kan uw ontwikkelcomputer testtoepassingen installeren en inspecteren.
Open op het Android XR-systeem Settings en schakel Developer options en USB debugging in volgens de instructies voor uw firmware. Op standaard Android verschijnen de Developer options meestal door herhaaldelijk Build number te selecteren, maar het exacte menupad op de Aura bleek niet uit de geraadpleegde openbare bronnen. Wijkt het meegeleverde onboardingpad af? Volg dan dat pad. [14]
Stap 2 | Sluit de computer aan en autoriseer hem
Voor deze bedrade debugworkflow zijn een USB-dataverbinding en goedkeuring op het apparaat nodig.
Sluit de host aan met een USB-datakabel via de gedocumenteerde ontwikkelpoort. Keur op het apparaat de debugautorisatie van de computer goed. Installeer op Windows de ADB-driver van de fabrikant als het systeem daarom vraagt. [14]
Stap 3 | Controleer of ADB het apparaat herkent
De apparatenlijst bevestigt dat de verbinding klaar is voordat u een build probeert uit te voeren.
Open in Android Studio SDK Manager en noteer de Android SDK Location. Open in uw terminal de map platform-tools van die SDK en voer de juiste opdracht hieronder uit.
# Windows PowerShell, in platform-tools
.\adb.exe devices -l
# macOS of Linux, in platform-tools
./adb devices -l
Verwacht resultaat: achter het serienummer van uw apparaat staat device. Staat er unauthorized, keur dan de melding goed. Is de lijst leeg? Controleer dan de kabel, de poort op de host, de debuginstelling en de driver. Zijn er meerdere apparaten of emulators verbonden, selecteer dan expliciet het juiste doel.
Controleer of uw ontwikkelomgeving klaar is
Controles voor Unity
Stap 1 | Controleer het buildprofiel
Controleer de installatie voordat u met de ontwikkeling van de toepassing begint.
Open File > Build Profiles en controleer of Android XR, of het voor XR geconfigureerde Android-profiel, actief is. Controleer of de benodigde Android-buildmodules voor deze editor beschikbaar zijn.
Stap 2 | Controleer packages en validatie
De vereiste XR-packages moeten in het project geïnstalleerd en ingeschakeld zijn.
Controleer in Package Manager de OpenXR Plugin en Unity OpenXR: Android XR. Controleer in Project Settings > XR Plug-in Management de Android OpenXR-provider en de featuregroep Android XR. Los vereiste punten op onder Project Validation.
Stap 3 | Controleer het doelapparaat
Een herkend apparaat rondt het verbindingsdeel van de installatie af.
Vernieuw in Build Profiles de optie Run Device en controleer of uw geautoriseerde Aura erin staat. Is dat niet zo, controleer dan de ADB-verbinding en in Unity de paden onder External Tools. U kunt het project configureren voordat er hardware is, maar de validatie van de uitrol op een fysiek apparaat moet wachten tot er een apparaat beschikbaar is.
Controles voor Android Studio
Controleer of Gradle sync zonder fouten wordt afgerond, SDK Manager de benodigde tools heeft geïnstalleerd en de XR-emulator of de geautoriseerde Aura in de targetselector verschijnt. Voer de ongewijzigde XR-template uit als er een testtarget beschikbaar is. Open View > Tool Windows > Logcat om startfouten te bekijken. Logcat toont diagnostische meldingen van Android.
Hoe Unity en Android Studio samenwerken
Unity kan Android-apps bouwen met de eigen ondersteunde tools, dus Android Studio is niet nodig om een Unity-project te configureren. Android Studio kan wel helpen bij het beheren van emulators en bij Android-diagnose, zoals met Logcat. Let op: de Android XR-emulator kan geen apps simuleren die zijn gebouwd met Unity, Godot, Unreal Engine of OpenXR. Voor Unity-builds hebt u dus een fysieke Aura nodig. Voor een native Kotlin-app is Android Studio uw belangrijkste werkomgeving en hebt u Unity niet nodig.
Wilt u de Android-build later aanpassen, dan kan Unity een Gradle-project voor Android Studio exporteren. Voor de eerste installatie is deze stap niet nodig. Houd de eigen ondersteunde buildtools van Unity geselecteerd, tenzij uw integratie specifiek een exportworkflow vereist.
Problemen oplossen bij de eerste installatie
- Android-buildtarget is niet beschikbaar: Voeg Android Build Support toe aan precies die installatie van de Unity-editor
- Groep Android XR ontbreekt: Controleer de package-identifier, de compatibiliteit en het tabblad voor het Android-target
- Gradle sync mislukt: Lees de eerste buildfout; controleer de SDK-installatie en of de versies van de dependencies op elkaar zijn afgestemd
- Vereiste packages of functies ontbreken: Controleer Package Manager, het actieve Android-target en de featuregroep Android XR
- Project Validation toont fouten: Bekijk elk vereist punt en pas de oplossing toe voor de versie van het package dat u hebt geïnstalleerd
- Apparaat is unauthorized: Keur de debugmelding op het apparaat goed
- Installatie op emulator mislukt: Controleer of de architectuur van de APK past bij de system image van de emulator
Conclusie
Een ontwikkelomgeving voor XREAL Aura inrichten betekent compatibele tools installeren, een Android XR-project voorbereiden, de juiste platformondersteuning inschakelen en de verbinding met het apparaat controleren. Unity past bij projecten met interactieve 3D-content, Android Studio bij native Android-interfaces. Een duidelijke, herhaalbare installatie helpt bedrijven configuratieproblemen te beperken en geeft ontwikkelaars een betrouwbare basis om toepassingen te bouwen en te testen.
Plant u ontwikkeling voor XREAL Aura? Bespreek hardwaretoegang, softwarevereisten en ondersteuning bij de uitrol met VR Expert.
Bekijk zakelijke XR-hardware en ondersteuning op: https://ai.vr-expert.com/

























