Δημιουργία εφαρμογής για το XREAL One Pro με το Unity SDK

Δημιουργία εφαρμογής για το XREAL One Pro με το Unity SDK

Σύνοψη

Αυτός ο οδηγός για το Unity SDK του XREAL One Pro δείχνει σε προγραμματιστές και επιχειρηματικές ομάδες πώς να δημιουργήσουν και να δοκιμάσουν μια εφαρμογή με το XREAL SDK 3.1.0. Το πρώτο αποτέλεσμα είναι ένα Android APK που ανοίγει μέσω του XREAL Control Glasses σε ένα υποστηριζόμενο τηλέφωνο. Ξεκινήστε με το επίσημο δείγμα Hello MR και, στη συνέχεια, προσθέστε ένα απλό πάνελ επιχειρηματικών οδηγιών αν χρειάζεται να εμφανίσετε το δικό σας περιεχόμενο ροής εργασιών.

Το πρώτο build του Hello MR δεν απαιτεί προσαρμοσμένο κώδικα. Μια εμπειρία προσαρμοσμένη στις ανάγκες της επιχείρησης απαιτεί όμως εργασία ανάπτυξης στο Unity, όταν οι ομάδες προσθέτουν δικά τους βήματα, στοιχεία ελέγχου, ροή δεδομένων, έλεγχο ταυτότητας ή σύνδεση με backend. Το XREAL One Pro είναι μια συνδεδεμένη οθόνη και όχι αυτόνομος υπολογιστής, επομένως την εφαρμογή την εκτελεί το υποστηριζόμενο τηλέφωνο. Επιβεβαιώστε τη συμβατότητα, τα δικαιώματα, τη διαχείριση δεδομένων και τη διαχείριση συσκευών με την εσωτερική τεχνική σας ομάδα πριν από μια ευρύτερη εγκατάσταση.

Εισαγωγή

Η ροή εργασίας του Unity SDK για το XREAL One Pro είναι ένας πρακτικός τρόπος για να δοκιμάσετε μια hands-free επιχειρηματική διεπαφή, όπως μια λίστα εργασιών, μια προβολή απομακρυσμένης καθοδήγησης ή μια σύντομη οδηγία εργασίας. Δείτε τη σελίδα του XREAL One Pro στο VR Expert για μια επισκόπηση της συσκευής. Ο οδηγός αυτός εστιάζει στη διαδρομή ανάπτυξης στο Unity και στους ελέγχους που έχουν σημασία πριν από ένα επιχειρηματικό πιλοτικό πρόγραμμα: υποστηριζόμενο τηλέφωνο-host, σωστό plug-in της XREAL, δικαιώματα Android και ένα σαφές πρώτο build.

Απαιτήσεις του Unity SDK για το XREAL One Pro

  • Διαδρομή ανάπτυξης: XREAL SDK για Unity. Ο οδηγός αυτός δεν καλύπτει εγγενή ανάπτυξη σε Android, Java ή Kotlin.
  • Τρέχουσα τεκμηρίωση SDK: Έκδοση 3.1.0 κατά τη στιγμή του ελέγχου. Ελέγξτε τις πιο πρόσφατες σημειώσεις έκδοσης της XREAL πριν από την ανάπτυξη ή τη διάθεση.
  • Εκδόσεις Unity στον οδηγό γρήγορης εκκίνησης: Unity 2021.3 LTS, 2022.3 LTS ή Unity 6000.0 LTS με Android Build Support.
  • Υποστηριζόμενη συσκευή-host: Η XREAL αναφέρει το Beam Pro ή υποστηριζόμενα τηλέφωνα Android· ο οδηγός γρήγορης εκκίνησης κατονομάζει τις ναυαρχίδες της σειράς Samsung S24 και τις μεταγενέστερες σειρές. Οι σημειώσεις της έκδοσης 3.1.0 αναφέρουν το Beam Pro και το Samsung S25 ως δοκιμασμένα συμβατά.
  • Παρακολούθηση στο One Pro: Ξεκινήστε με 3DoF. Το XREAL SDK 3.1.0 προσθέτει 6DoF για τη σειρά One με προσαρτημένο το XREAL Eye και ενημερωμένο firmware γυαλιών.
  • Σύνδεση τηλεφώνου: Το τηλέφωνο χρειάζεται έξοδο βίντεο DisplayPort μέσω USB C και, ξεχωριστά, συμβατότητα ως host με το XREAL SDK. Η έξοδος οθόνης από μόνη της δεν αποδεικνύει υποστήριξη του SDK.

Πριν ανοίξετε το Unity

· Υποστηριζόμενο τηλέφωνο-host: Χρησιμοποιήστε το Beam Pro ή ένα τηλέφωνο που αναφέρεται ως συμβατό στην τρέχουσα τεκμηρίωση SDK της XREAL. Ο οδηγός γρήγορης εκκίνησης αναφέρει προς το παρόν τις ναυαρχίδες της σειράς Samsung S24 και τις επόμενες σειρές· οι σημειώσεις της έκδοσης 3.1.0 αναφέρουν το Beam Pro και το Samsung S25 ως δοκιμασμένα συμβατά host (η XREAL δοκιμάζει το S24 σε Android 14 και το S25 σε Android 15). Κατά προτίμηση, μην αναβαθμίσετε το τηλέφωνο σε Android 16, καθώς η τεκμηρίωση της XREAL περιλαμβάνει την επισήμανση «Μην αναβαθμίζετε τις συσκευές ανάπτυξής σας σε Android 16», και απενεργοποιήστε το Samsung DeX κατά την ανάπτυξη.

