Σύνοψη
Ένα περιβάλλον ανάπτυξης για το Rokid Glass3 επιτρέπει σε μια επιχειρησιακή ομάδα να δημιουργεί εφαρμογές Android για τα [Rokid AI Glasses Enterprise](https://ai.vr-expert.com/en/ai-glasses/rokid-ai-glasses) και να δοκιμάζει την επικοινωνία με ένα τηλέφωνο Android. Ξεκινήστε με enterprise firmware, το Android Studio, το JDK 17, το αποθετήριο Maven της Rokid και το καλώδιο δεδομένων και αποσφαλμάτωσης του Glass3. Το συνηθισμένο καλώδιο φόρτισης δεν μπορεί να εγκαταστήσει ούτε να αποσφαλματώσει την εφαρμογή των γυαλιών.
Αυτή η ροή εργασιών για Windows 11 ανοίγει τα δύο επίσημα demo projects της Rokid, ελέγχει τη διαμόρφωση build τους, εγκαθιστά κάθε εφαρμογή και στέλνει ένα δείγμα μηνύματος εργασίας στα γυαλιά. Χρησιμοποιεί το enterprise SDK και μια τοπική δοκιμή επικοινωνίας. Οι online υπηρεσίες ομιλίας και AI αποτελούν ξεχωριστές ενσωματώσεις. Οι οδηγίες ελέγχθηκαν με βάση την επίσημη τεκμηρίωση και τον πηγαίο κώδικα των demo· δεν πραγματοποιήθηκε εκτέλεση σε φυσική συσκευή.
Για πληροφορίες σχετικά με το υλικό, δείτε τη σελίδα προϊόντος Rokid AI Glasses Enterprise. Η Rokid τεκμηριώνει την αρχιτεκτονική και το περιβάλλον εκτέλεσης αυτής της enterprise συσκευής στο πλαίσιο του Glass3 Enterprise SDK. Επιβεβαιώστε με τον προμηθευτή σας τη συσκευή και το firmware που παραλάβατε προτού θεωρήσετε κάποιο άλλο προϊόν Rokid συμβατό.
Απαιτήσεις για την ανάπτυξη στο Rokid Glass3
Υλικό: PC με Windows 11, Rokid Glass3 Enterprise (με enterprise firmware), αποκλειστικό τηλέφωνο Android για δοκιμές (συνιστάται Android 13+) και το καλώδιο δεδομένων και αποσφαλμάτωσης του Glass3.
Λογισμικό: Android Studio με Android SDK Platform 34 και Build-Tools 35.0.0.
Περιβάλλον build: JDK 17, AGP 8.4.2, Gradle 8.6 και Kotlin 2.2.0.
SDK: Glasses SDK και Phone SDK 2.2.0-E.
Βήμα 1 Προετοιμάστε το enterprise υλικό
· Επιβεβαιώστε το σύστημα: Το firmware είναι το ενσωματωμένο λογισμικό συστήματος των γυαλιών. Ζητήστε από τον προμηθευτή σας το μοντέλο των γυαλιών, την έκδοση του εγκατεστημένου enterprise firmware και τη συμβατότητα με το SDK. Σύμφωνα με τις Συχνές Ερωτήσεις της Rokid, οι εκδόσεις για επαγγελματική χρήση περιέχουν συνήθως το e στον αριθμό έκδοσης. Χρησιμοποιήστε το enterprise demo με enterprise firmware. Το όνομα του προϊόντος από μόνο του δεν αποδεικνύει τη συμβατότητα.
· Ελέγξτε το καλώδιο: Φροντίστε να προμηθευτείτε ρητά το καλώδιο δεδομένων και αποσφαλμάτωσης του Glass3. Κατά την εγκατάσταση του demo, συνδέστε το απευθείας στον υπολογιστή ανάπτυξης. Η επιτυχής φόρτιση δεν αποδεικνύει ότι λειτουργεί η μεταφορά δεδομένων μέσω USB.
· Προετοιμάστε τη δοκιμή: Φορτίστε και τις δύο συσκευές και κρατήστε τες κοντά τη μία στην άλλη. Χρησιμοποιήστε ένα αποκλειστικό τηλέφωνο και το δείγμα μηνύματος του Βήματος 10. Πριν από τη σύζευξη, αποσυνδέστε οποιοδήποτε άλλο τηλέφωνο είχε συνδεθεί προηγουμένως με αυτά τα γυαλιά.
Το καλώδιο δεδομένων και αποσφαλμάτωσης του Glass3, όπως εμφανίζεται στον Οδηγό γρήγορης εκκίνησης της Rokid. Αυτό είναι το καλώδιο που απαιτείται για την ενσύρματη διαδικασία ανάπτυξης.
Το συνηθισμένο καλώδιο φόρτισης του Glass3, όπως το παρουσιάζει η Rokid. Δεν μπορεί να αντικαταστήσει το καλώδιο δεδομένων και αποσφαλμάτωσης. Επιβεβαιώστε με τον προμηθευτή τη λειτουργία του καλωδίου που παρέχεται.
Βήμα 2 Εγκαταστήστε το Android Studio και το Android SDK (αν είναι ήδη εγκατεστημένα, προχωρήστε στο επόμενο βήμα)
· Κατεβάστε το πρόγραμμα εγκατάστασης: Κατεβάστε και εγκαταστήστε το Android Studio από τη διεύθυνση https://developer.android.com/studio.
· Ανοίξτε την εφαρμογή: Ανοίξτε το Android Studio. Στην πρώτη εκκίνηση, επιλέξτε Do not import settings αν σας προταθεί, και έπειτα επιλέξτε τον τύπο Standard για την εγκατάσταση. Ελέγξτε τις άδειες χρήσης του SDK, αποδεχτείτε όσες έχουν εγκριθεί για την εταιρεία σας και ολοκληρώστε τη λήψη των στοιχείων.
· Εγκαταστήστε τα απαιτούμενα πακέτα: Από την οθόνη υποδοχής, κάντε κλικ στο More Actions > SDK Manager. Στην ενότητα SDK Platforms, επιλέξτε Android 14 / API 34. Στην ενότητα SDK Tools, επιλέξτε Android SDK Platform-Tools. Ενεργοποιήστε την επιλογή Show Package Details, αναπτύξτε το Android SDK Build-Tools και επιλέξτε 35.0.0. Αξίζει να σημειωθεί ότι το Android Gradle Plugin του demo εγκαθιστά τα build tools 34.0.0 που χρειάζεται κατά τον πρώτο συγχρονισμό. Κάντε κλικ στο Apply, ελέγξτε τη λίστα πακέτων και, στη συνέχεια, κάντε κλικ στο OK για εγκατάσταση.
· Αποθηκεύστε τη θέση του SDK: Σημειώστε τη διαδρομή Android SDK Location για τη ρύθμιση του ADB στο Βήμα 8.
Βήμα 3 Κατεβάστε και ανοίξτε τα δύο demo projects
· Αποκτήστε τον πηγαίο κώδικα: Στο πρόγραμμα περιήγησης, μεταβείτε στο επίσημο αποθετήριο του enterprise demo για το Glass3 (π.χ. https://github.com/RokidSuuport/glass3_sdk_demo.git – αξίζει να σημειωθεί ότι πρόκειται πράγματι για το επίσημο αποθετήριο Git, παρότι η λέξη Support είναι γραμμένη λάθος) ή στο αποθετήριο Git που σας έχει δώσει ο προμηθευτής σας. Κάντε κλικ στο πράσινο κουμπί Code και, στη συνέχεια, στο Download ZIP. Στο File Explorer > Downloads, κάντε δεξί κλικ στο ZIP και επιλέξτε Extract All > Extract. Αποθηκεύστε τον φάκελο που εξήχθη σε μια θέση ανάπτυξης εγκεκριμένη από την εταιρεία.
· Ανοίξτε το project του τηλεφώνου: Στην οθόνη υποδοχής του Android Studio, κάντε κλικ στο Open. Περιηγηθείτε μέσα στον φάκελο που εξήχθη, επιλέξτε glass3sdkphonedemo και κάντε κλικ στο OK. Αν εμφανιστεί ερώτηση εμπιστοσύνης, ελέγξτε ότι πρόκειται για την επίσημη πηγή που κατεβάσατε πριν την εμπιστευτείτε. Ο εξωτερικός φάκελος του αποθετηρίου δεν είναι το project Android.
· Ανοίξτε το project των γυαλιών: Επιλέξτε File > Open, επιλέξτε τον γειτονικό φάκελο glassdemo και, όταν σας ζητηθεί, επιλέξτε New Window. Κρατήστε ανοιχτά και τα δύο παράθυρα. Το καθένα έχει τη δική του διαμόρφωση Gradle και ένα module app, δηλαδή το τμήμα που δημιουργεί την εγκαταστάσιμη εφαρμογή.
· Χρησιμοποιήστε την προβολή αρχείων: Σε κάθε παράθυρο, ανοίξτε το View > Tool Windows > Project. Στο αναπτυσσόμενο μενού στο επάνω μέρος του αριστερού πλαισίου, επιλέξτε Project. Έτσι εμφανίζονται οι πραγματικοί φάκελοι και τα αρχεία που χρησιμοποιούνται παρακάτω. Αν ο πρώτος συγχρονισμός αναφέρει σφάλμα, ολοκληρώστε τα Βήματα 4 και 5 πριν δοκιμάσετε ξανά.
Βήμα 4 Επιλέξτε το JDK 17 και για τα δύο projects
· Ανοίξτε τις ρυθμίσεις Gradle: Στο παράθυρο του project του τηλεφώνου, επιλέξτε File > Settings > Build, Execution, Deployment > Build Tools > Gradle. Βρείτε το αναπτυσσόμενο μενού Gradle JDK. Αυτό καθορίζει την έκδοση Java που χρησιμοποιείται για το build του project, ανεξάρτητα από το Java runtime με το οποίο εκκινείται το Android Studio.
· Επιλέξτε ή κατεβάστε τη Java 17: Επιλέξτε ένα εγκατεστημένο JDK με την ένδειξη 17. Αν δεν εμφανίζεται κανένα, επιλέξτε Download JDK, επιλέξτε Version 17, επιλέξτε έναν πάροχο εγκεκριμένο από το τμήμα IT και κάντε κλικ στο Download. Επιλέξτε το JDK που κατεβάσατε στο Gradle JDK και, στη συνέχεια, κάντε κλικ στο Apply > OK. Επαναλάβετε τη διαδικασία στο παράθυρο του project των γυαλιών.
· Διατηρήστε τους υπάρχοντες στόχους κώδικα: Οι ρυθμίσεις sourceCompatibility, targetCompatibility και το Kotlin jvmTarget του demo χρησιμοποιούν την τιμή 1.8. Αυτές περιγράφουν τη συμβατότητα του μεταγλωττισμένου κώδικα· δεν σημαίνουν ότι το Gradle πρέπει να εκτελείται σε JDK 8. Αφήστε τες αμετάβλητες για αυτό το demo. Ο οδηγός της Google για το build με Java εξηγεί τη διαφορά ανάμεσα σε αυτές τις ρυθμίσεις.
Βήμα 5 Ελέγξτε τις εξαρτήσεις Maven και ευθυγραμμίστε τα build tools
Ένα αποθετήριο Maven είναι ένας διακομιστής από τον οποίο το Gradle βρίσκει πακέτα βιβλιοθηκών, συμπεριλαμβανομένου του SDK της Rokid.
· Ελέγξτε το αποθετήριο: Στο αριστερό πλαίσιο κάθε project, κάντε διπλό κλικ στο settings.gradle. Βρείτε το dependencyResolutionManagement > repositories και επιβεβαιώστε ότι υπάρχει η διεύθυνση URL του Maven της Rokid που φαίνεται παρακάτω. Προσθέστε μόνο τη γραμμή που λείπει μέσα στο υπάρχον μπλοκ. Διατηρήστε τα υπόλοιπα αποθετήρια του demo για τις άλλες εξαρτήσεις του· αν κάποιος εταιρικός proxy τα μπλοκάρει, ζητήστε από το τμήμα IT να εγκρίνει την πρόσβαση.
// Μέσα στο settings.gradle > dependencyResolutionManagement
repositories {
google()
mavenCentral()
maven { url = uri("https://maven.rokid.com/repository/maven-public/") }
}
· Ελέγξτε τα δύο πακέτα SDK: Ανοίξτε το app > build.gradle σε κάθε παράθυρο. Στο dependencies, διατηρήστε μία ενεργή καταχώριση για το σωστό SDK. Τα παρακάτω αποσπάσματα είναι σε Groovy, τη σύνταξη που χρησιμοποιεί αυτό το demo. Μην προσθέσετε το SDK των γυαλιών στο project του τηλεφώνου και μην επικολλήσετε δεύτερο μπλοκ dependencies. Το org.slf4j είναι μια ομάδα βιβλιοθηκών καταγραφής· η εξαίρεση αποτρέπει τις διπλότυπες κλάσεις καταγραφής.
// glassdemo/app/build.gradle > dependencies
implementation("com.rokid.security:glass3.open.sdk:2.2.0-E") {
exclude group: "org.slf4j"
}
// glass3sdkphonedemo/app/build.gradle > dependencies
implementation("com.rokid.security:phone.sdk:2.2.0-E") {
exclude group: "org.slf4j"
}
· Ευθυγραμμίστε AGP και Gradle: Η Kotlin είναι η γλώσσα προγραμματισμού που χρησιμοποιούν αυτά τα demo. Για το snapshot που εξετάστηκε, ανοίξτε το gradle > libs.versions.toml και στα δύο projects. Στην ενότητα [versions], αλλάξτε μόνο το agp σε 8.4.2 αν δεν έχει ήδη αυτή την τιμή· διατηρήστε το kotlin = "2.2.0". Στη συνέχεια, ανοίξτε το gradle > wrapper > gradle-wrapper.properties και αντικαταστήστε μόνο το distributionUrl με την παρακάτω γραμμή. Το wrapper κατεβάζει την επιλεγμένη έκδοση του Gradle. Η Google τεκμηριώνει τον συνδυασμό Gradle και JDK για το AGP 8.10.
# gradle/libs.versions.toml > [versions]
agp = "8.4.2"
kotlin = "2.2.0"
# gradle/wrapper/gradle-wrapper.properties
distributionUrl=https\://services.gradle.org/distributions/gradle-8.11.1-bin.zip
· Συγχρονίστε και ελέγξτε το αποτέλεσμα: Αποθηκεύστε τα αρχεία που επεξεργαστήκατε και, στη συνέχεια, επιλέξτε File > Sync Project with Gradle Files και στα δύο παράθυρα. Ανοίξτε το View > Tool Windows > Build και ελέγξτε την έξοδο του συγχρονισμού. Μην αποδεχτείτε άσχετες αυτόματες αναβαθμίσεις. Το demo περιλαμβάνει ήδη κανόνες πακεταρίσματος για native βιβλιοθήκες· διατηρήστε τους. Μια native βιβλιοθήκη είναι μεταγλωττισμένος κώδικας συσκευής που πακετάρεται μαζί με το APK.
Βήμα 6 Διαμορφώστε ένα τοπικό επιχειρησιακό demo
· Απενεργοποιήστε τις online υπηρεσίες για αυτή τη δοκιμή: Στο project του τηλεφώνου, ανοίξτε το app > src > main > java > com > rokid > phone > ui > MainPhoneActivity.kt. Στην αρχή του MainPhoneActivity.kt, διατηρήστε το υπάρχον import του NetServiceType. Αν λείπει, προσθέστε την ακόλουθη γραμμή μαζί με τα υπόλοιπα imports:
Kotlin
import com.rokid.security.phone.sdk.base.data.NetServiceType
Στη συνέχεια, βρείτε το banServiceList μέσα στη initSDK(). Αντικαταστήστε την ενεργή δήλωσή του με την παρακάτω γραμμή. Διατηρήστε τα υπάρχοντα κενά πεδία του UserAuthInfo και τα client IDs. Ο πηγαίος κώδικας τεκμηριώνει αυτή την επιλογή για την απενεργοποίηση των υπηρεσιών δικτύου· δεν απενεργοποιεί την τοπική δοκιμή Bluetooth.
val banServiceList: List<NetServiceType> = arrayListOf(NetServiceType.ALL)
· Κρατήστε ξεχωριστά τα μελλοντικά διαπιστευτήρια: Το AK είναι το κλειδί πρόσβασης (access key) και το SK το μυστικό του. Για μεταγενέστερες υπηρεσίες με έλεγχο ταυτότητας, ζητήστε τα διαπιστευτήρια enterprise υπηρεσιών από την επαφή σας στο τμήμα πωλήσεων ή επιχειρησιακής συνεργασίας της Rokid. Στο UserAuthInfo, το appId λαμβάνει το AK και το secret λαμβάνει το SK. Χρησιμοποιήστε προστατευμένη διαμόρφωση project για τα δοκιμαστικά διαπιστευτήρια και μην κάνετε ποτέ commit πραγματικά κλειδιά. Αυτή η πρώτη τοπική εκτέλεση δεν χρειάζεται αυτές τις online λειτουργίες.
· Προσθέστε αγγλικά logs αρχικοποίησης: Στο project του τηλεφώνου, ανοίξτε το app > src > main > java > com > rokid > phone > ui > MainPhoneActivity.kt. Στη initSDK(), προσθέστε ένα αγγλικό log μέσα στο callback επιτυχίας:
Kotlin
Log.d(TAG, “Phone SDK ready”)
Στο project των γυαλιών, ανοίξτε το app > src > main > java > com > rokid > glass > HomeActivity.kt. Η initSDK() καλεί τη GlassSdkUtils.initSdk() και στη συνέχεια συλλέγει το GlobalData.sdkInitState· μέσα σε αυτόν τον collector, αμέσως μετά τη γραμμή Log.d(TAG, “SDK 初始化成功”), προσθέστε το αγγλικό log:“
Kotlin
Log.d(TAG, “Glasses SDK ready”)
(Σημείωση: Αν το Android Studio επισημάνει με κόκκινο αναφορές κλάσεων, πατήστε Alt + Enter για αυτόματη εισαγωγή των απαιτούμενων πακέτων.)
· Αποφύγετε την αλλαγή της συμπεριφοράς εκκίνησης: Στο project των γυαλιών, ανοίξτε το app > src > main > java > com > rokid > glass > HomeActivity.kt. Μέσα στη onCreate(), μετατρέψτε σε σχόλιο την παρακάτω υπάρχουσα γραμμή, προσθέτοντας // στην αρχή της. Η γραμμή αυτή ρυθμίζει την αυτόματη εκκίνηση μετά από επανεκκίνηση· δεν είναι απαραίτητη για μια πρώτη δοκιμή σε εταιρική συσκευή.
// DeviceUtil.setSystemProp("persist.vendor.boot.pkg", this.packageName)
· Περιορίστε τη δοκιμή λήψης μόνο σε κείμενο: Στον ίδιο φάκελο com > rokid > glass, ανοίξτε το MessageReceiveActivity.kt. Αντικαταστήστε μόνο τη συνάρτηση onTextMessage μέσα στο mMessageListener με τον παρακάτω κώδικα. Το κείμενο που λαμβάνεται παραμένει ορατό και καταγράφεται, χωρίς να καλούνται υπηρεσίες ομιλίας. Callback είναι μια συνάρτηση που καλεί το SDK όταν φτάνει ένα συμβάν.
override fun onTextMessage(msg: String) {
log(msg)
}
Βήμα 7 Κάντε build και εκτελέστε την εφαρμογή του τηλεφώνου
· Ενεργοποιήστε την αποσφαλμάτωση USB στο τηλέφωνο: Στο δοκιμαστικό τηλέφωνο, ανοίξτε το μενού Settings και χρησιμοποιήστε το πεδίο αναζήτησης για να βρείτε το Build number. Ανοίξτε την αντίστοιχη σελίδα πληροφοριών συσκευής και πατήστε το Build number επτά φορές· εισαγάγετε το PIN της συσκευής αν σας ζητηθεί. Επιστρέψτε στο Settings, αναζητήστε το Developer options, ανοίξτε το και ενεργοποιήστε το USB debugging. Η θέση των μενού διαφέρει ανάλογα με τον κατασκευαστή του τηλεφώνου.
· Συνδέστε και εξουσιοδοτήστε: Συνδέστε το τηλέφωνο στον υπολογιστή με το καλώδιο δεδομένων USB του. Στο παράθυρο διαλόγου Allow USB debugging? του τηλεφώνου, βεβαιωθείτε ότι πρόκειται για τον υπολογιστή ανάπτυξης και πατήστε Allow. Στην επάνω γραμμή εργαλείων του project του τηλεφώνου, επιλέξτε app ως διαμόρφωση εκτέλεσης και επιλέξτε το συνδεδεμένο τηλέφωνο στο διπλανό αναπτυσσόμενο μενού συσκευών.
· Εκτελέστε την εφαρμογή: Κάντε κλικ στο πράσινο τρίγωνο Run ή επιλέξτε Run > Run app. Το Android Studio κάνει build, εγκαθιστά και ανοίγει το demo του τηλεφώνου. Η ετικέτα της εφαρμογής που εξετάστηκε μπορεί να είναι Rokid Enterprise Demo ή rokid白板, και η διεπαφή του demo πιθανότατα να είναι στα κινεζικά. Στα παράθυρα αδειών, επιτρέψτε την πρόσβαση Nearby devices και την πρόσβαση Wi-Fi που ζητούνται για αυτή τη δοκιμή· οι παλαιότερες εκδόσεις Android ενδέχεται να ζητήσουν πρόσβαση στην τοποθεσία (Location). Αν τις αρνηθήκατε νωρίτερα, χρησιμοποιήστε το Settings > Apps > το demo > Permissions για να αλλάξετε τη σχετική άδεια.
· Ελέγξτε την αρχικοποίηση: Ανοίξτε το View > Tool Windows > Logcat, επιλέξτε το τηλέφωνο και πληκτρολογήστε package:com.rokid.phone στο πεδίο φίλτρου. Αναζητήστε το μήνυμα Phone SDK ready, που σημαίνει ότι η αρχικοποίηση του SDK του τηλεφώνου ολοκληρώθηκε με επιτυχία. Κρατήστε την εφαρμογή ανοιχτή. Αν η πολιτική του δοκιμαστικού τηλεφώνου μπλοκάρει την αποσφαλμάτωση ή τις απαιτούμενες άδειες, ζητήστε από το τμήμα IT να διαμορφώσει αυτή την αποκλειστική συσκευή ανάπτυξης πριν συνεχίσετε.
Βήμα 8 Συνδέστε και εκτελέστε την εφαρμογή των γυαλιών
Επαληθεύστε τις ρυθμίσεις προγραμματιστή των γυαλιών: Στο Rokid Glass3, μεταβείτε στο Settings > System > Developer Options και επιβεβαιώστε ότι το USB Debugging είναι ON (ενεργοποιημένο). Αν το μενού επιλογών είναι κλειδωμένο ή κρυφό στο enterprise build σας, επικοινωνήστε με τον διανομέα του υλικού σας για να εγκαταστήσει/παράσχει firmware με ενεργοποιημένες επιλογές προγραμματιστή πριν προχωρήσετε.
· Ελέγξτε το ADB μέσω του σωστού καλωδίου: Συνδέστε τα ενεργοποιημένα γυαλιά με το καλώδιο δεδομένων και αποσφαλμάτωσης του Glass3. Στο project των γυαλιών, επιλέξτε View > Tool Windows > Terminal. Πληκτρολογήστε cd " ακολουθούμενο από τη θέση του SDK που αποθηκεύσατε στο Βήμα 2 και, στη συνέχεια, \platform-tools", και πατήστε Enter. Σε αυτόν τον φάκελο, εκτελέστε την παρακάτω εντολή. Ο σειριακός αριθμός (serial) είναι το αναγνωριστικό της συσκευής που εμφανίζεται στην πρώτη στήλη.
.\adb.exe devices -l
· Διαβάστε την κατάσταση της συσκευής: Αναζητήστε τον σειριακό αριθμό των γυαλιών ακολουθούμενο από device και όχι offline ή unauthorized. Αν εμφανιστεί παράθυρο εξουσιοδότησης στα γυαλιά, εγκρίνετε αυτόν τον υπολογιστή ανάπτυξης. Αν δεν εμφανιστεί τίποτα, ελέγξτε πρώτα το καλώδιο και τη θύρα USB. Τα enterprise builds μπορεί να περιορίζουν την αποσφαλμάτωση· αν είναι μπλοκαρισμένη, ζητήστε από τον προμηθευτή να παράσχει την τεκμηριωμένη πρόσβαση ανάπτυξης. Μην χρησιμοποιήσετε στη θέση τους οδηγίες για τη συνοδευτική εφαρμογή καταναλωτών.
· Εγκαταστήστε και εκκινήστε: Στη γραμμή εργαλείων του project των γυαλιών, επιλέξτε app, επιλέξτε τα γυαλιά ως στόχο, π.χ. Rokid RG-glasses, και κάντε κλικ στο Run. Η ετικέτα της εφαρμογής είναι glassdemo. Ανοίξτε το Logcat, επιλέξτε τα γυαλιά και φιλτράρετε με package:com.rokid.glesse. Αναζητήστε το Glasses SDK ready, το log που προσθέσατε στο Βήμα 6, για να επιβεβαιώσετε ότι η αρχικοποίηση του SDK ολοκληρώθηκε με επιτυχία.
· Κατοπτρίστε τη διεπαφή: Το scrcpy είναι ένα εργαλείο προβολής και ελέγχου οθόνης Android· η ενσύρματη χρήση του τεκμηριώνεται από τη Rokid. Ανοίξτε τις επίσημες οδηγίες του scrcpy για Windows, κατεβάστε το ZIP για Windows 64-bit και χρησιμοποιήστε την επιλογή Extract All στην Εξερεύνηση αρχείων. Ανοίξτε τον φάκελο που εξήχθη και κάντε διπλό κλικ στο open_a_terminal_here.bat. Εκτελέστε adb devices και, στη συνέχεια, την παρακάτω εντολή, αντικαθιστώντας το GLASSES_SERIAL με τον σειριακό αριθμό των γυαλιών. Το παράθυρο κατοπτρισμού σάς επιτρέπει να κάνετε κλικ στη διεπαφή των γυαλιών με το ποντίκι του υπολογιστή.
scrcpy -s GLASSES_SERIAL --no-audio
Βήμα 9 Πραγματοποιήστε σύζευξη των enterprise demo
· Ανοίξτε την οθόνη σύνδεσης του τηλεφώνου: Στο Rokid Enterprise Demo, πατήστε το εικονίδιο + επάνω δεξιά για να ανοίξετε το Discover Bluetooth. Για την κινεζική έκδοση, στο demo του τηλεφώνου (rokid 白板), στη σελίδα 设备 (Συσκευή), πατήστε το εικονίδιο + επάνω δεξιά για να ανοίξετε το 发现蓝牙 (Discover Bluetooth). Σε αυτή την αναθεώρηση του κώδικα, η ενεργή διάταξη δεν έχει καρτέλα Device στο κάτω μέρος. Ξεκινά μια σάρωση· επιλέξτε την καταχώριση Glass3_… που αντιστοιχεί στα γυαλιά σας. Αν η σάρωση κολλήσει, πατήστε το εικονίδιο ανανέωσης σε αυτή την οθόνη.
· Ολοκληρώστε τη σύζευξη: Εγκρίνετε όποιο παράθυρο σύζευξης Bluetooth του Android εμφανιστεί και ελέγξτε τα γυαλιά για αίτημα σύνδεσης. Περιμένετε μέχρι η οθόνη Device του τηλεφώνου να ενημερώσει την ένδειξη σύνδεσης ώστε να δείχνει ότι το Classic Bluetooth είναι συνδεδεμένο. Αν η σελίδα εντοπισμού ή σύνδεσης παραμείνει ανοιχτή μετά τη σύζευξη, πατήστε το κουμπί Back του Android για να επιστρέψετε στο Device. Και οι δύο συσκευές πρέπει να έχουν ενεργοποιημένο το Bluetooth και τα γυαλιά δεν πρέπει να είναι συνδεδεμένα με άλλο τηλέφωνο. Η σελίδα αντιμετώπισης προβλημάτων Bluetooth της Rokid περιλαμβάνει αυτούς τους ελέγχους.
· Κρατήστε την πρώτη δοκιμή απλή: Το demo μπορεί επίσης να διαπραγματευτεί σύνδεση Wi-Fi P2P και εμφανίζει ξεχωριστά την κατάστασή της. Το Bluetooth αρκεί για την παρακάτω δοκιμή κειμένου. Αν το P2P δεν είναι συνδεδεμένο, μην το ερμηνεύσετε ως αποτυχημένη σύνδεση Bluetooth. Τα μεγάλα αρχεία και τα ζωντανά μέσα απαιτούν ξεχωριστή επικύρωση του P2P.
Βήμα 10 Στείλτε ένα μήνυμα εργασίας και επιβεβαιώστε ότι το demo λειτουργεί
· Ορίστε το δοκιμαστικό μήνυμα: Στο project του τηλεφώνου, ανοίξτε το app > src > main > java > com > rokid > phone > SendMessageActivity.kt. Βρείτε το binding.btSendTextBtn.setOnClickListener και αντικαταστήστε ολόκληρο αυτό το μπλοκ listener με τον παρακάτω κώδικα.
(Σημείωση: Στο SendMessageActivity.kt, διατηρήστε το υπάρχον import του PSecuritySDK. Αν λείπει, προσθέστε την ακόλουθη γραμμή στην αρχή του αρχείου, μαζί με τα υπόλοιπα imports: import com.rokid.security.phone.sdk.api.PSecuritySDK).
GlassSample είναι το client ID λήψης που έχει ήδη καταχωρίσει το demo των γυαλιών· μην το αλλάξετε σε καμία από τις δύο πλευρές.
binding.btSendTextBtn.setOnClickListener {
val message = "Work item 001 ready"
PSecuritySDK.getMessageService()
?.sendTextMessageByClassicBT(message, "GlassSample")
log(message)
}
· Εκτελέστε την τροποποιημένη εφαρμογή του τηλεφώνου: Στο παράθυρο του project του τηλεφώνου στο Android Studio, επιλέξτε το συνδεδεμένο τηλέφωνο και κάντε κλικ στο Run > Run app για να κάνετε rebuild και να εγκαταστήσετε την τροποποιημένη εφαρμογή. Περιμένετε να ολοκληρωθεί με επιτυχία η αρχικοποίηση του SDK και επιβεβαιώστε ότι το Bluetooth επανασυνδέεται. Στη συνέχεια, μεταβείτε στο Message Receive στα γυαλιά μέσω του scrcpy. Κάντε κλικ μέσα στο ενεργό παράθυρο του scrcpy στην επιφάνεια εργασίας για να το εστιάσετε. Επειδή τα γυαλιά προσομοιώνουν χειριστήρια D-pad υλικού, χρησιμοποιήστε το Δεξί βέλος ή το Αριστερό βέλος του πληκτρολογίου του υπολογιστή σας για να περιηγηθείτε στο μενού μέχρι να επισημανθεί το Message Receive ή το 消息接收 (Message Receive), το δεύτερο στοιχείο του μενού, και έπειτα πατήστε Enter για να ανοίξετε το activity. Το demo αντιστοιχίζει αυτά τα πλήκτρα στην επιλογή μενού στο HomeActivity.kt. Αφήστε αυτή τη σελίδα λήψης ορατή· καταχωρίζει τον message listener που χρησιμοποιείται σε αυτή τη δοκιμή.
· Στείλτε από το τηλέφωνο: Στη σελίδα Device ή 设备 του τηλεφώνου, κάντε κύλιση μέχρι την κάρτα Message Send ή 消息发送 και πατήστε την. Στην επόμενη σελίδα, πατήστε Send text via Bluetooth ή 蓝牙发送文本. Αυτό το κουμπί στέλνει τη σταθερή συμβολοσειρά που ορίστηκε παραπάνω· δεν υπάρχει πεδίο εισαγωγής κειμένου για συμπλήρωση. Αναζητήστε το Work item 001 ready στη σελίδα λήψης των γυαλιών.
· Καταγράψτε το κριτήριο επιτυχίας: Στο Logcat των γυαλιών, φιλτράρετε με package:com.rokid.glesse tag:MessageActivity και επιβεβαιώστε ότι έφτασε το ίδιο μήνυμα. Το log αποστολής του ίδιου του τηλεφώνου δεν αποδεικνύει από μόνο του τη λήψη. Αποθηκεύστε μαζί με το αποτέλεσμα τις εκδόσεις των SDK, το build του firmware, την αναθεώρηση του πηγαίου κώδικα και τις αλλαγές στα build tools. Επιτυχία σημαίνει ότι εκτελούνται και οι δύο εφαρμογές, το Bluetooth συνδέεται και τα γυαλιά λαμβάνουν ορατά το δοκιμαστικό μήνυμα.
Συνήθη προβλήματα ρύθμισης
· Τα γυαλιά φορτίζουν αλλά δεν εντοπίζονται: Χρησιμοποιήστε το καλώδιο δεδομένων και αποσφαλμάτωσης και επαναλάβετε τον έλεγχο ADB του Βήματος 8. Το συνηθισμένο καλώδιο φόρτισης είναι το πρώτο που πρέπει να αποκλείσετε.
· Το Gradle δεν μπορεί να κατεβάσει μια βιβλιοθήκη: Στο παράθυρο Build, αναπτύξτε το σφάλμα και σημειώστε το ακριβές πακέτο και τη διεύθυνση URL του διακομιστή. Ελέγξτε τις καταχωρίσεις αποθετηρίων του Βήματος 5 και την πρόσβαση μέσω του εταιρικού proxy. Το demo περιλαμβάνει επιπλέον αποθετήρια και εξαρτήσεις πέρα από τα δύο SDK της Rokid· μην τα διαγράψετε αδιακρίτως και μην προσθέσετε κάποιο τυχαίο mirror.
· Σφάλματα διπλότυπης καταγραφής ή native βιβλιοθηκών: Ελέγξτε για διπλότυπες καταχωρίσεις SDK και για την εξαίρεση του org.slf4j. Διατηρήστε τους υπάρχοντες κανόνες packagingOptions για το libr2aud.so στην εφαρμογή των γυαλιών και για το libc++_shared.so στην εφαρμογή του τηλεφώνου. Ένα σφάλμα διπλότυπης βιβλιοθήκης σημαίνει ότι δύο εξαρτήσεις πακετάρισαν το ίδιο αρχείο.
· Η σύζευξη λειτουργεί αλλά δεν φτάνει κανένα μήνυμα: Κρατήστε ανοιχτή τη σελίδα λήψης στα γυαλιά και επιβεβαιώστε ότι το GlassSample δεν έχει αλλάξει. Στο Logcat, επαληθεύστε και τα δύο μηνύματα επιτυχούς αρχικοποίησης πριν από την αποστολή. Αν η συσκευή δεν εντοπίζεται, ελέγξτε τις άδειες Nearby devices του τηλεφώνου και αποσυνδέστε πρώτα οποιοδήποτε άλλο τηλέφωνο.
Συμπέρασμα
Η ρύθμιση ενός περιβάλλοντος ανάπτυξης για το Rokid Glass3 ξεκινά με γυαλιά συμβατά με την έκδοση enterprise και το σωστό καλώδιο δεδομένων και αποσφαλμάτωσης και συνεχίζει με το Android Studio, το JDK 17, τις εξαρτήσεις Maven και μια συνεπή διαμόρφωση build. Η εκτέλεση των demo τηλεφώνου και γυαλιών και η επαλήθευση της λήψης ενός μηνύματος εργασίας δημιουργούν μια πρακτική βάση αναφοράς πριν προστεθεί επιχειρησιακή λογική ή online υπηρεσίες. Για τις επιχειρήσεις, η διαδικασία αυτή μπορεί να μειώσει τις αποφεύξιμες καθυστερήσεις στη ρύθμιση, να κάνει τα πιλοτικά προγράμματα ευκολότερα αναπαραγώγιμα και να δώσει στους προγραμματιστές πιο σαφή θεμέλια για εφαρμογές που παρέχουν χρήσιμες πληροφορίες ενώ οι εργαζόμενοι έχουν τα χέρια τους ελεύθερα.
Επιβεβαιώστε το enterprise υλικό, το καλώδιο δεδομένων και αποσφαλμάτωσης και την υποστήριξη firmware πριν αγοράσετε ένα development kit ή ζητήσετε εταιρικό πιλοτικό πρόγραμμα.
























