Σύνοψη
Για να συνδέσετε το 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 (όπως μια εφαρμογή Android 2D για κινητά ή για μεγάλες οθόνες) που εμφανίζονται σε ένα πάνελ συστήματος XR, ως δισδιάστατο παράθυρο μέσα στο περιβάλλον XR. Ακόμη και μια υπάρχουσα εφαρμογή χρειάζεται δοκιμές συμβατότητας και πρόσβασης. [4]
Για πληροφορίες σχετικά με το υλικό, δείτε τη σελίδα προϊόντος του XREAL Aura. Επιβεβαιώστε την τρέχουσα διαθεσιμότητα και υποστήριξη για τη χώρα σας, καθώς οι πληροφορίες κυκλοφορίας αλλάζουν. [2]
Βήμα 1 Αποκτήστε μια δοκιμαστική εντολή εργασίας και τα στοιχεία σύνδεσής της
Η εφαρμογή σας για το Aura χρειάζεται μια εγγραφή για να εμφανίσει και άδεια για να την ανακτήσει από το εταιρικό σας σύστημα. Η εντολή εργασίας είναι μια εγγραφή εργασίας που περιέχει αριθμό εντολής, στοιχεία εξοπλισμού και οδηγίες, όπως τα βήματα για τον έλεγχο ενός μηχανήματος.
· Πριν γράψετε τον κώδικα, βεβαιωθείτε ότι διαθέτετε ένα endpoint HTTPS, ένα δοκιμαστικό διακριτικό πρόσβασης (access token) και έναν αριθμό δείγματος εντολής εργασίας (π.χ. WO-1001) που αντιστοιχεί στο σχήμα JSON της ενότητας «Αναφορά για προγραμματιστές».
· Ζητήστε από το τμήμα IT τη διεύθυνση API που ανακτά αυτή την εντολή και ένα προσωρινό δοκιμαστικό διακριτικό πρόσβασης. Η διεύθυνση API υποδεικνύει στην εφαρμογή πού να ζητήσει την εγγραφή· το διακριτικό της δίνει άδεια να διαβάσει τα δεδομένα. Ζητήστε από το IT να επιβεβαιώσει ότι και τα δύο λειτουργούν και αν απαιτείται πρόσβαση στο εταιρικό δίκτυο.
· Μοιραστείτε με το IT την ενότητα «Αναφορά για προγραμματιστές» στο τέλος αυτού του άρθρου, ώστε να ελέγξουν ότι τα δεδομένα που επιστρέφονται αντιστοιχούν στο παράδειγμα εφαρμογής. Αν διαφέρουν, ενημερώστε τον κώδικα στο Βήμα 3 ώστε να διαβάζει τα ονόματα πεδίων του δικού σας συστήματος. Αν δεν υπάρχει κατάλληλο API, το IT πρέπει πρώτα να το παράσχει.
Έχετε έτοιμα αυτά τα τρία στοιχεία: η διεύθυνση 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 Επιτρέψτε στην εφαρμογή την πρόσβαση στο δίκτυο
Το manifest είναι το αρχείο 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] Το παράδειγμα χρησιμοποιεί τα ενσωματωμένα εργαλεία δικτύωσης και JSON του Android, οπότε δεν χρειάζεται να προσθέσετε το 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(...) με το μοτίβο endpoint της εταιρείας σας από το Βήμα 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 Δοκιμάστε τη σύνδεση στον υπολογιστή σας
Ο εξομοιωτής (emulator) είναι μια εικονική συσκευή 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 και επικολλήστε το προσωρινό διακριτικό που σας έδωσε το IT. Επικολλήστε μόνο την τιμή του, χωρίς τη λέξη 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. Ζητήστε από το IT να επιβεβαιώσει τυχόν απαιτήσεις ιδιωτικού δικτύου.
· Ακολουθήστε τις τρέχουσες οδηγίες εκκίνησης για προγραμματιστές που παρέχει η XREAL, για να ενεργοποιήσετε τον εντοπισμό σφαλμάτων (debugging) και να συνδέσετε τη μονάδα υπολογισμού στον υπολογιστή σας. Ξεκινήστε από τις Συχνές ερωτήσεις του 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 μόνο για τη θύρα γυαλιών, οπότε δοκιμάστε αυτή τη θύρα αν η αριστερή δεν αναγνωρίζεται, και χρησιμοποιήστε τις τρέχουσες οδηγίες της 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, επιβεβαιώστε ότι το παράδειγμα ονόματος κεντρικού υπολογιστή έχει αντικατασταθεί. Ζητήστε από το IT να ελέγξει ότι το endpoint είναι προσβάσιμο από το δίκτυο του εξομοιωτή ή του Aura.
· Το API επιστρέφει 401: Το API δεν αποδέχθηκε τα διαπιστευτήρια. Ζητήστε από το IT να ελέγξει την εγκυρότητα του διακριτικού και την υπηρεσία για την οποία προορίζεται ή αποκτήστε νέο δοκιμαστικό διακριτικό.
· Το API επιστρέφει 403: Ο λογαριασμός δεν διαθέτει τα απαραίτητα δικαιώματα. Ζητήστε από τον διαχειριστή του επιχειρηματικού συστήματος να παραχωρήσει την κατάλληλη πρόσβαση.
· Το API επιστρέφει 404: Ελέγξτε τον αριθμό εντολής και αν το endpoint παραπέμπει στο σωστό δοκιμαστικό περιβάλλον.
· Το API επιστρέφει δεδομένα αλλά η εφαρμογή αποτυγχάνει: Ζητήστε από τον προγραμματιστή του API να συγκρίνει την απόκριση με την «Αναφορά για προγραμματιστές». Το παράδειγμα απαιτεί μη κενή λίστα steps και id που αντιστοιχεί στην εντολή που ζητήθηκε.
· Λειτουργεί στον εξομοιωτή αλλά όχι στο Aura: Επιβεβαιώστε τη διαδρομή δικτύου του Aura και την πρόσβαση στο API και, στη συνέχεια, ελέγξτε την εφαρμογή στη συσκευή. Μην απενεργοποιείτε τους ελέγχους πιστοποιητικών HTTPS για να παρακάμψετε ένα σφάλμα σύνδεσης.
Το παράδειγμα εμφανίζει στον χρήστη ένα γενικό μήνυμα αποτυχίας. Για τον ακριβή κωδικό κατάστασης του API, ζητήστε από τον διαχειριστή να εξετάσει τα αρχεία καταγραφής του διακομιστή χωρίς να εκθέσει διακριτικά ή πλήρεις εντολές εργασίας. Για σφάλματα της εφαρμογής, χρησιμοποιήστε το View > Tool Windows > Logcat στο Android Studio· το Logcat εμφανίζει τα αρχεία καταγραφής της εφαρμογής.
Αναφορά για προγραμματιστές για το παράδειγμα API
Χρησιμοποιήστε αυτή την ενότητα όταν ελέγχετε την απόκριση στο Βήμα 1 ή προσαρμόζετε τη fetchOrder στο Βήμα 3. Περιγράφει τη σύμβαση για αυτό το παράδειγμα εφαρμογής, όχι κάποιο endpoint που παρέχει η 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 έχει number, title, πλήρη οδηγία (instruction) και expectedResult. Το παράδειγμα ταξινομεί τα βήματα κατά αριθμό.
Για πραγματικές εργασίες χρησιμοποιήστε εγκεκριμένες οδηγίες· το παράδειγμα περιγράφει έναν ανενεργό εκπαιδευτικό σταθμό. Πριν από την παραγωγική χρήση, επικυρώστε το μέγεθος της απόκρισης και τα μήκη των πεδίων, απορρίψτε μη έγκυρα δεδομένα διαδικασίας και ορίστε τη συμπεριφορά κατά τη λήξη του διακριτικού. Το API πρέπει να ελέγχει τα δικαιώματα για κάθε εντολή που ζητείται. Ο κώδικας του παραδείγματος είναι ενδεικτικός και δεν έχει μεταγλωττιστεί ούτε δοκιμαστεί σε πραγματικό σύστημα ή σε φυσική συσκευή Aura.
Συμπέρασμα
Η σύνδεση του XREAL Aura με ένα επιχειρηματικό σύστημα ξεκινά με μια εγκεκριμένη διεύθυνση API και άδεια πρόσβασης, και συνεχίζεται με μια εφαρμογή Android Studio που ανακτά την απαιτούμενη εγγραφή. Η δοκιμή της σύνδεσης σε υπολογιστή πριν από την ανάπτυξή της στο Aura βοηθά να διαχωριστούν τα προβλήματα πρόσβασης στα δεδομένα από τα ζητήματα ρύθμισης της συσκευής. Το παράδειγμα της εντολής εργασίας φέρνει τα στοιχεία του εξοπλισμού και τις οδηγίες βήμα προς βήμα σε μια ευανάγνωστη οθόνη γυαλιών, προσφέροντας στις επιχειρήσεις ένα πρακτικό σημείο εκκίνησης για να γίνουν οι επιχειρησιακές πληροφορίες προσβάσιμες στο σημείο εργασίας. Η εταιρική σύνδεση χρηστών, τα κατάλληλα δικαιώματα και οι δοκιμές στη συσκευή προετοιμάζουν αυτή τη σύνδεση για ένα πιλοτικό πρόγραμμα με εργαζομένους.
Συζητήστε τη διαθεσιμότητα του υλικού και τις απαιτήσεις του πιλοτικού σας προγράμματος με τη VR Expert.

























