Σύνοψη
Για να αναπτύξετε εφαρμογές για το VITURE BEAST, ανοίξτε τη σελίδα Developer της VITURE και επιλέξτε το VITURE XR Glasses SDK. Πρόκειται για το cross-platform C SDK για τη σύνδεση λογισμικού με τα γυαλιά VITURE. Η τεκμηρίωσή του αναφέρει Android, Linux, Windows και macOS. Το ξεχωριστό VITURE XR SDK for Unity περιγράφεται για εμπειρίες που εκτελούνται στο VITURE Neckband, επομένως δεν αποτελεί το σημείο εκκίνησης για μια εφαρμογή ελέγχου των γυαλιών BEAST.
Το SDK των γυαλιών δίνει σε μια εφαρμογή πρόσβαση στην επικοινωνία με τη συσκευή, στα δεδομένα παρακολούθησης κεφαλής, στη ροή της κάμερας και σε επιλεγμένα χειριστήρια των γυαλιών. Ειδικά για το BEAST, η VITURE τεκμηριώνει εγγενή παρακολούθηση 3DoF, camera passthrough και εγγενή χειριστήρια οθόνης. Το SDK δεν μετατρέπει τα γυαλιά σε υπολογιστή γενικής χρήσης ούτε δημιουργεί αυτόματα μια ολοκληρωμένη εφαρμογή XR. Εσείς κατασκευάζετε μια εφαρμογή host, συνδέετε το BEAST μέσω USB και καλείτε το SDK από αυτή την εφαρμογή.
Ροή ανάπτυξης: Επιλέξτε την πλατφόρμα host -> κατεβάστε το αντίστοιχο πακέτο SDK -> κάντε build το πρώτο δείγμα σύνδεσης του κατασκευαστή -> διαβάστε δεδομένα παρακολούθησης -> προσθέστε έναν έλεγχο ή μια λειτουργία κάμερας του BEAST -> δοκιμάστε την εφαρμογή με τα γυαλιά.
Για πληροφορίες σχετικά με το προϊόν πριν σχεδιάσετε την ενσωμάτωση του λογισμικού, δείτε την κριτική του VITURE BEAST στο VRX. Η επίσημη σελίδα προϊόντος της VITURE είναι επίσης χρήσιμη για λεπτομέρειες σχετικά με το υλικό.
ΕΙΣΑΓΩΓΗ:
(αν γνωρίζετε ήδη το SDK και την υποστήριξη πλατφορμών, μεταβείτε στις κύριες οδηγίες)
Τι είναι το VITURE BEAST;
Το VITURE BEAST είναι μια οθόνη XR με USB-C, ενσωματωμένους αισθητήρες και κάμερα. Σε λειτουργία native, η δική του επεξεργασία χειρίζεται την παρακολούθηση 3DoF και τα υποστηριζόμενα εφέ οθόνης· σε λειτουργία bypass, ο host στέλνει ένα σήμα βίντεο το οποίο τα γυαλιά απλώς μεταβιβάζουν. Αυτή η διάκριση μεταξύ native και bypass έχει σημασία όταν το λογισμικό αλλάζει τη λειτουργία οθόνης ή τη συμπεριφορά της παρακολούθησης.
Το SDK για προγραμματιστές είναι λογισμικό με το οποίο συνδέεται (link) το πρόγραμμά σας, ώστε να μπορεί να επικοινωνεί με τα γυαλιά. Είναι ξεχωριστό από τις καθημερινές εφαρμογές της VITURE, όπως το SpaceWalker, το οποίο προορίζεται για τη χρήση υποστηριζόμενων λειτουργιών οθόνης και χωρικής οθόνης, όχι για τη συγγραφή κώδικα.
Τα δύο SDK της VITURE εξυπηρετούν διαφορετικούς σκοπούς
VITURE XR Glasses SDK:
- Σε τι χρησιμεύει: Εγγενές C API για πρόσβαση στη συσκευή γυαλιών, παρακολούθηση, ροή κάμερας και χειριστήρια συσκευής στις υποστηριζόμενες πλατφόρμες host.
- Κατάλληλο για ανάπτυξη στο BEAST;: Ναι. Αυτό είναι το SDK του BEAST που καλύπτει ο παρών οδηγός.
VITURE XR SDK for Unity:
- Σε τι χρησιμεύει: Πακέτο Unity XR, τεκμηριωμένο για τη δημιουργία καθηλωτικών εμπειριών στο VITURE Neckband, με ενσωματώσεις Unity όπως η παρακολούθηση χεριών.
- Κατάλληλο για ανάπτυξη στο BEAST;: Όχι ως το προεπιλεγμένο SDK για τα γυαλιά BEAST. Μην το συγχέετε με το εγγενές SDK των γυαλιών.
SpaceWalker:
- Σε τι χρησιμεύει: Συνοδευτικό λογισμικό της VITURE για υποστηριζόμενες λειτουργίες οθόνης και λειτουργίες χωρικής οθόνης.
- Κατάλληλο για ανάπτυξη στο BEAST;: Όχι. Είναι εφαρμογή για τελικούς χρήστες, όχι περιβάλλον ανάπτυξης.
Τι ελέγχει το XR Glasses SDK
Σύνδεση συσκευής:
- Τι μπορεί να κάνει η εφαρμογή: Να εντοπίσει μια συνδεδεμένη συσκευή, να δημιουργήσει ένα handle συσκευής, να την αρχικοποιήσει, να την εκκινήσει και να την κλείσει σωστά.
- Τι πρέπει να θυμάστε για το BEAST: Το SDK επικοινωνεί με τα γυαλιά μέσω της σύνδεσης με τον host.
Παρακολούθηση κεφαλής:
- Τι μπορεί να κάνει η εφαρμογή: Να διαβάζει δεδομένα προσανατολισμού/IMU και να χρησιμοποιεί τη διεπαφή παρακολούθησης που αντιστοιχεί στο συγκεκριμένο μοντέλο.
- Τι πρέπει να θυμάστε για το BEAST: Το BEAST είναι τεκμηριωμένο για εγγενές 3DoF· η καταχώριση 6DoF VIO στον πίνακα συσκευών αφορά το Luma Ultra.
Χειριστήρια οθόνης και γυαλιών:
- Τι μπορεί να κάνει η εφαρμογή: Να διαβάζει ή να ορίζει υποστηριζόμενες ρυθμίσεις φωτεινότητας, έντασης ήχου, λειτουργίας οθόνης, λειτουργίας 2D/3D, χρωματισμού (tint) και επιλογές της λειτουργίας native.
- Τι πρέπει να θυμάστε για το BEAST: Σε λειτουργία native, χρησιμοποιήστε τις σταθερές εγγενούς οθόνης που αφορούν ειδικά το BEAST. Ορισμένοι συνδυασμοί λειτουργίας/ρυθμού ανανέωσης δεν υποστηρίζονται.
Ροή κάμερας:
- Τι μπορεί να κάνει η εφαρμογή: Να αποκτά πρόσβαση σε υποστηριζόμενα καρέ της κάμερας passthrough μέσω του camera API του SDK.
- Τι πρέπει να θυμάστε για το BEAST: Το BEAST αναφέρεται με κάμερα passthrough UVC. Η πρόσβαση στην κάμερα είναι ξεχωριστή από την παρακολούθηση 6DoF.
Τι δεν παρέχει από μόνο του το SDK: τη ροή εργασιών της εφαρμογής σας, την επιχειρησιακή λογική, τα μενού, την αποθήκευση δεδομένων, τους λογαριασμούς χρηστών ή μια ολοκληρωμένη σκηνή Unity. Η ομάδα ανάπτυξης της εφαρμογής σας κατασκευάζει αυτά τα μέρη γύρω από τις λειτουργίες συσκευής που εκθέτει το SDK. Η κύρια σελίδα για προγραμματιστές προβάλλει αυτές τις τέσσερις πλατφόρμες. Από το SDK 2.4.0 (6 Αυγούστου 2026), η τεκμηρίωση αναφέρει έναν πέμπτο στόχο: Browser, ένα build WebAssembly με TypeScript API που επικοινωνεί με τα γυαλιά μέσω WebHID, μόνο σε Chrome και Chromium, με υποστήριξη για το BEAST και εξαίρεση του Luma Ultra. Ελέγξτε το τρέχον πακέτο και τις σημειώσεις έκδοσης πριν επιλέξετε συσκευή ή λειτουργικό σύστημα για παραγωγή.
Υποστήριξη πολλαπλών πλατφορμών: Android, Linux, Windows και macOS
«Cross-platform» σημαίνει ότι η VITURE παρέχει builds του SDK και οδηγίες ρύθμισης ειδικά για κάθε πλατφόρμα, για το ίδιο SDK γυαλιών. Δεν σημαίνει ότι ένα ενιαίο binary εκτελείται αμετάβλητο παντού. Επιλέξτε τον host όπου πρέπει να εκτελείται η εφαρμογή σας και, στη συνέχεια, χρησιμοποιήστε την αντίστοιχη βιβλιοθήκη και τον αντίστοιχο οδηγό ενσωμάτωσης. Η τρέχουσα τεκμηρίωση του API αναφέρει τις εξής αρχιτεκτονικές:
Windows:
- Τεκμηριωμένη αρχιτεκτονική: x86_64
- Τυπική διαδικασία ρύθμισης: Εφαρμογή desktop σε C/C++ με χρήση της βιβλιοθήκης και των headers του SDK για Windows· ακολουθήστε το Quick Start: Desktop (C++).
Linux:
- Τεκμηριωμένη αρχιτεκτονική: x86_64 και aarch64
- Τυπική διαδικασία ρύθμισης: Εφαρμογή desktop σε C/C++. Προσθέστε τον κανόνα udev της VITURE, ώστε η εφαρμογή να έχει πρόσβαση στη διεπαφή USB/HID χωρίς να εκτελείται ως root.
macOS:
- Τεκμηριωμένη αρχιτεκτονική: aarch64 (Apple silicon)
- Τυπική διαδικασία ρύθμισης: Εφαρμογή desktop σε C/C++ με χρήση της βιβλιοθήκης και των headers για macOS· ακολουθήστε το Quick Start: Desktop (C++).
Android:
- Τεκμηριωμένη αρχιτεκτονική: armeabi-v7a και arm64-v8a
- Τυπική διαδικασία ρύθμισης: Εφαρμογή Android που χρησιμοποιεί την εγγενή βιβλιοθήκη C μέσω JNI· η άδεια USB και η σύνδεση διαχειρίζονται μέσα στην εφαρμογή Android.
Η κύρια σελίδα για προγραμματιστές προβάλλει αυτές τις τέσσερις πλατφόρμες. Η αναλυτική σελίδα του API ενδέχεται να προσθέσει στόχους ή να αλλάξει τις υποστηριζόμενες αρχιτεκτονικές με την πάροδο του χρόνου, γι' αυτό ελέγξτε το τρέχον πακέτο και τις σημειώσεις έκδοσης πριν επιλέξετε συσκευή ή λειτουργικό σύστημα για παραγωγή.
Τι χρειάζεστε πριν ξεκινήσετε την ανάπτυξη
· Γυαλιά VITURE BEAST και σύνδεση δεδομένων USB-C με τον υπολογιστή ή τον host Android που σκοπεύετε να υποστηρίξετε.
· Έναν υπολογιστή ανάπτυξης με τον compiler/τα εργαλεία build για τον στόχο σας: ένα toolchain C/C++ και CMake για desktop ή το Android Studio με τα στοιχεία NDK και CMake για Android.
· Το πακέτο VITURE XR Glasses SDK για την πλατφόρμα-στόχο, από τη σελίδα Developer της VITURE.
· Την αντίστοιχη τεκμηρίωση του SDK, ιδίως τα Core Concepts, Quick Start: Desktop (C++), Android Integration Guide, Head Tracking, Device Control, Camera Streaming και Native-DOF Devices.
· Βασική γνώση της γλώσσας που χρησιμοποιεί η ομάδα της εφαρμογής σας: C/C++ για τα παραδείγματα desktop, καθώς και Kotlin ή Java και JNI για μια τυπική ενσωμάτωση σε Android.
Πώς να δημιουργήσετε μια πρώτη δοκιμή με το SDK του VITURE BEAST
Ξεκινήστε με μια μικρή εφαρμογή host που εντοπίζει το BEAST και διαβάζει δεδομένα παρακολούθησης. Μόλις λειτουργήσει αυτό, προσθέστε έναν έλεγχο ή μια λειτουργία κάμερας.
Βήμα 1: Επιλέξτε πού θα εκτελείται η εφαρμογή σας
Επιλέξτε τον υπολογιστή ή το τηλέφωνο στο οποίο θα εκτελείται η εφαρμογή σας· αυτό καθορίζει το πακέτο SDK και τον οδηγό ρύθμισης.
1. Επιλέξτε τον host. Χρησιμοποιήστε Windows, Linux ή macOS για υπολογιστή ή Android για τηλέφωνο συνδεδεμένο με το BEAST.
2. Σημειώστε το λειτουργικό σύστημα και τον επεξεργαστή του. Για παράδειγμα, καταγράψτε Windows x86_64 ή macOS Apple silicon και, στη συνέχεια, ελέγξτε τον παραπάνω πίνακα πλατφορμών.
3. Ακολουθήστε τη διαδρομή Android μόνο για εφαρμογή Android. Χρησιμοποιεί εγγενή βιβλιοθήκη, γέφυρα JNI και άδεια USB.
Βήμα 2: Κατεβάστε το VITURE XR Glasses SDK
Κατεβάστε το επίσημο SDK των γυαλιών και ανοίξτε τον οδηγό για τον host σας. Το πακέτο Unity για το Neckband προορίζεται για διαφορετική διαμόρφωση.
1. Ανοίξτε τη σελίδα Developer. Σε ένα πρόγραμμα περιήγησης, μεταβείτε στη διεύθυνση https://www.viture.com/developer και κάντε κύλιση μέχρι το «VITURE XR Glasses SDK».
2. Κατεβάστε το πακέτο της πλατφόρμας σας. Στην κάρτα του SDK, κάντε κλικ στο «Download» και επιλέξτε τον host σας, αν σας ζητηθεί.
3. Ανοίξτε τον οδηγό ρύθμισης. Στην ίδια κάρτα, κάντε κλικ στο «Documents», μετά στο «Core Concepts» και έπειτα στο «Quick Start: Desktop (C++)» ή στο «Android Integration Guide».
4. Ελέγξτε τη συμβατότητα. Επιστρέψτε στη σελίδα Developer, ανοίξτε τα «Release Notes» και ελέγξτε το λειτουργικό σύστημα, τον επεξεργαστή και το firmware του BEAST.
Προχωρήστε στο Βήμα 3 όταν: έχετε την αντίστοιχη βιβλιοθήκη, τα headers και τον οδηγό ρύθμισης.
Βήμα 3: Ρυθμίστε το SDK στην πλατφόρμα host
Ακολουθήστε μόνο τη διαδρομή ρύθμισης για τον host που επιλέξατε στο Βήμα 1.
Για Windows, Linux ή macOS
1. Ανοίξτε τον οδηγό για desktop. Στα SDK Documents, επιλέξτε «Quick Start: Desktop (C++)» και κρατήστε τον ανοιχτό δίπλα στον επεξεργαστή κώδικα.
2. Συνδέστε (link) το SDK. Ανοίξτε το δείγμα ή το έργο σας και, στη συνέχεια, χρησιμοποιήστε το παράδειγμα CMake του οδηγού για να προσθέσετε τα headers του SDK και τη βιβλιοθήκη των γυαλιών.
Στο `CMakeLists.txt` του έργου σας, προσθέστε τις διαδρομές include και βιβλιοθήκης του SDK. Αντικαταστήστε το `VITURE_SDK_ROOT` με τον φάκελο όπου αποσυμπιέσατε το SDK:
target_include_directories(my_xr_app PRIVATE "${VITURE_SDK_ROOT}/include")
target_link_directories(my_xr_app PRIVATE "${VITURE_SDK_ROOT}/lib")
target_link_libraries(my_xr_app PRIVATE glasses)
3. Μόνο για Linux: επιτρέψτε την πρόσβαση USB. Στο Terminal, ακολουθήστε το «Linux udev Rule» και δημιουργήστε το `/etc/udev/rules.d/70-viture.rules`· φορτώστε ξανά τους κανόνες και επανασυνδέστε το BEAST. Παραλείψτε το σε Windows και macOS.
4. Κάντε build το δείγμα. Ανοίξτε το `main.cpp` του παραδείγματος του SDK και βεβαιωθείτε ότι γίνεται build πριν προσθέσετε λειτουργίες.
Για Android
1. Δημιουργήστε ένα έργο Android. Στο Android Studio, ξεκινήστε ένα έργο με υποστήριξη CMake/NDK και ανοίξτε το `app/src/main` στο πλαίσιο του έργου.
2. Αντιγράψτε τα αρχεία του SDK. Ακολουθήστε το «Android Integration Guide»: τοποθετήστε τα headers στο `app/src/main/include/` και το αντίστοιχο αρχείο `.so` στο `app/src/main/jniLibs/<ABI>/`.
3. Συνδέστε (link) τη βιβλιοθήκη. Στο Android Studio, ανοίξτε τα `app/src/main/cpp/CMakeLists.txt` και `app/build.gradle.kts`· εφαρμόστε τις ρυθμίσεις CMake, NDK και ABI του οδηγού.
Στο `CMakeLists.txt`, εισαγάγετε τη βιβλιοθήκη του SDK και συνδέστε την με τη γέφυρα JNI. Το παράδειγμα αυτό υποθέτει ότι τα αρχεία του SDK βρίσκονται στους φακέλους που υποδεικνύει το Android Integration Guide:
add_library(glasses SHARED IMPORTED)
set_target_properties(glasses PROPERTIES IMPORTED_LOCATION
"${CMAKE_SOURCE_DIR}/../jniLibs/arm64-v8a/libglasses.so")
add_library(glasses_bridge SHARED glasses_bridge.cpp)
target_include_directories(glasses_bridge PRIVATE "${CMAKE_SOURCE_DIR}/../include")
target_link_libraries(glasses_bridge glasses android log)
4. Προσθέστε τη γέφυρα από την εφαρμογή προς τη C++. Στον φάκελο πηγαίου κώδικα της εφαρμογής, δημιουργήστε την κλάση `GlassesBridge` του οδηγού· οι συναρτήσεις `external` της καλούν τον κώδικα JNI σας.
5. Ζητήστε άδεια USB. Χρησιμοποιήστε το `UsbManager` του Android για να εντοπίσετε το BEAST· αφού ο χρήστης πατήσει Allow, ανοίξτε τη σύνδεση USB και περάστε τον file descriptor της στη γέφυρα.
Αφού ο χρήστης πατήσει Allow, ανοίξτε τη σύνδεση USB στο Kotlin activity σας και περάστε τον file descriptor της στην εγγενή γέφυρα. Αντικαταστήστε το `GlassesBridge` με το όνομα της κλάσης γέφυρας του έργου σας:
val connection = usbManager.openDevice(device) ?: return val ok = GlassesBridge.create(device.productId, connection.fileDescriptor)
Στο `glasses_bridge.cpp`, η εγγενής συνάρτηση create περνά αυτόν τον file descriptor του Android στο SDK της VITURE:
static XRDeviceProviderHandle g_handle = nullptr;
extern "C" JNIEXPORT jboolean JNICALL Java_com_example_GlassesBridge_create(JNIEnv*, jobject, jint pid, jint fd) { g_handle = xr_device_provider_create((int)pid, (int)fd); return g_handle != nullptr; }
Προχωρήστε στο Βήμα 4 όταν: η εφαρμογή σας γίνεται build και φορτώνει το SDK χωρίς σφάλμα αρχείου που λείπει ή σφάλμα linker.
Βήμα 4: Συνδέστε το BEAST και εκτελέστε το πρώτο δείγμα
Τώρα δοκιμάστε τη σύνδεση με τα γυαλιά. Χρησιμοποιήστε το δείγμα για desktop σε Windows, Linux ή macOS. Στο Android, διατηρήστε τη ρύθμιση USB και JNI από το Βήμα 3· μη χρησιμοποιείτε κώδικα εντοπισμού HID για desktop.
1. Συνδέστε το BEAST. Χρησιμοποιήστε καλώδιο δεδομένων USB-C· στο Android, αποδεχτείτε το μήνυμα USB του τηλεφώνου.
2. Εντοπίστε το BEAST και δημιουργήστε το handle του. Σε desktop, βρείτε το product ID του BEAST μέσω εντοπισμού HID και, στη συνέχεια, δημιουργήστε τον provider με xr_device_provider_create(product_id). Στο Android, περάστε τόσο το product ID όσο και τον file descriptor από τη σύνδεση USB.
3. Ξεκινήστε την παρακολούθηση. Ξεκινήστε την παρακολούθηση καταχωρίζοντας ένα callback. Callback είναι μια συνάρτηση που καλεί το SDK όταν φτάνουν δεδομένα παρακολούθησης. Το BEAST παρέχει roll, pitch και yaw στα data[0] έως data[2] και το quaternion στα data[3] έως data[6], αλλά μόνο με SDK 2.4.0 ή νεότερο και ενημερωμένο firmware γυαλιών. Με παλαιότερο firmware, το pose callback δεν ενεργοποιείται ποτέ στο BEAST (η VITURE το αναφέρει στην ενότητα «Known Limitations on Beast» των σημειώσεων έκδοσης): σε αυτή την περίπτωση, είτε καταχωρίστε το xr_device_provider_register_imu_raw_callback και ολοκληρώστε (integrate) μόνοι σας τα ακατέργαστα δεδομένα IMU, είτε θέστε τα γυαλιά σε λειτουργία native και αφήστε τα να αναλάβουν την παρακολούθηση.
Προσθέστε αυτή τη συνάρτηση πάνω από τη main():
</> C++ static void on_pose(float* data, uint64_t timestamp) {
std::printf(
"Timestamp: %llu | Roll: %.2f | Pitch: %.2f | Yaw: %.2f\n",
static_cast<unsigned long long>(timestamp),
data[0], data[1], data[2]
);
}
Καταχωρίστε το callback πριν αρχικοποιήσετε και εκκινήσετε το SDK:
</> C++ xr_device_provider_register_imu_pose_callback(handle, on_pose);
int rc = xr_device_provider_initialize(handle, nullptr, nullptr);
if (rc != VITURE_GLASSES_SUCCESS) return rc;
rc = xr_device_provider_start(handle);
if (rc != VITURE_GLASSES_SUCCESS) return rc;
Σε desktop χρησιμοποιήστε το handle. Στον κώδικα JNI του Android, χρησιμοποιήστε το g_handle.
4. Ανοίξτε τη ροή παρακολούθησης. Προσθέστε αυτή την κλήση στο `main.cpp` για desktop· στο Android, εκθέστε την μέσω JNI και καλέστε την μετά το `start`.
rc = xr_device_provider_open_imu( handle, VITURE_IMU_MODE_POSE, VITURE_IMU_FREQUENCY_HIGH); if (rc != VITURE_GLASSES_SUCCESS) return rc;
Όταν η εφαρμογή τερματίζεται, κλείστε το IMU και, στη συνέχεια, σταματήστε, τερματίστε και καταστρέψτε τον provider. Στο Android, καλέστε τις ίδιες συναρτήσεις εκκαθάρισης πριν κλείσετε τη σύνδεση USB:
xr_device_provider_close_imu(handle, VITURE_IMU_MODE_POSE); xr_device_provider_stop(handle); xr_device_provider_shutdown(handle); xr_device_provider_destroy(handle);
5. Ελέγξτε την έξοδο. Εκτελέστε την εφαρμογή και αναζητήστε ενημερώσεις σύνδεσης και παρακολούθησης στην κονσόλα του desktop ή στο Logcat του Android Studio.
Προχωρήστε στο Βήμα 5 όταν: το BEAST συνδέεται και οι ενημερώσεις παρακολούθησης φτάνουν χωρίς σφάλματα.
Βήμα 5: Προσθέστε έναν έλεγχο του BEAST
Αφού λειτουργήσει η παρακολούθηση, προσθέστε έναν έλεγχο των γυαλιών στον κώδικα ελέγχου συσκευής της εφαρμογής σας, μετά την εκκίνηση του handle του SDK.
1. Επιλέξτε έναν έλεγχο. Στα SDK Documents, ανοίξτε το «Device Control» και ελέγξτε τις υποστηριζόμενες επιλογές φωτεινότητας, έντασης ήχου ή οθόνης του BEAST.
2. Διαβάστε και ορίστε την τιμή του. Προσθέστε τις κλήσεις C/C++ στον κώδικα ελέγχου· στο Android, τοποθετήστε τις στο `glasses_bridge.cpp` και εκθέστε τις μέσω JNI.
Αφού εκκινήσετε τον provider, διαβάστε τη φωτεινότητα του BEAST και δοκιμάστε μια υποστηριζόμενη τιμή. Το τεκμηριωμένο εύρος είναι από 0 έως 8:
int brightness = xr_device_provider_get_brightness_level(handle); int rc = xr_device_provider_set_brightness_level(handle, 5); if (rc != VITURE_GLASSES_SUCCESS) { std::fprintf(stderr, "Brightness update failed: %d\n", rc); }
3. Αντιστοιχίστε το API οθόνης με τη λειτουργία. Μπορείτε επίσης να διαμορφώσετε τη λειτουργία οθόνης του BEAST. Η λειτουργία native χρησιμοποιεί την ενσωματωμένη επεξεργασία οθόνης των γυαλιών και υποστηρίζει εγγενές 3DoF. Η λειτουργία bypass μεταβιβάζει το σήμα βίντεο του host μέσω των γυαλιών. Επιλέξτε το σκέλος που αντιστοιχεί στη λειτουργία που έχει επιλέξει η εφαρμογή σας. Μην εκτελείτε και τα δύο σκέλη το ένα μετά το άλλο.
Σε αυτό το παράδειγμα, το use_native_mode είναι μια ρύθμιση τύπου Boolean στην εφαρμογή σας και το rc είναι η υπάρχουσα μεταβλητή αποτελέσματος.
</> C++ if (use_native_mode) {
rc = xr_device_provider_native_set_mode(handle, 1);
if (rc != VITURE_GLASSES_SUCCESS) return rc;
rc = xr_device_provider_native_set_display_mode(
handle, VITURE_NATIVE_DISPLAY_MODE_1920_1200_60HZ);
if (rc != VITURE_GLASSES_SUCCESS) return rc;
rc = xr_device_provider_native_set_dof(handle, VITURE_NATIVE_DOF_3);
if (rc != VITURE_GLASSES_SUCCESS) return rc;
} else {
rc = xr_device_provider_native_set_mode(handle, 0);
if (rc != VITURE_GLASSES_SUCCESS) return rc;
rc = xr_device_provider_set_display_mode(
handle, VITURE_DISPLAY_MODE_3840_1200_90HZ);
if (rc != VITURE_GLASSES_SUCCESS) return rc;
}
Επιλέξτε ανάλυση και ρυθμό ανανέωσης που υποστηρίζει το BEAST.
4. Δοκιμάστε μία αλλαγή. Εκτελέστε την εφαρμογή, ελέγξτε το αποτέλεσμα στο BEAST και, στη συνέχεια, επαναφέρετε την αρχική ρύθμιση.
Σημαντικό: Το BEAST υποστηρίζει εγγενές 3DoF, αλλά το τρέχον firmware δέχεται μόνο τρεις λειτουργίες οθόνης: 1920 x 1200 στα 60 Hz και 3D side-by-side 3840 x 1200 στα 60 Hz σε λειτουργία native, καθώς και 3840 x 1200 στα 90 Hz σε λειτουργία bypass (σημειώσεις έκδοσης του VITURE XR Glasses SDK, 2.3.0 και 2.3.1). Άλλες σταθερές περνούν τον έλεγχο του SDK, αλλά τα γυαλιά τις απορρίπτουν ή τις αγνοούν, γι' αυτό διαβάστε ξανά τη λειτουργία αφού την ορίσετε και θεωρήστε τις σημειώσεις έκδοσης ως τη λίστα των υποστηριζόμενων τιμών.
Βήμα 6: Προσθέστε πρόσβαση στην κάμερα μόνο αν τη χρειάζεται η εφαρμογή
Προσθέστε την κάμερα passthrough μόνο αν η εφαρμογή σας χρειάζεται καρέ εικόνας. Η ροή κάμερας είναι ξεχωριστή από την παρακολούθηση κεφαλής και δεν παρέχει 6DoF.
1. Ανοίξτε τον οδηγό της κάμερας. Στα SDK Documents, επιλέξτε «Camera Streaming» και ακολουθήστε την ενότητα ρύθμισης για τον host σας.
2. Προσθέστε έναν χειριστή καρέ. Στην εφαρμογή σας, δημιουργήστε μια συνάρτηση που λαμβάνει καρέ από την κάμερα και τα στέλνει στη λειτουργία που τα χρειάζεται, όπως μια προεπισκόπηση.
Στο module κάμερας σε C++, δημιουργήστε τον camera provider του BEAST και εκκινήστε τον με το callback καρέ σας, `on_frame`. Αυτή η κλήση με δύο ορίσματα αφορά το desktop:
int camera_vid = xr_camera_provider_get_camera_vid(pid); int camera_pid = xr_camera_provider_get_camera_pid(pid); XRCameraProviderHandle camera = xr_camera_provider_create(camera_vid, camera_pid); int rc = xr_camera_provider_start(camera, on_frame, nullptr);
// When finished xr_camera_provider_stop(camera); xr_camera_provider_destroy(camera);
Στο Android, περάστε τον file descriptor USB της κάμερας ως τρίτο όρισμα, χρησιμοποιώντας τη ρύθμιση αδειών από το Βήμα 3:
XRCameraProviderHandle camera = xr_camera_provider_create(camera_vid, camera_pid, camera_fd);
3. Αποκτήστε πρώτα άδεια. Το Android χρειάζεται άδειες κάμερας και USB· σε desktop, ακολουθήστε τον οδηγό της πλατφόρμας.
4. Προστατέψτε την ιδιωτικότητα. Εξηγήστε τη χρήση της κάμερας, καταγράφετε μόνο ό,τι χρειάζεται η λειτουργία και ακολουθήστε τη διαδικασία GDPR του οργανισμού σας στην ΕΕ.
Παραλείψτε αυτό το βήμα αν η εφαρμογή σας χρειάζεται μόνο παρακολούθηση ή χειριστήρια οθόνης.
Βήμα 7: Δοκιμάστε και προετοιμάστε ένα μικρό πιλοτικό
1. Δοκιμάστε την επανασύνδεση. Επανεκκινήστε την εφαρμογή, αποσυνδέστε και επανασυνδέστε το BEAST και ελέγξτε ότι η εφαρμογή παραμένει σταθερή.
2. Δοκιμάστε στο BEAST. Ελέγξτε τη λειτουργία οθόνης, την ανάλυση, την παρακολούθηση και τις άδειες κάμερας κάθε λειτουργίας σε σχέση με το firmware.
3. Αποθηκεύστε τα στοιχεία των δοκιμών. Καταγράψτε τις εκδόσεις SDK, λειτουργικού συστήματος, επεξεργαστή, compiler/NDK και firmware, τα στοιχεία σύνδεσης και τα σφάλματα.
4. Σχεδιάστε τη διάθεση. Αποφασίστε πώς θα εγκαθιστάτε και θα ενημερώνετε την εφαρμογή host, πώς θα διαχειρίζεστε την πρόσβαση στην κάμερα και τα δεδομένα και πώς θα παρέχετε υποστήριξη.
Κριτήριο πιλοτικού: επεκταθείτε μόνο αφού δοκιμάσετε τον host, τις λειτουργίες, τις άδειες και τη διαδικασία ενημέρωσης.
Τι δεν κάνει το SDK
Το VITURE XR Glasses SDK είναι ένα εργαλείο ενσωμάτωσης συσκευής, όχι ένα ολοκληρωμένο περιβάλλον δημιουργίας περιεχομένου XR. Εκθέτει συναρτήσεις που μπορεί να καλεί το λογισμικό σας. Η ομάδα σας εξακολουθεί να επιλέγει framework εφαρμογής, να γράφει τη διεπαφή χρήστη και τη λογική των εργασιών, να κάνει build την εφαρμογή για την πλατφόρμα host και να αποφασίζει πώς η επιχείρηση θα τη διαθέσει και θα την υποστηρίξει.
Επίσης, δεν καθιστά διαθέσιμη κάθε δυνατότητα σε κάθε μοντέλο VITURE. Στον τρέχοντα πίνακα υλικού, το BEAST αναφέρεται με εγγενές 3DoF και πρόσβαση σε κάμερα passthrough, ενώ το Luma Ultra είναι το μοντέλο που αναφέρεται με 3/6DoF και stereo VIO. Ελέγξτε τον πίνακα υποστηριζόμενου υλικού για κάθε API που σκοπεύετε να χρησιμοποιήσετε, αντί να ερμηνεύετε τη γενική περιγραφή «3DoF/6DoF» της πύλης ως υπόσχεση ότι το BEAST υποστηρίζει κάθε λειτουργία παρακολούθησης.
Συνηθισμένα λάθη κατά την ανάπτυξη με το SDK του VITURE BEAST
- Λήψη του Unity XR SDK για εφαρμογή ελέγχου των γυαλιών BEAST.: Χρησιμοποιήστε την κάρτα VITURE XR Glasses SDK· ο οδηγός Unity είναι τεκμηριωμένος για το VITURE Neckband.
- Η υπόθεση ότι cross-platform σημαίνει το ίδιο binary ή την ίδια ρύθμιση παντού.: Κατεβάστε τη σωστή βιβλιοθήκη και ακολουθήστε τον οδηγό αρχιτεκτονικής και σύνδεσης της πλατφόρμας-στόχου.
- Η αντιμετώπιση του BEAST ως συσκευής 6DoF VIO επειδή η πύλη αναφέρει 6DoF.: Ελέγξτε την υποστήριξη ανά μοντέλο: ο τρέχων πίνακας του SDK αναφέρει εγγενές 3DoF για το BEAST και 6DoF VIO για το Luma Ultra.
- Κλήση τυπικών συναρτήσεων λειτουργίας οθόνης ενώ το BEAST βρίσκεται σε λειτουργία native.: Ελέγξτε την ενεργή λειτουργία και χρησιμοποιήστε το αντίστοιχο σύνολο συναρτήσεων, τις τυπικές ή τις `native_*`.
- Άνοιγμα της κάμερας πριν από τη χορήγηση αδειών ή χωρίς σενάριο χρήσης κάμερας.: Ζητήστε πρώτα τις άδειες της πλατφόρμας και προσθέστε ροή κάμερας μόνο όταν η εφαρμογή χρειάζεται δεδομένα εικόνας.
- Χρήση του SpaceWalker ως επεξεργαστή κώδικα ή εφαρμογής ρύθμισης του SDK.: Χρησιμοποιήστε τη σελίδα Developer, το πακέτο SDK, την τεκμηρίωση και έναν επεξεργαστή κώδικα ή το Android Studio.
Συμπέρασμα
Η ανάπτυξη για το VITURE BEAST ξεκινά με το VITURE XR Glasses SDK, όχι με το πακέτο Unity για εμπειρίες στο Neckband ούτε με την καταναλωτική εφαρμογή SpaceWalker. Επιλέξτε Android, Linux, Windows ή macOS ως host, κατεβάστε το αντίστοιχο SDK από τη σελίδα Developer της VITURE, ακολουθήστε τον οδηγό της πλατφόρμας και κατασκευάστε πρώτα ένα μικρό πρόγραμμα που συνδέεται μέσω USB και διαβάζει δεδομένα παρακολούθησης. Από εκεί και πέρα, προσθέστε έναν υποστηριζόμενο έλεγχο ή μια λειτουργία κάμερας του BEAST και δοκιμάστε τα στο πραγματικό υλικό. Για τις επιχειρήσεις, αυτή η προσέγγιση διαχωρίζει τη ροή εργασιών και τα δεδομένα της εφαρμογής από τις λειτουργίες συσκευής των γυαλιών, επιτρέπει την ανάπτυξη στην πλατφόρμα host που ταιριάζει στην εκάστοτε εγκατάσταση και δίνει στις ομάδες έναν τρόπο να επικυρώσουν ένα στοχευμένο βιομηχανικό σενάριο χρήσης πριν επενδύσουν σε ευρύτερη διάθεση.
Σχεδιάζετε μια ροή εργασιών XR για το VITURE BEAST; Εξερευνήστε τη σελίδα προϊόντος του VITURE BEAST και την τεκμηρίωση της VITURE για προγραμματιστές πριν καθορίσετε τις απαιτήσεις του πιλοτικού σας.
























