Koble XREAL Aura til forretningssystemene dine

Koble XREAL Aura til forretningssystemene dine

Sammendrag

For å koble XREAL Aura til et forretningssystem kjører du en autorisert bedriftsapp på Android XR-beregningsenheten (compute puck), og lar appen be om data fra systemets API. Et API er en programvareforbindelse som lar én applikasjon hente informasjon fra en annen. I denne veiledningen bygger vi en liten app som henter en arbeidsordre og viser instruksjonene i den på Aura.

En vedlikeholdsarbeidsordre egner seg godt som første integrasjon, fordi den kombinerer et ordrenummer, utstyrsdetaljer og praktiske instruksjoner. Appen henter disse feltene via en autorisert tilkobling og presenterer dem i et lettlest vindu. Samme tilnærming kan tilpasses andre forretningsposter når API-ene og tilgangsreglene deres tillater det.

Slik fungerer forretningsintegrasjon med XREAL Aura

XREAL Aura består av kablede briller og en beregningsenhet, den lille datamaskinen som kjører Android XR og appen din. Appen kobler seg til bedriftssystemet via Wi-Fi og en godkjent nettverksrute; brillene viser informasjonen som returneres. [1]

En arbeidsordre beskriver en jobb og instruksjonene for å utføre den. En ansatt skriver inn ordrenummeret i Aura-appen og velger Load work order. Appen ber forretningssystemet om posten og viser deretter utstyrsnavnet, prosedyreversjonen og de detaljerte instruksjonene. Med Next og Previous kan den ansatte bla gjennom instruksjonene, mens kildeposten forblir uendret.

Hvis bedriften din allerede har en Android-app som viser disse postene, bør du be utvikleren om å sjekke om den fungerer som den skal på Android XR før dere bygger en ny. Google støtter standard Android-grensesnitt (for eksempel en 2D-mobilapp eller en Android-app for store skjermer) i et XR-systempanel, som et 2D-vindu i XR-miljøet. En eksisterende app må likevel testes for kompatibilitet og tilgang. [4]

Mer om maskinvaren finner du på produktsiden vår for XREAL Aura. Kontroller gjeldende tilgjengelighet og støtte i ditt land, siden lanseringsinformasjonen endrer seg. [2]

Trinn 1 Skaff en testarbeidsordre og tilkoblingsdetaljene for den

Aura-appen trenger en post å vise og tillatelse til å hente den fra bedriftssystemet. En arbeidsordre er en jobbpost som inneholder et ordrenummer, utstyrsdetaljer og instruksjoner, for eksempel trinnene for å inspisere en maskin.

· Før du skriver koden, må du sørge for at du har et HTTPS-endepunkt, et testtilgangstoken og et eksempelnummer for en arbeidsordre (f.eks. WO-1001) som samsvarer med JSON-skjemaet i utviklerreferansen.

· Be IT-avdelingen om API-adressen som henter denne ordren, og et midlertidig testtilgangstoken. API-adressen forteller appen hvor den skal be om posten; tokenet gir den tillatelse til å lese dataene. Be IT bekrefte at begge fungerer, og om det kreves tilgang til bedriftsnettverket.

· Del utviklerreferansen nederst i denne artikkelen med IT, slik at de kan kontrollere at dataene som returneres, samsvarer med eksempelappen. Hvis de avviker, oppdaterer du koden i trinn 3 slik at den leser feltnavnene i systemet ditt. Hvis det ikke finnes et egnet API, må IT først sørge for et.

Ha disse tre tingene klare: API-adressen skal inn i koden i trinn 3, mens tokenet og arbeidsordrenummeret skal inn i den kjørende appen i trinn 4. Sammen gjør de det mulig for appen å hente jobben og vise instruksjonene på Aura.

Trinn 2 Åpne Android Studio og klargjør appen

Trinn 2.1 Opprett prosjektet på datamaskinen

