Streszczenie
Aby połączyć XREAL Aura z systemem firmowym, uruchom autoryzowaną aplikację firmową na module obliczeniowym (compute puck) z Android XR i pozwól tej aplikacji pobierać dane przez API systemu. API to połączenie programowe, które pozwala jednej aplikacji pobierać informacje z innej. W tym przewodniku zbudujemy niewielką aplikację, która pobiera zlecenie pracy i wyświetla jego instrukcje na Aura.
Zlecenie konserwacji to dobry punkt wyjścia do pierwszej integracji, ponieważ łączy numer rekordu, dane urządzenia i praktyczne instrukcje. Aplikacja pobiera te pola przez autoryzowane połączenie i prezentuje je w czytelnym oknie. To samo podejście można dostosować do innych rekordów biznesowych, jeśli pozwalają na to ich API i zasady dostępu.
Jak działa integracja XREAL Aura z systemami firmowymi
XREAL Aura składa się z okularów podłączanych przewodem oraz modułu obliczeniowego – małego komputera, na którym działa Android XR i Twoja aplikacja. Aplikacja łączy się z systemem firmowym przez Wi-Fi i zatwierdzoną trasę sieciową, a okulary wyświetlają zwrócone informacje. [1]
Zlecenie pracy opisuje zadanie i instrukcje jego wykonania. Pracownik wpisuje numer zlecenia w aplikacji na Aura i wybiera Load work order. Aplikacja żąda tego rekordu od systemu firmowego, a następnie wyświetla nazwę urządzenia, wersję procedury i szczegółowe instrukcje. Przyciski Next i Previous pozwalają pracownikowi przechodzić między instrukcjami, a rekord źródłowy pozostaje niezmieniony.
Jeśli Twoja firma ma już aplikację na Androida, która wyświetla te rekordy, przed budową kolejnej poproś jej dewelopera o sprawdzenie, czy działa ona poprawnie na Android XR. Google obsługuje standardowe interfejsy Androida (np. aplikacje 2D na telefony lub duże ekrany) wyświetlane w panelu systemowym XR jako okno 2D w środowisku XR. Istniejącą aplikację i tak trzeba przetestować pod kątem zgodności i dostępu. [4]
Informacje o sprzęcie znajdziesz na naszej stronie produktu XREAL Aura. Sprawdź aktualną dostępność i wsparcie w swoim kraju, ponieważ informacje o premierze się zmieniają. [2]
Krok 1. Przygotuj testowe zlecenie pracy i dane połączenia
Aplikacja na Aura potrzebuje rekordu do wyświetlenia oraz uprawnienia do pobrania go z systemu firmowego. Zlecenie pracy to rekord zadania zawierający numer zlecenia, dane urządzenia i instrukcje, np. kroki inspekcji maszyny.
· Zanim zaczniesz pisać kod, upewnij się, że masz endpoint HTTPS, testowy token dostępu i przykładowy numer zlecenia pracy (np. WO-1001) zgodny ze schematem JSON opisanym w sekcji „Informacje dla deweloperów”.
· Poproś dział IT o adres API, który pobiera to zlecenie, oraz o tymczasowy testowy token dostępu. Adres API wskazuje aplikacji, gdzie ma żądać rekordu, a token daje jej uprawnienie do odczytu danych. Poproś IT o potwierdzenie, że oba działają, i o informację, czy wymagany jest dostęp do sieci firmowej.
· Przekaż działowi IT sekcję „Informacje dla deweloperów” z końca tego artykułu, aby mógł sprawdzić, czy zwracane dane odpowiadają przykładowej aplikacji. Jeśli się różnią, zaktualizuj kod w kroku 3 tak, aby odczytywał nazwy pól Twojego systemu. Jeśli odpowiednie API nie istnieje, IT musi je najpierw udostępnić.
Miej pod ręką te trzy elementy: adres API trafia do kodu w kroku 3, a token i numer zlecenia pracy – do uruchomionej aplikacji w kroku 4. Razem pozwalają aplikacji pobrać zadanie i wyświetlić jego instrukcje na Aura.
Krok 2. Otwórz Android Studio i przygotuj aplikację
Krok 2.1. Utwórz projekt na komputerze
· W przeglądarce na komputerze otwórz oficjalną stronę pobierania Android Studio. Zainstaluj Android Studio i dokończ konfigurację. Jeśli potrzebujesz dedykowanych narzędzi XR, postępuj zgodnie z przygotowanym przez Google przewodnikiem konfiguracji Android Studio dla XR, który obecnie zaleca kompilację Canary, czyli wczesną wersję rozwojową. [5]
· Otwórz Android Studio. Na ekranie powitalnym wybierz New Project. Jeśli otwarty jest inny projekt, wybierz File > New > New Project z górnego menu Android Studio.
· W oknie projektu wybierz Phone and Tablet > Empty Activity. Wybierz Next.
· W polu Name wpisz AuraWorkOrders, a w polu Package name – com.example.auraworkorders. Tam, gdzie pojawia się wybór języka, użyj Kotlina, zachowaj ustawienia SDK z szablonu i wybierz Finish.
· Poczekaj, aż Android Studio zakończy synchronizację Gradle. Gradle to narzędzie do budowania, które przygotowuje biblioteki i ustawienia projektu. Przed kontynuowaniem rozwiąż wszelkie błędy w oknie Build lub Sync.
Krok 2.2. Zezwól aplikacji na dostęp do sieci
Manifest to plik Androida, w którym deklaruje się, czego potrzebuje aplikacja, w tym uprawnienie do korzystania z sieci.
· W lewym panelu Project w Android Studio wybierz z listy rozwijanej widok Android. Jeśli panel jest ukryty, wybierz View > Tool Windows > Project.
· W tym panelu rozwiń app > manifests i otwórz AndroidManifest.xml.
· Wewnątrz elementu manifest, nad elementem application, dodaj poniższy wiersz. Resztę wygenerowanego pliku pozostaw bez zmian.
<uses-permission android:name="android.permission.INTERNET" />· W tym samym pliku znajdź otwierający znacznik application. Dodaj wewnątrz tego znacznika atrybut android:usesCleartextTraffic="false". Android już blokuje nieszyfrowany ruch HTTP w aplikacjach, których docelową wersją jest Android 9 lub nowszy, więc ten wiersz jedynie jawnie wyraża ten zamiar.
Uprawnienie INTERNET jest przyznawane podczas instalacji i nie wywołuje okna z prośbą o dostęp w trakcie działania aplikacji. [6] Przykład korzysta z wbudowanych narzędzi Androida do obsługi sieci i JSON, więc nie musisz dodawać Retrofit ani innej biblioteki sieciowej.
Krok 3. Dodaj kod, który pobiera i wyświetla zlecenie pracy
Ten kod łączy aplikację z adresem z kroku 1, odczytuje odpowiedź i wyświetla instrukcje pojedynczo. Żądanie sieciowe działa niezależnie od interfejsu, dzięki czemu ekran pozostaje responsywny.
Krok 3.1. Otwórz właściwy plik w Android Studio
· W lewym panelu Project w Android Studio rozwiń app > kotlin+java > com.example.auraworkorders. W niektórych wersjach folder źródłowy nosi nazwę java.
· Otwórz MainActivity.kt. Ten plik steruje ekranem startowym aplikacji.
· Zastąp jego zawartość poniższym kodem. Jeśli nazwa pakietu jest inna, zmień pierwszy wiersz tak, aby odpowiadał pakietowi utworzonemu w 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. Wpisz adres API swojej firmy
· Pozostań w pliku MainActivity.kt w Android Studio. Naciśnij Ctrl+F w systemie Windows lub Linux albo Command+F w systemie macOS i wyszukaj api.your-company.example.
· Zastąp przykładowy URL w wierszu URL(...) wzorcem endpointu swojej firmy z kroku 1. Pozostaw $id w miejscu numeru zlecenia pracy. Jeśli na przykład serwer oczekuje /api/jobs/WO-1001, kod powinien wysyłać żądanie do https://YOUR-APPROVED-HOST/api/jobs/$id .· Nie umieszczaj tokenu w tym pliku. Po uruchomieniu aplikacja udostępnia na niego tymczasowe pole testowe.
· Jeśli odpowiedź Twojego API różni się od opisanej w sekcji „Informacje dla deweloperów”, przed uruchomieniem zaktualizuj nazwy pól i strukturę odczytywane przez fetchOrder. W tej funkcji JSONObject odczytuje odpowiedź, a getJSONArray("steps") otwiera listę instrukcji.
· W Android Studio wybierz Build > Make Project, jeśli to polecenie jest dostępne w Twojej wersji, albo skompiluj projekt przyciskiem Run na pasku narzędzi w kroku 4. Popraw ewentualne błędy kompilacji w oknie Build.
Oczekiwany rezultat: projekt się buduje, a URL w MainActivity.kt wskazuje na Twoją rzeczywistą usługę testową. Przykładowy adres z końcówką .example nie połączy się z żadnym systemem firmowym.
Krok 4. Przetestuj połączenie na komputerze
Emulator to wirtualne urządzenie z Androidem wyświetlane na komputerze. Użyj go najpierw, aby sprawdzić adres API, token i zwracane instrukcje, zanim zaczniesz rozwiązywać problemy na fizycznym urządzeniu.
Krok 4.1. Uruchom aplikację z Android Studio
· W górnym menu Android Studio wybierz Tools > Device Manager.
· Jeśli odpowiednie wirtualne urządzenie z Androidem już istnieje, kliknij jego przycisk uruchamiania. W przeciwnym razie wybierz Create Device lub przycisk plusa, wybierz profil telefonu, wskaż dostępny obraz systemu, pobierz go, jeśli pojawi się taka prośba, i dokończ kreator. Uruchom nowe urządzenie.
· Wróć do górnego paska narzędzi Android Studio i wybierz to uruchomione urządzenie z listy urządzeń. Pozostaw app jako konfigurację uruchomieniową, a następnie kliknij zielony przycisk Run.
· Poczekaj, aż aplikacja otworzy się w emulatorze. Powinny być widoczne elementy Work instructions, Work order ID, Sandbox access token i Load work order.
Krok 4.2. Pobierz rekord biznesowy
· W aplikacji uruchomionej w emulatorze wybierz pole Work order ID i wpisz testowy numer zlecenia z kroku 1.
· W tej samej aplikacji wybierz pole Sandbox access token i wklej tymczasowy token otrzymany od IT. Wklej tylko jego wartość, bez słowa Bearer.
· Wybierz Load work order. Gdy żądanie się powiedzie, aplikacja wyświetli komunikat Read-only instructions loaded, a pod nim numer zlecenia, nazwę urządzenia, wersję procedury i pierwszą instrukcję.
· Wybierz Next, aby przeczytać następną instrukcję. Wybierz Previous, aby wrócić. Jeśli instrukcja wykracza poza dolną krawędź okna, przewiń zawartość aplikacji.
Oczekiwany rezultat: wyświetlony rekord odpowiada rekordowi otwartemu w aplikacji biznesowej w kroku 1. Jeśli się nie ładuje, przed przejściem do Aura skorzystaj z sekcji rozwiązywania problemów.
Krok 5. Uruchom tę samą połączoną aplikację na XREAL Aura
Krok 5.1. Przygotuj Aura do programowania
· Włącz Aura za pomocą modułu obliczeniowego. W aplikacji Settings na Aura połącz się z siecią Wi-Fi, z której można dotrzeć do API z kroku 1. Poproś IT o potwierdzenie ewentualnych wymagań dotyczących sieci prywatnej.
· Postępuj zgodnie z aktualną procedurą wdrożenia deweloperskiego udostępnioną przez XREAL, aby włączyć debugowanie i podłączyć moduł obliczeniowy do komputera. Zacznij od FAQ XREAL dotyczącego Aura (tutorials.xreal.com/docs/aura/troubleshooting/faq/) – znajduje się tam pozycja z zasobami dla deweloperów; zacznij od niej, jeśli potrzebujesz aktualnych instrukcji.
· W aplikacji Settings na Aura otwórz Developer options i włącz metodę debugowania obsługiwaną przez Twoje urządzenie, zgodnie z tą procedurą. Jeśli Aura wyświetli monit, autoryzuj swój komputer deweloperski. Ogólny proces w Androidzie wyjaśnia przewodnik Google dotyczący urządzeń fizycznych. [7]
Dokładne nazwy menu Aura i sposób podłączenia przewodów zależą od sprzętu i oprogramowania układowego. Według FAQ XREAL Aura oba porty USB-C w module obliczeniowym obsługują standardowe debugowanie ADB z Android Studio, więc podłącz komputer do portu Charging Port po lewej stronie, a okulary pozostaw podłączone do portu Glasses Port po prawej. Tabela specyfikacji podaje pełną obsługę ADB tylko dla portu Glasses Port, więc jeśli lewy port nie zostanie rozpoznany, spróbuj tego portu, a do włączenia dostępu deweloperskiego korzystaj z aktualnych instrukcji XREAL. [1]
Krok 5.2. Zainstaluj aplikację z Android Studio
· Na komputerze wróć do projektu AuraWorkOrders w Android Studio.
· Otwórz listę urządzeń na górnym pasku narzędzi Android Studio. Wybierz podłączone urządzenie deweloperskie Aura zamiast emulatora.
· Jeśli urządzenia nie ma na liście, wybierz w Android Studio Tools > Troubleshoot Device Connections i postępuj zgodnie z asystentem połączenia. Sprawdź autoryzację debugowania i metodę połączenia w procedurze wdrożenia XREAL.
· Gdy urządzenie się pojawi, pozostaw app jako konfigurację uruchomieniową i kliknij zielony przycisk Run. Android Studio zbuduje, zainstaluje i uruchomi aplikację na wybranym urządzeniu.
Krok 5.3. Pobierz rekord w okularach
· Załóż Aura i znajdź okno aplikacji Work instructions uruchomionej przez Android Studio.
· W tym oknie wpisz ten sam testowy numer zlecenia i tymczasowy token co w kroku 4. Użyj metod wprowadzania dostępnych na urządzeniu; standardowe klawiatury i myszy Bluetooth współpracują z Aura (Settings > Connected Devices > Pair new device), a zgodna klawiatura Bluetooth może ułatwić wprowadzanie danych testowych. [1]
· Wybierz Load work order, a następnie użyj przycisków Next i Previous oraz przewijania, aby przeczytać instrukcje.
· Porównaj numer zlecenia, nazwę urządzenia i treść instrukcji z oryginalnym rekordem w aplikacji biznesowej. Jeśli są zgodne, udało się wykazać, że aplikacja na Aura potrafi pobrać i wyświetlić ten rekord biznesowy.
Typowe problemy i co sprawdzić
· Aplikacja się nie buduje: w Android Studio otwórz View > Tool Windows > Build i przeczytaj pierwszy zgłoszony błąd. Sprawdź nazwę pakietu oraz to, czy projekt Empty Activity korzysta z Compose i Material 3.
· Aplikacja nie może załadować zlecenia: w pliku MainActivity.kt w Android Studio sprawdź, czy przykładowa nazwa hosta została zastąpiona. Poproś IT o sprawdzenie, czy endpoint jest osiągalny z sieci emulatora lub Aura.
· API zwraca 401: API nie zaakceptowało poświadczenia. Poproś IT o sprawdzenie ważności tokenu i usługi, dla której jest przeznaczony, albo uzyskaj nowy token testowy.
· API zwraca 403: konto nie ma uprawnień. Poproś administratora systemu firmowego o nadanie właściwego dostępu.
· API zwraca 404: sprawdź numer zlecenia oraz to, czy endpoint wskazuje właściwe środowisko testowe.
· API zwraca dane, ale aplikacja nie działa: poproś dewelopera API o porównanie odpowiedzi z sekcją „Informacje dla deweloperów”. Przykład wymaga niepustej listy steps oraz pola id zgodnego z żądanym zleceniem.
· Działa w emulatorze, ale nie na Aura: sprawdź trasę sieciową Aura i dostęp do API, a następnie sprawdź aplikację na urządzeniu. Nie wyłączaj weryfikacji certyfikatów HTTPS, aby obejść błąd połączenia.
Przykład wyświetla użytkownikowi ogólny komunikat o błędzie. Aby poznać dokładny status API, poproś administratora o przejrzenie logów serwera bez ujawniania tokenów ani pełnych zleceń pracy. W przypadku błędów aplikacji użyj View > Tool Windows > Logcat w Android Studio; Logcat wyświetla logi aplikacji.
Informacje dla deweloperów dotyczące przykładowego API
Korzystaj z tej sekcji, sprawdzając odpowiedź w kroku 1 lub dostosowując fetchOrder w kroku 3. Opisuje ona kontrakt dla tej przykładowej aplikacji, a nie endpoint udostępniany przez XREAL.
Żądanie: GET https://api.your-company.example/work-orders/WO-1001
Nagłówki żądania: Authorization: Bearer <krótkotrwały token dostępu> oraz Accept: application/json
Oczekiwana odpowiedź w razie powodzenia: HTTP 200 z następującą strukturą 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 identyfikuje zlecenie pracy, asset – jego urządzenie, a revision – wersję procedury. Każdy wpis w steps zawiera numer (number), tytuł (title), pełną instrukcję (instruction) oraz expectedResult. Przykład sortuje kroki według numeru.
Do rzeczywistej pracy używaj zatwierdzonych instrukcji; przykład opisuje nieaktywne stanowisko szkoleniowe. Przed wdrożeniem produkcyjnym weryfikuj rozmiar odpowiedzi i długości pól, odrzucaj nieprawidłowe dane procedur i określ zachowanie po wygaśnięciu tokenu. API musi sprawdzać uprawnienia dla każdego żądanego zlecenia. Przykładowy kod ma charakter poglądowy i nie został skompilowany ani przetestowany z działającym systemem ani na fizycznym urządzeniu Aura.
Podsumowanie
Połączenie XREAL Aura z systemem firmowym zaczyna się od zatwierdzonego adresu API i uprawnień dostępu, po czym potrzebna jest aplikacja w Android Studio, która pobiera wymagany rekord. Przetestowanie połączenia na komputerze przed wdrożeniem na Aura pomaga oddzielić problemy z dostępem do danych od kwestii konfiguracji urządzenia. Przykład zlecenia pracy przenosi dane urządzenia i instrukcje krok po kroku na czytelny wyświetlacz okularów, dając firmom praktyczny punkt wyjścia do udostępniania informacji operacyjnych bezpośrednio w miejscu pracy. Logowanie firmowe, odpowiednie uprawnienia i testy na urządzeniu przygotowują to połączenie do pilotażu z udziałem pracowników.
Dostępność sprzętu i wymagania pilotażu omów z VR Expert.

























