XREAL Aura koppelen aan uw bedrijfssystemen

XREAL Aura koppelen aan uw bedrijfssystemen

Samenvatting

Om XREAL Aura aan een bedrijfssysteem te koppelen, draait u een geautoriseerde bedrijfsapp op de Android XR-compute puck. Die app vraagt vervolgens gegevens op via de API van het systeem. Een API is een softwarekoppeling waarmee de ene applicatie informatie uit een andere kan ophalen. In deze handleiding bouwen we een kleine app die een werkorder ophaalt en de instructies op Aura toont.

Een onderhoudswerkorder is een goede eerste integratie, omdat die een ordernummer, apparatuurgegevens en praktische instructies combineert. De app haalt die velden op via een geautoriseerde verbinding en toont ze in een goed leesbaar venster. Dezelfde aanpak is aan te passen voor andere bedrijfsrecords, mits de API's en toegangsregels dat toelaten.

Zo werkt een zakelijke integratie met XREAL Aura

XREAL Aura bestaat uit een bedrade bril en een compute puck: de kleine computer waarop Android XR en uw app draaien. De app maakt via Wi-Fi en een goedgekeurde netwerkroute verbinding met het bedrijfssysteem; de bril toont de ontvangen informatie. [1]

Een werkorder beschrijft een klus 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 de 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 toont? Vraag de ontwikkelaar dan eerst te controleren of die correct werkt op Android XR, voordat u een nieuwe app bouwt. Google ondersteunt standaard Android-interfaces (zoals een 2D-app voor mobiel of groot scherm) in een XR-systeempaneel: een 2D-venster binnen de XR-omgeving. Ook een bestaande app moet nog op compatibiliteit en toegang worden getest. [4]

Meer informatie over de hardware vindt u op onze productpagina van XREAL Aura. Controleer de actuele beschikbaarheid en ondersteuning in uw land, want lanceringsinformatie verandert. [2]

Stap 1 Zorg voor een testwerkorder en de verbindingsgegevens

Uw Aura-app heeft een record nodig om te tonen en toestemming om dat record uit uw bedrijfssysteem op te halen. Een werkorder is een taakrecord met een ordernummer, apparatuurgegevens en instructies, zoals de stappen voor het inspecteren van een machine.

· Zorg voordat u code schrijft voor een HTTPS-endpoint, een testtoegangstoken en een voorbeeldwerkordernummer (bijv. WO-1001) dat overeenkomt met het JSON-schema in de ontwikkelaarsreferentie.

· Vraag uw IT-afdeling om het API-adres waarmee deze order wordt opgehaald en om een tijdelijk testtoegangstoken. Het API-adres vertelt de app waar het record moet worden opgevraagd; het token geeft toestemming om de gegevens te lezen. Laat IT bevestigen dat beide werken en of toegang tot het bedrijfsnetwerk nodig is.

· Deel de ontwikkelaarsreferentie aan het eind van dit artikel met IT, zodat zij kunnen controleren of de geretourneerde 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 die eerst beschikbaar stellen.

Houd deze drie gegevens bij de hand: het API-adres komt in stap 3 in de code; het token en het werkordernummer voert u in stap 4 in de draaiende app in. Samen zorgen ze ervoor dat de app de klus ophaalt en de instructies op Aura toont.

Stap 2 Open Android Studio en bereid de app voor

Stap 2.1 Maak het project aan op uw computer

· Open in de browser op 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 installatiehandleiding voor Android Studio voor XR. Die raadt momenteel een Canary-build aan: een vroege ontwikkelversie. [5]

· Open Android Studio. Selecteer in het welkomstscherm New Project. Is er al een ander project geopend, kies dan File > New > New Project in het hoofdmenu 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 als er een taaloptie verschijnt, laat de SDK-instellingen van de template ongewijzigd en selecteer Finish.

· Wacht tot Android Studio de Gradle-synchronisatie heeft afgerond. Gradle is de buildtool die de bibliotheken en instellingen van het project voorbereidt. Los eventuele fouten in het Build- of Sync-venster op voordat u verdergaat.

Stap 2.2 Geef de app toegang tot het netwerk

Het manifest is het Android-bestand waarin staat wat de app nodig heeft, waaronder de netwerkmachtiging.

· Selecteer in het Project-paneel links in Android Studio de Android-weergave in de vervolgkeuzelijst. Is het paneel verborgen, kies dan View > Tool Windows > Project.

· Klap in dat paneel app > manifests uit en open AndroidManifest.xml.

