Δημιουργία της πρώτης επιχειρηματικής εφαρμογής για XREAL Aura με το Android Studio

Δημιουργία της πρώτης επιχειρηματικής εφαρμογής για XREAL Aura με το Android Studio

Σύνοψη

Αυτός ο οδηγός δείχνει πώς να δημιουργήσετε μια επιχειρηματική εφαρμογή για XREAL Aura στο Android Studio με Kotlin και το Jetpack XR SDK. Θα δημιουργήσετε ένα έργο, θα προσθέσετε τη βιβλιοθήκη χωρικής διεπαφής, θα επικολλήσετε ένα μικρό παράδειγμα πάνελ εργασιών και θα το εκτελέσετε στον εξομοιωτή XR Glasses πριν το δοκιμάσετε σε υλικό Aura.

Το παράδειγμα εμφανίζει οδηγίες εργασίας και επιτρέπει στους χρήστες να επιβεβαιώνουν κάθε εργασία. Αποτελεί σημείο εκκίνησης για μια επιχειρηματική εφαρμογή, χωρίς μόνιμα αρχεία εργασιών ούτε επαλήθευση ότι μια φυσική εργασία ολοκληρώθηκε. Ο κώδικας ακολουθεί την τεκμηρίωση που εξετάστηκε, αλλά δεν έχει μεταγλωττιστεί ούτε δοκιμαστεί σε υλικό Aura.

Εισαγωγή

Η δημιουργία μιας επιχειρηματικής εφαρμογής για XREAL Aura ξεκινά στο Android Studio, όπου γράφετε κώδικα Kotlin και χρησιμοποιείτε το Jetpack XR SDK για να προσθέσετε μια χωρική διεπαφή. Ο οδηγός αυτός σας καθοδηγεί από τη δημιουργία ενός έργου έως την εκτέλεσή του σε εξομοιωτή και τη δοκιμή του στο Aura. Ως απλό παράδειγμα, θα φτιάξετε ένα πάνελ που εμφανίζει οδηγίες εργασίας και επιτρέπει στον χρήστη να επιβεβαιώνει κάθε εργασία.

Το XREAL Aura συνδυάζει ενσύρματα γυαλιά με μια υπολογιστική μονάδα (puck) Android XR. Ακολουθήστε τη ροή εργασίας του Android XR για ενσύρματα γυαλιά XR και όχι τη χωριστή ροή εργασίας για γυαλιά ήχου και οθόνης που προβάλλονται από τηλέφωνο. Για πληροφορίες σχετικά με το υλικό, δείτε την επισκόπηση του XREAL Aura από τη VRX και την επίσημη σελίδα του Aura από την XREAL. [1]

Πριν ξεκινήσετε

· Χρησιμοποιήστε έναν εγκεκριμένο από την εταιρεία υπολογιστή με πρόσβαση στο διαδίκτυο για τις αρχικές λήψεις

· Ελέγξτε τις απαιτήσεις συστήματος του εξομοιωτή XR της Google, οι οποίες προς το παρόν καλύπτουν υποστηριζόμενες διαμορφώσεις Windows και macOS [2]

· Για δοκιμές σε φυσική συσκευή, προμηθευτείτε γυαλιά Aura, την υπολογιστική τους μονάδα (puck) και τις οδηγίες σύνδεσης προγραμματιστή του κιτ

Διαθεσιμότητα: Επιβεβαιώστε τη διαθεσιμότητα στην περιοχή σας με τη VR Expert. Η τρέχουσα σελίδα της XREAL δίνει προτεραιότητα σε ΗΠΑ, Καναδά, Ιαπωνία και Νότια Κορέα· παλαιότερες λίστες κρατήσεων δεν πρέπει να θεωρούνται επιβεβαιωμένη παράδοση στην Ευρώπη. [1]

Βήμα 1 Εγκαταστήστε το Android Studio και τα εργαλεία SDK

Ξεκινήστε εγκαθιστώντας το Android Studio και τα εργαλεία SDK που χρησιμοποιούνται για τη δημιουργία της εφαρμογής, την εκτέλεση μιας προσομοιωμένης συσκευής XR και τη σύνδεση με το υλικό.

Η Google συνιστά το Android Studio Canary για XR. Το Canary είναι μια έκδοση προεπισκόπησης με νεότερα εργαλεία και πιθανώς ημιτελείς λειτουργίες· μπορείτε να το εγκαταστήσετε παράλληλα με το υπάρχον Android Studio σας.

· Ανοίξτε το Android Studio Preview, κατεβάστε το κατάλληλο πρόγραμμα εγκατάστασης και ολοκληρώστε τον οδηγό εγκατάστασης.