· Unity: Εγκαταστήστε έναν editor Unity LTS από αυτούς που αναφέρει η XREAL, με Android Build Support. Αν λείπει, προσθέστε το Android Build Support από το Unity Hub > Installs > (ο editor σας) > Add modules.

· Εργαλεία Android SDK: Εγκαταστήστε το Android SDK 12.0 (API 31) ή νεότερο από το Android Studio > More Actions > SDK Manager ή από το Tools > SDK Manager σε ένα ανοιχτό έργο του Android Studio. Πρόκειται μόνο για την αλυσίδα εργαλείων build του Android για το Unity, όχι για ροή εργασιών εγγενούς εφαρμογής.

· SDK και runtime: Κατεβάστε το XREAL SDK for Unity 3.1.0 από τη σελίδα λήψεων για προγραμματιστές της XREAL. Αποκτήστε το ControlGlasses 3.1.0 από τον σύνδεσμο στις σημειώσεις έκδοσης του SDK 3.1.0· η σελίδα λήψεων εξακολουθεί να αναφέρει το παλαιότερο build 1.1.0, το οποίο αντιστοιχεί στο SDK 3.0.0. Ελέγξτε τις τρέχουσες σημειώσεις firmware πριν από τη δοκιμή.

· Όροι SDK και ενημέρωση για τα δεδομένα: Πριν από την ανάπτυξη, διαβάστε και αποδεχτείτε τους τρέχοντες όρους XREAL APIs Terms. Η XREAL απαιτεί από τους προγραμματιστές να γνωστοποιούν πώς το SDK συλλέγει και επεξεργάζεται δεδομένα στην εφαρμογή και συνιστά να αναφέρεται το XREAL SDK μαζί με σύνδεσμο προς την πολιτική απορρήτου του. Προσθέστε αυτή την ενημέρωση παράλληλα με τις πληροφορίες απορρήτου και τη διαδικασία ελέγχου του δικού σας οργανισμού.

· Καλώδιο γυαλιών: Χρησιμοποιήστε σύνδεση USB C που υποστηρίζει βίντεο DisplayPort. Επιβεβαιώστε ότι το τηλέφωνο είναι επίσης host που υποστηρίζεται από το SDK, καθώς πρόκειται για ξεχωριστό έλεγχο.

Δημιουργία και εκτέλεση της πρώτης εφαρμογής για το XREAL One Pro

Βήμα 1 Δημιουργήστε ένα έργο Unity για Android

· Ανοίξτε το Unity Hub. Επιλέξτε Projects και μετά New project.

· Επιλέξτε πρότυπο. Επιλέξτε ένα πρότυπο 3D, δώστε ένα σαφές όνομα έργου, όπως `BusinessXREALPilot`, και κάντε κλικ στο Create project.

· Μεταβείτε σε Android. Στο Unity Editor, ανοίξτε το File > Build Settings ή, στο Unity 6, το Android Build Profile. Επιλέξτε Android και πατήστε Switch Platform.

Έλεγχος: Η πλατφόρμα Android είναι επιλεγμένη και το Unity έχει ολοκληρώσει την εισαγωγή του έργου.

Βήμα 2 Εγκαταστήστε τα πακέτα XR του Unity

· Ανοίξτε το Package Manager. Στο Unity Editor, επιλέξτε Window > Package Manager.

· Επιλέξτε το Unity Registry. Χρησιμοποιήστε το μενού πηγής πακέτων πάνω αριστερά και, στη συνέχεια, αναζητήστε το XR Interaction Toolkit.

· Εγκαταστήστε το toolkit. Επιλέξτε το XR Interaction Toolkit (η XREAL υποστηρίζει τις εκδόσεις 2.5.x και 3.0.x) και κάντε κλικ στο Install. Ανοίξτε την καρτέλα Samples και εισαγάγετε τα Starter Assets και Hands Interaction Demo· σύμφωνα με τις σημειώσεις αντιμετώπισης προβλημάτων της XREAL, το HelloMR εμφανίζει prefabs που λείπουν αν δεν υπάρχει το δείγμα για τα χέρια.

· Κρατήστε το πρώτο build μικρό. Παραλείψτε το AR Foundation. Ο πίνακας συμβατότητας της XREAL χαρακτηρίζει την παρακολούθηση επιπέδων, την παρακολούθηση εικόνων, την παρακολούθηση χεριών, το depth mesh και τα spatial anchors ως μη υποστηριζόμενα στη σειρά XREAL One, με ή χωρίς το πρόσθετο κάμερας· οι λειτουργίες αυτές απαιτούν το Air 2 Ultra, οπότε ένα πρωτότυπο για το One Pro δεν μπορεί να τις χρησιμοποιήσει.

Έλεγχος: Το XR Interaction Toolkit εμφανίζεται στο έργο και το δείγμα Starter Assets έχει εισαχθεί.

Βήμα 3 Εισαγάγετε το XREAL SDK για Unity

· Ανοίξτε το μενού πακέτων. Στο Package Manager, κάντε κλικ στο κουμπί συν και επιλέξτε Add package from tarball.

· Επιλέξτε το αρχείο του SDK. Εντοπίστε το αρχείο `com.xreal.xr.tar.gz` που κατεβάσατε και κάντε κλικ στο Open.