· Voeg deze regel toe binnen het manifest-element, boven het application-element. Laat de rest van het gegenereerde bestand staan.

<uses-permission android:name="android.permission.INTERNET" />

· Zoek in hetzelfde bestand de openingstag van application. Voeg android:usesCleartextTraffic="false" als attribuut aan die tag toe. Android blokkeert onversleuteld HTTP al voor apps die op Android 9 of nieuwer zijn gericht; deze regel maakt die bedoeling expliciet.

De INTERNET-machtiging wordt bij de installatie verleend; er verschijnt geen toestemmingspop-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 toont

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 Project-paneel links in Android Studio app > kotlin+java > com.example.auraworkorders uit. In sommige versies heet de bronmap java.

· Open MainActivity.kt. Dit bestand bestuurt het openingsscherm van de app.

· Vervang de inhoud door 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 (Windows of Linux) of Command+F (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 plek van het werkordernummer. 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 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 compileer het project in stap 4 met de Run-knop in de werkbalk. Los compilatiefouten op in het Build-venster.

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-apparaat dat op uw computer wordt weergegeven. Controleer hiermee eerst het API-adres, het token en de geretourneerde instructies, voordat u problemen op een fysiek apparaat gaat oplossen.

Stap 4.1 Start de app vanuit Android Studio

· Kies in het hoofdmenu van Android Studio Tools > Device Manager.

· Bestaat er al een geschikt virtueel Android-apparaat, selecteer dan de startknop ervan. Selecteer anders Create Device of de plusknop, kies een telefoonprofiel, selecteer een beschikbare system image, download die als daarom wordt gevraagd en rond de wizard af. Start het nieuwe apparaat.

· Selecteer in de bovenste werkbalk van Android Studio dat draaiende apparaat in de vervolgkeuzelijst voor apparaten. Laat app geselecteerd als runconfiguratie en selecteer de groene Run-knop.

· Wacht tot de app in de emulator opent. U ziet nu Work instructions, Work order ID, Sandbox access token en Load work order.

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 en Previous om terug te gaan. Scrol in de app als een instructie onder het venster doorloopt.

Verwacht resultaat: het getoonde record komt overeen met het record dat u in stap 1 in de bedrijfsapplicatie hebt geopend. Wordt het niet geladen, raadpleeg dan het onderdeel 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 Wi-Fi-netwerk dat de API uit stap 1 kan bereiken. Laat IT eventuele eisen voor een privénetwerk bevestigen.

· Volg de actuele ontwikkelaarsonboarding 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 staat de vermelding voor ontwikkelaarsresources. Begin daar als u de actuele instructies nodig hebt.

· Open in de app Settings van Aura de Developer options en schakel volgens die onboarding de debugmethode in die uw apparaat ondersteunt. Autoriseer uw ontwikkelcomputer als Aura daarom vraagt. De handleiding voor hardwareapparaten 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. Sluit de computer dus aan op de Charging Port links en laat de bril aangesloten op de Glasses Port rechts. De specificatietabel vermeldt volledige ADB-ondersteuning echter alleen bij de Glasses Port. Probeer die poort dus 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 voor apparaten in de bovenste werkbalk van Android Studio. Selecteer uw verbonden Aura-ontwikkelapparaat in plaats van de emulator.

· Ontbreekt het apparaat, kies 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 apparaat verschijnt, laat u app geselecteerd als runconfiguratie en selecteert u de groene Run-knop. Android Studio bouwt, installeert en start de app op het geselecteerde apparaat.

Stap 5.3 Haal het record op in de bril

· Zet Aura op en zoek het app-venster 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 uw apparaat ondersteunt. Standaard Bluetooth-toetsenborden en -muizen werken met Aura (Settings > Connected Devices > Pair new device); een compatibel Bluetooth-toetsenbord maakt het invoeren tijdens het testen eenvoudiger. [1]

· Selecteer Load work order en gebruik daarna 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 tonen.

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 is vervangen. Laat IT nagaan of het endpoint bereikbaar is vanaf het netwerk van de emulator of van Aura.

· API geeft 401: de API heeft de inloggegevens niet geaccepteerd. Laat IT de geldigheid van het token en de beoogde service controleren, of vraag een nieuw testtoken aan.

· API geeft 403: het account heeft onvoldoende rechten. Vraag de beheerder van het bedrijfssysteem om de juiste toegang te verlenen.

· API geeft 404: controleer het ordernummer en of het endpoint naar de juiste testomgeving verwijst.

· API geeft gegevens terug, maar de app faalt: vraag de API-ontwikkelaar 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 apparaat. 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 prijs te geven. Gebruik voor app-fouten View > Tool Windows > Logcat in Android Studio; Logcat toont de applicatielogs.

Ontwikkelaarsreferentie voor de voorbeeld-API

Gebruik dit onderdeel bij het controleren van het antwoord in stap 1 of het aanpassen van fetchOrder in stap 3. Het beschrijft het contract voor deze voorbeeldapp, niet een endpoint van XREAL.

Verzoek: GET https://api.your-company.example/work-orders/WO-1001

Headers van het verzoek: 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."
    }
  ]
}