· Åpne den offisielle nedlastingssiden for Android Studio i nettleseren på datamaskinen. Installer Android Studio og fullfør oppsettet. Hvis du trenger Googles dedikerte XR-verktøy, følger du oppsettveiledningen for Android Studio for XR, som for øyeblikket anbefaler en Canary-versjon, altså en tidlig utviklingsversjon. [5]

· Åpne Android Studio. Velg New Project på velkomstskjermen. Hvis et annet prosjekt er åpent, velger du File > New > New Project i toppmenyen i Android Studio.

· I prosjektvinduet velger du Phone and Tablet > Empty Activity. Velg Next.

· Sett Name til AuraWorkOrders og Package name til com.example.auraworkorders. Velg Kotlin der det vises et språkvalg, behold malens SDK-innstillinger og velg Finish.

· Vent til Android Studio er ferdig med Gradle-synkroniseringen. Gradle er byggeverktøyet som klargjør prosjektets biblioteker og innstillinger. Løs eventuelle feil i Build- eller Sync-vinduet før du fortsetter.

Trinn 2.2 Gi appen tilgang til nettverket

Manifestet er Android-filen som angir hva appen trenger, blant annet nettverkstillatelse.

· I Project-ruten til venstre i Android Studio velger du Android-visningen fra rullegardinmenyen. Hvis ruten er skjult, velger du View > Tool Windows > Project.

· I den ruten utvider du app > manifests og åpner AndroidManifest.xml.

· Legg til denne linjen inne i manifest-elementet, over application-elementet. Behold resten av den genererte filen.

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

· Finn den åpnende application-taggen i samme fil. Legg til android:usesCleartextTraffic="false" som et attributt i taggen. Android blokkerer allerede ukryptert HTTP for apper som er rettet mot Android 9 eller nyere, så denne linjen gjør intensjonen eksplisitt.

INTERNET-tillatelsen gis ved installasjon; den utløser ingen tilgangsforespørsel når appen kjører. [6] Eksempelet bruker Androids innebygde nettverks- og JSON-verktøy, så du trenger ikke å legge til Retrofit eller et annet nettverksbibliotek.

Trinn 3 Legg til koden som henter og viser arbeidsordren

Denne koden kobler appen til adressen fra trinn 1, leser svaret og viser én instruksjon om gangen. Nettverksforespørselen kjøres atskilt fra grensesnittet, slik at skjermen fortsetter å reagere.

Trinn 3.1 Åpne riktig fil i Android Studio

· I Project-ruten til venstre i Android Studio utvider du app > kotlin+java > com.example.auraworkorders. I enkelte versjoner heter kildemappen java.

· Åpne MainActivity.kt. Denne filen styrer appens startskjerm.

· Erstatt innholdet med koden nedenfor. Hvis pakkenavnet ditt er et annet, endrer du første linje slik at den samsvarer med pakken du opprettet i trinn 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.")
        	}
    	}
    }
}

Trinn 3.2 Legg inn bedriftens API-adresse

· Bli værende i MainActivity.kt i Android Studio. Trykk Ctrl+F på Windows eller Linux, eller Command+F på macOS, og søk etter api.your-company.example.

· Erstatt eksempel-URL-en i URL(...)-linjen med bedriftens endepunktmønster fra trinn 1. Behold $id der arbeidsordrenummeret skal stå. Hvis serveren for eksempel forventer /api/jobs/WO-1001, skal koden be om https://YOUR-APPROVED-HOST/api/jobs/$id .· Ikke legg tokenet i denne filen. Appen har et midlertidig testfelt for det når du kjører appen.

· Hvis API-svaret ditt avviker fra utviklerreferansen, oppdaterer du feltnavnene og strukturen som fetchOrder leser, før du kjører appen. I denne funksjonen leser JSONObject svaret, og getJSONArray("steps") åpner listen over instruksjoner.