· Στην οθόνη υποδοχής του Android Studio, επιλέξτε More Actions > SDK Manager. Αν υπάρχει ήδη ανοιχτό έργο, χρησιμοποιήστε το Tools > SDK Manager στο επάνω μενού.

· Στο παράθυρο ρυθμίσεων του SDK Manager, εντοπίστε τις καρτέλες SDK Platforms και SDK Tools, πάνω από τη λίστα των πακέτων προς εγκατάσταση. Και οι δύο καρτέλες βρίσκονται στο ίδιο παράθυρο του SDK Manager.

· Επιλέξτε SDK Tools. Τσεκάρετε τα Android SDK Build-Tools, Android Emulator και Android SDK Platform-Tools. Αφήστε τα επιλεγμένα αν είναι ήδη εγκατεστημένα· εφαρμόστε τις διαθέσιμες ενημερώσεις. Το Build-Tools προετοιμάζει το αρχείο εγκατάστασης της εφαρμογής, το Emulator εκτελεί προσομοιωμένες συσκευές και το Platform-Tools περιλαμβάνει το εργαλείο σύνδεσης συσκευών ADB.

· Κάντε κλικ στο Apply, ελέγξτε τις επιλεγμένες λήψεις, αποδεχτείτε τις απαιτούμενες άδειες χρήσης και περιμένετε να ολοκληρωθεί η εγκατάσταση. Κάντε κλικ στο OK για να κλείσετε το παράθυρο.

Η καρτέλα SDK Platforms εγκαθιστά την πλατφόρμα Android που χρησιμοποιείται για τη μεταγλώττιση της εφαρμογής. Η απαιτούμενη έκδοσή της καθορίζεται από τη διαμόρφωση του έργου. Δημιουργήστε το έργο στο Βήμα 2 και, στη συνέχεια, χρησιμοποιήστε τη ρύθμιση compileSdk του έργου για να επιλέξετε την αντίστοιχη πλατφόρμα. Το Βήμα 6 καλύπτει την εικόνα συστήματος του εξομοιωτή XR, η οποία παρέχει το λειτουργικό σύστημα της προσομοιωμένης συσκευής.

Σημείο ελέγχου: Τα τρία εργαλεία SDK έχουν εγκατασταθεί. Μπορείτε πλέον να δημιουργήσετε το έργο. [3, 13]

Βήμα 2 Δημιουργήστε το έργο της επιχειρηματικής εφαρμογής για XREAL Aura

Το πρότυπο έργου XR δημιουργεί τα αρχικά αρχεία και τη διαμόρφωση build της εφαρμογής. Ακολουθήστε τις οδηγίες της Google για έργα Android XR για την έκδοση του Studio που έχετε εγκαταστήσει. [4]

· Στο Android Studio, επιστρέψτε στην οθόνη υποδοχής και κάντε κλικ στο New Project ή επιλέξτε File > New > New Project.

· Επιλέξτε XR στη λίστα προτύπων και, στη συνέχεια, το πρότυπο για σετ κεφαλής XR και ενσύρματα γυαλιά XR. Η σελίδα έργων της Google δεν κατονομάζει πλέον πρότυπα (αναφέρει ότι πρέπει να επιλέξετε το πρότυπο που αντιστοιχεί στον τύπο συσκευής XR για τον οποίο θέλετε να αναπτύξετε) και τα ονόματα μπορεί να αλλάζουν μεταξύ εκδόσεων Canary, οπότε πάρτε το ακριβές όνομα από το IDE για το στιγμιότυπο οθόνης. Μην επιλέξετε το πρότυπο για γυαλιά ήχου ή οθόνης, το οποίο δημιουργεί εμπειρία που προβάλλεται από τηλέφωνο.

· Κάντε κλικ στο Next. Πληκτρολογήστε AuraTaskPanel στο πεδίο Name. Στο πεδίο Package name, πληκτρολογήστε com.example.aurataskpanel για αυτόν τον οδηγό. Επιλέξτε Kotlin αν εμφανιστεί επιλογή γλώσσας. Το όνομα πακέτου προσδιορίζει τον κώδικα της εφαρμογής και μπορεί να προσαρμοστεί για τον οργανισμό σας. Εισάγεται στο Android Studio ως αναγνωριστικό με τελείες ως διαχωριστικά, χωρίς https:// ή διαδρομή διεύθυνσης ιστού.

Στη συνέχεια, διατηρήστε τις ρυθμίσεις build του παραγόμενου προτύπου και κάντε κλικ στο Finish. Περιμένετε να ολοκληρωθεί ο πρώτος συγχρονισμός Gradle. Ο συγχρονισμός κάνει το Android Studio να διαβάσει τη διαμόρφωση build και να επιλύσει τις εξαρτήσεις της.

Ανοίξτε το View > Tool Windows > Project και, στη συνέχεια, επιλέξτε Android στον επιλογέα προβολής του παραθύρου. Θα χρησιμοποιήσετε τα εξής αρχεία:

· MainActivity.kt: app > kotlin+java > com.example.aurataskpanel. Περιέχει το σημείο εισόδου και τη διεπαφή της εφαρμογής· ορισμένες εκδόσεις ονομάζουν τον φάκελο πηγαίου κώδικα java

· AndroidManifest.xml: app > manifests. Δηλώνει το σημείο εισόδου, τα δικαιώματα και τις ρυθμίσεις εκκίνησης της εφαρμογής

· build.gradle.kts (Module :app): Gradle Scripts. Διαμορφώνει το build και τις βιβλιοθήκες της εφαρμογής

Εγκαταστήστε την πλατφόρμα που ζητά το έργο σας

Η ρύθμιση compileSdk υποδεικνύει στο Android Studio ποιο σύνολο API του Android να χρησιμοποιήσει κατά τη δημιουργία της εφαρμογής. Εγκαταστήστε την αντίστοιχη πλατφόρμα SDK· μην επιλέξετε πλατφόρμα μόνο με βάση τη μάρκα των γυαλιών.

· Στο παράθυρο Project του Android Studio, ανοίξτε το Gradle Scripts > build.gradle.kts (Module :app). Στο μπλοκ android, εντοπίστε το compileSdk. Μια τιμή όπως compileSdk = 36 σημαίνει ότι το έργο χρειάζεται το Android API 36. Ο αριθμός αυτός είναι παράδειγμα και όχι απαιτούμενη τιμή για κάθε έργο Aura.

· Αν η τιμή παραπέμπει σε καταχώριση καταλόγου, όπως libs.versions.compileSdk, ανοίξτε το Gradle Scripts > libs.versions.toml και διαβάστε την τιμή στην οποία γίνεται αναφορά. Αν το πρότυπο χρησιμοποιεί όνομα προεπισκόπησης ή ένθετη διαμόρφωση compileSdk, διατηρήστε αυτή τη ρύθμιση και χρησιμοποιήστε την αντίστοιχη πλατφόρμα.

· Ανοίξτε το Tools > SDK Manager > SDK Platforms. Επιλέξτε τη γραμμή της οποίας το API Level αντιστοιχεί στη ρύθμιση του έργου. Κάντε κλικ στο Apply, ολοκληρώστε τη λήψη και, στη συνέχεια, στο OK.

· Επιστρέψτε στο έργο και επιλέξτε File > Sync Project with Gradle Files ή Sync Now αν σας το προτείνει κάποια γραμμή ειδοποίησης. Ο συγχρονισμός Gradle διαβάζει τις ρυθμίσεις build και κατεβάζει τις βιβλιοθήκες που απαιτεί το έργο.

Διατηρήστε τη ρύθμιση πλατφόρμας του προτύπου. Αν το Android Studio αναφέρει ότι λείπει κάποια πλατφόρμα, εγκαταστήστε την αντί να μειώσετε το compileSdk για να αποφύγετε τη λήψη. Η εικόνα συσκευής XR που χρησιμοποιείται για τις δοκιμές επιλέγεται ξεχωριστά στο Βήμα 6. [13]

Σημείο ελέγχου: Η απαιτούμενη πλατφόρμα SDK έχει εγκατασταθεί και το παράθυρο εργαλείων Build ή Sync δεν περιέχει ανεπίλυτα σφάλματα.

Βήμα 3 Προσθέστε τη βιβλιοθήκη XR και ελέγξτε τη συμβατότητα του Kotlin

Προσθέστε το Jetpack Compose for XR για να αποκτήσει η εφαρμογή στοιχεία χωρικών πάνελ και ελέγξτε τη συμβατότητα του Kotlin, ώστε το έργο να μπορεί να κάνει build αυτής της βιβλιοθήκης χωρίς σφάλματα εκδόσεων. Αυτό το παράδειγμα χρησιμοποιεί το XR Compose 1.0.0-beta02 (21-10-2026, ακόμη η νεότερη έκδοση), το οποίο απαιτεί Kotlin 2.2 σύμφωνα με τις σημειώσεις έκδοσης της Google. Οι ίδιες σημειώσεις αναφέρουν ότι το beta02 εξαρτάται από το SceneCore 1.0.0-rc01, το οποίο έχει γνωστή διαρροή μνήμης, οπότε προσθέστε implementation (“androidx.xr.scenecore:1.0.0”) ή νεότερη έκδοση στη γραμμή του Compose στο Βήμα 3.

Ελέγξτε μία φορά την έκδοση του Kotlin

· Στο Android Studio, αναπτύξτε το Gradle Scripts και, στη συνέχεια, ανοίξτε το libs.versions.toml. Το αρχείο αυτό, όταν υπάρχει, είναι η κεντρική λίστα του έργου με τις εκδόσεις βιβλιοθηκών και plugin.