· Εισαγάγετε το πρώτο δείγμα. Επιλέξτε το XREAL XR Plugin στο Package Manager, ανοίξτε τα Samples και εισαγάγετε το Interaction Basics. Αφήστε έξω το δείγμα AR Features: οι λειτουργίες επιπέδων, εικόνων και anchors που περιέχει δεν εκτελούνται στη σειρά One.

Έλεγχος: Το XREAL XR Plugin εμφανίζεται στο Package Manager και το Interaction Basics είναι διαθέσιμο για εισαγωγή.

Βήμα 4 Ενεργοποιήστε το plug-in της XREAL για Android

· Ανοίξτε τα Project Settings. Επιλέξτε Edit > Project Settings > XR Plug in Management.

· Επιλέξτε Android. Ανοίξτε την καρτέλα Android και τσεκάρετε το XREAL.

· Εφαρμόστε τις διορθώσεις του έργου. Αν εμφανιστεί το Project Validation με προειδοποιήσεις, ανοίξτε το και κάντε κλικ στο Fix All δίπλα στις απαιτούμενες διορθώσεις. Περιμένετε μέχρι το Unity να ολοκληρώσει την αλλαγή των ρυθμίσεων.

Έλεγχος: Η καρτέλα Android δείχνει το XREAL ενεργοποιημένο και τα απαιτούμενα στοιχεία επικύρωσης έχουν διορθωθεί.

Βήμα 5 Ορίστε την υποστήριξη συσκευής και την παρακολούθηση για το One Pro

· Ανοίξτε τη σελίδα ρυθμίσεων της XREAL. Στα Project Settings, επιλέξτε XR Plug in Management > XREAL.

· Ελέγξτε την κατηγορία συσκευής. Στην ενότητα Support Devices, ενεργοποιήστε την κατηγορία Vision για τα γυαλιά της σειράς XREAL One.

· Επιλέξτε τον τύπο παρακολούθησης. Ορίστε το Initial Tracking Type σε MODE_3DOF για γυαλιά One Pro χωρίς XREAL Eye. Ορίστε MODE_6DOF μόνο όταν είναι προσαρτημένο το XREAL Eye και το firmware των γυαλιών έχει ενημερωθεί όπως προβλέπεται για το SDK 3.1.0.

· Επιλέξτε είσοδο για το πρωτότυπο. Ορίστε το Initial Input Source σε Controller, ώστε το υποστηριζόμενο τηλέφωνο Android να λειτουργεί ως χειριστήριο της εφαρμογής. Η ακτίνα του χειριστηρίου ρυθμίζεται στο Βήμα 11.

Έλεγχος: Το έργο είναι ρυθμισμένο για τη σειρά XREAL One και η λειτουργία παρακολούθησης αντιστοιχεί στο συνδεδεμένο υλικό.

Βήμα 6 Ορίστε τις τιμές build για Android

· Ανοίξτε τα Player Settings. Επιστρέψτε στο File > Build Settings ή στο Android Build Profile, επιλέξτε Player Settings και ανοίξτε τα Other Settings.

· Δώστε στην εφαρμογή ένα μοναδικό αναγνωριστικό. Εισαγάγετε ένα Package Name σε μορφή αντεστραμμένου domain, για παράδειγμα `com.companyname.workflowpilot`. Μην αφήνετε το αναγνωριστικό του δείγματος σε έργο παραγωγής.

· Ορίστε την ταυτότητα της εφαρμογής. Στην ίδια περιοχή των Player Settings, ορίστε τα Company Name και Product Name με τα ονόματα του οργανισμού σας και της πιλοτικής εφαρμογής. Στο Resolution and Presentation, ορίστε το Default Orientation σε Portrait, όπως φαίνεται στον οδηγό γρήγορης εκκίνησης της XREAL.

· Ορίστε τις επιλογές γραφικών. Σύμφωνα με τον οδηγό γρήγορης εκκίνησης της XREAL, απενεργοποιήστε το Auto Graphics API και χρησιμοποιήστε OpenGLES3.

· Ορίστε τα επίπεδα API του Android. Ορίστε το Minimum API Level σε Android 10 ή νεότερο και το Target API Level σε Automatic (highest installed). Εγκαταστήστε το Android SDK API 31 ή νεότερο στο SDK Manager. Πρόκειται για ξεχωριστές ρυθμίσεις: τα εγκατεστημένα εργαλεία SDK και η ελάχιστη έκδοση της εφαρμογής.

· Ορίστε την αρχιτεκτονική Android. Στο Player Settings > Other Settings > Configuration, ενεργοποιήστε το ARM64 για το τηλέφωνο-στόχο και ορίστε το Scripting Backend σε IL2CPP όταν κάνετε build για ARM64. Η XREAL τεκμηριώνει αυτή την απαίτηση για τα builds ARM64.

Έλεγχος: Το έργο χρησιμοποιεί το αναγνωριστικό πακέτου και τις ρυθμίσεις Android που απαιτούνται για το build του Unity.

Βήμα 7 Περάστε τους ελέγχους του Android manifest και των δικαιωμάτων

· Χρησιμοποιήστε πρώτα το manifest που δημιουργείται αυτόματα. Το Unity και το πακέτο της XREAL δημιουργούν ή συγχωνεύουν καταχωρίσεις του Android manifest κατά το build. Μη δημιουργήσετε προσαρμοσμένο Android manifest για ένα βασικό δείγμα, εκτός αν το απαιτεί κάποια ρύθμιση της XREAL ή κάποια τεκμηριωμένη λειτουργία. Το κριτήριο για το manifest είναι ότι η τελική εφαρμογή δηλώνει τα δικαιώματα και τις ρυθμίσεις εφαρμογής που χρειάζονται οι λειτουργίες της.

