Samenvatting
Gebruik Unity wanneer je zakelijke toepassing interactieve 3D-content nodig heeft, of Android Studio wanneer ze een native Android-interface nodig heeft. De installatie is voltooid wanneer de vereiste tools geïnstalleerd zijn, het project de configuratiecontroles doorstaat en je testtoestel of emulator beschikbaar is.
De instructies volgen de officiële documentatie van Android XR. Aura-specifieke ontwikkelpoorten, firmwaremenu's en machtigingen moet je controleren aan de hand van de onboardinginstructies die bij je toestel geleverd worden. Deze gids beweert niet dat er fysiek met de Aura getest is.
Kies je ontwikkelroute
Kies Unity als je project 3D-modellen, interactieve training of simulatie zal gebruiken, of als je ontwikkelaars al met Unity en C# werken. Unity biedt je een visuele werkomgeving om content te schikken en XR-functies te configureren. Je kunt de omgeving instellen zonder code te schrijven of een prototype te bouwen.
Kies Android Studio als je een zakelijke Android-toepassing uitbreidt of native interfaces maakt, zoals werkinstructies, formulieren of taakpanelen. Het gebruikt Kotlin en Google's Jetpack XR-bibliotheken. Beide routes kunnen later met bedrijfssystemen verbonden worden via een API, een vastgelegde manier waarop software informatie uitwisselt; kies de route op basis van de interface van de toepassing en de vaardigheden van je team.
Belangrijkste ontwikkeleditor:
- Unity-route: Unity Editor, geïnstalleerd via Unity Hub
- Android Studio-route: Android Studio
Taal voor latere 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
Kernondersteuning voor XR:
- 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: Unity OpenXR: Android XR-pakket
- Android Studio-route: XR-projecttemplate en vereiste Jetpack XR-bibliotheken
Wat de XR-tools betekenen:
- Unity-route: OpenXR is een gemeenschappelijke interface tussen een XR-app en de runtime van het toestel, de systeemsoftware die XR-functies uitvoert
- Android Studio-route: Jetpack XR SDK is Google's verzameling bibliotheken 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 berichten weergeeft
Bereid je werkstation en ontwikkeltoegang voor
Zorg voor een ondersteunde ontwikkelcomputer, een betrouwbare internetverbinding voor dependencies, een goedgekeurde projectmap van het bedrijf en een USB-datakabel. De vereisten voor de emulator verschillen van die voor de editor; raadpleeg Google's hardwarepagina voor de XR-emulator voordat je op een virtueel toestel rekent. Een virtueel toestel is een softwaresimulatie van een Android-toestel. [4]
Gebruik een Aura-toestel met geautoriseerde ontwikkelaarstoegang, de meegeleverde brilverbinding en de ontwikkelverbinding die XREAL documenteert. Bevestig de regionale levering en de onboarding van de kit voordat je je vastlegt op een workshopdatum. De huidige pagina's van XREAL en regionale pagina's kunnen verschillen wat beschikbaarheid betreft; een productvermelding alleen zegt niets zeker over de levertermijn. [1]
Controleer voor zakelijk gebruik of je organisatie in aanmerking komt voor een Unity-licentie en welke Industry-voorwaarden eventueel van toepassing zijn voordat je Unity commercieel gebruikt. Gebruik versiebeheer onder controle van het bedrijf, goedgekeurde pakketbronnen en testdata. Android Studio en Unity zijn ontwikkeltools voor professionele toepassingen; ze installeren betekent niet dat er ondersteuning voor enterprisebeheer op Aura is.
Route A: de Unity-ontwikkelomgeving instellen
Deze route installeert Unity en de bijbehorende Android-tools, maakt een leeg project aan en schakelt ondersteuning voor Android XR in. Zo is de werkomgeving klaar voor latere ontwikkeling.
Stap 1 | Installeer de Unity-editor
Unity Hub beheert je editorinstallaties; de Unity Editor is de werkomgeving waarin je projecten configureert en later je toepassing ontwikkelt.
Installeer Unity Hub via de officiële website van Unity en open het. Ga naar Installs en vervolgens naar Install Editor. Kies een ondersteunde release van Unity 6.5 (of nieuwer) die compatibel is met het Android XR-pakket dat je gaat gebruiken, zodat je volledige ondersteuning krijgt voor de trackpadinvoer van de puck en andere functies. Google's installatiepagina vermeldt momenteel 6000.0.58f2 of hoger; daarnaast gelden ook de vereisten van nieuwere pakketten. [5]
Stap 2 | Voeg de Android-buildtools toe
Met deze modules kan Unity je project omzetten in een Android-toepassing.
XREAL Aura draait Android XR en heeft dus een Android-toepassing nodig die het besturingssysteem kan installeren en uitvoeren. Je 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 toestel te testen.
Selecteer bij de installatiemodules Android Build Support en de onderliggende onderdelen, klik dan op Continue en doorloop de installatieprompts. De tools die geïnstalleerd moeten worden:
· Android SDK (Software Development Kit)
· Android NDK (Native Development Kit): zet code op een lager niveau om in een vorm die de processor van het toestel kan uitvoeren.
· JDK (Java Development Kit)
Voor een bestaande editor ga je terug naar Unity Hub > Installs, open je het menu van de editor, kies je Add modules, selecteer je dezelfde onderdelen en klik je op Installs.
Stap 3 | Maak een project aan
Een leeg project geeft je een plek om de Android XR-ontwikkelomgeving te 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 je toepassing tekent.
Stap 4 | Controleer de toolpaden
Unity moet weten waar de compatibele Android-buildtools geïnstalleerd zijn.
Open in de Unity Editor Edit > Preferences > External Tools (Unity > Settings of Preferences op macOS). Laat de door Unity meegeleverde SDK (Android-platformtools), NDK (compilertools voor native code) en JDK (Java-buildtools) geselecteerd. Die versies zijn afgestemd op je Unity-editor, wat buildfouten helpt voorkomen. Vervang ze niet door niet-gerelateerde toolversies van Android Studio, louter omdat beide geïnstalleerd zijn.
Configureer je XREAL Aura-ontwikkelomgeving in Unity
OpenXR is een open standaard die XR-toepassingen helpt communiceren met compatibele runtimes van toestellen. Installeer in Unity de OpenXR Plugin voor de kernverbinding 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 het Android XR-buildtarget
Het buildtarget vertelt Unity op welk platform de toepassing moet draaien.
Open File > Build Profiles. Voeg in Unity 6.1 of nieuwer het Android XR-platformprofiel toe of selecteer het, en schakel ernaar over. Volgens de documentatie van Unity kan dit het compatibele Android XR-pakket automatisch installeren. Gebruikt je ondersteunde editor in plaats daarvan het Android-platform, selecteer dan Android en configureer OpenXR handmatig. [7]
Stap 2 | Installeer de OpenXR-pakketten
Pakketten voegen de softwarecomponenten toe die je 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 geïnstalleerd zijn. Ontbreekt het Android XR-pakket, gebruik dan het plusmenu > Add package by name en voer com.unity.xr.androidxr-openxr in. De identifier van het OpenXR-kernpakket is com.unity.xr.openxr. Laat Package Manager de compatibele dependencies oplossen. [6]
Stap 3 | Schakel de XR-provider in
Door een pakket 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 op het tabblad Android OpenXR in. Open de OpenXR-sectie daaronder en schakel de featuregroep Android XR in. Schakel Android XR: Session in wanneer je AR Foundation-functies gebruikt. Schakel Android XR: AR Session in voor versie 1.0. Schakel voor deze build geen niet-gerelateerde providers in. [8]
Stap 4 | Valideer het project
De validatie spoort instellingen op die een ondersteunde XR-build zouden verhinderen.
Open XR Plug-in Management > Project Validation en selecteer Android. Bekijk de vereiste problemen, los ze op en controleer opnieuw. Pakketspecifieke validatievereisten hebben voorrang op instellingen die uit een oudere tutorial zijn overgenomen.
Stap 5 | Houd de invoervereisten eenvoudig
Schakel alleen functies in die je geplande toepassing nodig heeft en die het doeltoestel ondersteunt.
Bewaar optionele invoerfuncties voor de ontwikkelfase van de toepassing, tenzij je project of template ze vereist. Een profiel voor eye gaze of controllers inschakelen voegt die hardware niet toe aan Aura. Controleer eventuele vereiste interactie-instellingen in Project Validation voordat je verdergaat.
Google's Android XR Extensions for Unity is een bijkomend pakket met extra functies. Het staat los van Unity OpenXR: Android XR. Je hoeft het niet toe te voegen alleen omdat de namen op elkaar lijken; voeg het toe wanneer je 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. Als Auto Graphics API ingeschakeld is, schakel het dan uit en zet Vulkan bovenaan. Voor een eenvoudige URP-basisconfiguratie schakel je 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 toestel. IL2CPP zet C#-code om in native code; ARM64 is de processorarchitectuur waarop de build gericht is. Controleer de validatie van de geïnstalleerde pakketten en de toestelvereisten op eventuele bijkomende beperkingen.
Google vermeldt API 24 als minimum voor de OpenXR-loader, niet als de versie van het besturingssysteem van Aura. Gebruik een minimaal API-niveau dat ook voldoet aan de eisen van elk geïnstalleerd pakket, en een geïnstalleerde target-SDK die door je editor en je distributievereisten ondersteund wordt. Configureer GameActivity als toegangspunt van de toepassing, vink Activity uit en schakel Resizable Activity in onder Resolution and Presentation, zoals Google aangeeft. [5]
Route B: de Android Studio-ontwikkelomgeving instellen
Deze route installeert Android Studio, downloadt de Android-ontwikkeltools en maakt een XR-project aan op basis van Google's template. Zo is de native Android-werkomgeving klaar voor latere ontwikkeling van toepassingen. Je kunt ook een emulator aanmaken om te controleren of het project bouwt en opstart.
Overzicht van de installatie: installeer Android Studio → download de Android-tools → maak een XR-project aan → controleer de dependencies → bereid een testtarget voor.Android Studio is de ontwikkelomgeving van Google voor Android-toepassingen. Kotlin is de programmeertaal die hier gebruikt wordt. Jetpack XR SDK levert native bibliotheken voor ruimtelijke UI en XR, terwijl Jetpack Compose interfaces beschrijft in Kotlin-code.
Stap 1 | Installeer de XR-compatibele editor
De aanbevolen versie van Android Studio bevat de XR-tools en templates die in deze route gebruikt worden.
Download de build van Android Studio die Google's XR-installatiepagina aanbeveelt. De huidige richtlijnen raden de nieuwste Canary-build aan; installeer die indien nodig naast je gewone stabiele versie. Canary staat voor een vroege ontwikkelrelease, dus noteer de exacte versie die je team gebruikt. [10]
Stap 2 | Download de Android-ontwikkeltools
SDK Manager installeert de componenten die nodig zijn om je toepassing te bouwen, uit te voeren en te inspecteren.
Open op het welkomstscherm More Actions > SDK Manager. Installeer of update onder SDK Tools Android SDK Build-Tools, Android Emulator en Android SDK Platform-Tools, plus de versie van Layout Inspector die in de huidige instructies van Google vermeld staat. Klik op Apply en aanvaard 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 daarna de immersive 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 pakketnaam van je bedrijf in als dat aangeboden wordt, kies een map om op te slaan en klik op Finish. [11]
Stap 4 | Laat het project de dependencies downloaden
Gradle sync bereidt de bibliotheken en de buildconfiguratie voor voordat je 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. Behoud de onderling compatibele versies van de template; upgrade niet zomaar één XR-bibliotheek.
Stap 5 | Controleer de Android API-vereisten
De API-instellingen moeten voldoen aan de vereisten van de template en van elke bibliotheek die je gebruikt.
Vergelijk de installatiepagina van de Jetpack XR SDK met je template. De gepubliceerde basis is minSdk 24 en compileSdk 34 of hoger; gebruik hogere waarden als de gekozen bibliotheken of template dat vereisen. compileSdk is de Android-API die bij het compileren gebruikt wordt, terwijl minSdk de oudste ondersteunde Android-API vastlegt. [12]
De SDK-installatiepagina vermeldt 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 perceptiemogelijkheden. Previewversies kunnen veranderen, dus gebruik de template en de release notes samen in plaats van een oud dependency-blok te plakken.
Als je template de basis-XR-bibliotheken niet automatisch bevat, zorg er dan voor dat je app/build.gradle.kts de volgende basisdependencies bevat:
android {
compileSdk = 34 // of een hogere waarde die je 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, en volgens de release notes hangt het af 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. Dat is een van de redenen om de volledige set dependencies vast te leggen in plaats van een willekeurige nieuwste installatie als productieklaar te beschrijven. [13]
Draaien op een XR-emulator voordat er hardware beschikbaar is
Stap 1 | Maak een virtueel XR-toestel aan
Met de emulator kun je de software controleren voordat er een fysiek Aura-toestel beschikbaar is.
Open Tools > Device Manager en daarna Add a new device > Create Virtual Device. Selecteer XR als vormfactor 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 toestel.
Kies de preview-system image die Google's gids voor XR Glasses vereist, download die als daarom gevraagd wordt en rond het aanmaken van het virtuele toestel af. Start het vanuit Device Manager.
Stap 3 | Voer de toepassing uit
Android Studio bouwt het project en installeert het op het geselecteerde virtuele toestel.
Kies in de bovenste werkbalk van Android Studio de runconfiguratie app en het actieve virtuele XR-toestel. Klik op Run. Laat Android Studio de ongewijzigde template bouwen en installeren. Voor deze controle van de omgeving hoef je de interface niet aan te passen.
Stap 4 | Controleer het resultaat
Een geslaagde build en opstart bevestigen dat de geïnstalleerde tools de template kunnen verwerken.
Controleer of de template opent zonder build- of opstartfout. Dit valideert de basisinstallatie van de software, niet de optiek van Aura, fysieke tracking, prestaties of productieklaarheid.
XREAL Aura verbinden met de ontwikkelcomputer
Met ADB, kort voor Android Debug Bridge, kan een ontwikkelcomputer toepassingen installeren en diagnostische logs van een Android-toestel lezen. Zowel Unity als Android Studio kan het gebruiken.
Volgens de Aura-FAQ van XREAL ondersteunen beide USB-C-poorten op de compute puck standaard ADB-debugging met Android Studio, maar de specificatietabel vermeldt volledige ADB-ondersteuning enkel onder de Glasses Port, dus gebruik indien mogelijk die poort. Houd de bril aangesloten volgens de instructies. DisplayPort-mirroring en een geautoriseerde ADB-verbinding zijn verschillende functies: dat je een laptopscherm in de bril ziet, bewijst dus niet dat de ontwikkelverbinding werkt.
Stap 1 | Schakel geautoriseerde debugging in
Met debugging kan je ontwikkelcomputer testtoepassingen installeren en inspecteren.
Open op het Android XR-systeem Settings en schakel Developer options en USB debugging in volgens de instructies voor je firmware. Op standaard-Android verschijnen de Developer options meestal door herhaaldelijk op Build number te tikken, maar het exacte menupad op Aura kon in de geraadpleegde openbare bronnen niet vastgesteld worden. Gebruik het meegeleverde onboardingpad als dat afwijkt. [14]
Stap 2 | Verbind en autoriseer de computer
Voor deze bedrade debuggingworkflow zijn een USB-dataverbinding en goedkeuring op het toestel vereist.
Verbind de host met een USB-datakabel via de gedocumenteerde ontwikkelpoort. Keur op het toestel de prompt voor debugging-autorisatie van de computer goed. Installeer op Windows de ADB-driver van de fabrikant als het systeem er een vereist. [14]
Stap 3 | Controleer of ADB het toestel ziet
De toestellenlijst bevestigt dat de verbinding klaar is voordat je een build probeert te maken en uit te voeren.
Open in Android Studio SDK Manager en noteer de Android SDK Location. Open in je terminal de map platform-tools van die SDK en voer het passende commando hieronder uit.
# Windows PowerShell, in platform-tools
.\adb.exe devices -l
# macOS of Linux, in platform-tools
./adb devices -l
Verwacht resultaat: het serienummer van je toestel wordt gevolgd door device. Staat er unauthorized, keur dan de prompt goed. Is de lijst leeg, controleer dan de kabel, de hostpoort, de debugginginstelling en de driver. Zijn er meerdere toestellen of emulators verbonden, selecteer dan expliciet het beoogde doel.
Bevestig dat je ontwikkelomgeving klaar is
Gereedheidscontroles voor Unity
Stap 1 | Controleer het buildprofiel
Controleer de installatie voordat je begint met de ontwikkeling van de toepassing.
Open File > Build Profiles en controleer of Android XR, of het voor XR geconfigureerde Android-profiel, actief is. Controleer of de vereiste Android-buildmodules beschikbaar zijn voor deze editor.
Stap 2 | Controleer pakketten en validatie
Het project moet de vereiste XR-pakketten geïnstalleerd en ingeschakeld hebben.
Controleer in Package Manager of OpenXR Plugin en Unity OpenXR: Android XR aanwezig zijn. Controleer in Project Settings > XR Plug-in Management de Android OpenXR-provider en de featuregroep Android XR. Los vereiste problemen op onder Project Validation.
Stap 3 | Controleer het doeltoestel
Een herkend toestel rondt het verbindingsgedeelte van de installatie af.
Vernieuw in Build Profiles de lijst Run Device en controleer of je geautoriseerde Aura-toestel verschijnt. Is dat niet zo, controleer dan de ADB-verbinding en de paden onder External Tools in Unity. Je kunt het project configureren voordat er hardware beschikbaar is, maar de validatie van de uitrol op een fysiek toestel moet wachten tot er een toestel is.
Gereedheidscontroles voor Android Studio
Controleer of Gradle sync zonder fouten afloopt, of SDK Manager de vereiste tools geïnstalleerd heeft en of de XR-emulator of het geautoriseerde Aura-toestel in de doelselector verschijnt. Voer de ongewijzigde XR-template uit als er een testtarget beschikbaar is. Open View > Tool Windows > Logcat om opstartfouten te bekijken. Logcat toont diagnostische berichten van Android.
Hoe Unity en Android Studio samenwerken
Unity kan Android-toepassingen bouwen met zijn eigen ondersteunde tools, dus Android Studio is niet nodig om een Unity-project te configureren. Android Studio kan wel nog helpen bij het beheren van emulators en bij Android-diagnose, zoals Logcat. Belangrijk om te vermelden: de Android XR-emulator ondersteunt geen simulatie van apps die gebouwd zijn met Unity, Godot, Unreal Engine of OpenXR, dus voor Unity-builds heb je een fysieke Aura nodig. Voor een native Kotlin-toepassing is Android Studio je belangrijkste werkomgeving en is Unity overbodig.
Voor latere aanpassingen aan de Android-build kan Unity een Gradle-project exporteren voor Android Studio. Voor de eerste installatie heb je die stap niet nodig. Laat de eigen ondersteunde buildtools van Unity geselecteerd, tenzij je 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
- Android XR-groep 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 dependencyversies op elkaar afgestemd zijn
- Vereiste pakketten of functies ontbreken: Controleer Package Manager, het actieve Android-target en de featuregroep Android XR
- Project Validation toont fouten: Bekijk elk vereist probleem en pas de oplossing toe voor je geïnstalleerde pakketversie
- Toestel is unauthorized: Keur de debuggingprompt op het toestel goed
- Installatie mislukt op de emulator: Controleer of de APK-architectuur overeenkomt met de system image van de emulator
Conclusie
Een XREAL Aura-ontwikkelomgeving instellen betekent compatibele tools installeren, een Android XR-project voorbereiden, de juiste platformondersteuning inschakelen en de verbinding met het toestel controleren. Unity is geschikt voor projecten met interactieve 3D-content, terwijl Android Studio geschikt is voor 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.
Plan je ontwikkeling voor XREAL Aura? Bespreek hardwaretoegang, softwarevereisten en ondersteuning bij de uitrol met VR Expert.
Ontdek zakelijke XR-hardware en ondersteuning op: https://ai.vr-expert.com/

