· Στην ενότητα [versions], αναζητήστε την καταχώριση του Kotlin, συνήθως kotlin = "2.2.0" ή κάποια άλλη έκδοση 2.2.x. Διατηρήστε τη συμβατή έκδοση που παρέχει το τρέχον πρότυπο.

· Αν το έργο χρησιμοποιεί το plugin org.jetbrains.kotlin.plugin.compose, η έκδοσή του πρέπει να ταιριάζει με την έκδοση του Kotlin. Τα πρότυπα συνήθως κάνουν και τα δύο να παραπέμπουν στην ίδια καταχώριση έκδοσης Kotlin· διατηρήστε αυτή τη σύνδεση.

· Αν δεν υπάρχει καταχώριση Kotlin ή κατάλογος, ελέγξτε το build.gradle.kts ανώτατου επιπέδου για ρητά δηλωμένα plugin Kotlin. Ορισμένες νεότερες διαμορφώσεις build διαχειρίζονται το Kotlin μέσω των εργαλείων build του Android. Σε αυτή την περίπτωση, διατηρήστε την παραγόμενη διαμόρφωση και ελέγξτε τη συμβατότητα Kotlin της αλυσίδας εργαλείων αν εμφανιστεί σφάλμα build· μην προσθέσετε δεύτερο plugin Kotlin μόνο και μόνο για να δημιουργήσετε καταχώριση έκδοσης.

Αν το πρότυπο παρέχει ήδη συμβατά εργαλεία Kotlin, μην αλλάξετε τίποτα. Αν ένα build αναφέρει ότι το Kotlin είναι πολύ παλιό για τη βιβλιοθήκη XR, ενημερώστε μαζί τα εργαλεία Kotlin του έργου και τυχόν αντίστοιχο plugin μεταγλωττιστή Compose, χρησιμοποιώντας την υποστηριζόμενη διαμόρφωση για το συγκεκριμένο πρότυπο. Αποφύγετε αλλαγές σε άσχετες ρυθμίσεις build.

Προσθέστε την εξάρτηση χωρικής διεπαφής

· Ανοίξτε το Gradle Scripts > build.gradle.kts (Module :app).

· Εντοπίστε το υπάρχον μπλοκ dependencies { ... }.

· Αναζητήστε μια εξάρτηση XR Compose, είτε γραμμένη απευθείας είτε μέσω ψευδωνύμου (alias) όπως implementation(libs.androidx.xr.compose). Αν υπάρχει ήδη alias, ορίστε την έκδοση XR Compose στην οποία παραπέμπει σε 1.0.0-beta02 στο libs.versions.toml. Μην προσθέσετε την ίδια βιβλιοθήκη δύο φορές.

· Αν το XR Compose απουσιάζει, προσθέστε αυτή τη γραμμή μέσα στο υπάρχον μπλοκ dependencies:

implementation("androidx.xr.compose:compose:1.0.0-beta02")

Διατηρήστε τις υπόλοιπες εξαρτήσεις του προτύπου. Συγκεκριμένα, ο παρακάτω κώδικας χρησιμοποιεί το συνηθισμένο Material 3, τη βιβλιοθήκη που παρέχει τα κουμπιά, το κείμενο και το θέμα του, καθώς και το Activity Compose, το οποίο φιλοξενεί περιεχόμενο Compose σε ένα Activity του Android.

Συγχρονίστε και συνεχίστε

Κάντε κλικ στο Sync Now στη γραμμή ειδοποίησης του επεξεργαστή ή επιλέξτε File > Sync Project with Gradle Files. Περιμένετε να ολοκληρωθεί η διαδικασία λήψης και διαμόρφωσης.

Σημείο ελέγχου: Ο συγχρονισμός ολοκληρώνεται χωρίς σφάλματα εξαρτήσεων ή συμβατότητας Kotlin. Όταν ο συγχρονισμός επιτύχει, διατηρήστε τις υπόλοιπες παραγόμενες ρυθμίσεις build και, στη συνέχεια, ανοίξτε το MainActivity.kt για να προσθέσετε τη διεπαφή. Αν ο συγχρονισμός αναφέρει σφάλμα εξάρτησης, συγκρίνετε το στοιχείο που κατονομάζεται με τη σελίδα ρύθμισης του Jetpack XR SDK της Google. [6]

Βήμα 4 Δημιουργήστε το πάνελ εργασιών σε Kotlin

Η διεπαφή εμφανίζει το κείμενο της εργασίας μαζί με ένα κουμπί Mark complete και ένα κουμπί Restart demo. Οι ενδεικτικές οδηγίες μπορούν αργότερα να αντικατασταθούν από μια εγκεκριμένη διαδικασία του χώρου εργασίας.