· I Android Studio velger du Build > Make Project hvis kommandoen finnes i din versjon, eller bruker Run-knappen på verktøylinjen i trinn 4 for å kompilere prosjektet. Rett eventuelle kompileringsfeil i Build-vinduet.

Forventet resultat: Prosjektet bygges, og URL-en i MainActivity.kt peker til den faktiske testtjenesten din. Eksempeladressen som slutter på .example, vil ikke koble til noe forretningssystem.

Trinn 4 Test tilkoblingen på datamaskinen

En emulator er en virtuell Android-enhet som vises på datamaskinen. Bruk den først til å kontrollere API-adressen, tokenet og instruksjonene som returneres, før du begynner å feilsøke på en fysisk enhet.

Trinn 4.1 Start appen fra Android Studio

· Velg Tools > Device Manager i toppmenyen i Android Studio.

· Hvis det allerede finnes en egnet virtuell Android-enhet, velger du startknappen for den. Ellers velger du Create Device eller plussknappen, velger en telefonprofil og et tilgjengelig systembilde, laster det ned hvis du blir bedt om det, og fullfører veiviseren. Start den nye enheten.

· Tilbake på verktøylinjen øverst i Android Studio velger du den kjørende enheten i enhetsmenyen. La app være valgt som kjørekonfigurasjon, og velg deretter den grønne Run-knappen.

· Vent til appen åpnes i emulatoren. Du skal se Work instructions, Work order ID, Sandbox access token og Load work order.

Trinn 4.2 Be om forretningsposten

· I appen som kjører i emulatoren, velger du Work order ID og skriver inn testordrenummeret fra trinn 1.

· I samme app velger du Sandbox access token og limer inn det midlertidige tokenet du har fått fra IT. Lim bare inn selve verdien, uten ordet Bearer.

· Velg Load work order. Når forespørselen lykkes, viser appen Read-only instructions loaded, etterfulgt av ordrenummeret, utstyrsnavnet, prosedyrerevisjonen og den første instruksjonen.

· Velg Next for å lese neste instruksjon. Velg Previous for å gå tilbake. Rull i appen hvis en instruksjon går lenger ned enn vinduet.

Forventet resultat: Posten som vises, samsvarer med posten du åpnet i forretningsapplikasjonen i trinn 1. Hvis den ikke lastes inn, går du gjennom feilsøkingsdelen før du går videre til Aura.

Trinn 5 Kjør den samme tilkoblede appen på XREAL Aura

Trinn 5.1 Klargjør Aura for utvikling

· Slå på Aura med beregningsenheten. I Settings-appen på Aura kobler du til et Wi-Fi-nettverk som kan nå API-et fra trinn 1. Be IT bekrefte eventuelle krav til private nettverk.

· Følg den gjeldende utviklerveiledningen fra XREAL for å aktivere feilsøking og koble beregningsenheten til datamaskinen. Begynn med XREALs Aura-FAQ (tutorials.xreal.com/docs/aura/troubleshooting/faq/), som har en oppføring om utviklerressurser; start der hvis du trenger de gjeldende instruksjonene.

· Åpne Developer options i Settings-appen på Aura, og aktiver feilsøkingsmetoden enheten din støtter, i tråd med den veiledningen. Autoriser utviklingsdatamaskinen hvis Aura viser en forespørsel. Googles veiledning for maskinvareenheter forklarer den generelle prosessen for Android. [7]

De nøyaktige menynavnene og kabeloppsettet på Aura avhenger av maskinvaren og fastvaren. Ifølge XREAL Auras FAQ støtter begge USB-C-portene på beregningsenheten standard ADB-feilsøking med Android Studio, så koble datamaskinen til ladeporten (Charging Port) til venstre, og la brillene være koblet til brilleporten (Glasses Port) til høyre. Spesifikasjonstabellen oppgir full ADB-støtte bare for brilleporten, så prøv den porten hvis den venstre ikke blir gjenkjent, og bruk XREALs gjeldende instruksjoner for å aktivere utviklertilgang. [1]

