Rezumat
Un mediu de dezvoltare Rokid Glass3 permite unei echipe din mediul de afaceri să creeze aplicații Android pentru [Rokid AI Glasses Enterprise](https://ai.vr-expert.com/en/ai-glasses/rokid-ai-glasses) și să testeze comunicarea cu un telefon Android. Începeți cu firmware-ul enterprise, Android Studio, JDK 17, depozitul Maven Rokid și cablul de date pentru depanare Glass3. Cablul obișnuit de încărcare nu poate instala sau depana aplicația pentru ochelari.
Acest flux de lucru pentru Windows 11 deschide cele două proiecte demo oficiale ale Rokid, verifică configurația lor de build, instalează fiecare aplicație și trimite un exemplu de mesaj de lucru către ochelari. Folosește SDK-ul enterprise și un test local de comunicare. Serviciile online de vorbire și AI sunt integrări separate. Instrucțiunile au fost verificate pe baza documentației oficiale și a codului sursă al demo-ului; nu a fost efectuată o rulare pe un dispozitiv fizic.
Pentru context despre hardware, consultați pagina de produs Rokid AI Glasses Enterprise. Rokid documentează arhitectura și mediul de rulare ale acestui dispozitiv enterprise în cadrul Glass3 Enterprise SDK. Confirmați cu furnizorul dispozitivul livrat și firmware-ul înainte de a considera compatibil un alt produs Rokid.
Cerințe pentru dezvoltarea pe Rokid Glass3
Hardware: PC cu Windows 11, Rokid Glass3 Enterprise (firmware enterprise), telefon Android dedicat pentru testare (recomandat Android 13+) și cablul Glass3 de date pentru depanare.
Software: Android Studio cu Android SDK Platform 34 și Build-Tools 35.0.0.
Mediu de build: JDK 17, AGP 8.4.2, Gradle 8.6 și Kotlin 2.2.0.
SDK-uri: Glasses SDK și Phone SDK 2.2.0-E.
Pasul 1 Pregătiți hardware-ul enterprise
· Confirmați sistemul: Firmware-ul este software-ul de sistem integrat al ochelarilor. Cereți furnizorului modelul ochelarilor, versiunea de firmware enterprise instalată și compatibilitatea cu SDK-ul. Secțiunea de întrebări frecvente a Rokid precizează că versiunile pentru uz profesional conțin de obicei litera e în numărul versiunii. Folosiți demo-ul enterprise cu firmware enterprise. Numele produsului nu este suficient, de unul singur, pentru a stabili compatibilitatea.
· Verificați cablul: Procurați în mod explicit cablul de date pentru depanare Glass3. Conectați-l direct la computerul de dezvoltare când instalați demo-ul. Faptul că încărcarea funcționează nu dovedește că transferul de date prin USB funcționează.
· Pregătiți testul: Încărcați ambele dispozitive și țineți-le aproape unul de celălalt. Folosiți un telefon dedicat și mesajul de test din Pasul 10. Înainte de asociere, deconectați orice alt telefon conectat anterior la acești ochelari.
Cablul de date pentru depanare Glass3, prezentat în ghidul Quick Start al Rokid. Acesta este cablul necesar pentru dezvoltarea prin conexiune cu fir.
Cablul obișnuit de încărcare Glass3, prezentat de Rokid. Acesta nu poate înlocui cablul de date pentru depanare. Confirmați cu furnizorul funcția cablului livrat.
Pasul 2 Instalați Android Studio și Android SDK (dacă sunt deja instalate, treceți la pasul următor)
· Descărcați programul de instalare: Descărcați și instalați Android Studio de pe https://developer.android.com/studio.
· Deschideți aplicația: Deschideți Android Studio. La prima lansare, selectați Do not import settings, dacă vi se oferă această opțiune, apoi alegeți varianta Standard pentru configurare. Examinați licențele SDK, acceptați-le pe cele aprobate de compania dumneavoastră și finalizați descărcarea componentelor.
· Instalați pachetele necesare: Din ecranul de întâmpinare, faceți clic pe More Actions > SDK Manager. La SDK Platforms, selectați Android 14 / API 34. La SDK Tools, selectați Android SDK Platform-Tools. Activați Show Package Details, extindeți Android SDK Build-Tools și selectați 35.0.0. De reținut că Android Gradle Plugin al demo-ului instalează la prima sincronizare versiunea 34.0.0 a build tools de care are nevoie. Faceți clic pe Apply, verificați lista de pachete, apoi faceți clic pe OK pentru a instala.
· Salvați locația SDK: Notați calea Android SDK Location pentru configurarea ADB din Pasul 8.
Pasul 3 Descărcați și deschideți cele două proiecte demo
· Obțineți codul sursă: În browser, accesați depozitul oficial al demo-ului enterprise Glass3 (de exemplu, https://github.com/RokidSuuport/glass3_sdk_demo.git – de reținut că acesta este într-adevăr depozitul Git oficial, deși „Support” este scris greșit) sau depozitul Git pus la dispoziție de furnizorul dumneavoastră. Faceți clic pe butonul verde Code, apoi pe Download ZIP. În File Explorer > Downloads, faceți clic dreapta pe fișierul ZIP și selectați Extract All > Extract. Păstrați folderul extras într-o locație de dezvoltare aprobată de companie.
· Deschideți proiectul pentru telefon: În ecranul de întâmpinare al Android Studio, faceți clic pe Open. Navigați în folderul extras, selectați glass3sdkphonedemo și faceți clic pe OK. Dacă apare o solicitare de încredere, verificați că aceasta este sursa oficială pe care ați descărcat-o înainte de a o marca drept de încredere. Folderul exterior al depozitului nu este proiectul Android.
· Deschideți proiectul pentru ochelari: Alegeți File > Open, selectați folderul alăturat glassdemo și alegeți New Window când vi se cere. Păstrați ambele ferestre deschise. Fiecare are propria configurație Gradle și un modul app, partea care creează aplicația instalabilă.
· Folosiți vizualizarea fișierelor: În fiecare fereastră, deschideți View > Tool Windows > Project. Din lista derulantă din partea de sus a panoului din stânga, alegeți Project. Astfel sunt afișate folderele și fișierele reale folosite mai jos. Dacă prima sincronizare raportează o eroare, finalizați Pașii 4 și 5 înainte de a reîncerca.
Pasul 4 Selectați JDK 17 pentru ambele proiecte
· Deschideți setările Gradle: În fereastra proiectului pentru telefon, alegeți File > Settings > Build, Execution, Deployment > Build Tools > Gradle. Găsiți lista derulantă Gradle JDK. Aceasta controlează versiunea Java folosită pentru build-ul proiectului, separat de mediul de rulare Java care lansează Android Studio.
· Selectați sau descărcați Java 17: Alegeți un JDK instalat etichetat 17. Dacă nu apare niciunul, alegeți Download JDK, selectați Version 17, alegeți un furnizor aprobat de departamentul IT și faceți clic pe Download. Selectați JDK-ul descărcat în Gradle JDK, apoi faceți clic pe Apply > OK. Repetați în fereastra proiectului pentru ochelari.
· Păstrați țintele de cod existente: Setările sourceCompatibility, targetCompatibility și setarea Kotlin jvmTarget ale demo-ului folosesc valoarea 1.8. Acestea descriu compatibilitatea codului compilat; nu înseamnă că Gradle ar trebui să ruleze pe JDK 8. Lăsați-le neschimbate pentru acest demo. Ghidul Google pentru build-urile Java face distincția între aceste setări.
Pasul 5 Verificați dependențele Maven și aliniați build tools
Un depozit Maven este un server de pe care Gradle obține pachetele de biblioteci, inclusiv SDK-ul Rokid.
· Verificați depozitul: În panoul din stânga al fiecărui proiect, faceți dublu clic pe settings.gradle. Găsiți dependencyResolutionManagement > repositories și confirmați că URL-ul Maven Rokid de mai jos este prezent. Adăugați doar linia lipsă în blocul existent. Păstrați celelalte depozite ale demo-ului pentru celelalte dependențe ale sale; dacă un proxy al companiei le blochează, cereți departamentului IT să aprobe accesul.
// În settings.gradle > dependencyResolutionManagement
repositories {
google()
mavenCentral()
maven { url = uri("https://maven.rokid.com/repository/maven-public/") }
}
· Verificați cele două pachete SDK: Deschideți app > build.gradle în fiecare fereastră. În dependencies, păstrați o singură intrare activă pentru SDK-ul corect. Fragmentele de mai jos sunt scrise în Groovy, sintaxa folosită de acest demo. Nu adăugați SDK-ul pentru ochelari în proiectul pentru telefon și nu lipiți un al doilea bloc dependencies. org.slf4j este un grup de biblioteci de logging; excluderea evită clasele de logging duplicate.
// 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"
}
· Aliniați AGP și Gradle: Kotlin este limbajul de programare folosit de aceste demo-uri. Pentru versiunea inspectată, deschideți gradle > libs.versions.toml în ambele proiecte. La [versions], modificați doar agp la 8.4.2, dacă nu are deja această valoare; păstrați kotlin = "2.2.0". Apoi deschideți gradle > wrapper > gradle-wrapper.properties și înlocuiți doar distributionUrl cu linia de mai jos. Wrapper-ul descarcă versiunea Gradle aleasă. Google documentează corespondența dintre AGP 8.10, Gradle și JDK.
# 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
· Sincronizați și verificați rezultatul: Salvați fișierele editate, apoi alegeți File > Sync Project with Gradle Files în ambele ferestre. Deschideți View > Tool Windows > Build și verificați rezultatul sincronizării. Nu acceptați actualizări automate fără legătură cu acest proces. Demo-ul include deja reguli de împachetare pentru bibliotecile native; păstrați-le. O bibliotecă nativă este cod compilat pentru dispozitiv, împachetat împreună cu APK-ul.
Pasul 6 Configurați un demo local pentru mediul de afaceri
· Dezactivați serviciile online pentru acest test: În proiectul pentru telefon, deschideți app > src > main > java > com > rokid > phone > ui > MainPhoneActivity.kt. În partea de sus a fișierului MainPhoneActivity.kt, păstrați importul NetServiceType existent. Dacă lipsește, adăugați următoarea linie alături de celelalte importuri:
Kotlin
import com.rokid.security.phone.sdk.base.data.NetServiceType
Apoi găsiți banServiceList în initSDK(). Înlocuiți declarația sa activă cu linia de mai jos. Păstrați câmpurile goale existente din UserAuthInfo și ID-urile de client. Sursa documentează această opțiune pentru dezactivarea serviciilor de rețea; ea nu dezactivează testul Bluetooth local.
val banServiceList: List<NetServiceType> = arrayListOf(NetServiceType.ALL)
· Păstrați separat datele de autentificare viitoare: AK este o cheie de acces (access key), iar SK este secretul acesteia. Pentru serviciile autentificate de mai târziu, solicitați datele de autentificare pentru serviciile enterprise de la persoana de contact Rokid din vânzări sau din zona comercială. În UserAuthInfo, appId primește AK, iar secret primește SK. Folosiți o configurație de proiect protejată pentru datele de autentificare de test și nu faceți niciodată commit cu chei reale. Această primă rulare locală nu are nevoie de aceste funcții online.
· Adăugați jurnale de inițializare în engleză: În proiectul pentru telefon, deschideți app > src > main > java > com > rokid > phone > ui > MainPhoneActivity.kt. În initSDK(), adăugați un mesaj de jurnal în engleză în callback-ul de succes:
Kotlin
Log.d(TAG, “Phone SDK ready”)
În proiectul pentru ochelari, deschideți app > src > main > java > com > rokid > glass > HomeActivity.kt. initSDK() apelează GlassSdkUtils.initSdk() și apoi colectează GlobalData.sdkInitState; în acel collector, imediat după linia Log.d(TAG, “SDK 初始化成功”), adăugați jurnalul în engleză:“
Kotlin
Log.d(TAG, “Glasses SDK ready”)
(Notă: Dacă Android Studio evidențiază cu roșu referințele la clase, apăsați Alt + Enter pentru a importa automat pachetele necesare.)
· Evitați modificarea comportamentului la pornire: În proiectul pentru ochelari, deschideți app > src > main > java > com > rokid > glass > HomeActivity.kt. În onCreate(), transformați în comentariu următoarea linie existentă, adăugând // la începutul ei. Linia respectivă configurează lansarea automată după repornire; nu este necesară pentru un prim test pe un dispozitiv al companiei.
// DeviceUtil.setSystemProp("persist.vendor.boot.pkg", this.packageName)
· Limitați testul de recepție la text: În același folder com > rokid > glass, deschideți MessageReceiveActivity.kt. Înlocuiți doar funcția onTextMessage din mMessageListener cu codul de mai jos. Textul primit rămâne vizibil și este înregistrat în jurnal, fără a apela serviciile de vorbire. Un callback este o funcție pe care SDK-ul o apelează când sosește un eveniment.
override fun onTextMessage(msg: String) {
log(msg)
}
Pasul 7 Compilați și rulați aplicația pentru telefon
· Activați depanarea USB pe telefon: Pe telefonul de test, deschideți Settings și folosiți caseta de căutare pentru a găsi Build number. Deschideți pagina corespunzătoare cu informații despre dispozitiv și atingeți Build number de șapte ori; introduceți codul PIN al dispozitivului dacă vi se cere. Reveniți la Settings, căutați Developer options, deschideți secțiunea și activați USB debugging. Locația meniurilor diferă în funcție de producătorul telefonului.
· Conectați și autorizați: Conectați telefonul la computer cu cablul său de date USB. În dialogul Allow USB debugging? de pe telefon, verificați că este vorba de computerul de dezvoltare și atingeți Allow. În bara de instrumente de sus a proiectului pentru telefon, alegeți app ca configurație de rulare și selectați telefonul conectat în lista derulantă de dispozitive alăturată.
· Rulați aplicația: Faceți clic pe triunghiul verde Run sau alegeți Run > Run app. Android Studio compilează, instalează și deschide demo-ul pentru telefon. Eticheta aplicației inspectate poate fi Rokid Enterprise Demo sau rokid白板, iar interfața demo-ului este probabil în limba chineză. În dialogurile de permisiuni, permiteți accesul solicitat la Nearby devices și la Wi-Fi, necesar pentru acest test; versiunile mai vechi de Android pot solicita Location. Dacă ați refuzat anterior, folosiți Settings > Apps > demo-ul > Permissions pentru a modifica permisiunea relevantă.
· Verificați inițializarea: Deschideți View > Tool Windows > Logcat, selectați telefonul și introduceți package:com.rokid.phone în câmpul de filtrare. Căutați Phone SDK ready, ceea ce înseamnă că inițializarea SDK-ului pe telefon a reușit. Lăsați aplicația deschisă. Dacă politica telefonului de test blochează depanarea sau permisiunile necesare, cereți departamentului IT să configureze acest dispozitiv de dezvoltare dedicat înainte de a continua.
Pasul 8 Conectați și rulați aplicația pentru ochelari
Verificați setările pentru dezvoltatori ale ochelarilor: Pe Rokid Glass3, navigați la Settings > System > Developer Options și confirmați că opțiunea USB Debugging este setată pe ON. Dacă meniul de opțiuni este blocat sau ascuns în versiunea enterprise de care dispuneți, contactați distribuitorul de hardware pentru a instala/configura un firmware cu opțiunile pentru dezvoltatori activate înainte de a continua.
· Verificați ADB prin cablul corect: Conectați ochelarii porniți cu cablul de date pentru depanare Glass3. În proiectul pentru ochelari, alegeți View > Tool Windows > Terminal. Tastați cd " urmat de locația SDK salvată în Pasul 2, apoi \platform-tools" și apăsați Enter. În acel folder, rulați comanda de mai jos. Numărul de serie este identificatorul dispozitivului afișat în prima coloană.
.\adb.exe devices -l
· Citiți starea dispozitivului: Căutați numărul de serie al ochelarilor urmat de device, nu de offline sau unauthorized. Dacă pe ochelari apare un dialog de autorizare, aprobați acest computer de dezvoltare. Dacă nu apare nimic, verificați mai întâi cablul și portul USB. Versiunile enterprise pot restricționa depanarea; dacă aceasta este blocată, cereți furnizorului să configureze accesul de dezvoltare documentat. Nu folosiți în locul acestora instrucțiunile pentru aplicația însoțitoare destinată consumatorilor.
· Instalați și lansați: În bara de instrumente a proiectului pentru ochelari, selectați app, alegeți ochelarii ca țintă, de exemplu Rokid RG-glasses, și faceți clic pe Run. Eticheta aplicației este glassdemo. Deschideți Logcat, selectați ochelarii și filtrați după package:com.rokid.glesse. Căutați Glasses SDK ready, jurnalul adăugat în Pasul 6, care confirmă că inițializarea SDK-ului a reușit.
· Oglindiți interfața: scrcpy este un instrument Android pentru vizualizarea și controlul ecranului; utilizarea prin cablu este documentată de Rokid. Deschideți instrucțiunile oficiale scrcpy pentru Windows, descărcați arhiva ZIP pentru Windows pe 64 de biți și folosiți Extract All în File Explorer. Deschideți folderul extras și faceți dublu clic pe open_a_terminal_here.bat. Rulați adb devices, apoi comanda de mai jos, înlocuind GLASSES_SERIAL cu numărul de serie al ochelarilor. Fereastra de oglindire vă permite să faceți clic pe interfața ochelarilor cu mouse-ul computerului.
scrcpy -s GLASSES_SERIAL --no-audio
Pasul 9 Asociați demo-urile enterprise
· Deschideți ecranul de conectare de pe telefon: În Rokid Enterprise Demo, atingeți pictograma + din dreapta sus pentru a deschide Discover Bluetooth. Pentru versiunea în chineză, în demo-ul pentru telefon (rokid 白板), pe pagina 设备 (Device), atingeți pictograma + din dreapta sus pentru a deschide 发现蓝牙 (Discover Bluetooth). În layoutul activ al acestei revizii a sursei nu există o filă Device în partea de jos. Se pornește o scanare; alegeți intrarea Glass3_… care corespunde ochelarilor dumneavoastră. Dacă scanarea se blochează, atingeți pictograma de reîmprospătare de pe acel ecran.
· Finalizați asocierea: Aprobați orice dialog Android de asociere Bluetooth care apare și verificați dacă pe ochelari există o solicitare de conectare. Așteptați până când ecranul Device de pe telefon își actualizează indicatorul de conexiune, arătând că Bluetooth Classic este conectat. Dacă pagina de descoperire sau de conectare rămâne deschisă după asociere, atingeți butonul Android Back pentru a reveni la Device. Ambele dispozitive trebuie să aibă Bluetooth activat, iar ochelarii nu trebuie să fie conectați la alt telefon. Pagina Rokid de depanare a problemelor Bluetooth enumeră aceste verificări.
· Păstrați primul test simplu: Demo-ul poate negocia și o conexiune Wi-Fi P2P și afișează separat starea acesteia. Bluetooth este suficient pentru testul cu text de mai jos. Dacă P2P nu este conectat, nu interpretați acest lucru ca pe o conexiune Bluetooth eșuată. Fișierele mari și conținutul media live necesită o validare P2P separată.
Pasul 10 Trimiteți un mesaj de lucru și confirmați funcționarea demo-ului
· Setați mesajul de test: În proiectul pentru telefon, deschideți app > src > main > java > com > rokid > phone > SendMessageActivity.kt. Găsiți binding.btSendTextBtn.setOnClickListener și înlocuiți întregul bloc al acelui listener cu codul de mai jos.
(Notă: în SendMessageActivity.kt, păstrați importul PSecuritySDK existent. Dacă lipsește, adăugați următoarea linie în partea de sus a fișierului, alături de celelalte importuri: import com.rokid.security.phone.sdk.api.PSecuritySDK).
GlassSample este ID-ul clientului receptor deja înregistrat de demo-ul pentru ochelari; păstrați-l neschimbat pe ambele părți.
binding.btSendTextBtn.setOnClickListener {
val message = "Work item 001 ready"
PSecuritySDK.getMessageService()
?.sendTextMessageByClassicBT(message, "GlassSample")
log(message)
}
· Rulați aplicația modificată pe telefon: În fereastra proiectului pentru telefon din Android Studio, selectați telefonul conectat și faceți clic pe Run > Run app pentru a recompila și instala aplicația modificată. Așteptați ca inițializarea SDK-ului să reușească și confirmați că Bluetooth se reconectează. Apoi navigați la Message Receive pe ochelari folosind scrcpy. Faceți clic direct în fereastra activă scrcpy de pe desktop pentru a o aduce în prim-plan. Deoarece ochelarii emulează comenzile unui D-pad hardware, folosiți tasta Săgeată dreapta sau Săgeată stânga de pe tastatura computerului pentru a naviga prin meniu până când Message Receive sau 消息接收 (Message Receive), al doilea element din meniu, este evidențiat, apoi apăsați Enter pentru a deschide activitatea. Demo-ul asociază aceste taste cu selecția din meniu în HomeActivity.kt. Lăsați această pagină de recepție vizibilă; ea înregistrează listenerul de mesaje folosit în acest test.
· Trimiteți de pe telefon: Pe pagina Device sau 设备 a telefonului, derulați până la cardul Message Send sau 消息发送 și atingeți-l. Pe pagina următoare, atingeți Send text via Bluetooth sau 蓝牙发送文本. Acest buton trimite șirul fix de mai sus; nu există niciun câmp de introducere a textului de completat. Căutați Work item 001 ready pe pagina de recepție a ochelarilor.
· Înregistrați condiția de reușită: În Logcat pentru ochelari, filtrați după package:com.rokid.glesse tag:MessageActivity și confirmați că a sosit același mesaj. Jurnalul de trimitere al telefonului nu dovedește, de unul singur, recepția. Salvați împreună cu rezultatul versiunile SDK, build-ul de firmware, revizia sursei și modificările aduse build tools. Reușita înseamnă că ambele aplicații rulează, Bluetooth se conectează, iar ochelarii primesc vizibil mesajul de test.
Probleme frecvente de configurare
· Ochelarii se încarcă, dar nu sunt detectați: Folosiți cablul de date pentru depanare și repetați verificarea ADB din Pasul 8. Cablul obișnuit de încărcare este primul lucru de eliminat.
· Gradle nu poate descărca o bibliotecă: În Build, extindeți eroarea și notați pachetul exact și URL-ul serverului. Verificați intrările de depozit din Pasul 5 și accesul prin proxy-ul companiei. Demo-ul include depozite și dependențe suplimentare față de cele două SDK-uri Rokid; nu le ștergeți fără discernământ și nu adăugați o oglindă (mirror) oarecare.
· Erori de logging duplicat sau de biblioteci native: Verificați dacă există intrări SDK duplicate și excluderea org.slf4j. Păstrați regulile packagingOptions existente pentru libr2aud.so în aplicația pentru ochelari și libc++_shared.so în aplicația pentru telefon. O eroare de bibliotecă duplicată înseamnă că două dependențe au împachetat același fișier.
· Asocierea funcționează, dar nu sosește niciun mesaj: Păstrați deschisă pagina de recepție de pe ochelari și confirmați că GlassSample este neschimbat. În Logcat, verificați ambele mesaje de inițializare reușită înainte de a trimite. Dacă dispozitivul nu poate fi descoperit, verificați permisiunile Nearby devices ale telefonului și deconectați mai întâi orice alt telefon.
Concluzie
Configurarea unui mediu de dezvoltare Rokid Glass3 începe cu ochelari compatibili cu varianta enterprise și cu cablul corect de date pentru depanare, apoi continuă cu Android Studio, JDK 17, dependențele Maven și o configurație de build coerentă. Rularea demo-urilor pentru telefon și ochelari și verificarea recepției unui mesaj de lucru stabilesc o bază practică înainte de adăugarea logicii de business sau a serviciilor online. Pentru companii, acest proces poate reduce întârzierile de configurare evitabile, poate face proiectele pilot mai ușor de reprodus și le poate oferi dezvoltatorilor o bază mai clară pentru aplicații care furnizează informații utile, în timp ce angajații își păstrează mâinile libere.
Confirmați hardware-ul enterprise, cablul de date pentru depanare și compatibilitatea firmware-ului înainte de a achiziționa un kit de dezvoltare sau de a solicita un proiect pilot pentru compania dumneavoastră.
























