Samenvatting
Om XREAL Aura aan een bedrijfssysteem te koppelen, laat u een geautoriseerde bedrijfsapp draaien op de Android XR-compute puck en laat u die app gegevens opvragen via de API van het systeem. Een API is een softwarekoppeling waarmee de ene applicatie informatie uit een andere kan ophalen. In deze gids bouwen we een kleine app die een werkorder ophaalt en de instructies ervan op Aura weergeeft.
Een onderhoudswerkorder is een handige eerste integratie, omdat die een recordnummer, gegevens over de apparatuur en praktische instructies combineert. De app haalt die velden op via een geautoriseerde verbinding en toont ze in een goed leesbaar venster. Dezelfde aanpak kan worden aangepast voor andere bedrijfsrecords, als hun API's en toegangsregels dat toelaten.
Hoe een zakelijke integratie met XREAL Aura werkt
XREAL Aura gebruikt een bedrade bril en een compute puck, de kleine computer waarop Android XR en uw app draaien. De app maakt verbinding met het bedrijfssysteem via wifi en een goedgekeurde netwerkroute; de bril toont de teruggestuurde informatie. [1]
Een werkorder beschrijft een taak en de instructies om die uit te voeren. Een medewerker voert het ordernummer in de Aura-app in en selecteert Load work order. De app vraagt dat record op bij het bedrijfssysteem en toont vervolgens de naam van de apparatuur, de versie van de procedure en gedetailleerde instructies. Met Next en Previous bladert de medewerker door de instructies, terwijl het bronrecord ongewijzigd blijft.
Heeft uw bedrijf al een Android-app die deze records weergeeft, vraag de ontwikkelaar dan om na te gaan of die correct werkt op Android XR voordat u een nieuwe app bouwt. Google ondersteunt standaard Android-interfaces (zoals een 2D-app voor smartphones of voor grote schermen) in een XR-systeempaneel, als een 2D-venster binnen de XR-omgeving. Ook een bestaande app moet nog op compatibiliteit en toegang worden getest. [4]
Meer context over de hardware vindt u op onze productpagina van XREAL Aura. Controleer de actuele beschikbaarheid en ondersteuning in uw land, want de lanceringsinformatie verandert. [2]
Stap 1 Zorg voor een testwerkorder en de bijbehorende verbindingsgegevens
Uw Aura-app heeft een record nodig om weer te geven en toestemming om dat record uit uw bedrijfssysteem op te halen. Een werkorder is een taakrecord met een ordernummer, gegevens over de apparatuur en instructies, zoals de stappen om een machine te inspecteren.
· Zorg er vóór u code schrijft voor dat u beschikt over een HTTPS-endpoint, een testtoegangstoken en een voorbeeldnummer van een werkorder (bv. WO-1001) dat overeenkomt met het JSON-schema in de ontwikkelaarsreferentie.
· Vraag uw IT-team naar het API-adres waarmee deze order wordt opgehaald en naar een tijdelijk testtoegangstoken. Een API-adres vertelt de app waar het record moet worden opgevraagd; het token geeft de app toestemming om de gegevens te lezen. Vraag IT om te bevestigen dat beide werken en of toegang tot het bedrijfsnetwerk vereist is.
· Bezorg IT de ontwikkelaarsreferentie aan het einde van dit artikel, zodat ze kunnen nagaan of de teruggestuurde gegevens overeenkomen met de voorbeeldapp. Wijken ze af, pas dan de code in stap 3 aan zodat die de veldnamen van uw systeem leest. Bestaat er geen geschikte API, dan moet IT er eerst een voorzien.
Houd deze drie zaken klaar: het API-adres komt in de code in stap 3; het token en het werkordernummer voert u in stap 4 in de draaiende app in. Samen zorgen ze ervoor dat de app de taak kan ophalen en de instructies op Aura kan weergeven.
Stap 2 Open Android Studio en bereid de app voor
Stap 2.1 Maak het project aan op uw computer
· Open in de browser van uw computer de officiële downloadpagina van Android Studio. Installeer Android Studio en doorloop de installatie. Hebt u de specifieke XR-tools van Google nodig, volg dan de installatiegids voor Android Studio voor XR, die momenteel een Canary-build aanbeveelt, een vroege ontwikkelversie. [5]
· Open Android Studio. Selecteer op het welkomstscherm New Project. Is er al een ander project geopend, selecteer dan File > New > New Project in het bovenste menu van Android Studio.
· Selecteer in het projectvenster Phone and Tablet > Empty Activity. Selecteer Next.
· Stel Name in op AuraWorkOrders en Package name op com.example.auraworkorders. Kies Kotlin waar een taaloptie verschijnt, behoud de SDK-instellingen van de template en selecteer Finish.
· Wacht tot Android Studio de Gradle-synchronisatie heeft voltooid. Gradle is de buildtool die de bibliotheken en instellingen van het project voorbereidt. Los eventuele fouten in het venster Build of Sync op voordat u verdergaat.
Stap 2.2 Geef de app toegang tot het netwerk
Het manifest is het Android-bestand dat aangeeft wat de app nodig heeft, waaronder netwerktoestemming.
· Selecteer in het linkerdeelvenster Project van Android Studio de Android-weergave in de vervolgkeuzelijst. Is het deelvenster verborgen, selecteer dan View > Tool Windows > Project.
· Klap in dat deelvenster app > manifests open en open AndroidManifest.xml.
· Voeg deze regel toe binnen het element manifest, boven het element application. Laat de rest van het gegenereerde bestand ongewijzigd.
<uses-permission android:name="android.permission.INTERNET" />· Zoek in hetzelfde bestand de openingstag application. Voeg android:usesCleartextTraffic="false" toe als attribuut binnen die tag. Android blokkeert onversleuteld HTTP al voor apps die Android 9 of nieuwer targeten, dus deze regel maakt de bedoeling expliciet.
De INTERNET-toestemming wordt bij de installatie verleend; er verschijnt geen toegangspop-up wanneer de app draait. [6] Het voorbeeld gebruikt de ingebouwde netwerk- en JSON-tools van Android, dus u hoeft Retrofit of een andere netwerkbibliotheek niet toe te voegen.
Stap 3 Voeg de code toe die de werkorder ophaalt en weergeeft
Deze code verbindt de app met het adres uit stap 1, leest het antwoord en toont telkens één instructie. Het netwerkverzoek draait los van de interface, zodat het scherm responsief blijft.
Stap 3.1 Open het juiste bestand in Android Studio
· Klap in het linkerdeelvenster Project van Android Studio app > kotlin+java > com.example.auraworkorders open. In sommige versies heet de bronmap java.
· Open MainActivity.kt. Dit bestand stuurt het openingsscherm van de app aan.
· Vervang de inhoud door de onderstaande code. Wijkt uw pakketnaam af, pas dan de eerste regel aan zodat die overeenkomt met het pakket dat u in stap 2 hebt aangemaakt.
package com.example.auraworkorders
import android.os.Bundle
import androidx.activity.ComponentActivity
import androidx.activity.compose.setContent
import androidx.compose.foundation.layout.*
import androidx.compose.foundation.rememberScrollState
import androidx.compose.foundation.verticalScroll
import androidx.compose.material3.*
import androidx.compose.runtime.*
import androidx.compose.ui.Modifier
import androidx.compose.ui.text.input.PasswordVisualTransformation
import androidx.compose.ui.unit.dp
import org.json.JSONObject
import java.net.URL
import java.util.concurrent.Executors
import javax.net.ssl.HttpsURLConnection
data class WorkStep(
val number: Int, val title: String,
val instruction: String, val expectedResult: String
)
data class WorkOrder(
val id: String, val asset: String,
val revision: String, val steps: List<WorkStep>
)
fun fetchOrder(id: String, token: String): WorkOrder {
require(Regex("[A-Za-z0-9-]{1,40}").matches(id))
// Replace only this origin with your approved API origin.
val url = URL("https://api.your-company.example/work-orders/$id")
val c = url.openConnection() as HttpsURLConnection
try {
c.requestMethod = "GET"
c.instanceFollowRedirects = false
c.connectTimeout = 10000
c.readTimeout = 10000
c.setRequestProperty("Authorization", "Bearer $token")
c.setRequestProperty("Accept", "application/json")
val status = c.responseCode
check(status == 200) { "HTTP $status" }
val text = c.inputStream.bufferedReader().use { it.readText() }
val obj = JSONObject(text)
check(obj.getString("id") == id) { "Order ID mismatch" }
val array = obj.getJSONArray("steps")
check(array.length() > 0) { "No instructions available" }
val steps = (0 until array.length()).map { index ->
val s = array.getJSONObject(index)
WorkStep(s.getInt("number"), s.getString("title"),
s.getString("instruction"), s.getString("expectedResult"))
}.sortedBy { it.number }
return WorkOrder(obj.getString("id"), obj.getString("asset"),
obj.getString("revision"), steps)
} finally {
c.disconnect()
}
}
class MainActivity : ComponentActivity() {
private val worker = Executors.newSingleThreadExecutor()
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContent {
MaterialTheme {
WorkOrderScreen { id, token, done ->
worker.execute {
val result = runCatching { fetchOrder(id, token) }
runOnUiThread {
if (!isDestroyed) done(result)
}
}
}
}
}
}
override fun onDestroy() {
worker.shutdownNow()
super.onDestroy()
}
}
@Composable
fun WorkOrderScreen(
load: (String, String, (Result<WorkOrder>) -> Unit) -> Unit
) {
var id by remember { mutableStateOf("WO-1001") }
var token by remember { mutableStateOf("") }
var order by remember { mutableStateOf<WorkOrder?>(null) }
var index by remember { mutableStateOf(0) }
var busy by remember { mutableStateOf(false) }
var message by remember { mutableStateOf("Enter test credentials.") }
Surface(Modifier.fillMaxSize()) {
Column(Modifier.padding(24.dp)
.verticalScroll(rememberScrollState()),
verticalArrangement = Arrangement.spacedBy(16.dp)) {
Text("Work instructions", style = MaterialTheme.typography.headlineMedium)
OutlinedTextField(value = id, onValueChange = { id = it },
label = { Text("Work order ID") },
singleLine = true, enabled = !busy)
OutlinedTextField(value = token, onValueChange = { token = it },
label = { Text("Sandbox access token") }, singleLine = true,
visualTransformation = PasswordVisualTransformation(),
enabled = !busy)
Button(enabled = !busy && token.isNotBlank() &&
Regex("[A-Za-z0-9-]{1,40}").matches(id), onClick = {
busy = true
order = null
index = 0
message = "Loading work order..."
load(id, token) { result ->
busy = false
result.onSuccess {
order = it
message = "Read-only instructions loaded."
}.onFailure {
message = "Could not load order. Check access and network."
}
}
}) { Text(if (busy) "Loading..." else "Load work order") }
Text(message)
order?.let { current ->
Text("${current.id} | ${current.asset}")
Text("Procedure revision ${current.revision}")
val step = current.steps[index]
Text("Step ${index + 1} of ${current.steps.size}",
style = MaterialTheme.typography.titleLarge)
Text(step.title, style = MaterialTheme.typography.headlineSmall)
Text(step.instruction, style = MaterialTheme.typography.bodyLarge)
Text("Expected result: ${step.expectedResult}")
Row(horizontalArrangement = Arrangement.spacedBy(16.dp)) {
Button(enabled = index > 0,
onClick = { index-- }) { Text("Previous") }
Button(enabled = index < current.steps.lastIndex,
onClick = { index++ }) { Text("Next") }
}
Text("Navigation does not record task completion.")
}
}
}
}Stap 3.2 Voer het API-adres van uw bedrijf in
· Blijf in MainActivity.kt in Android Studio. Druk op Ctrl+F op Windows of Linux, of op Command+F op macOS, en zoek naar api.your-company.example.
· Vervang de voorbeeld-URL in de regel URL(...) door het endpointpatroon van uw bedrijf uit stap 1. Laat $id staan op de plaats waar het werkordernummer hoort. Verwacht de server bijvoorbeeld /api/jobs/WO-1001, dan moet de code https://YOUR-APPROVED-HOST/api/jobs/$id opvragen.· Zet het token niet in dit bestand. De app biedt er een tijdelijk testveld voor wanneer u de app uitvoert.
· Wijkt het antwoord van uw API af van de ontwikkelaarsreferentie, pas dan vóór het uitvoeren de veldnamen en de structuur aan die fetchOrder inleest. In deze functie leest JSONObject het antwoord en opent getJSONArray("steps") de lijst met instructies.
· Selecteer in Android Studio Build > Make Project als die opdracht in uw versie beschikbaar is, of gebruik in stap 4 de knop Run in de werkbalk om het project te compileren. Los eventuele compilatiefouten op in het venster Build.
Verwacht resultaat: het project wordt gebouwd en de URL in MainActivity.kt verwijst naar uw echte testservice. Het voorbeeldadres dat eindigt op .example maakt geen verbinding met een bedrijfssysteem.
Stap 4 Test de verbinding op uw computer
Een emulator is een virtueel Android-toestel dat op uw computer wordt weergegeven. Gebruik die eerst om het API-adres, het token en de teruggestuurde instructies te controleren, voordat u problemen op een fysiek toestel gaat oplossen.
Stap 4.1 Start de app vanuit Android Studio
· Selecteer in het bovenste menu van Android Studio Tools > Device Manager.
· Bestaat er al een geschikt virtueel Android-toestel, selecteer dan de startknop ervan. Selecteer anders Create Device of de plusknop, kies een telefoonprofiel, selecteer een beschikbare systeemimage, download die indien gevraagd en voltooi de wizard. Start het nieuwe toestel.
· Selecteer terug in de bovenste werkbalk van Android Studio dat draaiende toestel in de vervolgkeuzelijst met toestellen. Laat app geselecteerd als runconfiguratie en selecteer vervolgens de groene knop Run.
· Wacht tot de app in de emulator opent. U zou Work instructions, Work order ID, Sandbox access token en Load work order moeten zien.
Stap 4.2 Vraag het bedrijfsrecord op
· Selecteer in de draaiende app in de emulator Work order ID en voer het testordernummer uit stap 1 in.
· Selecteer in dezelfde app Sandbox access token en plak het tijdelijke token dat u van IT hebt gekregen. Plak alleen de waarde, zonder het woord Bearer.
· Selecteer Load work order. Als het verzoek slaagt, toont de app Read-only instructions loaded, gevolgd door het ordernummer, de naam van de apparatuur, de procedureversie en de eerste instructie.
· Selecteer Next om de volgende instructie te lezen. Selecteer Previous om terug te gaan. Scrol in de app als een instructie onder het venster doorloopt.
Verwacht resultaat: het weergegeven record komt overeen met het record dat u in stap 1 in de bedrijfsapplicatie hebt geopend. Laadt het niet, raadpleeg dan het deel over probleemoplossing voordat u naar Aura overstapt.
Stap 5 Voer dezelfde gekoppelde app uit op XREAL Aura
Stap 5.1 Bereid Aura voor op ontwikkeling
· Zet Aura aan met de compute puck. Maak in de app Settings van Aura verbinding met een wifinetwerk dat de API uit stap 1 kan bereiken. Vraag IT om eventuele vereisten voor een privénetwerk te bevestigen.
· Volg de actuele onboarding voor ontwikkelaars van XREAL om debugging in te schakelen en de compute puck met uw computer te verbinden. Begin bij de Aura-FAQ van XREAL (tutorials.xreal.com/docs/aura/troubleshooting/faq/); daar vindt u het item over ontwikkelaarsresources. Begin daar als u de actuele instructies nodig hebt.
· Open in de app Settings van Aura de Developer options en schakel de debugmethode in die uw toestel ondersteunt, volgens die onboarding. Autoriseer uw ontwikkelcomputer als Aura daarom vraagt. De handleiding voor hardwaretoestellen van Google legt het algemene Android-proces uit. [7]
De exacte menulabels en kabelopstelling van Aura hangen af van de hardware en firmware. Volgens de FAQ van XREAL Aura ondersteunen beide USB-C-poorten op de compute puck standaard ADB-debugging met Android Studio. Verbind de computer dus met de Charging Port links en laat de bril aangesloten op de Glasses Port rechts. De specificatietabel vermeldt volledige ADB-ondersteuning alleen bij de Glasses Port, dus probeer die poort als de linkerpoort niet wordt herkend, en volg de actuele instructies van XREAL om ontwikkelaarstoegang in te schakelen. [1]
Stap 5.2 Installeer de app vanuit Android Studio
· Ga op uw computer terug naar het project AuraWorkOrders in Android Studio.
· Open de vervolgkeuzelijst met toestellen in de bovenste werkbalk van Android Studio. Selecteer uw verbonden Aura-ontwikkeltoestel in plaats van de emulator.
· Ontbreekt het toestel, selecteer dan Tools > Troubleshoot Device Connections in Android Studio en volg de verbindingsassistent. Controleer de debugautorisatie en de verbindingsmethode aan de hand van de onboarding van XREAL.
· Zodra het toestel verschijnt, laat u app geselecteerd als runconfiguratie en selecteert u de groene knop Run. Android Studio bouwt, installeert en start de app op het geselecteerde toestel.
Stap 5.3 Haal het record op in de bril
· Zet Aura op en zoek het appvenster Work instructions dat Android Studio heeft gestart.
· Voer in dat venster hetzelfde testordernummer en tijdelijke token in als in stap 4. Gebruik de invoermethoden die op uw toestel beschikbaar zijn; standaard bluetoothtoetsenborden en -muizen werken met Aura (Settings > Connected Devices > Pair new device), en een compatibel bluetoothtoetsenbord kan het invoeren tijdens het testen vereenvoudigen. [1]
· Selecteer Load work order en gebruik vervolgens Next, Previous en scrollen om de instructies te lezen.
· Vergelijk het ordernummer, de naam van de apparatuur en de instructietekst met het oorspronkelijke record in uw bedrijfsapplicatie. Komen ze overeen, dan hebt u aangetoond dat de Aura-app dat bedrijfsrecord kan ophalen en weergeven.
Veelvoorkomende problemen en wat u kunt controleren
· App wordt niet gebouwd: open in Android Studio View > Tool Windows > Build en lees de eerste gemelde fout. Controleer de pakketnaam en of het Empty Activity-project Compose en Material 3 gebruikt.
· App kan de order niet laden: controleer in MainActivity.kt in Android Studio of de voorbeeldhostnaam werd vervangen. Vraag IT om na te gaan of het endpoint bereikbaar is vanaf de emulator of het netwerk van Aura.
· API geeft 401 terug: de API heeft de inloggegevens niet aanvaard. Vraag IT om de geldigheid en de beoogde service van het token te controleren, of vraag een nieuw testtoken aan.
· API geeft 403 terug: het account heeft niet de nodige toestemming. Vraag de beheerder van het bedrijfssysteem om de juiste toegang te verlenen.
· API geeft 404 terug: controleer het ordernummer en of het endpoint naar de juiste testomgeving verwijst.
· API geeft gegevens terug, maar de app faalt: vraag de API-ontwikkelaar om het antwoord te vergelijken met de ontwikkelaarsreferentie. Het voorbeeld vereist een niet-lege steps-lijst en een id die overeenkomt met de opgevraagde order.
· Werkt in de emulator, maar niet op Aura: controleer de netwerkroute en API-toegang van Aura en test daarna de app op het toestel. Schakel HTTPS-certificaatcontroles niet uit om een verbindingsfout te omzeilen.
Het voorbeeld toont de gebruiker een algemene foutmelding. Vraag voor de exacte API-status de beheerder om de serverlogs te bekijken zonder tokens of volledige werkorders bloot te geven. Gebruik voor appfouten View > Tool Windows > Logcat in Android Studio; Logcat toont de applicatielogs.
Ontwikkelaarsreferentie voor de voorbeeld-API
Gebruik dit deel wanneer u het antwoord in stap 1 controleert of fetchOrder in stap 3 aanpast. Het beschrijft het contract voor deze voorbeeldapp, niet een endpoint dat door XREAL wordt aangeboden.
Verzoek: GET https://api.your-company.example/work-orders/WO-1001
Verzoekheaders: Authorization: Bearer <kortlevend toegangstoken> en Accept: application/json
Verwacht succesvol antwoord: HTTP 200 met deze JSON-structuur
{
"id": "WO-1001",
"asset": "Training station A",
"revision": "3",
"steps": [
{
"number": 1,
"title": "Confirm the training station",
"instruction": "Match the station label to this work order. Stop if the labels differ.",
"expectedResult": "The station label matches Training station A."
},
{
"number": 2,
"title": "Review the reference label",
"instruction": "Read the sample label and compare it with the training reference sheet.",
"expectedResult": "The sample label matches the approved reference."
}
]
}De id identificeert de werkorder, asset identificeert de bijbehorende apparatuur en revision identificeert de procedureversie. Elk item binnen steps heeft een nummer, een titel, een volledige instructie en een expectedResult. Het voorbeeld sorteert de stappen op nummer.
Gebruik goedgekeurde instructies voor echt werk; het voorbeeld beschrijft een inactief trainingsstation. Valideer vóór productie de grootte van het antwoord en de veldlengtes, weiger ongeldige proceduregegevens en leg vast hoe de app omgaat met verlopen tokens. De API moet voor elke opgevraagde order de toestemming controleren. De voorbeeldcode is illustratief en werd niet gecompileerd of getest met een live systeem of een fysiek Aura-toestel.
Conclusie
XREAL Aura koppelen aan een bedrijfssysteem begint met een goedgekeurd API-adres en toegangstoestemming, gevolgd door een Android Studio-app die het vereiste record ophaalt. Door de verbinding eerst op een computer te testen voordat u ze op Aura uitrolt, kunt u problemen met gegevenstoegang beter onderscheiden van problemen met de toestelconfiguratie. Het werkordervoorbeeld brengt gegevens over de apparatuur en stapsgewijze instructies naar een leesbare weergave in de bril en biedt bedrijven zo een praktisch vertrekpunt om operationele informatie toegankelijk te maken op de plek waar het werk gebeurt. Aanmelden met bedrijfsaccounts, passende toestemmingen en tests op het toestel maken die verbinding klaar voor een pilot met medewerkers.
Bespreek de beschikbaarheid van hardware en uw pilotvereisten met VR Expert.

