Στο ίδιο αρχείο MainActivity.kt του Android Studio, διατηρήστε τη γραμμή package αν το πακέτο σας διαφέρει και, στη συνέχεια, αντικαταστήστε το υπόλοιπο αρχείο με τον παρακάτω κώδικα. Αφαιρέστε από αυτό το αρχείο τις παλιές ενδεικτικές συναρτήσεις και τις συναρτήσεις προεπισκόπησης του προτύπου, ώστε να υπάρχει μόνο ένα MainActivity. Ένα Activity είναι ένα σημείο εισόδου του Android που φιλοξενεί μια διεπαφή. Το παρακάτω παράδειγμα περιλαμβάνει το Activity και τα imports του.

package com.example.aurataskpanel
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.runtime.saveable.rememberSaveable
import androidx.compose.ui.Modifier
import androidx.compose.ui.unit.dp
import androidx.compose.ui.unit.sp
import androidx.xr.compose.platform.LocalSpatialCapabilities
import androidx.xr.compose.spatial.Subspace
import androidx.xr.compose.subspace.SpatialPanel
import androidx.xr.compose.subspace.layout.SubspaceModifier
import androidx.xr.compose.subspace.layout.height
import androidx.xr.compose.subspace.layout.width
class MainActivity : ComponentActivity() {
	override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
    	setContent {
            MaterialTheme(colorScheme = darkColorScheme()) {
                TaskApp()
        	}
    	}
	}
}
@Composable
private fun TaskApp() {
	val steps = listOf(
    	"Check that the training area is clear.",
        "Confirm the training device is charged.",
    	"Open the approved training application."
	)
	var completed by rememberSaveable { mutableIntStateOf(0) }
	val content: @Composable () -> Unit = {
    	TaskPanel(
        	steps = steps,
            completed = completed,
            onComplete = {
            	if (completed < steps.size) completed++
        	},
            onRestart = { completed = 0 }
    	)
	}
	if (LocalSpatialCapabilities.current.isSpatialUiEnabled) {
    	Subspace {
            SpatialPanel(
                modifier = SubspaceModifier
                    .width(640.dp)
                    .height(540.dp)
        	) {
                content()
        	}
    	}
	} else {
    	content()
	}
}
@Composable
private fun TaskPanel(
	steps: List<String>,
	completed: Int,
	onComplete: () -> Unit,
	onRestart: () -> Unit
) {
	val finished = completed >= steps.size
    Surface(modifier = Modifier.fillMaxSize()) {
    	Column(
            modifier = Modifier
                .fillMaxSize()
                .verticalScroll(rememberScrollState())
                .padding(24.dp),
            verticalArrangement = Arrangement.spacedBy(16.dp)
    	) {
            Text("Training station preparation", fontSize = 28.sp)
            Text("Demo procedure v1.0", fontSize = 18.sp)
        	Text(
                "$completed of ${steps.size} tasks acknowledged",
                fontSize = 20.sp
        	)
        	Text(
            	if (finished) "Checklist complete"
                else "Task ${completed + 1}: ${steps[completed]}",
                fontSize = 26.sp
        	)
        	Text(
                "Your confirmation does not verify physical work.",
                fontSize = 18.sp
        	)
        	Button(
                onClick = onComplete,
                enabled = !finished,
                modifier = Modifier
                    .fillMaxWidth()
                    .heightIn(min = 64.dp)
        	) {
                Text("Mark complete", fontSize = 22.sp)
        	}
            OutlinedButton(
                onClick = onRestart,
                modifier = Modifier
                    .fillMaxWidth()
                    .heightIn(min = 64.dp)
        	) {
                Text("Restart demo", fontSize = 22.sp)
        	}
    	}
	}
}

Τι κάνει ο κώδικας

· steps περιέχει το κείμενο των οδηγιών

· completed μετρά τις επιβεβαιώσεις και αποτρέπει την προώθηση πέρα από την τελευταία εργασία

· rememberSaveable διατηρεί αυτή τη μικρή τιμή κατά την υποστηριζόμενη αναδημιουργία οθόνης και επαναφορά κατάστασης του Android· δεν αποτελεί μόνιμη αποθήκευση

· LocalSpatialCapabilities ελέγχει αν είναι διαθέσιμο το χωρικό UI [7]

· Subspace δημιουργεί μια περιοχή για χωρικό περιεχόμενο και το SpatialPanel τοποθετεί τη διεπαφή μέσα σε αυτήν [8]

· Ο κλάδος εναλλακτικής λειτουργίας (fallback) εμφανίζει το ίδιο περιεχόμενο σε κανονικό παράθυρο όταν το χωρικό UI δεν είναι διαθέσιμο

