Resumé
For at forbinde XREAL Aura med et forretningssystem skal du køre en godkendt virksomhedsapp på Auras compute puck med Android XR og lade appen hente data fra systemets API. Et API er en softwareforbindelse, der gør det muligt for ét program at hente oplysninger fra et andet. I denne guide bygger vi en lille app, der henter en arbejdsordre og viser dens instruktioner på Aura.
En vedligeholdelsesarbejdsordre er en oplagt første integration, fordi den kombinerer et registreringsnummer, udstyrsoplysninger og praktiske instruktioner. Appen henter disse felter via en godkendt forbindelse og præsenterer dem i et letlæseligt vindue. Samme fremgangsmåde kan tilpasses andre forretningsdata, når deres API'er og adgangsregler tillader det.
Sådan fungerer forretningsintegration med XREAL Aura
XREAL Aura består af kablede briller og en compute puck – den lille computer, der kører Android XR og din app. Appen forbinder til virksomhedens system via Wi-Fi og en godkendt netværksrute; brillerne viser de returnerede oplysninger. [1]
En arbejdsordre beskriver en opgave og instruktionerne til at udføre den. En medarbejder indtaster ordrenummeret i Aura-appen og vælger Load work order. Appen anmoder om posten fra forretningssystemet og viser derefter udstyrets navn, procedureversionen og de detaljerede instruktioner. Med Next og Previous kan medarbejderen bladre gennem instruktionerne, mens kildeposten forbliver uændret.
Hvis din virksomhed allerede har en Android-app, der viser disse poster, så bed dens udvikler om at undersøge, om den kører korrekt på Android XR, før I bygger en ny. Google understøtter standard-Android-brugerflader (som en 2D-mobilapp eller en Android-app til store skærme) vist i et XR-systempanel, dvs. som et 2D-vindue i XR-miljøet. En eksisterende app skal stadig testes for kompatibilitet og adgang. [4]
Se vores produktside for XREAL Aura for baggrund om hardwaren. Bekræft den aktuelle tilgængelighed og support i dit land, da lanceringsoplysninger ændrer sig. [2]
Trin 1 Skaf en testarbejdsordre og dens forbindelsesoplysninger
Din Aura-app skal have en post at vise og tilladelse til at hente den fra virksomhedens system. En arbejdsordre er en opgavepost med et ordrenummer, udstyrsoplysninger og instruktioner, f.eks. trinene til at inspicere en maskine.
· Før du skriver koden, skal du sikre dig, at du har et HTTPS-endpoint, et testadgangstoken og et eksempel på et arbejdsordrenummer (f.eks. WO-1001), der matcher JSON-skemaet i udviklerreferencen.
· Bed din IT-afdeling om den API-adresse, der henter denne ordre, og et midlertidigt testadgangstoken. En API-adresse fortæller appen, hvor den skal anmode om posten; tokenet giver den tilladelse til at læse dataene. Bed IT om at bekræfte, at begge dele virker, og om der kræves adgang til virksomhedens netværk.
· Del udviklerreferencen sidst i denne artikel med IT, så de kan kontrollere, at de returnerede data matcher eksempelappen. Hvis de afviger, skal du opdatere koden i trin 3, så den læser dit systems feltnavne. Hvis der ikke findes et egnet API, skal IT først stille et til rådighed.
Hav disse tre ting klar: API-adressen skal ind i koden i trin 3; tokenet og arbejdsordrenummeret skal bruges i den kørende app i trin 4. Sammen gør de det muligt for appen at hente opgaven og vise dens instruktioner på Aura.
Trin 2 Åbn Android Studio, og forbered appen
Trin 2.1 Opret projektet på din computer
· Gå i din computers browser til den officielle downloadside for Android Studio. Installer Android Studio, og gennemfør opsætningen. Hvis du har brug for Googles dedikerede XR-værktøjer, så følg den tilhørende opsætningsguide til Android Studio for XR, som i øjeblikket anbefaler en Canary-build, dvs. en tidlig udviklingsversion. [5]
· Åbn Android Studio. Vælg New Project på velkomstskærmen. Hvis et andet projekt er åbent, så vælg File > New > New Project i Android Studios øverste menu.
· Vælg Phone and Tablet > Empty Activity i projektvinduet. Vælg Next.
· Sæt Name til AuraWorkOrders og Package name til com.example.auraworkorders. Brug Kotlin, hvor der vises et sprogvalg, behold skabelonens SDK-indstillinger, og vælg Finish.
· Vent, til Android Studio er færdig med Gradle-synkroniseringen. Gradle er det byggeværktøj, der forbereder projektets biblioteker og indstillinger. Løs eventuelle fejl i vinduet Build eller Sync, før du fortsætter.
Trin 2.2 Giv appen adgang til netværket
Manifestet er den Android-fil, der angiver, hvad appen har brug for, herunder netværkstilladelse.
· Vælg visningen Android i rullemenuen i Android Studios Project-rude til venstre. Hvis ruden er skjult, så vælg View > Tool Windows > Project.
· Udvid app > manifests i ruden, og åbn AndroidManifest.xml.
· Tilføj denne linje inde i manifest-elementet, over application-elementet. Behold resten af den genererede fil.
<uses-permission android:name="android.permission.INTERNET" />· Find det indledende application-tag i samme fil. Tilføj android:usesCleartextTraffic="false" som en attribut i dette tag. Android blokerer allerede ukrypteret HTTP for apps, der er målrettet Android 9 eller nyere, så denne linje gør hensigten eksplicit.
INTERNET-tilladelsen gives ved installationen; den udløser ikke en adgangs-popup, når appen kører. [6] Eksemplet bruger Androids indbyggede netværks- og JSON-værktøjer, så du behøver ikke at tilføje Retrofit eller et andet netværksbibliotek.
Trin 3 Tilføj koden, der henter og viser arbejdsordren
Denne kode forbinder appen til adressen fra trin 1, læser svaret og viser én instruktion ad gangen. Netværksanmodningen kører adskilt fra brugerfladen, så skærmen forbliver responsiv.
Trin 3.1 Åbn den rigtige fil i Android Studio
· Udvid app > kotlin+java > com.example.auraworkorders i Android Studios Project-rude til venstre. I nogle versioner hedder kildemappen java.
· Åbn MainActivity.kt. Denne fil styrer appens startskærm.
· Erstat indholdet med koden nedenfor. Hvis dit pakkenavn er anderledes, så ret den første linje, så den matcher den pakke, du oprettede i trin 2.
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.")
}
}
}
}Trin 3.2 Indtast virksomhedens API-adresse
· Bliv i MainActivity.kt i Android Studio. Tryk på Ctrl+F på Windows eller Linux eller Command+F på macOS, og søg efter api.your-company.example.
· Erstat eksempel-URL'en i linjen URL(...) med virksomhedens endpoint-mønster fra trin 1. Behold $id der, hvor arbejdsordrenummeret skal stå. Hvis serveren f.eks. forventer /api/jobs/WO-1001, skal koden anmode om https://YOUR-APPROVED-HOST/api/jobs/$id .· Læg ikke tokenet i denne fil. Appen har et midlertidigt testfelt til det, når du kører appen.
· Hvis dit API-svar afviger fra udviklerreferencen, skal du opdatere de feltnavne og den struktur, som fetchOrder læser, før du kører appen. I denne funktion læser JSONObject svaret, og getJSONArray("steps") åbner listen over instruktioner.
· Vælg Build > Make Project i Android Studio, hvis kommandoen findes i din version, eller brug værktøjslinjens Run-knap i trin 4 til at kompilere projektet. Ret eventuelle kompileringsfejl i Build-vinduet.
Forventet resultat: Projektet bygges, og URL'en i MainActivity.kt peger på din rigtige testtjeneste. Eksempeladressen, der ender på .example, kan ikke oprette forbindelse til et forretningssystem.
Trin 4 Test forbindelsen på din computer
En emulator er en virtuel Android-enhed, der vises på din computer. Brug den først til at kontrollere API-adressen, tokenet og de returnerede instruktioner, før du går i gang med fejlfinding på en fysisk enhed.
Trin 4.1 Start appen fra Android Studio
· Vælg Tools > Device Manager i Android Studios øverste menu.
· Hvis der allerede findes en egnet virtuel Android-enhed, så vælg dens startknap. Ellers skal du vælge Create Device eller plusknappen, vælge en telefonprofil, vælge et tilgængeligt systemimage, downloade det, hvis du bliver bedt om det, og gennemføre guiden. Start den nye enhed.
· Tilbage i Android Studios øverste værktøjslinje vælger du den kørende enhed i enhedsrullemenuen. Behold app som kørselskonfiguration, og vælg derefter den grønne Run-knap.
· Vent, til appen åbner i emulatoren. Du bør se Work instructions, Work order ID, Sandbox access token og Load work order.
Trin 4.2 Anmod om forretningsposten
· Vælg Work order ID i den kørende app i emulatoren, og indtast testordrenummeret fra trin 1.
· Vælg Sandbox access token i samme app, og indsæt det midlertidige token fra IT. Indsæt kun selve værdien, uden ordet Bearer.
· Vælg Load work order. Når anmodningen lykkes, viser appen Read-only instructions loaded efterfulgt af ordrenummer, udstyrsnavn, procedurerevision og første instruktion.
· Vælg Next for at læse den næste instruktion. Vælg Previous for at gå tilbage. Rul i appen, hvis en instruktion fortsætter under vinduets kant.
Forventet resultat: Den viste post svarer til den post, du åbnede i forretningsprogrammet i trin 1. Hvis den ikke indlæses, så brug fejlfindingsafsnittet, før du går videre til Aura.
Trin 5 Kør den samme forbundne app på XREAL Aura
Trin 5.1 Gør Aura klar til udvikling
· Tænd Aura via compute-pucken. Opret i Auras Settings-app forbindelse til et Wi-Fi-netværk, der kan nå API'et fra trin 1. Bed IT om at bekræfte eventuelle krav til private netværk.
· Følg den aktuelle udviklervejledning fra XREAL for at aktivere fejlfinding og forbinde compute-pucken til din computer. Start med XREALs Aura-FAQ (tutorials.xreal.com/docs/aura/troubleshooting/faq/), der indeholder et punkt om udviklerressourcer; start der, hvis du har brug for de aktuelle instruktioner.
· Åbn Developer options i Auras Settings-app, og aktivér den fejlfindingsmetode, din enhed understøtter, i henhold til vejledningen. Godkend din udviklingscomputer, hvis Aura viser en forespørgsel. Googles vejledning om hardwareenheder forklarer den generelle Android-proces. [7]
De præcise menunavne og kabelopsætninger på Aura afhænger af hardware og firmware. Ifølge XREAL Auras FAQ understøtter begge USB-C-porte på compute-pucken standard-ADB-fejlfinding med Android Studio, så tilslut computeren til Charging Port til venstre, og lad brillerne sidde i Glasses Port til højre. Specifikationstabellen angiver kun fuld ADB-understøttelse under Glasses Port, så prøv den port, hvis den venstre ikke bliver genkendt, og brug XREALs aktuelle instruktioner til at aktivere udvikleradgang. [1]
Trin 5.2 Installer appen fra Android Studio
· Gå tilbage til projektet AuraWorkOrders i Android Studio på din computer.
· Åbn enhedsrullemenuen i Android Studios øverste værktøjslinje. Vælg din tilsluttede Aura-udviklingsenhed i stedet for emulatoren.
· Hvis enheden mangler, så vælg Tools > Troubleshoot Device Connections i Android Studio, og følg forbindelsesassistenten. Bekræft fejlfindingsgodkendelsen og forbindelsesmetoden med XREALs vejledning.
· Når enheden vises, skal du beholde app som kørselskonfiguration og vælge den grønne Run-knap. Android Studio bygger, installerer og starter appen på den valgte enhed.
Trin 5.3 Hent posten i brillerne
· Tag Aura på, og find appvinduet Work instructions, som Android Studio har startet.
· Indtast det samme testordrenummer og midlertidige token, som du brugte i trin 4, i vinduet. Brug de inputmetoder, der er tilgængelige på din enhed; almindelige Bluetooth-tastaturer og -mus fungerer med Aura (Settings > Connected Devices > Pair new device), og et kompatibelt Bluetooth-tastatur kan gøre det nemmere at indtaste testdata. [1]
· Vælg Load work order, og brug derefter Next, Previous og rulning til at læse instruktionerne.
· Sammenlign ordrenummer, udstyrsnavn og instruktionstekst med den oprindelige post i dit forretningsprogram. Hvis de stemmer overens, har du vist, at Aura-appen kan hente og vise den pågældende forretningspost.
Almindelige problemer, og hvad du skal kontrollere
· Appen kan ikke bygges: Åbn View > Tool Windows > Build i Android Studio, og læs den første rapporterede fejl. Kontrollér pakkenavnet, og om Empty Activity-projektet bruger Compose og Material 3.
· Appen kan ikke indlæse ordren: Bekræft i MainActivity.kt i Android Studio, at eksempelværtsnavnet er blevet erstattet. Bed IT om at kontrollere, at endpointet kan nås fra emulatoren eller Auras netværk.
· API'et returnerer 401: API'et accepterede ikke legitimationsoplysningerne. Bed IT om at kontrollere tokenets gyldighed og den tjeneste, det er beregnet til, eller skaf et nyt testtoken.
· API'et returnerer 403: Kontoen mangler tilladelse. Bed administratoren af forretningssystemet om at give den korrekte adgang.
· API'et returnerer 404: Kontrollér ordrenummeret, og om endpointet peger på det rigtige testmiljø.
· API'et returnerer data, men appen fejler: Bed API-udvikleren om at sammenligne svaret med udviklerreferencen. Eksemplet kræver en steps-liste, der ikke er tom, og et id, der matcher den anmodede ordre.
· Virker i emulatoren, men ikke på Aura: Bekræft Auras netværksrute og API-adgang, og kontrollér derefter appen på enheden. Deaktiver ikke kontrollen af HTTPS-certifikater for at omgå en forbindelsesfejl.
Eksemplet viser en generel fejlmeddelelse til brugeren. Hvis du skal kende den præcise API-status, så bed administratoren om at gennemgå serverlogfilerne uden at afsløre tokens eller hele arbejdsordrer. Ved appfejl kan du bruge View > Tool Windows > Logcat i Android Studio; Logcat viser applikationslogs.
Udviklerreference til eksempel-API'et
Brug dette afsnit, når du kontrollerer svaret i trin 1 eller tilpasser fetchOrder i trin 3. Det beskriver kontrakten for denne eksempelapp, ikke et endpoint leveret af XREAL.
Anmodning: GET https://api.your-company.example/work-orders/WO-1001
Anmodningsheadere: Authorization: Bearer <kortlivet adgangstoken> og Accept: application/json
Forventet vellykket svar: HTTP 200 med denne JSON-struktur
{
"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."
}
]
}id identificerer arbejdsordren, asset identificerer udstyret, og revision identificerer procedureversionen. Hver post i steps har et number, en title, en fuld instruction og et expectedResult. Eksemplet sorterer trinene efter number.
Brug godkendte instruktioner til rigtigt arbejde; eksemplet beskriver en inaktiv træningsstation. Før produktion skal du validere svarstørrelse og feltlængder, afvise ugyldige proceduredata og fastlægge, hvad der skal ske, når et token udløber. API'et skal kontrollere tilladelsen for hver anmodet ordre. Eksempelkoden er illustrativ og er ikke blevet kompileret eller testet mod et live system eller en fysisk Aura-enhed.
Konklusion
At forbinde XREAL Aura med et forretningssystem begynder med en godkendt API-adresse og adgangstilladelse efterfulgt af en Android Studio-app, der henter den nødvendige post. Ved at teste forbindelsen på en computer, før den tages i brug på Aura, er det lettere at skelne problemer med dataadgang fra problemer med enhedsopsætningen. Arbejdsordreeksemplet bringer udstyrsoplysninger og trinvise instruktioner ind på en letlæselig brillevisning og giver virksomheder et praktisk udgangspunkt for at gøre driftsoplysninger tilgængelige der, hvor arbejdet udføres. Virksomhedslogin, passende tilladelser og test på enheden gør forbindelsen klar til et pilotprojekt med medarbejdere.
Drøft hardwaretilgængelighed og jeres krav til pilotprojektet med VR Expert.

