· Επιλέξτε μόνο τα απαραίτητα δικαιώματα. Στο Project Settings > XR Plug in Management > XREAL, ανοίξτε τα Android Permissions. Ενεργοποιήστε το Camera μόνο για λειτουργία που βασίζεται στην κάμερα, το Audio μόνο όταν η εφαρμογή χρειάζεται πρόσβαση σε ήχο και το Vibration μόνο αν η εφαρμογή χρησιμοποιεί απτική ανάδραση.

· Επιτρέψτε το δικαίωμα εμφάνισης κατά την εκτέλεση. Όταν το Control Glasses ζητήσει δικαίωμα κατά την εκκίνηση, επιτρέψτε στο Control Glasses να εμφανίζεται πάνω από άλλες εφαρμογές. Αν κλείσατε το μήνυμα, ανοίξτε Android Settings > Apps > Special app access > Display over other apps > Control Glasses και ενεργοποιήστε το. Οι ακριβείς ετικέτες μπορεί να διαφέρουν ανάλογα με το τηλέφωνο.

Έλεγχος: Το πακέτο της XREAL είναι ρυθμισμένο μόνο για τα δικαιώματα που χρειάζεται το πρωτότυπό σας και το Control Glasses μπορεί να εμφανίζεται πάνω από άλλες εφαρμογές κατά την εκκίνηση.

Βήμα 8 Ανοίξτε το Hello MR και επιβεβαιώστε τη σκηνή

· Βρείτε το δείγμα που εισαγάγατε. Στο παράθυρο Project του Unity, ανοίξτε Assets > Samples > XREAL XR Plugin > την εγκατεστημένη έκδοση του πακέτου > Interaction Basics.

· Ανοίξτε τη σκηνή του δείγματος. Κάντε διπλό κλικ στο `HelloMR.unity`. Αν δεν υπάρχει, επιστρέψτε στο Window > Package Manager > XREAL XR Plugin > Samples και εισαγάγετε το Interaction Basics.

· Αποθηκεύστε τη σκηνή. Επιλέξτε File > Save. Ελέγξτε το Hierarchy και επιβεβαιώστε ότι τα αντικείμενα του δείγματος είναι ορατά.

Έλεγχος: Το Hello MR ανοίγει χωρίς να λείπουν assets του δείγματος. Το δείγμα αυτό σας δίνει μια βάση αναφοράς χωρίς προσαρμοσμένο κώδικα.

Βήμα 9 Προσθέστε ένα πάνελ επιχειρηματικών οδηγιών με C sharp στο Unity

· Αποφασίστε αν θα προσθέσετε κώδικα. Παραλείψτε αυτό το βήμα για να κάνετε build του αμετάβλητου δείγματος Hello MR. Προσθέστε το όταν θέλετε το πρωτότυπο να εμφανίζει το δικό σας κείμενο επιχειρηματικών οδηγιών.

· Δημιουργήστε ένα Canvas σε world space. Στο Hierarchy, κάντε δεξί κλικ > UI > Canvas. Στο Hierarchy, τοποθετήστε το Canvas απευθείας στη ρίζα της σκηνής ή κάτω από το XR Origin (μην το ορίσετε απευθείας ως θυγατρικό του Main Camera, ώστε να αποφύγετε το άκαμπτο κλείδωμα μπροστά στο πρόσωπο). Ορίστε το Render Mode σε World Space. Στο Rect Transform, ορίστε τη θέση σε X 0, Y 0, Z 1.5 (μπροστά από το σημείο εκκίνησης του χρήστη), την περιστροφή σε 0, 0, 0 και την κλίμακα σε 0.001 σε όλους τους άξονες.

· Προσθέστε το κείμενο εργασίας και κατάστασης. Στο Hierarchy, κάντε δεξί κλικ στο Canvas > UI > Text - TextMeshPro. Εισαγάγετε τα TMP Essentials αν σας το ζητήσει το Unity. Μετονομάστε το πρώτο αντικείμενο κειμένου σε InstructionText. Δημιουργήστε ένα δεύτερο αντικείμενο Text - TextMeshPro με το όνομα StatusText. Δώστε και στα δύο ευανάγνωστα πλαίσια κειμένου, για παράδειγμα πλάτος 900, ύψος 180 και μέγεθος γραμματοσειράς 42. Τοποθετήστε το StatusText κάτω από την οδηγία.

· Προσθέστε ένα κουμπί ολοκλήρωσης. Στο Hierarchy, κάντε δεξί κλικ στο Canvas > UI > Button - TextMeshPro. Μετονομάστε το σε MarkCompleteButton και ορίστε την ορατή ετικέτα του σε Mark complete. Αν η σκηνή δεν έχει EventSystem, δημιουργήστε ένα από το Hierarchy > δεξί κλικ > UI > Event System. Δημιουργήστε ένα C Sharp Script στα Assets με το όνομα BusinessChecklistDisplay και ανοίξτε το στον επεξεργαστή κώδικα που χρησιμοποιείτε με το Unity.

Έλεγχος: Η σκηνή έχει ένα Canvas σε world space, ένα αντικείμενο κειμένου TextMeshPro και ένα νέο αρχείο script σε C sharp.

using TMPro; using UnityEngine; using UnityEngine.UI;

