Резюме
За да свържете XREAL Aura с бизнес система, стартирайте оторизирано фирмено приложение на нейния изчислителен модул (compute puck) с Android XR и оставете това приложение да изисква данни от API на системата. API е софтуерна връзка, която позволява на едно приложение да извлича информация от друго. В това ръководство се създава малко приложение, което извлича работна поръчка и показва инструкциите ѝ на Aura.
Работната поръчка за поддръжка е подходяща първа интеграция, защото съчетава номер на запис, данни за оборудването и практически инструкции. Приложението извлича тези полета чрез оторизирана връзка и ги представя в четим прозорец. Същият подход може да се адаптира и за други бизнес записи, когато техните API и правила за достъп позволяват това.
Как работи бизнес интеграцията на XREAL Aura
XREAL Aura използва очила, свързани с кабел, и изчислителен модул – малкия компютър, на който работят Android XR и вашето приложение. Приложението се свързва с фирмената система чрез Wi-Fi и одобрен мрежов маршрут, а очилата показват върнатата информация. [1]
Работната поръчка описва дадена задача и инструкциите за изпълнението ѝ. Служителят въвежда номера на поръчката в приложението на Aura и избира Load work order. Приложението изисква този запис от бизнес системата, след което показва името на оборудването, версията на процедурата и подробните инструкции. С бутоните Next и Previous служителят преминава през инструкциите, а изходният запис остава непроменен.
Ако компанията ви вече има приложение за Android, което показва тези записи, помолете разработчика му да провери дали то работи правилно на Android XR, преди да създавате ново. Google поддържа стандартни интерфейси на Android (например 2D мобилно приложение или приложение за Android за големи екрани), показвани в системен панел на XR като 2D прозорец в XR средата. Съществуващото приложение все пак трябва да бъде тествано за съвместимост и достъп. [4]
За информация за хардуера вижте нашата продуктова страница за XREAL Aura. Проверете актуалната наличност и поддръжка за вашата държава, тъй като информацията за пускането на пазара се променя. [2]
Стъпка 1. Осигурете тестова работна поръчка и данните за връзка
Приложението на Aura се нуждае от запис, който да покаже, и от разрешение да го извлече от фирмената система. Работната поръчка е запис за задача, съдържащ номер на поръчката, данни за оборудването и инструкции, например стъпките за проверка на машина.
· Преди да пишете кода, уверете се, че разполагате с HTTPS крайна точка, тестов токен за достъп и примерен номер на работна поръчка (напр. WO-1001), съответстващ на JSON схемата в справочника за разработчици.
· Поискайте от ИТ екипа адреса на API, който извлича тази поръчка, и временен тестов токен за достъп. Адресът на API казва на приложението откъде да изиска записа, а токенът му дава разрешение да чете данните. Помолете ИТ отдела да потвърди, че и двете работят и дали е необходим достъп до фирмената мрежа.
· Предоставете на ИТ отдела справочника за разработчици в края на тази статия, за да проверят дали върнатите данни съответстват на примерното приложение. Ако има разлики, актуализирайте кода в стъпка 3, така че да чете имената на полетата на вашата система. Ако не съществува подходящ API, ИТ отделът трябва първо да осигури такъв.
Подгответе тези три неща: адресът на API влиза в кода в стъпка 3, а токенът и номерът на работната поръчка – в работещото приложение в стъпка 4. Заедно те позволяват на приложението да извлече задачата и да покаже инструкциите ѝ на Aura.
Стъпка 2. Отворете Android Studio и подгответе приложението
Стъпка 2.1. Създайте проекта на компютъра си
· В браузъра на компютъра си отворете официалната страница за изтегляне на Android Studio. Инсталирайте Android Studio и завършете настройката. Ако имате нужда от специализираните XR инструменти на Google, следвайте ръководството му за настройка на Android Studio за XR, което в момента препоръчва версия Canary – ранна версия в процес на разработка. [5]
· Отворете Android Studio. На началния екран изберете New Project. Ако е отворен друг проект, изберете File > New > New Project от горното меню на Android Studio.
· В прозореца на проекта изберете Phone and Tablet > Empty Activity. Изберете Next.
· Задайте Name на AuraWorkOrders и Package name на com.example.auraworkorders. Където се появи опция за език, използвайте Kotlin, запазете настройките на SDK от шаблона и изберете Finish.
· Изчакайте Android Studio да завърши синхронизацията с Gradle. Gradle е инструментът за компилиране, който подготвя библиотеките и настройките на проекта. Отстранете всички грешки в прозореца Build или Sync, преди да продължите.
Стъпка 2.2. Разрешете на приложението достъп до мрежата
Манифестът е файлът на Android, в който се декларира от какво се нуждае приложението, включително разрешение за мрежов достъп.
· В левия панел Project на Android Studio изберете изгледа Android от падащото меню. Ако панелът е скрит, изберете View > Tool Windows > Project.
· В този панел разгънете app > manifests и отворете AndroidManifest.xml.
· Вътре в елемента manifest, над елемента application, добавете този ред. Запазете останалата част от генерирания файл.
<uses-permission android:name="android.permission.INTERNET" />· В същия файл намерете отварящия таг application. Добавете android:usesCleartextTraffic="false" като атрибут в този таг. Android вече блокира некриптирания HTTP за приложения, насочени към Android 9 или по-нова версия, така че този ред прави намерението изрично.
Разрешението INTERNET се предоставя при инсталирането; то не предизвиква изскачащ прозорец за достъп, докато приложението работи. [6] Примерът използва вградените в Android инструменти за мрежа и JSON, така че не е нужно да добавяте Retrofit или друга библиотека за мрежова комуникация.
Стъпка 3. Добавете кода, който извлича и показва работната поръчка
Този код свързва приложението с адреса от стъпка 1, чете отговора и показва инструкциите една по една. Мрежовата заявка се изпълнява отделно от интерфейса, така че екранът да остава отзивчив.
Стъпка 3.1. Отворете правилния файл в Android Studio
· В левия панел Project на Android Studio разгънете app > kotlin+java > com.example.auraworkorders. В някои версии папката с изходния код е обозначена като java.
· Отворете MainActivity.kt. Този файл управлява началния екран на приложението.
· Заменете съдържанието му с кода по-долу. Ако името на пакета ви е различно, променете първия ред така, че да съответства на пакета, който създадохте в стъпка 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.")
}
}
}
}Стъпка 3.2. Въведете адреса на API на вашата компания
· Останете в MainActivity.kt в Android Studio. Натиснете Ctrl+F в Windows или Linux или Command+F в macOS и потърсете api.your-company.example.
· Заменете примерния URL адрес в реда URL(...) с шаблона на крайната точка на вашата компания от стъпка 1. Запазете $id на мястото на номера на работната поръчка. Например, ако сървърът очаква /api/jobs/WO-1001, кодът трябва да изисква https://YOUR-APPROVED-HOST/api/jobs/$id .· Не поставяйте токена в този файл. Приложението предоставя временно тестово поле за него, когато го стартирате.
· Ако отговорът на вашия API се различава от справочника за разработчици, актуализирайте имената на полетата и структурата, които чете fetchOrder, преди да стартирате. В тази функция JSONObject чете отговора, а getJSONArray("steps") отваря списъка с инструкции.
· В Android Studio изберете Build > Make Project, ако тази команда е налична във вашата версия, или използвайте бутона Run в лентата с инструменти в стъпка 4, за да компилирате проекта. Отстранете всички грешки при компилирането в прозореца Build.
Очакван резултат: проектът се компилира, а URL адресът в MainActivity.kt сочи към реалната ви тестова услуга. Примерният адрес, завършващ на .example, няма да се свърже с бизнес система.
Стъпка 4. Тествайте връзката на компютъра си
Емулаторът е виртуално устройство с Android, показвано на компютъра ви. Използвайте го първо, за да проверите адреса на API, токена и върнатите инструкции, преди да отстранявате проблеми на физическо устройство.
Стъпка 4.1. Стартирайте приложението от Android Studio
· В горното меню на Android Studio изберете Tools > Device Manager.
· Ако вече съществува подходящо виртуално устройство с Android, изберете бутона му за стартиране. В противен случай изберете Create Device или бутона плюс, изберете профил на телефон, изберете наличен системен образ, изтеглете го, ако бъдете подканени, и завършете съветника. Стартирайте новото устройство.
· Обратно в горната лента с инструменти на Android Studio изберете това работещо устройство от падащото меню с устройства. Оставете app избрано като конфигурация за стартиране, след което изберете зеления бутон Run.
· Изчакайте приложението да се отвори в емулатора. Трябва да видите Work instructions, Work order ID, Sandbox access token и Load work order.
Стъпка 4.2. Изискайте бизнес записа
· В работещото приложение в емулатора изберете Work order ID и въведете тестовия номер на поръчка от стъпка 1.
· В същото приложение изберете Sandbox access token и поставете временния токен, предоставен от ИТ отдела. Поставете само стойността му, без думата Bearer.
· Изберете Load work order. Когато заявката е успешна, приложението показва Read-only instructions loaded, следвано от номера на поръчката, името на оборудването, версията на процедурата и първата инструкция.
· Изберете Next, за да прочетете следващата инструкция. Изберете Previous, за да се върнете назад. Превъртете в приложението, ако дадена инструкция излиза извън долния край на прозореца.
Очакван резултат: показаният запис съвпада със записа, който отворихте в бизнес приложението в стъпка 1. Ако не се зареди, използвайте раздела за отстраняване на проблеми, преди да преминете към Aura.
Стъпка 5. Стартирайте същото свързано приложение на XREAL Aura
Стъпка 5.1. Подгответе Aura за разработка
· Включете Aura чрез изчислителния модул. В приложението Settings на Aura се свържете с Wi-Fi мрежа, от която има достъп до API от стъпка 1. Помолете ИТ отдела да потвърди евентуални изисквания за частна мрежа.
· Следвайте актуалните инструкции за начална настройка за разработка, предоставени от XREAL, за да активирате отстраняването на грешки и да свържете изчислителния модул с компютъра си. Започнете от често задаваните въпроси за Aura на XREAL (tutorials.xreal.com/docs/aura/troubleshooting/faq/) – там има раздел с ресурси за разработчици; започнете оттам, ако се нуждаете от актуалните инструкции.
· В приложението Settings на Aura отворете Developer options и активирайте метода за отстраняване на грешки, поддържан от устройството ви, като следвате тези инструкции. Оторизирайте компютъра си за разработка, ако Aura покаже подкана. В ръководството на Google за хардуерни устройства е обяснен общият процес в Android. [7]
Точните етикети на менютата в Aura и начинът на свързване на кабелите зависят от хардуера и фърмуера. Според често задаваните въпроси за XREAL Aura и двата USB-C порта на изчислителния модул поддържат стандартно отстраняване на грешки чрез ADB с Android Studio, така че свържете компютъра към порта за зареждане (Charging Port) отляво и оставете очилата на порта за очилата (Glasses Port) отдясно. В таблицата със спецификации пълната поддръжка на ADB е посочена само за Glasses Port, затова опитайте този порт, ако левият не бъде разпознат, и използвайте актуалните инструкции на XREAL за активиране на достъпа за разработчици. [1]
Стъпка 5.2. Инсталирайте приложението от Android Studio
· На компютъра си се върнете към проекта AuraWorkOrders в Android Studio.
· Отворете падащото меню с устройства в горната лента с инструменти на Android Studio. Изберете свързаното си устройство Aura за разработка вместо емулатора.
· Ако устройството липсва, изберете Tools > Troubleshoot Device Connections в Android Studio и следвайте помощника за свързване. Проверете оторизацията за отстраняване на грешки и метода на свързване според инструкциите за начална настройка на XREAL.
· След като устройството се появи, оставете app избрано като конфигурация за стартиране и изберете зеления бутон Run. Android Studio компилира, инсталира и стартира приложението на избраното устройство.
Стъпка 5.3. Извлечете записа в очилата
· Сложете Aura и намерете прозореца на приложението Work instructions, което Android Studio стартира.
· В този прозорец въведете същия тестов номер на поръчка и временния токен, използвани в стъпка 4. Използвайте наличните на устройството ви методи за въвеждане; стандартни Bluetooth клавиатури и мишки работят с Aura (Settings > Connected Devices > Pair new device), а съвместима Bluetooth клавиатура може да улесни въвеждането при тестване. [1]
· Изберете Load work order, след което използвайте Next, Previous и превъртане, за да прочетете инструкциите.
· Сравнете номера на поръчката, името на оборудването и текста на инструкциите с оригиналния запис в бизнес приложението си. Ако съвпадат, сте демонстрирали, че приложението на Aura може да извлича и показва този бизнес запис.
Чести проблеми и какво да проверите
· Приложението не се компилира: в Android Studio отворете View > Tool Windows > Build и прочетете първата отчетена грешка. Проверете името на пакета и дали проектът Empty Activity използва Compose и Material 3.
· Приложението не може да зареди поръчката: в MainActivity.kt в Android Studio проверете дали примерното име на хост е заменено. Помолете ИТ отдела да провери дали крайната точка е достъпна от емулатора или от мрежата на Aura.
· API връща 401: API не е приел идентификационните данни. Помолете ИТ отдела да провери валидността на токена и услугата, за която е предназначен, или получете нов тестов токен.
· API връща 403: акаунтът няма разрешение. Помолете администратора на бизнес системата да предостави правилния достъп.
· API връща 404: проверете номера на поръчката и дали крайната точка сочи към правилната тестова среда.
· API връща данни, но приложението дава грешка: помолете разработчика на API да сравни отговора със справочника за разработчици. Примерът изисква непразен списък steps и id, съвпадащ със заявената поръчка.
· Работи в емулатора, но не и на Aura: проверете мрежовия маршрут на Aura и достъпа до API, след което проверете приложението на устройството. Не изключвайте проверките на HTTPS сертификатите, за да заобиколите грешка при свързване.
Примерът показва на потребителя общо съобщение за грешка. За точния статус от API помолете администратора да прегледа сървърните журнали, без да разкрива токени или пълни работни поръчки. За грешки в приложението използвайте View > Tool Windows > Logcat в Android Studio; Logcat показва журналите на приложението.
Справочник за разработчици за примерния API
Използвайте този раздел, когато проверявате отговора в стъпка 1 или адаптирате fetchOrder в стъпка 3. Той описва договора за това примерно приложение, а не крайна точка, предоставена от XREAL.
Заявка: GET https://api.your-company.example/work-orders/WO-1001
Заглавки на заявката: Authorization: Bearer <краткотраен токен за достъп> и Accept: application/json
Очакван успешен отговор: HTTP 200 със следната 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."
}
]
}id идентифицира работната поръчка, asset – нейното оборудване, а revision – версията на процедурата. Всеки елемент в steps има номер, заглавие, пълна инструкция и expectedResult. Примерът сортира стъпките по номер.
За реална работа използвайте одобрени инструкции; примерът описва неактивна станция за обучение. Преди внедряване в продукционна среда валидирайте размера на отговора и дължината на полетата, отхвърляйте невалидни данни за процедури и определете поведението при изтичане на токена. API трябва да проверява разрешението за всяка заявена поръчка. Примерният код е илюстративен и не е компилиран или тестван с реална система или с физическо устройство Aura.
Заключение
Свързването на XREAL Aura с бизнес система започва с одобрен адрес на API и разрешение за достъп, последвани от приложение, създадено в Android Studio, което извлича необходимия запис. Тестването на връзката на компютър преди внедряването ѝ на Aura помага да се разграничат проблемите с достъпа до данни от проблемите с настройката на устройството. Примерът с работна поръчка извежда данните за оборудването и инструкциите стъпка по стъпка на четим дисплей в очилата, като дава на бизнеса практическа отправна точка за осигуряване на достъп до оперативна информация там, където се извършва работата. Фирменото влизане, подходящите разрешения и тестването на устройството подготвят тази връзка за пилотен проект със служители.
Обсъдете наличността на хардуера и изискванията за пилотния си проект с VR Expert.

























