Resumé
Et udviklingsmiljø til Rokid Glass3 gør det muligt for et virksomhedsteam at bygge Android-applikationer til [Rokid AI Glasses Enterprise](https://ai.vr-expert.com/en/ai-glasses/rokid-ai-glasses) og teste kommunikationen med en Android-telefon. Start med enterprise-firmware, Android Studio, JDK 17, Rokids Maven-repository og Glass3-data-debugkablet. Det almindelige ladekabel kan ikke bruges til at installere eller debugge brillernes applikation.
Denne arbejdsgang til Windows 11 åbner Rokids to officielle demoprojekter, kontrollerer deres build-konfiguration, installerer hver app og sender en eksempel på en arbejdsbesked til brillerne. Den bruger enterprise-SDK'et og en lokal kommunikationstest. Online tale- og AI-tjenester er separate integrationer. Vejledningen er kontrolleret op imod officiel dokumentation og demoens kildekode; der er ikke foretaget en kørsel på en fysisk enhed.
Se produktsiden for Rokid AI Glasses Enterprise for hardwaremæssig baggrund. Rokid dokumenterer denne enterprise-enheds arkitektur og runtime under Glass3 Enterprise SDK. Bekræft den leverede enhed og firmware med din leverandør, før du betragter et andet Rokid-produkt som kompatibelt.
Krav til Rokid Glass3-udvikling
Hardware: Windows 11-pc, Rokid Glass3 Enterprise (enterprise-firmware), dedikeret Android-testtelefon (Android 13+ anbefales) og Glass3-data-debugkablet.
Software: Android Studio med Android SDK Platform 34 og Build-Tools 35.0.0.
Build-miljø: JDK 17, AGP 8.4.2, Gradle 8.6 og Kotlin 2.2.0.
SDK'er: Glasses SDK og Phone SDK 2.2.0-E.
Trin 1 Forbered enterprise-hardwaren
· Bekræft systemet: Firmware er brillernes indbyggede systemsoftware. Bed din leverandør om brillemodellen, den installerede enterprise-firmwareversion og SDK-kompatibiliteten. Ifølge Rokids FAQ indeholder erhvervsversioner normalt et e i versionsnummeret. Brug enterprise-demoen sammen med enterprise-firmware. Et produktnavn alene er ikke nok til at fastslå kompatibilitet.
· Kontrollér kablet: Sørg udtrykkeligt for at få Glass3-data-debugkablet. Tilslut det direkte til udviklingscomputeren, når du installerer demoen. At opladningen virker, beviser ikke, at USB-dataforbindelsen fungerer.
· Forbered testen: Oplad begge enheder, og hold dem tæt på hinanden. Brug en dedikeret telefon og eksempelbeskeden i trin 10. Afbryd forbindelsen til enhver anden telefon, der tidligere har været forbundet til disse briller, før du parrer.
Glass3-data-debugkablet som vist i Rokids Quick Start. Det er dette kabel, der kræves til det kablede udviklingsforløb.
Almindeligt Glass3-ladekabel som vist af Rokid. Det kan ikke erstatte data-debugkablet. Bekræft det medfølgende kabels funktion med forhandleren.
Trin 2 Installer Android Studio og Android SDK (hvis de allerede er installeret, så gå videre til næste trin)
· Download installationsprogrammet: Download og installer Android Studio fra https://developer.android.com/studio.
· Åbn applikationen: Åbn Android Studio. Ved første opstart skal du vælge Do not import settings, hvis muligheden vises, og derefter bruge Standard-opsætningen. Gennemgå SDK-licenserne, accepter dem, der er godkendt i din virksomhed, og fuldfør downloaden af komponenterne.
· Installer de nødvendige pakker: På velkomstskærmen skal du klikke på More Actions > SDK Manager. Under SDK Platforms skal du vælge Android 14 / API 34. Under SDK Tools skal du vælge Android SDK Platform-Tools. Aktivér Show Package Details, udvid Android SDK Build-Tools, og vælg 35.0.0. Bemærk, at demoens Android Gradle Plugin selv installerer de 34.0.0-build-tools, den har brug for, ved den første synkronisering. Klik på Apply, gennemgå pakkelisten, og klik derefter på OK for at installere.
· Gem SDK-placeringen: Notér stien under Android SDK Location til ADB-opsætningen i trin 8.
Trin 3 Download og åbn de to demoprojekter
· Hent kildekoden: Gå i din browser til det officielle Glass3-enterprise-demorepository (f.eks. https://github.com/RokidSuuport/glass3_sdk_demo.git – bemærk, at dette faktisk er det officielle Git-repository, selvom Support er stavet forkert) eller til det Git-repository, din leverandør har stillet til rådighed. Klik på den grønne Code-knap og derefter på Download ZIP. I File Explorer > Downloads skal du højreklikke på ZIP-filen og vælge Extract All > Extract. Placer den udpakkede mappe et sted, som virksomheden har godkendt til udvikling.
· Åbn telefonprojektet: På Android Studios velkomstskærm skal du klikke på Open. Gå ind i den udpakkede mappe, vælg glass3sdkphonedemo, og klik på OK. Hvis du bliver spurgt, om du stoler på projektet, så kontrollér, at det er den officielle kilde, du har downloadet, før du bekræfter. Repositoryets yderste mappe er ikke selve Android-projektet.
· Åbn brilleprojektet: Vælg File > Open, vælg mappen glassdemo, der ligger ved siden af, og vælg New Window, når du bliver spurgt. Hold begge vinduer åbne. Hvert projekt har sin egen Gradle-konfiguration og et app-modul – den del, der opretter den installerbare applikation.
· Brug filvisningen: I hvert vindue skal du åbne View > Tool Windows > Project. I rullemenuen øverst i venstre panel skal du vælge Project. Så vises de faktiske mapper og filer, der bruges nedenfor. Hvis den første synkronisering melder en fejl, så gennemfør trin 4 og 5, før du prøver igen.
Trin 4 Vælg JDK 17 til begge projekter
· Åbn Gradle-indstillingerne: I telefonprojektets vindue skal du vælge File > Settings > Build, Execution, Deployment > Build Tools > Gradle. Find rullemenuen Gradle JDK. Den styrer, hvilken Java-version der bruges til at bygge projektet, uafhængigt af den Java-runtime, der starter Android Studio.
· Vælg eller download Java 17: Vælg en installeret JDK med betegnelsen 17. Hvis der ikke er nogen på listen, så vælg Download JDK, vælg Version 17, vælg en leverandør, som IT har godkendt, og klik på Download. Vælg den downloadede JDK under Gradle JDK, og klik derefter på Apply > OK. Gentag i brilleprojektets vindue.
· Behold de eksisterende kodemål: Demoens sourceCompatibility, targetCompatibility og Kotlins jvmTarget bruger 1.8. De beskriver kompatibiliteten for den kompilerede kode; de betyder ikke, at Gradle skal køre på JDK 8. Lad dem være uændrede i denne demo. Googles vejledning til Java-builds skelner mellem disse indstillinger.
Trin 5 Kontrollér Maven-afhængigheder, og afstem build-værktøjerne
Et Maven-repository er en server, hvor Gradle finder bibliotekspakker, herunder Rokids SDK.
· Kontrollér repositoryet: I hvert projekts venstre panel skal du dobbeltklikke på settings.gradle. Find dependencyResolutionManagement > repositories, og bekræft, at Rokids Maven-URL nedenfor er til stede. Tilføj kun den manglende linje inde i den eksisterende blok. Behold demoens øvrige repositories til dens andre afhængigheder; bed IT om at godkende adgangen, hvis en virksomhedsproxy blokerer dem.
// Inde i settings.gradle > dependencyResolutionManagement
repositories {
google()
mavenCentral()
maven { url = uri("https://maven.rokid.com/repository/maven-public/") }
}
· Kontrollér de to SDK-pakker: Åbn app > build.gradle i hvert vindue. Under dependencies skal du beholde én aktiv post for det korrekte SDK. Kodestykkerne nedenfor er skrevet i Groovy, den syntaks, som denne demo bruger. Tilføj ikke brille-SDK'et til telefonprojektet, og indsæt ikke en ekstra dependencies-blok. org.slf4j er en gruppe af logningsbiblioteker; udelukkelsen forhindrer duplikerede logningsklasser.
// 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"
}
· Afstem AGP og Gradle: Kotlin er det programmeringssprog, som disse demoer bruger. For det undersøgte snapshot skal du åbne gradle > libs.versions.toml i begge projekter. Under [versions] skal du kun ændre agp til 8.4.2, hvis den ikke allerede er sat til det; behold kotlin = "2.2.0". Åbn derefter gradle > wrapper > gradle-wrapper.properties, og erstat kun distributionUrl med linjen nedenfor. Wrapperen downloader den valgte Gradle-version. Google dokumenterer, hvilke Gradle- og JDK-versioner der passer til 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
· Synkronisér, og gennemgå resultatet: Gem de redigerede filer, og vælg derefter File > Sync Project with Gradle Files i begge vinduer. Åbn View > Tool Windows > Build, og kontrollér synkroniseringsoutputtet. Accepter ikke urelaterede automatiske opgraderinger. Demoen indeholder allerede pakningsregler for native biblioteker; behold dem. Et native bibliotek er kompileret enhedskode, der pakkes sammen med APK'en.
Trin 6 Konfigurer en lokal erhvervsdemo
· Deaktiver onlinetjenester til denne test: I telefonprojektet skal du åbne app > src > main > java > com > rokid > phone > ui > MainPhoneActivity.kt. Behold den eksisterende NetServiceType-import øverst i MainPhoneActivity.kt. Hvis den mangler, så tilføj følgende linje sammen med de øvrige imports:
Kotlin
import com.rokid.security.phone.sdk.base.data.NetServiceType
Find derefter banServiceList inde i initSDK(). Erstat dens aktive deklaration med linjen nedenfor. Behold de eksisterende tomme UserAuthInfo-felter og klient-id'er. Kildekoden dokumenterer denne indstilling til deaktivering af netværkstjenester; den deaktiverer ikke den lokale Bluetooth-test.
val banServiceList: List<NetServiceType> = arrayListOf(NetServiceType.ALL)
· Hold fremtidige legitimationsoplysninger adskilt: AK er en adgangsnøgle (access key), og SK er den tilhørende hemmelige nøgle. Til senere godkendte tjenester skal du anmode om legitimationsoplysningerne til enterprise-tjenesterne hos din salgs- eller forretningskontakt hos Rokid. I UserAuthInfo modtager appId AK, og secret modtager SK. Brug beskyttet projektkonfiguration til testlegitimationsoplysninger, og commit aldrig rigtige nøgler. Denne lokale første kørsel har ikke brug for disse onlinefunktioner.
· Tilføj engelske initialiseringslogs: I telefonprojektet skal du åbne app > src > main > java > com > rokid > phone > ui > MainPhoneActivity.kt. I initSDK() skal du tilføje en engelsk logbesked i success-callbacket:
Kotlin
Log.d(TAG, “Phone SDK ready”)
I brilleprojektet skal du åbne app > src > main > java > com > rokid > glass > HomeActivity.kt. initSDK() kalder GlassSdkUtils.initSdk() og indsamler derefter GlobalData.sdkInitState; inde i denne collector skal du lige efter linjen Log.d(TAG, “SDK 初始化成功”) tilføje den engelske logbesked:“
Kotlin
Log.d(TAG, “Glasses SDK ready”)
(Bemærk: Hvis Android Studio fremhæver klassereferencer med rødt, så tryk på Alt + Enter for automatisk at importere de nødvendige pakker.)
· Undgå at ændre opstartsadfærden: I brilleprojektet skal du åbne app > src > main > java > com > rokid > glass > HomeActivity.kt. I onCreate() skal du udkommentere følgende eksisterende linje ved at sætte // foran den. Linjen konfigurerer automatisk start efter genstart; det er unødvendigt ved en første test på en virksomhedsenhed.
// DeviceUtil.setSystemProp("persist.vendor.boot.pkg", this.packageName)
· Gør modtagetesten til ren tekst: I samme mappe, com > rokid > glass, skal du åbne MessageReceiveActivity.kt. Erstat kun dens onTextMessage-funktion i mMessageListener med koden nedenfor. Den modtagne tekst forbliver synlig og bliver logget, uden at taletjenester aktiveres. Et callback er en funktion, som SDK'et kalder, når en hændelse indtræffer.
override fun onTextMessage(msg: String) {
log(msg)
}
Trin 7 Byg og kør telefonapplikationen
· Aktivér USB-debugging på telefonen: På testtelefonen skal du åbne Settings og bruge søgefeltet til at finde Build number. Åbn den tilhørende side med enhedsoplysninger, og tryk på Build number syv gange; indtast enhedens pinkode, hvis du bliver bedt om det. Gå tilbage til Settings, søg efter Developer options, åbn den, og aktivér USB debugging. Menuernes placering varierer fra telefonproducent til telefonproducent.
· Tilslut og godkend: Forbind telefonen til computeren med dens USB-datakabel. I telefonens dialogboks Allow USB debugging? skal du kontrollere, at det er udviklingscomputeren, og trykke på Allow. I telefonprojektets øverste værktøjslinje skal du vælge app som kørselskonfiguration og vælge den tilsluttede telefon i rullemenuen med enheder ved siden af.
· Kør appen: Klik på den grønne Run-trekant, eller vælg Run > Run app. Android Studio bygger, installerer og åbner telefondemoen. Den undersøgte apps navn kan være Rokid Enterprise Demo eller rokid白板, og demoens brugerflade er sandsynligvis på kinesisk. Ved tilladelsesdialogerne skal du give den anmodede adgang til Nearby devices og Wi-Fi, som er nødvendig for denne test; ældre Android-versioner kan bede om adgang til placering. Hvis du tidligere har afvist, så brug Settings > Apps > demoen > Permissions til at ændre den relevante tilladelse.
· Kontrollér initialiseringen: Åbn View > Tool Windows > Logcat, vælg telefonen, og indtast package:com.rokid.phone i filterfeltet. Se efter Phone SDK ready, som betyder, at initialiseringen af telefon-SDK'et lykkedes. Lad appen være åben. Hvis testtelefonens politik blokerer debugging eller nødvendige tilladelser, så få IT til at konfigurere denne dedikerede udviklingsenhed, før du fortsætter.
Trin 8 Tilslut og kør brilleapplikationen
Kontrollér brillernes udviklerindstillinger: På Rokid Glass3 skal du gå til Settings > System > Developer Options og bekræfte, at USB Debugging er sat til ON. Hvis menuen er låst eller skjult i din enterprise-build, så kontakt din hardwaredistributør for at få flashet/klargjort firmware med udviklerfunktioner aktiveret, før du fortsætter.
· Kontrollér ADB via det rigtige kabel: Forbind de tændte briller med Glass3-data-debugkablet. I brilleprojektet skal du vælge View > Tool Windows > Terminal. Skriv cd " efterfulgt af den SDK-placering, du gemte i trin 2, og derefter \platform-tools", og tryk på Enter. Kør kommandoen nedenfor i den mappe. Serienummeret er enhedens id, som vises i første kolonne.
.\adb.exe devices -l
· Aflæs enhedens tilstand: Se efter brillernes serienummer efterfulgt af device – ikke offline eller unauthorized. Hvis der vises en godkendelsesdialog på brillerne, så godkend denne udviklingscomputer. Hvis der ikke vises noget, så kontrollér først kablet og USB-porten. Enterprise-builds kan begrænse debugging; bed leverandøren om at klargøre den dokumenterede udviklingsadgang, hvis den er blokeret. Brug ikke vejledninger til forbrugerversionens ledsagerapp i stedet.
· Installer og start: Vælg app i brilleprojektets værktøjslinje, vælg brillerne som mål, f.eks. Rokid RG-glasses, og klik på Run. Appens navn er glassdemo. Åbn Logcat, vælg brillerne, og filtrér på package:com.rokid.glesse. Se efter Glasses SDK ready – den logbesked, der blev tilføjet i trin 6 – som bekræfter, at SDK-initialiseringen lykkedes.
· Spejl brugerfladen: scrcpy er et Android-værktøj til at se og styre skærmen; kablet brug er dokumenteret af Rokid. Åbn den officielle scrcpy-vejledning til Windows, download Windows 64-bit-ZIP-filen, og brug Extract All i File Explorer. Åbn den udpakkede mappe, og dobbeltklik på open_a_terminal_here.bat. Kør adb devices og derefter kommandoen nedenfor, hvor du erstatter GLASSES_SERIAL med brillernes serienummer. I spejlingsvinduet kan du klikke i brillernes brugerflade med computerens mus.
scrcpy -s GLASSES_SERIAL --no-audio
Trin 9 Par enterprise-demoerne
· Åbn telefonens forbindelsesskærm: I Rokid Enterprise Demo skal du trykke på ikonet + øverst til højre for at åbne Discover Bluetooth. I den kinesiske version af telefondemoen (rokid 白板) skal du på siden 设备 (Device) trykke på ikonet + øverst til højre for at åbne 发现蓝牙 (Discover Bluetooth). I det aktive layout i denne kildekoderevision er der ingen Device-fane nederst. Skærmen starter en scanning; vælg den Glass3_…-post, der svarer til dine briller. Hvis scanningen går i stå, så tryk på opdateringsikonet på skærmen.
· Fuldfør parringen: Godkend en eventuel Android-dialog om Bluetooth-parring, og hold øje med en forbindelsesanmodning på brillerne. Vent, indtil forbindelsesindikatoren på telefonens Device-skærm opdateres og viser, at Classic Bluetooth er forbundet. Hvis søge- eller forbindelsessiden stadig er åben efter parringen, så tryk på Androids Tilbage-knap for at vende tilbage til Device. Begge enheder skal have Bluetooth slået til, og brillerne må ikke være forbundet til en anden telefon. Rokids side om fejlfinding af Bluetooth gennemgår disse kontroller.
· Hold den første test lille: Demoen kan også etablere en Wi-Fi P2P-forbindelse og viser den forbindelse separat. Bluetooth er tilstrækkeligt til teksttesten nedenfor. Hvis P2P ikke er forbundet, skal det ikke tolkes som en mislykket Bluetooth-forbindelse. Store filer og live-medier kræver en separat validering af P2P.
Trin 10 Send en arbejdsbesked, og bekræft, at demoen kører
· Angiv testbeskeden: I telefonprojektet skal du åbne app > src > main > java > com > rokid > phone > SendMessageActivity.kt. Find binding.btSendTextBtn.setOnClickListener, og erstat hele denne listener-blok med koden nedenfor.
(Bemærk: Behold den eksisterende PSecuritySDK-import i SendMessageActivity.kt. Hvis den mangler, så tilføj følgende linje øverst i filen sammen med de øvrige imports: import com.rokid.security.phone.sdk.api.PSecuritySDK).
GlassSample er det modtagende klient-id, som brilledemoen allerede har registreret; lad det være uændret i begge ender.
binding.btSendTextBtn.setOnClickListener {
val message = "Work item 001 ready"
PSecuritySDK.getMessageService()
?.sendTextMessageByClassicBT(message, "GlassSample")
log(message)
}
· Kør den ændrede telefonapp: Vælg den tilsluttede telefon i Android Studios vindue til telefonprojektet, og klik på Run > Run app for at genopbygge og installere den ændrede applikation. Vent på, at SDK-initialiseringen lykkes, og bekræft, at Bluetooth-forbindelsen genoprettes. Navigér derefter til Message Receive på brillerne ved hjælp af scrcpy. Klik direkte i det aktive scrcpy-vindue på skrivebordet for at give det fokus. Da brillerne emulerer fysiske D-pad-knapper, skal du bruge højre piletast eller venstre piletast på computerens tastatur til at navigere i menuen, indtil Message Receive eller 消息接收 (Message Receive), det andet menupunkt, er fremhævet, og derefter trykke på Enter for at åbne aktiviteten. Demoen knytter disse taster til menuvalg i HomeActivity.kt. Lad denne modtageside være synlig; den registrerer den message listener, som testen bruger.
· Send fra telefonen: På telefonens side Device eller 设备 skal du rulle ned til kortet Message Send eller 消息发送 og trykke på det. På næste side skal du trykke på Send text via Bluetooth eller 蓝牙发送文本. Knappen sender den faste tekststreng ovenfor; der er intet tekstfelt, der skal udfyldes. Se efter Work item 001 ready på brillernes modtageside.
· Registrér beståelseskriteriet: I brillernes Logcat skal du filtrere på package:com.rokid.glesse tag:MessageActivity og bekræfte, at den samme besked er kommet frem. Telefonens egen afsendelseslog alene beviser ikke, at beskeden er modtaget. Gem SDK-versionerne, firmwarebuildet, kildekoderevisionen og ændringerne af build-værktøjerne sammen med dit resultat. Testen er bestået, når begge apps kører, Bluetooth forbinder, og brillerne synligt modtager testbeskeden.
Almindelige problemer ved opsætningen
· Brillerne lader, men bliver ikke registreret: Brug data-debugkablet, og gentag ADB-kontrollen i trin 8. Det almindelige ladekabel er det første, der skal udelukkes.
· Gradle kan ikke downloade et bibliotek: I Build skal du udvide fejlen og notere den nøjagtige pakke og server-URL. Kontrollér repository-posterne fra trin 5 og adgangen gennem virksomhedens proxy. Demoen indeholder flere repositories og afhængigheder end Rokids to SDK'er; slet dem ikke ukritisk, og tilføj ikke et tilfældigt mirror.
· Fejl med duplikeret logning eller native biblioteker: Kontrollér, om der er duplikerede SDK-poster, og om org.slf4j-udelukkelsen er til stede. Behold de eksisterende packagingOptions-regler for libr2aud.so i brilleappen og libc++_shared.so i telefonappen. En fejl om duplikerede biblioteker betyder, at to afhængigheder har pakket den samme fil.
· Parringen virker, men der kommer ingen besked: Hold brillernes modtageside åben, og bekræft, at GlassSample er uændret. Kontrollér i Logcat begge meddelelser om vellykket initialisering, før du sender. Hvis enheden ikke kan findes, så kontrollér telefonens tilladelser til Nearby devices, og afbryd først forbindelsen til eventuelle andre telefoner.
Konklusion
Opsætningen af et udviklingsmiljø til Rokid Glass3 begynder med enterprise-kompatible briller og det rigtige data-debugkabel og fortsætter derefter med Android Studio, JDK 17, Maven-afhængigheder og en konsistent build-konfiguration. Når telefon- og brilledemoerne kører, og en modtaget arbejdsbesked er verificeret, har man et praktisk udgangspunkt, før der tilføjes forretningslogik eller onlinetjenester. For virksomheder kan denne proces reducere undgåelige forsinkelser i opsætningen, gøre pilotprojekter lettere at gentage og give udviklerne et klarere fundament for applikationer, der leverer nyttig information, mens medarbejderne har hænderne fri.
Bekræft enterprise-hardwaren, data-debugkablet og firmwareunderstøttelsen, før du køber et udviklingskit eller anmoder om et pilotprojekt for din virksomhed.