public class BusinessChecklistDisplay : MonoBehaviour { [SerializeField] private TMP_Text instructionText; [SerializeField] private TMP_Text statusText; [SerializeField] private Button completeButton;

[TextArea(2, 5)] [SerializeField] private string instruction = "Review the assigned task.\nConfirm the required item.";

private void Start() { if (instructionText == null || statusText == null || completeButton == null) { Debug.LogError("Assign the text fields and button in the Inspector.", this); return; }

instructionText.text = instruction; statusText.text = "Status: Not complete"; completeButton.onClick.AddListener(MarkComplete); }

private void MarkComplete() { statusText.text = "Status: Complete (local demo)"; completeButton.interactable = false; }

private void OnDestroy() { if (completeButton != null) completeButton.onClick.RemoveListener(MarkComplete); } }

Εύρος για τους προγραμματιστές: Ο κώδικας αυτός εμφανίζει οδηγίες και αλλάζει την κατάσταση τοπικά όταν επιλεγεί το κουμπί. Δεν αποθηκεύει εργασία σε εταιρικό σύστημα, δεν ελέγχει την ταυτότητα χρήστη και δεν στέλνει δεδομένα μέσω δικτύου. Αυτές οι λειτουργίες απαιτούν κώδικα εφαρμογής που να ταιριάζει με τον σχεδιασμό API, ταυτότητας και διαχείρισης δεδομένων του οργανισμού σας. Μην τοποθετείτε διαπιστευτήρια ή πραγματικά επιχειρηματικά αρχεία στο APK.

Βήμα 10 Συνδέστε το script με το πάνελ οδηγιών

· Περιμένετε να ολοκληρωθεί η μεταγλώττιση στο Unity. Αποθηκεύστε το script στον επεξεργαστή κώδικα, επιστρέψτε στο Unity και περιμένετε μέχρι να εξαφανιστεί η ένδειξη μεταγλώττισης.

· Προσαρτήστε το script. Σύρετε το `BusinessChecklistDisplay` από το παράθυρο Project πάνω στο Canvas στο Hierarchy.

· Αντιστοιχίστε τα πεδία UI. Επιλέξτε το Canvas. Στο Inspector, βρείτε το Business Checklist Display. Σύρετε τα InstructionText και StatusText από το Hierarchy στα αντίστοιχα πεδία και, στη συνέχεια, σύρετε το MarkCompleteButton στο Complete Button.

· Ορίστε τις τιμές του δείγματος. Στο ίδιο component του Inspector, αντικαταστήστε το Instruction με εγκεκριμένη, μη εμπιστευτική διατύπωση επίδειξης. Αποθηκεύστε τη σκηνή. Μετά την επιλογή, το κουμπί αλλάζει το StatusText σε «Complete (local demo)»· δεν υποβάλλει ούτε αποθηκεύει πραγματικό επιχειρηματικό αποτέλεσμα.

Έλεγχος: Το Inspector δείχνει και τα δύο πεδία κειμένου και το κουμπί αντιστοιχισμένα, και το κείμενο κατάστασης αλλάζει όταν επιλέγετε Mark complete στο Unity Editor.

Βήμα 11 Ρυθμίστε την επιλογή με χειριστήριο για το UI

· Ορίστε το input module του EventSystem. Επιλέξτε το EventSystem στο Hierarchy. Αφαιρέστε το Standalone Input Module αν υπάρχει και, στη συνέχεια, χρησιμοποιήστε το Add Component για να προσθέσετε το XR UI Input Module. Αν είναι διαθέσιμο το preset των XRI Starter Assets, εφαρμόστε το XRI Default XR UI Input Module, ώστε το module να έχει τις αναμενόμενες ενέργειες εισόδου.

· Ορίστε το raycaster του Canvas. Επιλέξτε το Canvas. Αφαιρέστε το Graphic Raycaster και προσθέστε το Tracked Device Graphic Raycaster. Έτσι, μια ακτίνα παρακολουθούμενης συσκευής XR μπορεί να στοχεύσει το κουμπί.

· Ενεργοποιήστε την αλληλεπίδραση UI στην ακτίνα του χειριστηρίου. Στο XR Origin, επιλέξτε το αντικείμενο χειριστηρίου που διαθέτει XR Ray Interactor. Στην ενότητα UI Interaction, ενεργοποιήστε το Interaction with UI GameObjects. Διατηρήστε το Initial Input Source της XREAL ρυθμισμένο σε Controller, όπως στο Βήμα 5.

· Ελέγξτε τη διαδρομή του χειριστηρίου. Το δείγμα Interaction Basics θα πρέπει να παρέχει τα αντικείμενα χειριστηρίου και τις ενέργειες εισόδου. Αν το XR Origin δεν έχει XR Ray Interactor, εισαγάγετε το δείγμα XRI Starter Assets και χρησιμοποιήστε τη διαμόρφωση XR Origin/χειριστηρίου που περιέχει πριν κάνετε build.

Έλεγχος: Στο Unity Editor, η ακτίνα του χειριστηρίου επισημαίνει το κουμπί Mark complete και η επιλογή του αλλάζει το κείμενο κατάστασης. Επαναλάβετε τη δοκιμή στο υποστηριζόμενο τηλέφωνο και στα γυαλιά πριν χρησιμοποιήσετε τη ροή σε πιλοτικό πρόγραμμα.

Βήμα 12 Προαιρετικά: συνδέστε την ολοκλήρωση εργασιών με ένα επιχειρηματικό API