Trinn 5.2 Installer appen fra Android Studio

· Gå tilbake til AuraWorkOrders-prosjektet i Android Studio på datamaskinen.

· Åpne enhetsmenyen på verktøylinjen øverst i Android Studio. Velg den tilkoblede Aura-utviklingsenheten i stedet for emulatoren.

· Hvis enheten mangler, velger du Tools > Troubleshoot Device Connections i Android Studio og følger tilkoblingsassistenten. Kontroller feilsøkingsautorisasjonen og tilkoblingsmetoden mot XREALs utviklerveiledning.

· Når enheten vises, lar du app være valgt som kjørekonfigurasjon og velger den grønne Run-knappen. Android Studio bygger, installerer og starter appen på den valgte enheten.

Trinn 5.3 Hent posten i brillene

· Ta på deg Aura og finn appvinduet Work instructions som Android Studio startet.

· Skriv inn det samme testordrenummeret og det midlertidige tokenet som i trinn 4 i dette vinduet. Bruk inndatametodene som er tilgjengelige på enheten din. Vanlige Bluetooth-tastaturer og -mus fungerer med Aura (Settings > Connected Devices > Pair new device), og et kompatibelt Bluetooth-tastatur kan gjøre det enklere å skrive inn testdata. [1]

· Velg Load work order, og bruk deretter Next, Previous og rulling for å lese instruksjonene.

· Sammenlign ordrenummeret, utstyrsnavnet og instruksjonsteksten med den opprinnelige posten i forretningsapplikasjonen. Hvis de samsvarer, har du vist at Aura-appen kan hente og vise denne forretningsposten.

Vanlige problemer og hva du bør sjekke

· Appen bygges ikke: Åpne View > Tool Windows > Build i Android Studio og les den første feilen som rapporteres. Kontroller pakkenavnet og om Empty Activity-prosjektet bruker Compose og Material 3.

· Appen får ikke lastet inn ordren: Kontroller i MainActivity.kt i Android Studio at eksempelvertsnavnet er erstattet. Be IT sjekke at endepunktet kan nås fra emulatoren eller Aura-nettverket.

· API-et returnerer 401: API-et godtok ikke legitimasjonen. Be IT kontrollere om tokenet er gyldig og beregnet på riktig tjeneste, eller skaff et nytt testtoken.

· API-et returnerer 403: Kontoen mangler tillatelse. Be administratoren for forretningssystemet om å gi riktig tilgang.

· API-et returnerer 404: Kontroller ordrenummeret og om endepunktet peker til riktig testmiljø.

· API-et returnerer data, men appen feiler: Be API-utvikleren sammenligne svaret med utviklerreferansen. Eksempelet krever en steps-liste som ikke er tom, og en id som samsvarer med den forespurte ordren.

· Fungerer i emulatoren, men ikke på Aura: Kontroller nettverksruten og API-tilgangen for Aura, og sjekk deretter appen på enheten. Ikke deaktiver kontrollen av HTTPS-sertifikater for å omgå en tilkoblingsfeil.

Eksempelet viser en generell feilmelding til brukeren. For å finne den nøyaktige API-statusen kan du be administratoren undersøke serverloggene uten å eksponere tokener eller fullstendige arbeidsordrer. For appfeil bruker du View > Tool Windows > Logcat i Android Studio; Logcat viser applikasjonslogger.

Utviklerreferanse for eksempel-API-et

Bruk denne delen når du kontrollerer svaret i trinn 1 eller tilpasser fetchOrder i trinn 3. Den beskriver kontrakten for denne eksempelappen, ikke et endepunkt som XREAL tilbyr.

Forespørsel: GET https://api.your-company.example/work-orders/WO-1001

Forespørselshoder: Authorization: Bearer <kortvarig tilgangstoken> og Accept: application/json

