Tiivistelmä
Kun XREAL Aura yhdistetään yritysjärjestelmään, sen Android XR -laskentayksikössä ajetaan valtuutettua yrityssovellusta, joka pyytää tietoja järjestelmän API:sta. API on ohjelmistoliittymä, jonka avulla sovellus voi hakea tietoja toisesta sovelluksesta. Tässä oppaassa rakennetaan pieni sovellus, joka hakee työmääräyksen ja näyttää sen ohjeet Aurassa.
Huollon työmääräys on hyvä ensimmäinen integraatio, koska siinä yhdistyvät tietueen numero, laitetiedot ja käytännön ohjeet. Sovellus hakee nämä kentät valtuutetun yhteyden kautta ja esittää ne helppolukuisessa ikkunassa. Samaa lähestymistapaa voi soveltaa muihinkin yritystietueisiin, kun niiden API:t ja käyttöoikeussäännöt sen sallivat.
Näin XREAL Auran yritysintegraatio toimii
XREAL Aura koostuu johdollisista laseista ja laskentayksiköstä eli pienestä tietokoneesta, jossa Android XR ja sovelluksesi toimivat. Sovellus muodostaa yhteyden yrityksen järjestelmään Wi-Fin ja hyväksytyn verkkoreitin kautta; lasit näyttävät palautetut tiedot. [1]
Työmääräys kuvaa työtehtävän ja ohjeet sen suorittamiseen. Työntekijä syöttää Aura-sovellukseen määräyksen numeron ja valitsee Load work order. Sovellus pyytää tietueen yritysjärjestelmästä ja näyttää sitten laitteen nimen, menettelyn version ja yksityiskohtaiset ohjeet. Next- ja Previous-painikkeilla työntekijä voi siirtyä ohjeissa eteen- ja taaksepäin, eikä lähdetietue muutu.
Jos yritykselläsi on jo Android-sovellus, joka näyttää nämä tietueet, pyydä sen kehittäjää tarkistamaan, toimiiko se oikein Android XR:ssä, ennen kuin rakennatte uuden. Google tukee tavallisia Android-käyttöliittymiä (kuten 2D-mobiilisovellusta tai suurelle näytölle tarkoitettua Android-sovellusta) XR-järjestelmäpaneelissa eli 2D-ikkunana XR-ympäristön sisällä. Olemassa olevan sovelluksen yhteensopivuus ja käyttöoikeudet on silti testattava. [4]
Laitteistotietoja löydät XREAL Aura -tuotesivultamme. Tarkista ajantasainen saatavuus ja tuki omassa maassasi, sillä julkaisutiedot muuttuvat. [2]
Vaihe 1 Hanki testityömääräys ja sen yhteystiedot
Aura-sovelluksesi tarvitsee näytettävän tietueen ja luvan hakea se yrityksesi järjestelmästä. Työmääräys on työtehtävän tietue, joka sisältää määräyksen numeron, laitetiedot ja ohjeet, kuten koneen tarkastuksen vaiheet.
· Varmista ennen koodin kirjoittamista, että sinulla on HTTPS-päätepiste, testikäyttöoikeustunnus ja esimerkkityömääräyksen numero (esim. WO-1001), jotka vastaavat kehittäjäviitteessä kuvattua JSON-skeemaa.
· Pyydä IT-tiimiltäsi API-osoite, josta tämä määräys haetaan, sekä väliaikainen testikäyttöoikeustunnus. API-osoite kertoo sovellukselle, mistä tietue pyydetään; tunnus antaa sille luvan lukea tiedot. Pyydä IT:tä varmistamaan, että molemmat toimivat ja tarvitaanko yhteys yrityksen verkkoon.
· Jaa tämän artikkelin lopussa oleva kehittäjäviite IT:lle, jotta he voivat tarkistaa, vastaavatko palautetut tiedot esimerkkisovellusta. Jos ne poikkeavat, päivitä vaiheen 3 koodi lukemaan järjestelmäsi kenttien nimet. Jos sopivaa API:a ei ole, IT:n on ensin tarjottava sellainen.
Pidä nämä kolme asiaa valmiina: API-osoite lisätään koodiin vaiheessa 3; tunnus ja työmääräyksen numero syötetään käynnissä olevaan sovellukseen vaiheessa 4. Niiden avulla sovellus voi hakea työtehtävän ja näyttää sen ohjeet Aurassa.
Vaihe 2 Avaa Android Studio ja valmistele sovellus
Vaihe 2.1 Luo projekti tietokoneellasi
· Avaa tietokoneesi selaimessa Android Studion virallinen lataussivu. Asenna Android Studio ja suorita sen käyttöönotto loppuun. Jos tarvitset Googlen erillisiä XR-työkaluja, noudata sen Android Studio for XR -asennusopasta, jossa suositellaan tällä hetkellä Canary-versiota eli varhaista kehitysversiota. [5]
· Avaa Android Studio. Valitse aloitusnäytössä New Project. Jos toinen projekti on auki, valitse Android Studion ylävalikosta File > New > New Project.
· Valitse projekti-ikkunassa Phone and Tablet > Empty Activity. Valitse Next.
· Kirjoita Name-kenttään AuraWorkOrders ja Package name -kenttään com.example.auraworkorders. Valitse kieleksi Kotlin, jos kielivalinta näkyy, säilytä mallipohjan SDK-asetukset ja valitse Finish.
· Odota, kunnes Android Studio on suorittanut Gradle-synkronoinnin. Gradle on koontityökalu, joka valmistelee projektin kirjastot ja asetukset. Korjaa mahdolliset virheet Build- tai Sync-ikkunassa ennen kuin jatkat.
Vaihe 2.2 Salli sovelluksen käyttää verkkoa
Manifesti on Android-tiedosto, jossa ilmoitetaan, mitä sovellus tarvitsee, verkko-oikeus mukaan lukien.
· Valitse Android Studion vasemman reunan Project-paneelin pudotusvalikosta Android-näkymä. Jos paneeli on piilotettu, valitse View > Tool Windows > Project.
· Laajenna paneelissa app > manifests ja avaa AndroidManifest.xml.
· Lisää tämä rivi manifest-elementin sisälle application-elementin yläpuolelle. Jätä muu luotu tiedosto ennalleen.
<uses-permission android:name="android.permission.INTERNET" />· Etsi samasta tiedostosta application-elementin aloitustagi. Lisää tagin sisälle attribuutti android:usesCleartextTraffic="false". Android estää jo salaamattoman HTTP-liikenteen sovelluksilta, joiden kohdeversio on Android 9 tai uudempi, joten tämä rivi vain tekee tarkoituksen näkyväksi.
INTERNET-oikeus myönnetään asennuksen yhteydessä; se ei tuo esiin käyttöoikeuskehotetta sovelluksen ollessa käynnissä. [6] Esimerkki käyttää Androidin sisäänrakennettuja verkko- ja JSON-työkaluja, joten Retrofitia tai muuta verkkokirjastoa ei tarvitse lisätä.
Vaihe 3 Lisää koodi, joka hakee ja näyttää työmääräyksen
Tämä koodi yhdistää sovelluksen vaiheen 1 osoitteeseen, lukee vastauksen ja näyttää yhden ohjeen kerrallaan. Verkkopyyntö suoritetaan erillään käyttöliittymästä, jotta näyttö pysyy responsiivisena.
Vaihe 3.1 Avaa oikea tiedosto Android Studiossa
· Laajenna Android Studion vasemman reunan Project-paneelissa app > kotlin+java > com.example.auraworkorders. Joissakin versioissa lähdekoodikansion nimi on java.
· Avaa MainActivity.kt. Tämä tiedosto ohjaa sovelluksen aloitusnäyttöä.
· Korvaa sen sisältö alla olevalla koodilla. Jos pakettisi nimi on eri, muuta ensimmäinen rivi vastaamaan vaiheessa 2 luomaasi pakettia.
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.")
}
}
}
}Vaihe 3.2 Syötä yrityksesi API-osoite
· Pysy Android Studiossa MainActivity.kt-tiedostossa. Paina Windowsissa tai Linuxissa Ctrl+F tai macOS:ssä Command+F ja hae api.your-company.example.
· Korvaa URL(...)-rivin esimerkki-URL yrityksesi päätepisteen mallilla vaiheesta 1. Säilytä $id kohdassa, johon työmääräyksen numero kuuluu. Jos palvelin esimerkiksi odottaa muotoa /api/jobs/WO-1001, koodin tulee pyytää osoitetta https://YOUR-APPROVED-HOST/api/jobs/$id .· Älä lisää tunnusta tähän tiedostoon. Sovelluksessa on sille väliaikainen testikenttä, kun suoritat sovelluksen.
· Jos API-vastauksesi poikkeaa kehittäjäviitteestä, päivitä fetchOrder-funktion lukemat kenttien nimet ja rakenne ennen suorittamista. Tässä funktiossa JSONObject lukee vastauksen ja getJSONArray("steps") avaa sen ohjeluettelon.
· Valitse Android Studiossa Build > Make Project, jos komento on käytettävissä versiossasi, tai käännä projekti vaiheessa 4 työkalurivin Run-painikkeella. Korjaa mahdolliset käännösvirheet Build-ikkunassa.
Odotettu tulos: projekti kääntyy, ja MainActivity.kt-tiedoston URL osoittaa todelliseen testipalveluusi. Esimerkkiosoite, joka päättyy .example, ei muodosta yhteyttä yritysjärjestelmään.
Vaihe 4 Testaa yhteys tietokoneellasi
Emulaattori on tietokoneellasi näkyvä virtuaalinen Android-laite. Tarkista sen avulla ensin API-osoite, tunnus ja palautetut ohjeet, ennen kuin ryhdyt selvittämään fyysisen laitteen ongelmia.
Vaihe 4.1 Käynnistä sovellus Android Studiosta
· Valitse Android Studion ylävalikosta Tools > Device Manager.
· Jos sopiva Android-virtuaalilaite on jo olemassa, valitse sen käynnistyspainike. Muussa tapauksessa valitse Create Device tai plus-painike, valitse puhelinprofiili, valitse saatavilla oleva järjestelmäkuva, lataa se pyydettäessä ja suorita ohjattu toiminto loppuun. Käynnistä uusi laite.
· Palaa Android Studion ylätyökaluriville ja valitse käynnissä oleva laite laitteiden pudotusvalikosta. Pidä suoritusmäärityksenä app ja valitse vihreä Run-painike.
· Odota, että sovellus avautuu emulaattorissa. Näkyvissä pitäisi olla Work instructions, Work order ID, Sandbox access token ja Load work order.
Vaihe 4.2 Pyydä yritystietue
· Valitse emulaattorissa käynnissä olevassa sovelluksessa Work order ID ja syötä vaiheen 1 testimääräyksen numero.
· Valitse samassa sovelluksessa Sandbox access token ja liitä IT:n toimittama väliaikainen tunnus. Liitä vain sen arvo ilman sanaa Bearer.
· Valitse Load work order. Kun pyyntö onnistuu, sovellus näyttää ilmoituksen Read-only instructions loaded ja sen jälkeen määräyksen numeron, laitteen nimen, menettelyn version ja ensimmäisen ohjeen.
· Valitse Next lukeaksesi seuraavan ohjeen. Valitse Previous palataksesi takaisin. Vieritä sovelluksessa, jos ohje jatkuu ikkunan alareunan yli.
Odotettu tulos: näytetty tietue vastaa tietuetta, jonka avasit yrityssovelluksessa vaiheessa 1. Jos se ei lataudu, käy läpi vianmääritysosio ennen kuin siirryt Auraan.
Vaihe 5 Suorita sama yhdistetty sovellus XREAL Aurassa
Vaihe 5.1 Valmistele Aura kehitystä varten
· Käynnistä Aura sen laskentayksiköstä. Yhdistä Auran Settings-sovelluksessa Wi-Fi-verkkoon, josta on yhteys vaiheen 1 API:in. Pyydä IT:tä vahvistamaan mahdolliset yksityisverkon vaatimukset.
· Ota virheenkorjaus käyttöön ja yhdistä laskentayksikkö tietokoneeseesi XREALin toimittaman ajantasaisen kehittäjäperehdytyksen mukaisesti. Aloita XREALin Auran usein kysytyistä kysymyksistä (tutorials.xreal.com/docs/aura/troubleshooting/faq/), joissa on kehittäjäresurssien kohta; aloita sieltä, jos tarvitset ajantasaiset ohjeet.
· Avaa Auran Settings-sovelluksessa Developer options ja ota käyttöön laitteesi tukema virheenkorjaustapa perehdytyksen ohjeiden mukaisesti. Valtuuta kehitystietokoneesi, jos Aura näyttää kehotteen. Googlen fyysisten laitteiden opas kuvaa Androidin yleisen menettelyn. [7]
Auran tarkat valikkonimet ja kaapelijärjestelyt riippuvat laitteistosta ja laiteohjelmistosta. XREAL Auran usein kysytyissä kysymyksissä todetaan, että laskentayksikön molemmat USB-C-portit tukevat tavallista ADB-virheenkorjausta Android Studion kanssa, joten yhdistä tietokone vasemmalla olevaan latausporttiin (Charging Port) ja jätä lasit oikealla olevaan lasiporttiin (Glasses Port). Teknisten tietojen taulukossa täysi ADB-tuki mainitaan vain lasiportin kohdalla, joten kokeile sitä porttia, jos vasenta ei tunnisteta, ja ota kehittäjäkäyttö käyttöön XREALin ajantasaisten ohjeiden mukaisesti. [1]
Vaihe 5.2 Asenna sovellus Android Studiosta
· Palaa tietokoneellasi Android Studion AuraWorkOrders-projektiin.
· Avaa laitteiden pudotusvalikko Android Studion ylätyökalurivillä. Valitse emulaattorin sijaan yhdistetty Aura-kehityslaitteesi.
· Jos laitetta ei näy, valitse Android Studiossa Tools > Troubleshoot Device Connections ja noudata yhteysavustajan ohjeita. Tarkista virheenkorjauksen valtuutus ja yhteystapa XREALin perehdytysohjeista.
· Kun laite tulee näkyviin, pidä suoritusmäärityksenä app ja valitse vihreä Run-painike. Android Studio kääntää, asentaa ja käynnistää sovelluksen valitussa laitteessa.
Vaihe 5.3 Hae tietue laseihin
· Laita Aura päähäsi ja etsi Android Studion käynnistämä Work instructions -sovellusikkuna.
· Syötä ikkunaan sama testimääräyksen numero ja väliaikainen tunnus, joita käytit vaiheessa 4. Käytä laitteesi tarjoamia syöttötapoja; tavalliset Bluetooth-näppäimistöt ja -hiiret toimivat Auran kanssa (Settings > Connected Devices > Pair new device), ja yhteensopiva Bluetooth-näppäimistö voi helpottaa testitietojen syöttämistä. [1]
· Valitse Load work order ja lue ohjeet Next- ja Previous-painikkeilla sekä vierittämällä.
· Vertaa määräyksen numeroa, laitteen nimeä ja ohjetekstiä yrityssovelluksesi alkuperäiseen tietueeseen. Jos ne vastaavat toisiaan, olet osoittanut, että Aura-sovellus pystyy hakemaan ja näyttämään kyseisen yritystietueen.
Yleisiä ongelmia ja mitä tarkistaa
· Sovellus ei käänny: Avaa Android Studiossa View > Tool Windows > Build ja lue ensimmäinen raportoitu virhe. Tarkista paketin nimi ja se, käyttääkö Empty Activity -projekti Composea ja Material 3:a.
· Sovellus ei pysty lataamaan määräystä: Varmista Android Studiossa MainActivity.kt-tiedostosta, että esimerkkipalvelimen nimi on korvattu. Pyydä IT:tä tarkistamaan, että päätepiste on tavoitettavissa emulaattorin tai Auran verkosta.
· API palauttaa koodin 401: API ei hyväksynyt tunnistetietoa. Pyydä IT:tä tarkistamaan tunnuksen voimassaolo ja palvelu, jolle se on tarkoitettu, tai hanki uusi testitunnus.
· API palauttaa koodin 403: Tililtä puuttuu käyttöoikeus. Pyydä yritysjärjestelmän pääkäyttäjää myöntämään oikeat käyttöoikeudet.
· API palauttaa koodin 404: Tarkista määräyksen numero ja se, osoittaako päätepiste oikeaan testiympäristöön.
· API palauttaa tietoja, mutta sovellus epäonnistuu: Pyydä API-kehittäjää vertaamaan vastausta kehittäjäviitteeseen. Esimerkki edellyttää, että steps-luettelo ei ole tyhjä ja että id vastaa pyydettyä määräystä.
· Toimii emulaattorissa mutta ei Aurassa: Varmista Auran verkkoreitti ja API-käyttöoikeus ja tarkista sitten sovellus laitteessa. Älä poista HTTPS-varmenteiden tarkistusta käytöstä ohittaaksesi yhteysvirheen.
Esimerkki näyttää käyttäjälle yleisen virheilmoituksen. Tarkan API-tilakoodin selvittämiseksi pyydä pääkäyttäjää tutkimaan palvelinlokit paljastamatta tunnuksia tai kokonaisia työmääräyksiä. Sovellusvirheiden selvittämiseen käytä Android Studiossa kohtaa View > Tool Windows > Logcat; Logcat näyttää sovelluslokit.
Esimerkki-API:n kehittäjäviite
Käytä tätä osiota, kun tarkistat vastausta vaiheessa 1 tai mukautat fetchOrder-funktiota vaiheessa 3. Se kuvaa tämän esimerkkisovelluksen rajapintasopimuksen, ei XREALin tarjoamaa päätepistettä.
Pyyntö: GET https://api.your-company.example/work-orders/WO-1001
Pyynnön otsakkeet: Authorization: Bearer <lyhytikäinen käyttöoikeustunnus> ja Accept: application/json
Odotettu onnistunut vastaus: HTTP 200 ja seuraava JSON-rakenne
{
"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 yksilöi työmääräyksen, asset sen laitteen ja revision menettelyn version. Jokaisella steps-luettelon merkinnällä on numero, otsikko, koko ohje ja expectedResult. Esimerkki lajittelee vaiheet numeron mukaan.
Käytä todellisessa työssä hyväksyttyjä ohjeita; esimerkki kuvaa käytöstä poissa olevaa koulutusasemaa. Ennen tuotantokäyttöä validoi vastauksen koko ja kenttien pituudet, hylkää virheelliset menettelytiedot ja määritä, miten toimitaan tunnuksen vanhentuessa. API:n on tarkistettava käyttöoikeus jokaisen pyydetyn määräyksen kohdalla. Esimerkkikoodi on havainnollistava, eikä sitä ole käännetty tai testattu todellista järjestelmää tai fyysistä Aura-laitetta vasten.
Yhteenveto
XREAL Auran yhdistäminen yritysjärjestelmään alkaa hyväksytystä API-osoitteesta ja käyttöoikeudesta, minkä jälkeen rakennetaan Android Studio -sovellus, joka hakee tarvittavan tietueen. Kun yhteys testataan tietokoneella ennen sen käyttöönottoa Aurassa, tietojen saatavuuteen liittyvät ongelmat on helpompi erottaa laitteen asetuksiin liittyvistä. Työmääräysesimerkki tuo laitetiedot ja vaiheittaiset ohjeet helppolukuiseen lasinäyttöön, mikä antaa yrityksille käytännöllisen lähtökohdan operatiivisen tiedon saattamiseen saataville työn äärellä. Yrityksen kirjautumispalvelu, asianmukaiset käyttöoikeudet ja laitetestaus valmistelevat yhteyden työntekijäpilottia varten.
Keskustele laitteiden saatavuudesta ja pilottisi vaatimuksista VR Expertin kanssa.

