Όροι επιχειρηματικού API πριν από τον προγραμματισμό

· REST API: Μια διεύθυνση web και μια συμφωνημένη μορφή αιτημάτων που επιτρέπουν στην εφαρμογή να ανταλλάσσει δεδομένα με μια εταιρική υπηρεσία.

· Access token: Ένα διαπιστευτήριο σύντομης διάρκειας που εκδίδεται μετά από εγκεκριμένη σύνδεση· η εφαρμογή το στέλνει για να αποδείξει ότι ο χρήστης έχει δικαίωμα να εκτελέσει την ενέργεια.

· Κλειδί idempotency: Ένα μοναδικό αναγνωριστικό αιτήματος που επιτρέπει στον διακομιστή να αναγνωρίζει μια επανάληψη και να αποφεύγει την αποθήκευση της ίδιας ολοκλήρωσης δύο φορές.

· HTTPS: Κρυπτογραφημένη επικοινωνία δικτύου που προστατεύει τα δεδομένα κατά τη μετάδοσή τους μεταξύ τηλεφώνου και διακομιστή.

· Ορίστε πρώτα τη σύμβαση του εταιρικού API. Ζητήστε από την ομάδα πλατφόρμας σας το endpoint HTTPS, τα αποδεκτά πεδία JSON, την πηγή ταυτότητας χρηστών, τον εκδότη των access tokens, την απόκριση επιτυχίας και την πολιτική επαναλήψεων. Το παρακάτω παράδειγμα στέλνει τα taskId, operatorId, requestId και completedAtUtc· αντιστοιχίστε τα με το εταιρικό σας API πριν από τη χρήση. Χρησιμοποιήστε αδιαφανή αναγνωριστικά εγκεκριμένα από τον οργανισμό σας, όχι ονόματα ή ευαίσθητα αρχεία.

· Ενεργοποιήστε την πρόσβαση στο δίκτυο για αυτό το build. Για την έκδοση της εφαρμογής με API, ανοίξτε Edit > Project Settings > Player > Android > Other Settings > Configuration και ορίστε το Internet Access σε Require. Κάντε ξανά build και ελέγξτε το συγχωνευμένο manifest για να επιβεβαιώσετε ότι υπάρχει το android.permission.INTERNET. Αυτό το δικαίωμα δεν εμφανίζει μήνυμα στο Android.

· Προσθέστε ένα script σύνδεσης. Στο Unity, δημιουργήστε το `BusinessTaskApi.cs`, επικολλήστε και τα δύο διαδοχικά μπλοκ κώδικα στο ίδιο αρχείο με τη σειρά και αποθηκεύστε το. Το δεύτερο μπλοκ συνεχίζει μέσα στο SubmitCompletion. Το endpoint είναι placeholder· αντικαταστήστε το με το εγκεκριμένο εταιρικό endpoint. Κρατήστε το access token εκτός Inspector, πηγαίου κώδικα, APK και αρχείων καταγραφής.

using System; using System.Collections; using System.Text; using UnityEngine; using UnityEngine.Networking;

[Serializable] public class TaskCompletionPayload { public string taskId; public string operatorId; public string requestId; public string completedAtUtc; }

public class BusinessTaskApi : MonoBehaviour { [SerializeField] private string completionEndpoint = "https://api.example.com/v1/task-completions";

public IEnumerator SubmitCompletion( string taskId, string operatorId, string accessToken, string requestId, Action<bool, string> onComplete) { if (string.IsNullOrWhiteSpace(taskId) || string.IsNullOrWhiteSpace(operatorId) || string.IsNullOrWhiteSpace(accessToken) || string.IsNullOrWhiteSpace(requestId)) { onComplete?.Invoke(false, "Missing task, user, token, or request ID."); yield break; }

if (!Uri.TryCreate(completionEndpoint, UriKind.Absolute, out Uri endpoint) || endpoint.Scheme != Uri.UriSchemeHttps) { onComplete?.Invoke(false, "Use the approved HTTPS API endpoint."); yield break; }

var payload = new TaskCompletionPayload { taskId = taskId, operatorId = operatorId, requestId = requestId, completedAtUtc = DateTime.UtcNow.ToString("o") }; byte[] body = Encoding.UTF8.GetBytes(JsonUtility.ToJson(payload));

using (var request = new UnityWebRequest(completionEndpoint, "POST")) { request.uploadHandler = new UploadHandlerRaw(body); request.downloadHandler = new DownloadHandlerBuffer(); request.timeout = 20; request.SetRequestHeader("Content-Type", "application/json"); request.SetRequestHeader("Authorization", "Bearer " + accessToken); request.SetRequestHeader("Idempotency-Key", requestId);

yield return request.SendWebRequest();

bool accepted = request.result == UnityWebRequest.Result.Success && request.responseCode >= 200 && request.responseCode < 300; string message = accepted ? "Completion accepted by the business system." : "Request failed (HTTP " + request.responseCode + "). " + request.error; onComplete?.Invoke(accepted, message); } } }

· Καλέστε το script σύνδεσης από το κουμπί. Προσθέστε ένα component `BusinessTaskApi` στο Canvas και αντιστοιχίστε το στο `taskApi` του `BusinessChecklistDisplay`. Αντικαταστήστε τη μέθοδο `MarkComplete`, που λειτουργεί μόνο τοπικά, με κλήση coroutine αφού το εταιρικό SDK ταυτότητας παράσχει έγκυρο access token και το επιχειρηματικό σύστημα παράσχει τα αναγνωριστικά εργασίας και χειριστή:

· Συνδέστε την ενέργεια με έλεγχο ταυτότητας. Στο υπάρχον script BusinessChecklistDisplay, το κουμπί καλεί προς το παρόν την τοπική μέθοδο MarkComplete. Για τη διαδρομή παραγωγής, αλλάξτε αυτόν τον handler ώστε η εγκεκριμένη εταιρική ροή σύνδεσης να λαμβάνει access token και να καλεί το SubmitToBusinessSystem(token). Μην προσθέσετε φόρμα ονόματος χρήστη/κωδικού πρόσβασης και μην αποθηκεύετε token στη σκηνή.

// Fields to add to BusinessChecklistDisplay: [SerializeField] private BusinessTaskApi taskApi; [SerializeField] private string taskId; // Set from your approved task source. [SerializeField] private string operatorId; // Set from your approved identity source. // Call this after obtaining a short-lived token from the company identity SDK. private void SubmitToBusinessSystem(string accessToken) { string requestId = System.Guid.NewGuid().ToString("N"); StartCoroutine(taskApi.SubmitCompletion( taskId, operatorId, accessToken, requestId, HandleCompletionResult)); } private void HandleCompletionResult(bool accepted, string message) { statusText.text = accepted ? "Status: Submitted" : "Status: Not submitted"; Debug.Log(message); // Do not log tokens or sensitive business data. }

Σημαντικό: Το `accessToken` πρέπει να προέρχεται από τον εγκεκριμένο πάροχο σύνδεσης κατά την εκτέλεση. Το παραπάνω όνομα συνάρτησης είναι σημείο παράδοσης, όχι πλήρης υλοποίηση ταυτότητας. Ρυθμίστε εξουσιοδότηση στην πλευρά του API για την εργασία και τον χρήστη, επικυρώνετε κάθε πεδίο στον διακομιστή, χρησιμοποιείτε σταθερό αναγνωριστικό αιτήματος κατά τις επαναλήψεις και μην απενεργοποιείτε το κουμπί μέχρι ο διακομιστής να αποδεχτεί το αίτημα. Προσαρμόστε το script σύνδεσης στο σχήμα απόκρισης του API σας και στην έκδοση του Unity πριν από την παραγωγή.

Έλεγχος: Σε περιβάλλον δοκιμών, επιβεβαιώστε ότι ένα εξουσιοδοτημένο αίτημα γίνεται αποδεκτό, ότι ένα ληγμένο ή μη εξουσιοδοτημένο token απορρίπτεται, ότι η λήξη χρονικού ορίου αφήνει την εργασία εμφανώς μη υποβληθείσα και ότι η επανάληψη με το ίδιο αναγνωριστικό αιτήματος δεν δημιουργεί διπλότυπο.

Βήμα 13 Προσθέστε τη σκηνή Hello MR στο build για Android

· Ανοίξτε το παράθυρο build. Επιλέξτε File > Build Settings. Στο Scenes In Build, κάντε κλικ στο Add Open Scenes και επιβεβαιώστε ότι το HelloMR εμφανίζεται στη λίστα και είναι τσεκαρισμένο.

· Για το Unity 6. Ανοίξτε το ενεργό Android Build Profile και προσθέστε την τρέχουσα ανοιχτή σκηνή HelloMR στη λίστα σκηνών του.

Έλεγχος: Το build για Android περιλαμβάνει τη σκηνή που μόλις δοκιμάσατε και προσαρμόσατε.

Βήμα 14 Δημιουργήστε το πρώτο APK

· Επιβεβαιώστε ότι το Android είναι ενεργό. Ελέγξτε την επιλεγμένη πλατφόρμα στα Build Settings ή στο Android Build Profile.

· Κάντε build της εφαρμογής. Κάντε κλικ στο Build, επιλέξτε φάκελο εξόδου και ονομάστε το αρχείο `BusinessXREALPilot.apk`.

· Ελέγξτε το τελικό manifest. Ανοίξτε το Android Studio, επιλέξτε Build > Analyze APK και, στη συνέχεια, το BusinessXREALPilot.apk. Στο AndroidManifest.xml, επαληθεύστε το όνομα πακέτου και επιβεβαιώστε ότι τα δηλωμένα δικαιώματα αντιστοιχούν στις λειτουργίες αυτού του πιλοτικού. Ελέγξτε το APK που δημιουργήθηκε, επειδή περιέχει το συγχωνευμένο manifest που θα εγκαταστήσει το Unity.

· Κρατήστε ένα αντίγραφο δοκιμής με αριθμό έκδοσης. Για ένα επιχειρηματικό πιλοτικό πρόγραμμα, αποθηκεύστε το APK μαζί με την έκδοση του Unity, την έκδοση του XREAL SDK, το μοντέλο τηλεφώνου και την ημερομηνία δοκιμής, ώστε η ομάδα να μπορεί να επαναλάβει το ίδιο build.

Έλεγχος: Το Unity δημιουργεί το APK χωρίς σφάλματα build και το τελικό manifest έχει ελεγχθεί πριν από την εγκατάσταση.

Βήμα 15 Εγκαταστήστε το APK σε υποστηριζόμενο τηλέφωνο Android

· Συνδέστε το τηλέφωνο στον υπολογιστή. Χρησιμοποιήστε USB ή ρυθμίστε ασύρματο ADB. Στο τηλέφωνο, ενεργοποιήστε τις Επιλογές για προγραμματιστές και τον εντοπισμό σφαλμάτων USB αν κάνετε εγκατάσταση με καλώδιο.