Η μονάδα dp κλιμακώνει τις διαστάσεις της διάταξης ανάλογα με την πυκνότητα της οθόνης· η μονάδα sp κλιμακώνει το κείμενο και σέβεται τις προτιμήσεις μεγέθους γραμματοσειράς. Το κοντέινερ κύλισης διατηρεί προσβάσιμες τις μεγαλύτερες οδηγίες. Αντιμετωπίστε το μέγεθος του πάνελ ως σημείο εκκίνησης και ελέγξτε την αναγνωσιμότητα στο Aura.

Σημείο ελέγχου: Το Android Studio αναγνωρίζει τα imports και δεν εμφανίζει συντακτικά σφάλματα Kotlin. Αν η εγκατεστημένη βιβλιοθήκη σας απαιτεί opt-in για πειραματικό API, χρησιμοποιήστε την ακριβή annotation που αναφέρει το διαγνωστικό μήνυμα του μεταγλωττιστή και ελέγξτε την τεκμηρίωση API της συγκεκριμένης έκδοσης.

Βήμα 5 Ελέγξτε πώς ξεκινά η εφαρμογή στο Android XR

Διαμορφώστε τη λειτουργία εκκίνησης ώστε το Android XR να μπορεί να ανοίγει την εφαρμογή με τη χωρική διάταξη που χρησιμοποιείται σε αυτό το παράδειγμα.

Στα γυαλιά Aura, τα Home Space και Full Space είναι ήδη ενσωματωμένα στο Android XR και ελέγχουν τον τρόπο εμφάνισης των εφαρμογών που εκτελούνται. Ο εξομοιωτής XR Glasses παρέχει αυτές τις λειτουργίες για την ανάπτυξη, οπότε δεν χρειάζεται ξεχωριστή εγκατάσταση.

Στο παράθυρο Project του Android Studio, ανοίξτε app > manifests > AndroidManifest.xml και εξετάστε την καταχώριση MainActivity. Διατηρήστε το intent filter MAIN και LAUNCHER, τη ρύθμιση exported και το παραγόμενο θέμα. Για Full Space υπό τη διαχείριση του Compose, η σχετική ιδιότητα φαίνεται παρακάτω. Αν το πρότυπο δηλώνει ήδη ιδιότητα εκκίνησης σε επίπεδο application ή Activity, επεξεργαστείτε την υπάρχουσα τιμή αντί να τη δηλώσετε δεύτερη φορά. [9]

<!-- Μέσα στο υπάρχον στοιχείο MainActivity -->
<property
    android:name="android.window.PROPERTY_XR_ACTIVITY_START_MODE"
    android:value="XR_ACTIVITY_START_MODE_FULL_SPACE_MANAGED" />

Το Managed Full Space σημαίνει ότι το Android διαχειρίζεται τη χωρική σκηνή για το Activity. Η τιμή UNMANAGED προορίζεται για εφαρμογές που αποδίδουν γραφικά μέσω του OpenXR, μιας διεπαφής XR για πολλές πλατφόρμες· αυτό το παράδειγμα Compose δεν τη χρησιμοποιεί. Συμβουλευτείτε την τεκμηρίωση αναφοράς για τις σταθερές του manifest όταν συγκρίνετε πρότυπα. [9]

Στο υπάρχον στοιχείο application, διατηρήστε επίσης ή προσθέστε το android:enableOnBackInvokedCallback="true", ώστε το χωρικό πάνελ να λαμβάνει συμβάντα επιστροφής, όπως τεκμηριώνει ο οδηγός πάνελ της Google· το παράδειγμά του το ορίζει στο στοιχείο activity, αλλά ισχύει και στο στοιχείο application. Μην προσθέσετε δικαιώματα κάμερας, μικροφώνου ή κατανόησης σκηνής για αυτή τη στατική λίστα ελέγχου. Δεν διαβάζει τον χώρο ούτε αναγνωρίζει αντικείμενα. [8]

Βήμα 6 Δημιουργήστε έναν εξομοιωτή γυαλιών XR και εκτελέστε την εφαρμογή

Εκτελέστε την εφαρμογή σε μια προσομοιωμένη συσκευή γυαλιών XR πριν συνδέσετε το Aura. Ένας εξομοιωτής προσομοιώνει μια συσκευή στον υπολογιστή σας· ένα AVD είναι η αποθηκευμένη διαμόρφωσή του.

· Στο Android Studio, ανοίξτε Tools > Device Manager. Κάντε κλικ στο στοιχείο ελέγχου προσθήκης συσκευής και επιλέξτε Create Virtual Device.

· Στην ενότητα Form Factor, επιλέξτε XR και, στη συνέχεια, XR Glasses. Κάντε κλικ στο Next.

