Shrnutí
Chcete-li XREAL Aura propojit s firemním systémem, spusťte na její výpočetní jednotce (tzv. compute puck) se systémem Android XR schválenou firemní aplikaci a nechte ji vyžadovat data z API daného systému. API je softwarové rozhraní, které jedné aplikaci umožňuje získávat informace z jiné. V tomto návodu vytvoříme malou aplikaci, která načte pracovní příkaz a zobrazí jeho pokyny na Aura.
Pracovní příkaz k údržbě se hodí jako první integrace, protože kombinuje číslo záznamu, údaje o zařízení a praktické pokyny. Aplikace tato pole načte přes autorizované připojení a zobrazí je v přehledném okně. Stejný přístup lze přizpůsobit i pro jiné firemní záznamy, pokud to jejich API a pravidla přístupu umožňují.
Jak funguje firemní integrace XREAL Aura
XREAL Aura se skládá z brýlí připojených kabelem a výpočetní jednotky – malého počítače, na kterém běží Android XR a vaše aplikace. Aplikace se k firemnímu systému připojuje přes Wi-Fi a schválenou síťovou cestu; brýle zobrazují vrácené informace. [1]
Pracovní příkaz popisuje úkol a pokyny k jeho provedení. Zaměstnanec zadá v aplikaci na Aura číslo příkazu a vybere Load work order. Aplikace si záznam vyžádá z firemního systému a poté zobrazí název zařízení, verzi postupu a podrobné pokyny. Tlačítky Next a Previous může zaměstnanec mezi pokyny přecházet, přičemž zdrojový záznam zůstává beze změny.
Pokud vaše firma už má aplikaci pro Android, která tyto záznamy zobrazuje, požádejte jejího vývojáře, aby ověřil, zda v Android XR funguje správně, a teprve pak vytvářejte novou. Google podporuje standardní rozhraní Androidu (například 2D mobilní aplikace nebo aplikace pro velké obrazovky) zobrazená v systémovém panelu XR jako 2D okno uvnitř prostředí XR. I stávající aplikaci je ale třeba otestovat z hlediska kompatibility a přístupu. [4]
Informace o hardwaru najdete na naší produktové stránce XREAL Aura. Ověřte si aktuální dostupnost a podporu ve vaší zemi, protože informace o uvedení na trh se mění. [2]
Krok 1 Získejte testovací pracovní příkaz a údaje pro připojení
Vaše aplikace pro Aura potřebuje záznam, který zobrazí, a oprávnění k jeho načtení z firemního systému. Pracovní příkaz je záznam o úkolu, který obsahuje číslo příkazu, údaje o zařízení a pokyny, například kroky pro kontrolu stroje.
· Než začnete psát kód, ujistěte se, že máte koncový bod HTTPS, testovací přístupový token a ukázkové číslo pracovního příkazu (např. WO-1001), které odpovídá schématu JSON v části Reference pro vývojáře.
· Požádejte IT oddělení o adresu API, která tento příkaz načítá, a o dočasný testovací přístupový token. Adresa API aplikaci říká, kde si má záznam vyžádat; token jí dává oprávnění data číst. Požádejte IT o potvrzení, že obojí funguje a zda je nutný přístup do firemní sítě.
· Předejte IT oddělení Referenci pro vývojáře na konci tohoto článku, aby mohli ověřit, že vracená data odpovídají ukázkové aplikaci. Pokud se liší, upravte kód v kroku 3 tak, aby četl názvy polí vašeho systému. Pokud vhodné API neexistuje, musí ho IT nejprve zajistit.
Tyto tři položky mějte připravené: adresa API se vkládá do kódu v kroku 3, token a číslo pracovního příkazu se zadávají do spuštěné aplikace v kroku 4. Společně aplikaci umožní načíst úkol a zobrazit jeho pokyny na Aura.
Krok 2 Otevřete Android Studio a připravte aplikaci
Krok 2.1 Vytvořte projekt na počítači
· V prohlížeči na počítači otevřete oficiální stránku pro stažení Android Studia. Nainstalujte Android Studio a dokončete jeho nastavení. Pokud potřebujete specializované nástroje Googlu pro XR, postupujte podle jeho průvodce nastavením Android Studia pro XR, který v současnosti doporučuje sestavení Canary, tedy ranou vývojovou verzi. [5]
· Otevřete Android Studio. Na úvodní obrazovce vyberte New Project. Pokud je otevřený jiný projekt, vyberte v horní nabídce Android Studia File > New > New Project.
· V okně projektu vyberte Phone and Tablet > Empty Activity. Vyberte Next.
· Do pole Name zadejte AuraWorkOrders a do pole Package name com.example.auraworkorders. Pokud se zobrazí volba jazyka, použijte Kotlin, ponechte nastavení SDK ze šablony a vyberte Finish.
· Počkejte, až Android Studio dokončí synchronizaci Gradle. Gradle je nástroj pro sestavení, který připravuje knihovny a nastavení projektu. Než budete pokračovat, vyřešte případné chyby v okně Build nebo Sync.
Krok 2.2 Povolte aplikaci přístup k síti
Manifest je soubor Androidu, který deklaruje, co aplikace potřebuje, včetně oprávnění k síti.
· V levém panelu Project v Android Studiu vyberte z rozbalovací nabídky zobrazení Android. Pokud je panel skrytý, vyberte View > Tool Windows > Project.
· V tomto panelu rozbalte app > manifests a otevřete AndroidManifest.xml.
· Do elementu manifest nad element application přidejte tento řádek. Zbytek vygenerovaného souboru ponechte beze změny.
<uses-permission android:name="android.permission.INTERNET" />· Ve stejném souboru najděte otevírací značku application. Přidejte do ní atribut android:usesCleartextTraffic="false". Android u aplikací cílících na Android 9 nebo novější nešifrovaný protokol HTTP blokuje už sám, tento řádek tedy jen výslovně vyjadřuje záměr.
Oprávnění INTERNET se uděluje při instalaci; při spuštění aplikace se tedy nezobrazí žádná výzva k povolení přístupu. [6] Ukázka používá vestavěné nástroje Androidu pro práci se sítí a JSON, takže nemusíte přidávat Retrofit ani jinou síťovou knihovnu.
Krok 3 Přidejte kód, který načte a zobrazí pracovní příkaz
Tento kód připojí aplikaci k adrese z kroku 1, přečte odpověď a zobrazuje vždy jeden pokyn. Síťový požadavek běží odděleně od rozhraní, aby obrazovka zůstala responzivní.
Krok 3.1 Otevřete v Android Studiu správný soubor
· V levém panelu Project v Android Studiu rozbalte app > kotlin+java > com.example.auraworkorders. V některých verzích se složka se zdrojovým kódem jmenuje java.
· Otevřete MainActivity.kt. Tento soubor řídí úvodní obrazovku aplikace.
· Nahraďte jeho obsah níže uvedeným kódem. Pokud se název vašeho balíčku liší, upravte první řádek tak, aby odpovídal balíčku vytvořenému v kroku 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.")
}
}
}
}Krok 3.2 Zadejte adresu API vaší firmy
· Zůstaňte v Android Studiu v souboru MainActivity.kt. Stiskněte Ctrl+F ve Windows nebo Linuxu, případně Command+F v macOS, a vyhledejte api.your-company.example.
· V řádku URL(...) nahraďte ukázkovou adresu URL vzorem koncového bodu vaší firmy z kroku 1. Na místě, kam patří číslo pracovního příkazu, ponechte $id. Pokud například server očekává /api/jobs/WO-1001, kód by měl volat https://YOUR-APPROVED-HOST/api/jobs/$id .· Token do tohoto souboru nevkládejte. Aplikace pro něj po spuštění nabízí dočasné testovací pole.
· Pokud se odpověď vašeho API liší od Reference pro vývojáře, upravte před spuštěním názvy polí a strukturu, které čte funkce fetchOrder. V této funkci JSONObject čte odpověď a getJSONArray("steps") otevírá její seznam pokynů.
· V Android Studiu vyberte Build > Make Project, pokud je tento příkaz ve vaší verzi k dispozici, nebo projekt zkompilujte tlačítkem Run na panelu nástrojů v kroku 4. Případné chyby kompilace opravte v okně Build.
Očekávaný výsledek: projekt se sestaví a adresa URL v souboru MainActivity.kt odkazuje na vaši skutečnou testovací službu. Ukázková adresa končící na .example se k žádnému firemnímu systému nepřipojí.
Krok 4 Otestujte připojení na počítači
Emulátor je virtuální zařízení s Androidem zobrazené na vašem počítači. Použijte ho nejprve k ověření adresy API, tokenu a vrácených pokynů, než začnete řešit problémy na fyzickém zařízení.
Krok 4.1 Spusťte aplikaci z Android Studia
· V horní nabídce Android Studia vyberte Tools > Device Manager.
· Pokud už vhodné virtuální zařízení s Androidem existuje, klikněte na jeho tlačítko spuštění. V opačném případě vyberte Create Device nebo tlačítko plus, zvolte profil telefonu, vyberte dostupný systémový obraz, na vyžádání ho stáhněte a dokončete průvodce. Nové zařízení spusťte.
· Zpět na horním panelu nástrojů Android Studia vyberte v rozbalovací nabídce zařízení toto spuštěné zařízení. Jako konfiguraci spuštění ponechte app a poté klikněte na zelené tlačítko Run.
· Počkejte, až se aplikace v emulátoru otevře. Měli byste vidět Work instructions, Work order ID, Sandbox access token a Load work order.
Krok 4.2 Vyžádejte si firemní záznam
· Ve spuštěné aplikaci v emulátoru vyberte Work order ID a zadejte testovací číslo příkazu z kroku 1.
· Ve stejné aplikaci vyberte Sandbox access token a vložte dočasný token od IT oddělení. Vložte pouze jeho hodnotu, bez slova Bearer.
· Vyberte Load work order. Pokud je požadavek úspěšný, aplikace zobrazí Read-only instructions loaded a za tím číslo příkazu, název zařízení, revizi postupu a první pokyn.
· Výběrem Next přejdete na další pokyn. Výběrem Previous se vrátíte zpět. Pokud pokyn přesahuje spodní okraj okna, posuňte obsah v aplikaci.
Očekávaný výsledek: zobrazený záznam odpovídá záznamu, který jste v kroku 1 otevřeli ve firemní aplikaci. Pokud se nenačte, projděte si před přechodem na Aura část o řešení problémů.
Krok 5 Spusťte stejnou propojenou aplikaci na XREAL Aura
Krok 5.1 Připravte Aura na vývoj
· Zapněte Aura pomocí její výpočetní jednotky. V aplikaci Settings na Aura se připojte k síti Wi-Fi, ze které je dostupné API z kroku 1. Požádejte IT o potvrzení případných požadavků na privátní síť.
· Podle aktuálních pokynů pro vývojáře od společnosti XREAL povolte ladění a připojte výpočetní jednotku k počítači. Začněte v sekci častých dotazů k Aura od XREAL (tutorials.xreal.com/docs/aura/troubleshooting/faq/), kde najdete položku s vývojářskými zdroji; pokud potřebujete aktuální pokyny, začněte právě tam.
· V aplikaci Settings na Aura otevřete Developer options a podle těchto pokynů povolte metodu ladění, kterou vaše zařízení podporuje. Pokud Aura zobrazí výzvu, autorizujte svůj vývojový počítač. Obecný postup v Androidu vysvětluje průvodce hardwarovými zařízeními od Googlu. [7]
Přesné názvy položek nabídek Aura a způsob zapojení kabelů závisí na hardwaru a firmwaru. Podle častých dotazů k XREAL Aura podporují oba porty USB-C na výpočetní jednotce standardní ladění ADB s Android Studiem, takže počítač připojte k nabíjecímu portu (Charging Port) vlevo a brýle ponechte v portu pro brýle (Glasses Port) vpravo. Tabulka specifikací však uvádí plnou podporu ADB pouze u portu Glasses Port, proto pokud levý port nebude rozpoznán, zkuste tento port, a při povolování vývojářského přístupu se řiďte aktuálními pokyny společnosti XREAL. [1]
Krok 5.2 Nainstalujte aplikaci z Android Studia
· Na počítači se vraťte k projektu AuraWorkOrders v Android Studiu.
· Otevřete rozbalovací nabídku zařízení na horním panelu nástrojů Android Studia. Místo emulátoru vyberte připojené vývojové zařízení Aura.
· Pokud zařízení v nabídce chybí, vyberte v Android Studiu Tools > Troubleshoot Device Connections a postupujte podle asistenta připojení. Autorizaci ladění a způsob připojení ověřte podle pokynů pro vývojáře od XREAL.
· Jakmile se zařízení zobrazí, ponechte jako konfiguraci spuštění app a klikněte na zelené tlačítko Run. Android Studio aplikaci sestaví, nainstaluje a spustí na vybraném zařízení.
Krok 5.3 Načtěte záznam v brýlích
· Nasaďte si Aura a najděte okno aplikace Work instructions, které spustilo Android Studio.
· V tomto okně zadejte stejné testovací číslo příkazu a dočasný token jako v kroku 4. Použijte metody zadávání, které vaše zařízení nabízí; s Aura fungují standardní bluetoothové klávesnice a myši (Settings > Connected Devices > Pair new device) a kompatibilní bluetoothová klávesnice může zadávání při testování usnadnit. [1]
· Vyberte Load work order a poté pokyny procházejte pomocí Next, Previous a posouvání.
· Porovnejte číslo příkazu, název zařízení a text pokynů s původním záznamem ve firemní aplikaci. Pokud se shodují, prokázali jste, že aplikace na Aura dokáže tento firemní záznam načíst a zobrazit.
Časté problémy a co zkontrolovat
· Aplikaci nelze sestavit: V Android Studiu otevřete View > Tool Windows > Build a přečtěte si první hlášenou chybu. Zkontrolujte název balíčku a to, zda projekt Empty Activity používá Compose a Material 3.
· Aplikace nedokáže načíst příkaz: V Android Studiu v souboru MainActivity.kt ověřte, že byl ukázkový název hostitele nahrazen. Požádejte IT, aby zkontrolovalo, zda je koncový bod dostupný ze sítě emulátoru nebo Aura.
· API vrací 401: API nepřijalo přihlašovací údaj. Požádejte IT o kontrolu platnosti tokenu a služby, pro kterou je určen, nebo si opatřete nový testovací token.
· API vrací 403: Účet nemá potřebné oprávnění. Požádejte správce firemního systému o udělení správného přístupu.
· API vrací 404: Zkontrolujte číslo příkazu a to, zda koncový bod odkazuje na správné testovací prostředí.
· API vrací data, ale aplikace selže: Požádejte vývojáře API, aby odpověď porovnal s Referencí pro vývojáře. Ukázka vyžaduje neprázdný seznam steps a id odpovídající požadovanému příkazu.
· Funguje v emulátoru, ale ne na Aura: Ověřte síťovou cestu Aura a přístup k API a poté zkontrolujte aplikaci na zařízení. Nevypínejte kontrolu certifikátů HTTPS, abyste obešli chybu připojení.
Ukázka uživateli zobrazuje obecnou chybovou zprávu. Přesný stavový kód API zjistíte tak, že požádáte správce o kontrolu serverových logů, aniž by přitom byly odhaleny tokeny nebo celé pracovní příkazy. U chyb aplikace použijte v Android Studiu View > Tool Windows > Logcat; Logcat zobrazuje logy aplikace.
Reference pro vývojáře k ukázkovému API
Tuto část využijte při kontrole odpovědi v kroku 1 nebo při úpravě funkce fetchOrder v kroku 3. Popisuje rozhraní této ukázkové aplikace, nikoli koncový bod poskytovaný společností XREAL.
Požadavek: GET https://api.your-company.example/work-orders/WO-1001
Hlavičky požadavku: Authorization: Bearer <krátkodobý přístupový token> a Accept: application/json
Očekávaná úspěšná odpověď: HTTP 200 s touto strukturou JSON
{
"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."
}
]
}Pole id identifikuje pracovní příkaz, asset jeho zařízení a revision verzi postupu. Každá položka v poli steps obsahuje number, title, úplný pokyn a expectedResult. Ukázka řadí kroky podle čísla.
Pro skutečnou práci používejte schválené pokyny; ukázka popisuje neaktivní školicí stanoviště. Před nasazením do produkce ověřujte velikost odpovědi a délku polí, odmítejte neplatná data postupů a definujte chování při vypršení platnosti tokenu. API musí u každého požadovaného příkazu kontrolovat oprávnění. Ukázkový kód je pouze ilustrativní a nebyl zkompilován ani otestován se skutečným systémem či na fyzickém zařízení Aura.
Závěr
Propojení XREAL Aura s firemním systémem začíná schválenou adresou API a přístupovým oprávněním, po nichž následuje aplikace z Android Studia, která potřebný záznam načte. Otestování připojení na počítači před nasazením na Aura pomáhá oddělit problémy s přístupem k datům od problémů s nastavením zařízení. Příklad s pracovním příkazem přenáší údaje o zařízení a podrobné pokyny krok za krokem na přehledný displej brýlí, a dává tak firmám praktický výchozí bod pro zpřístupnění provozních informací přímo na pracovišti. Firemní přihlašování, odpovídající oprávnění a testování na zařízení pak toto propojení připraví na pilotní provoz se zaměstnanci.
Dostupnost hardwaru a požadavky na váš pilotní provoz proberte se společností VR Expert.

