· Εγκαταστήστε το APK. Χρησιμοποιήστε το Build and Run του Unity ή εκτελέστε `adb install -r BusinessXREALPilot.apk` από ένα τερματικό όπου είναι διαθέσιμο το ADB.

· Αποδεχτείτε τα μηνύματα του Android. Επιβεβαιώστε στο τηλέφωνο τα μηνύματα εγκατάστασης και εντοπισμού σφαλμάτων. Κρατήστε το APK στο ίδιο υποστηριζόμενο τηλέφωνο που σκοπεύετε να χρησιμοποιήσετε με τα γυαλιά.

Έλεγχος: Η νέα εφαρμογή Unity εμφανίζεται στη λίστα εφαρμογών του τηλεφώνου.

Βήμα 16 Εκκινήστε την επιχειρηματική εφαρμογή μέσω του Control Glasses

· Συνδέστε τα γυαλιά. Αποσυνδέστε το τηλέφωνο από τον υπολογιστή ανάπτυξης και συνδέστε το XREAL One Pro στην έξοδο USB C DisplayPort του τηλεφώνου.

· Ανοίξτε την εφαρμογή runtime. Στο τηλέφωνο, ανοίξτε το Control Glasses. Βρείτε το `BusinessXREALPilot` στη λίστα εφαρμογών του και πατήστε το. Στο Beam Pro χρησιμοποιείται αντί αυτού το MyGlasses.

· Παραχωρήστε την πρόσβαση που ζητείται. Επιτρέψτε στο Control Glasses να εμφανίζεται πάνω από άλλες εφαρμογές, αν το ζητήσει το Android. Παραχωρήστε Camera, Audio ή Vibration μόνο αν η εφαρμογή Unity χρησιμοποιεί αυτές τις λειτουργίες και ζητά το αντίστοιχο δικαίωμα.

· Ελέγξτε το αποτέλεσμα. Επιβεβαιώστε ότι το Hello MR και το προαιρετικό πάνελ επιχειρηματικών οδηγιών είναι ορατά στα γυαλιά. Γυρίστε απαλά το κεφάλι σας για να επιβεβαιώσετε ότι η προβολή ακολουθεί την αναμενόμενη λειτουργία 3DoF.

Έλεγχος: Η εφαρμογή εκτελείται στο υποστηριζόμενο τηλέφωνο και η εικόνα της εμφανίζεται στο XREAL One Pro.

Έλεγχοι πιλοτικού προγράμματος πριν από ευρύτερη χρήση

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

· Επαληθεύστε τον ακριβή συνδυασμό τηλεφώνου και firmware. Μην υποθέτετε ότι μια σύνδεση βίντεο USB C σημαίνει συμβατότητα με το XREAL SDK.

· Επιβεβαιώστε την είσοδο και την αναγνωσιμότητα. Ελέγξτε το μέγεθος γραμματοσειράς, την αντίθεση, τη θέση και τον αριθμό των ενεργειών που απαιτούνται ενώ φοράτε τα γυαλιά.

· Εξετάστε τις απαιτήσεις της εταιρείας. Πριν από ευρύτερη χρήση, ελέγξτε τον έλεγχο ταυτότητας, την αποθήκευση δεδομένων, την πρόσβαση στο δίκτυο, τη διανομή ενημερώσεων, τη διαχείριση συσκευών και τις ισχύουσες απαιτήσεις απορρήτου, όπως ο GDPR.

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

Συμπέρασμα

Ένα επιχειρηματικά προσανατολισμένο πρωτότυπο για το XREAL One Pro ξεκινά στο Unity με το τρέχον XREAL SDK, ένα υποστηριζόμενο host Android, το plug-in και τις ρυθμίσεις συσκευής της XREAL, καθώς και τα σωστά δικαιώματα manifest και εκτέλεσης. Η σκηνή Hello MR παρέχει ένα πρώτο build χωρίς κώδικα, ενώ ένα μικρό component σε C sharp στο Unity μπορεί να προσθέσει ένα απλό πάνελ επιχειρηματικών οδηγιών πριν η ομάδα δημιουργήσει και εγκαταστήσει ένα APK. Εκκινήστε την εφαρμογή μέσω του Control Glasses και δοκιμάστε την με το ακριβές τηλέφωνο, firmware, περιεχόμενο και ροή εργασιών που έχουν προβλεφθεί για το πιλοτικό. Η διαδικασία αυτή βοηθά τις επιχειρήσεις να αξιολογήσουν αν το hands-free χωρικό λογισμικό ταιριάζει στις ανάγκες τους, να εντοπίσουν νωρίς τις τεχνικές απαιτήσεις και τις απαιτήσεις απορρήτου και να λάβουν πιο τεκμηριωμένες αποφάσεις πριν επενδύσουν σε ευρύτερη εγκατάσταση.

Εξερευνήστε τη σελίδα προϊόντος του XREAL One Pro για λεπτομέρειες σχετικά με το προϊόν και, στη συνέχεια, επικοινωνήστε με τη VR Expert για να συζητήσετε αν η συσκευή και η διάταξη λογισμικού ταιριάζουν στις απαιτήσεις ανάπτυξης και πιλοτικής εφαρμογής του οργανισμού σας.

Προτεινόμενος σχετικός σύνδεσμος: Κριτική του XREAL One Pro για επαγγελματίες