· Επιλέξτε την εικόνα συστήματος Preview API που απαιτείται για το προφίλ XR Glasses και κατεβάστε την αν σας ζητηθεί. Επιλέξτε την υποστηριζόμενη αρχιτεκτονική εικόνας που ταιριάζει στον υπολογιστή σας. Ολοκληρώστε τη διαμόρφωση.

· Εκκινήστε το AVD με το κουμπί αναπαραγωγής του. Περιμένετε να ολοκληρωθεί η φόρτωση του περιβάλλοντος Android XR.

· Στην επάνω γραμμή εργαλείων του Android Studio, επιλέξτε τη διαμόρφωση εκτέλεσης της εφαρμογής και τη συσκευή XR Glasses που εκτελείται. Κάντε κλικ στο Run, το πράσινο τρίγωνο.

Ο εξομοιωτής εγκαθιστά και ανοίγει την εφαρμογή. Χρησιμοποιήστε τα στοιχεία ελέγχου εισόδου του για να ενεργοποιήσετε το Mark complete. Αν το πάνελ παραμένει στο Home Space, ελέγξτε το manifest και τα στοιχεία ελέγχου Full Space του περιβάλλοντος πριν αλλάξετε τη διάταξη Kotlin. Δείτε τις επίσημες οδηγίες για το AVD.

Εκτελέστε τον εξής έλεγχο αποδοχής:

· Η πρώτη οθόνη εμφανίζει μηδέν από τρεις εργασίες επιβεβαιωμένες και την πρώτη οδηγία

· Κάθε ενεργοποίηση του Mark complete προχωρά ακριβώς μία οδηγία

· Η τρίτη ενεργοποίηση εμφανίζει το Checklist complete και απενεργοποιεί το Mark complete

· Το Restart demo επαναφέρει την πρώτη οδηγία και μηδενίζει τις επιβεβαιώσεις

· Το μεγαλύτερο κείμενο παραμένει προσβάσιμο με κύλιση

· Το περιεχόμενο εξακολουθεί να εμφανίζεται όταν το χωρικό UI δεν είναι διαθέσιμο

Μια επιτυχημένη δοκιμή στον εξομοιωτή επικυρώνει μέρος της λογικής και της διάταξης της εφαρμογής. Δεν επικυρώνει τα οπτικά του Aura, την αξιοπιστία της εισόδου ούτε την καταλληλότητα για τον χώρο εργασίας.

Βήμα 7 Ανάπτυξη σε εξουσιοδοτημένο υλικό Aura

Τα παρακάτω βήματα ακολουθούν την τυπική διαδικασία αποσφαλμάτωσης του Android. Τα μενού και οι επιλογές σύνδεσης του Aura μπορεί να διαφέρουν ανάλογα με την έκδοση λογισμικού, οπότε ακολουθήστε τις οδηγίες του συγκεκριμένου κιτ όπου υπάρχουν διαφορές.

Συνδέστε το Aura και εκτελέστε την εφαρμογή

· Εκκινήστε το Aura με τα γυαλιά συνδεδεμένα και ανοίξτε την εφαρμογή Settings της συσκευής

· Στο Aura, στη διεπαφή ρυθμίσεων, ενεργοποιήστε τις Developer options και την αποσφαλμάτωση σύμφωνα με τις οδηγίες του κιτ· αν αυτά τα στοιχεία ελέγχου δεν είναι διαθέσιμα, προμηθευτείτε τον οδηγό ρύθμισης για προγραμματιστές

· Συνδέστε τον υπολογιστή στη θύρα Charging Port (αριστερή πλευρά) της υπολογιστικής μονάδας (puck) με καλώδιο δεδομένων USB και αφήστε τα γυαλιά στη θύρα Glasses Port (δεξιά πλευρά)· αν αυτό δεν λειτουργήσει, συνδέστε το στη θύρα της δεξιάς πλευράς για πλήρη υποστήριξη ADB.

· Αποδεχτείτε το μήνυμα εξουσιοδότησης αποσφαλμάτωσης της συσκευής· μια διαχειριζόμενη συσκευή μπορεί να απαιτεί έγκριση διαχειριστή

· Στην επάνω γραμμή εργαλείων του Android Studio, επιλέξτε Aura στο αναπτυσσόμενο μενού συσκευών και κάντε κλικ στο Run

· Στο Aura, επαναλάβετε τους ελέγχους του πάνελ εργασιών από το Βήμα 6, συμπεριλαμβανομένης της προώθησης εργασιών και της επανεκκίνησης της λίστας ελέγχου

Αντιμετώπιση προβλημάτων σύνδεσης συσκευής

Αν το Aura δεν εμφανίζεται στον επιλογέα συσκευών-στόχων του Android Studio, επαληθεύστε τη σύνδεση με το ADB:

  1. Ανοίξτε το View > Tool Windows > Terminal στο Android Studio.
  1. Εκτελέστε την ακόλουθη εντολή:
adb devices -l

Ελέγξτε την έξοδο:

· Αν η συσκευή σας εμφανίζεται με την ένδειξη device, είναι συνδεδεμένη και εξουσιοδοτημένη.

· Αν εμφανίζει unauthorized, φορέστε τα γυαλιά και αποδεχτείτε το μήνυμα αποσφαλμάτωσης USB στην οθόνη.

· Αν η λίστα είναι κενή, ελέγξτε ξανά το καλώδιο δεδομένων USB, βεβαιωθείτε ότι η υπολογιστική μονάδα είναι ενεργοποιημένη και επιβεβαιώστε ότι η αποσφαλμάτωση USB παραμένει ενεργοποιημένη στις ρυθμίσεις (Settings).

Συμπέρασμα

Η δημιουργία μιας πρώτης επιχειρηματικής εφαρμογής για XREAL Aura ξεκινά με το Android Studio, το Kotlin και το Jetpack XR SDK και προχωρά από ένα απλό πάνελ οδηγιών εργασίας στις δοκιμές σε εξομοιωτή και στην ανάπτυξη σε εξουσιοδοτημένο υλικό. Αυτή η προσέγγιση προσφέρει στις επιχειρήσεις έναν στοχευμένο τρόπο να αξιολογήσουν αν οι χωρικές οδηγίες βελτιώνουν μια πραγματική ροή εργασίας, πριν επενδύσουν σε ενσωματώσεις και σε ευρεία διάθεση σε στόλο συσκευών. Μόλις το πάνελ είναι ευανάγνωστο, εύχρηστο και επικυρωμένο στο Aura, το επόμενο βήμα είναι η σύνδεση εγκεκριμένων διαδικασιών και αξιόπιστων αρχείων εργασιών με τα συστήματα της εταιρείας.

Μιλήστε με τη VR Expert για τη διαθεσιμότητα του Aura και τις απαιτήσεις σε υλικό, ανάπτυξη λογισμικού και υποστήριξη για το επιχειρηματικό πιλοτικό σας πρόγραμμα.

João Noronha

Γράφτηκε από

João Noronha

Ειδικός XR και Εμβυθιστικού Περιεχομένου στην VR Expert

Ο João Noronha είναι Ειδικός XR και Εμβυθιστικού Περιεχομένου στην VR Expert, με ιδιαίτερο ενδιαφέρον για τις αναδυόμενες τεχνολογίες και τις πρακτικές εφαρμογές τους στον πραγματικό κόσμο. Επικεντρώνεται στη μετατροπή σύνθετων εξελίξεων στα πεδία VR, AR, γυαλιών AI και εμβυθιστικής τεχνολογίας σε σαφές, πρακτικό περιεχόμενο για επιχειρήσεις και επαγγελματίες που εξερευνούν τον κλάδο XR.

Συχνές ερωτήσεις

Αυτό το άρθρο

Ναι. Ξεκινήστε με τον εξομοιωτή Android XR Glasses για να αναπτύξετε τη διεπαφή και τη ροή εργασιών. Οι δοκιμές σε φυσικό Aura παραμένουν απαραίτητες πριν από ένα πιλοτικό πρόγραμμα σε χώρο εργασίας.

Όχι. Το Android Studio, το Kotlin και το Jetpack Compose for XR ταιριάζουν σε αυτό το παράδειγμα που εστιάζει στη διεπαφή. Το Unity είναι μια ξεχωριστή μηχανή ανάπτυξης που μπορεί να είναι κατάλληλη για έργα με εκτεταμένο διαδραστικό τρισδιάστατο περιεχόμενο.

Όχι. Παρέχει δυνατότητες XR. Η ομάδα σας πρέπει ακόμη να υλοποιήσει και να επικυρώσει τις απαιτήσεις ασφάλειας, αποθήκευσης δεδομένων, ταυτότητας, διανομής, υποστήριξης και ενσωμάτωσης.

Όχι. Εμφανίζει τοπικά αποθηκευμένο κείμενο και καταγράφει τις επιβεβαιώσεις στην κατάσταση του UI. Η αναγνώριση εξοπλισμού, η κατανόηση σκηνής και τα επαληθευμένα αρχεία εργασιών απαιτούν πρόσθετο σχεδιασμό και υλοποίηση.

Αυτό το παράδειγμα δεν υλοποιεί μόνιμη φυσική άγκυρα (anchor). Η άγκυρα είναι ένα χωρικό σημείο αναφοράς που χρησιμοποιείται για την τοποθέτηση περιεχομένου σε σχέση με μια θέση· η τοποθέτηση σε συγκεκριμένο μηχάνημα απαιτεί πρόσθετη υποστηριζόμενη ροή εργασίας αγκύρωσης και επικύρωση στη συσκευή.