Forventet vellykket svar: HTTP 200 med denne JSON-strukturen

{
  "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 identifiserer arbeidsordren, asset identifiserer utstyret, og revision identifiserer prosedyreversjonen. Hver oppføring i steps har et nummer (number), en tittel (title), en fullstendig instruksjon (instruction) og et expectedResult. Eksempelet sorterer trinnene etter nummer.

Bruk godkjente instruksjoner for reelt arbeid; eksempelet beskriver en inaktiv opplæringsstasjon. Før produksjon må du validere svarstørrelse og feltlengder, avvise ugyldige prosedyredata og definere hvordan appen skal oppføre seg når tokenet utløper. API-et må kontrollere tillatelsen for hver ordre som etterspørres. Eksempelkoden er ment som illustrasjon og er ikke kompilert eller testet mot et live system eller en fysisk Aura-enhet.

Konklusjon

Å koble XREAL Aura til et forretningssystem starter med en godkjent API-adresse og tilgangstillatelse, etterfulgt av en Android Studio-app som henter den nødvendige posten. Ved å teste tilkoblingen på en datamaskin før den tas i bruk på Aura blir det lettere å skille problemer med datatilgang fra problemer med enhetsoppsettet. Arbeidsordreeksempelet bringer utstyrsdetaljer og trinnvise instruksjoner inn i en lettlest brillevisning og gir bedrifter et praktisk utgangspunkt for å gjøre driftsinformasjon tilgjengelig der arbeidet utføres. Bedriftspålogging, riktige tillatelser og enhetstesting gjør tilkoblingen klar for en pilot med ansatte.

Diskuter tilgjengelighet av maskinvare og kravene til piloten deres med VR Expert.

João Noronha

Skrevet av

João Noronha

XR- og Immersive Content-spesialist hos VR Expert

João Noronha er XR- og Immersive Content-spesialist hos VR Expert, med stor interesse for ny teknologi og dens praktiske bruksområder. Han fokuserer på å omgjøre komplekse utviklinger innen VR, AR, AI-briller og immersiv teknologi til klart og praktisk innhold for bedrifter og fagfolk som utforsker XR-bransjen.

Ofte stilte spørsmål

Denne artikkelen

Systemet må ha et tilgjengelig API, en godkjent autentiseringsmetode og tillatelse til å hente de nødvendige postene. ERP-programvare (Enterprise Resource Planning) koordinerer forretningsdriften, mens programvare for vedlikeholdsstyring organiserer service på utstyr. API-ene og datastrukturene deres varierer, så hver integrasjon må kontrolleres opp mot det aktuelle produktet og den aktuelle konfigurasjonen.

Google støtter standard Android-grensesnitt i Android XR-systempaneler. 2D-mobilapper og Android-apper for store skjermer fungerer som standard i Android XR og vises som et 2D-panel i et XR/3D-rom. Test appens pålogging, nettverkstilgang, visning og inndata på Aura før du godkjenner den for ansatte. En eksisterende app som allerede leverer de nødvendige postene, kan redusere hvor mye utvikling som trengs. [4]

Et vanlig Android-appvindu kan vise arbeidsordren og instruksjonene. Egendefinerte Jetpack XR-paneler er en valgfri utvidelse når en bestemt oppgave har nytte av en annen plassering av informasjonen. [4]

Et internt bedrifts-API kan være tilgjengelig via et godkjent lokalt eller privat nettverk. Enheten må likevel kunne nå API-et og eventuelle tjenester som kreves for autentisering. Eksempelet krever en aktiv tilkobling og lagrer ikke arbeidsordrer for bruk uten nett.

Eksempelet henter og viser informasjon. Innsending av resultater krever en ekstra API-operasjon, brukertillatelse og et bekreftelsesgrensesnitt. Serveren må validere innsendingen og håndtere gjentatte forespørsler på en trygg måte.