Het veld id identificeert de werkorder, asset de bijbehorende apparatuur en revision de procedureversie. Elk item in steps heeft een nummer (number), een titel (title), de volledige instructie (instruction) en een expectedResult. Het voorbeeld sorteert de stappen op nummer.

Gebruik voor echt werk goedgekeurde instructies; het voorbeeld beschrijft een inactief trainingsstation. Valideer vóór productie de omvang van het antwoord en de veldlengtes, weiger ongeldige proceduregegevens en bepaal wat er gebeurt als een token verloopt. De API moet voor elke opgevraagde order de rechten controleren. De voorbeeldcode is illustratief en is niet gecompileerd of getest met een live systeem of een fysiek Aura-apparaat.

Conclusie

Een koppeling tussen XREAL Aura en een bedrijfssysteem begint met een goedgekeurd API-adres en toegangsrechten, gevolgd door een Android Studio-app die het benodigde record ophaalt. Door de verbinding eerst op een computer te testen en pas daarna naar Aura uit te rollen, houdt u problemen met gegevenstoegang gescheiden van de apparaatconfiguratie. Het werkordervoorbeeld brengt apparatuurgegevens en stapsgewijze instructies naar een goed leesbaar brilscherm. Zo hebben bedrijven een praktisch startpunt om operationele informatie beschikbaar te maken op de plek waar het werk gebeurt. Inloggen met bedrijfsaccounts, passende rechten en tests op het apparaat maken die koppeling klaar voor een pilot met medewerkers.

Bespreek de beschikbaarheid van hardware en de eisen voor uw pilot met VR Expert.

João Noronha

Geschreven door

João Noronha

XR- en Immersive Content Specialist bij VR Expert

João Noronha is XR- en Immersive Content Specialist bij VR Expert, met een sterke interesse in opkomende technologieën en hun praktische toepassingen. Hij richt zich op het vertalen van complexe ontwikkelingen op het gebied van VR, AR, AI-brillen en immersieve technologie naar heldere, praktische content voor bedrijven en professionals die de XR-sector verkennen.

Veelgestelde vragen

Dit artikel

Een systeem heeft een toegankelijke API, een goedgekeurde authenticatiemethode en toestemming nodig om de vereiste records op te halen. Software voor enterprise resource planning coördineert bedrijfsprocessen, terwijl onderhoudsbeheersoftware het onderhoud van apparatuur organiseert. Hun API's en datastructuren verschillen, dus elke integratie moet worden getoetst aan het specifieke product en de configuratie.

Google ondersteunt standaard Android-interfaces in systeempanelen van Android XR. 2D-apps voor mobiel of groot scherm werken standaard in Android XR en worden weergegeven als 2D-paneel in een XR/3D-ruimte. Test het inloggen, de netwerktoegang, de weergave en de invoer van de app op Aura voordat u de app goedkeurt voor medewerkers. Een bestaande app die de benodigde records al levert, kan de hoeveelheid ontwikkelwerk beperken. [4]

Een standaard Android-appvenster kan de werkorder en de instructies tonen. Aangepaste Jetpack XR-panelen zijn een optionele uitbreiding als een specifieke taak baat heeft bij een andere indeling van de informatie. [4]

Een interne bedrijfs-API kan bereikbaar zijn via een goedgekeurd lokaal of privénetwerk. Het apparaat moet dan nog steeds de API kunnen bereiken, evenals alle services die nodig zijn voor authenticatie. Het voorbeeld vereist een actieve verbinding en slaat geen werkorders op voor offline gebruik.

Het voorbeeld haalt informatie op en toont die. Voor het indienen van resultaten zijn een extra API-bewerking, gebruikersrechten en een bevestigingsinterface nodig. De server moet de inzending valideren en herhaalde verzoeken veilig afhandelen.