Samenvatting
Met een ontwikkelomgeving voor Rokid Glass3 kan een bedrijfsteam Android-applicaties bouwen voor [Rokid AI Glasses Enterprise](https://ai.vr-expert.com/en/ai-glasses/rokid-ai-glasses) en de communicatie met een Android-smartphone testen. Begin met enterprise-firmware, Android Studio, JDK 17, de Maven-repository van Rokid en de Glass3-datadebugkabel. Met de gewone oplaadkabel kun je de brilapplicatie niet installeren of debuggen.
Deze workflow voor Windows 11 opent de twee officiële demoprojecten van Rokid, controleert hun buildconfiguratie, installeert beide apps en stuurt een voorbeeldwerkbericht naar de bril. Daarbij worden de enterprise-SDK en een lokale communicatietest gebruikt. Online spraak- en AI-diensten zijn afzonderlijke integraties. De instructies zijn gecontroleerd aan de hand van de officiële documentatie en de broncode van de demo; er is geen test op een fysiek toestel uitgevoerd.
Zie voor de hardwarecontext de productpagina van Rokid AI Glasses Enterprise. Rokid documenteert de architectuur en runtime van dit enterprise-toestel onder de Glass3 Enterprise SDK. Laat het geleverde toestel en de firmware bevestigen door je leverancier voordat je een ander Rokid-product als compatibel beschouwt.
Vereisten voor Rokid Glass3-ontwikkeling
Hardware: Windows 11-pc, Rokid Glass3 Enterprise (enterprise-firmware), een aparte Android-testsmartphone (Android 13+ aanbevolen) en de Glass3-datadebugkabel.
Software: Android Studio met Android SDK Platform 34 en Build-Tools 35.0.0.
Buildomgeving: JDK 17, AGP 8.4.2, Gradle 8.6 en Kotlin 2.2.0.
SDK's: Glasses SDK en Phone SDK 2.2.0-E.
Stap 1 De enterprise-hardware voorbereiden
· Bevestig het systeem: Firmware is de ingebouwde systeemsoftware van de bril. Vraag je leverancier naar het brilmodel, de geïnstalleerde versie van de enterprise-firmware en de SDK-compatibiliteit. Volgens de FAQ van Rokid bevatten werkbuilds doorgaans een e in het versienummer. Gebruik de enterprise-demo met enterprise-firmware. Een productnaam alleen volstaat niet om compatibiliteit vast te stellen.
· Controleer de kabel: Vraag uitdrukkelijk om de Glass3-datadebugkabel. Sluit die bij het installeren van de demo rechtstreeks aan op de ontwikkelcomputer. Dat het opladen lukt, bewijst nog niet dat de USB-gegevensoverdracht werkt.
· Bereid de test voor: Laad beide toestellen op en houd ze dicht bij elkaar. Gebruik een aparte smartphone en het voorbeeldbericht uit stap 10. Verbreek de verbinding met elke andere smartphone die eerder met deze bril verbonden was, voordat je gaat koppelen.
Glass3-datadebugkabel zoals getoond in de Quick Start van Rokid. Dit is de kabel die nodig is voor het bekabelde ontwikkeltraject.
Gewone Glass3-oplaadkabel zoals getoond door Rokid. Deze kan de datadebugkabel niet vervangen. Laat de functie van de meegeleverde kabel bevestigen door de leverancier.
Stap 2 Android Studio en de Android SDK installeren (al geïnstalleerd? Ga dan naar de volgende stap)
· Download het installatieprogramma: Download en installeer Android Studio via https://developer.android.com/studio.
· Open de applicatie: Open Android Studio. Kies bij de eerste start Do not import settings als die optie wordt aangeboden en gebruik vervolgens de Standard-installatie. Bekijk de SDK-licenties, aanvaard de licenties die voor je bedrijf zijn goedgekeurd en rond het downloaden van de componenten af.
· Installeer de vereiste pakketten: Klik in het welkomstscherm op More Actions > SDK Manager. Selecteer onder SDK Platforms de optie Android 14 / API 34. Selecteer onder SDK Tools de optie Android SDK Platform-Tools. Schakel Show Package Details in, klap Android SDK Build-Tools open en selecteer 35.0.0. Goed om te weten: de Android Gradle Plugin van de demo installeert bij de eerste synchronisatie zelf de build tools 34.0.0 die hij nodig heeft. Klik op Apply, controleer de pakketlijst en klik dan op OK om te installeren.
· Noteer de SDK-locatie: Noteer het pad bij Android SDK Location voor de ADB-configuratie in stap 8.
Stap 3 De twee demoprojecten downloaden en openen
· Haal de broncode op: Ga in je browser naar de officiële Glass3-enterprise-demorepository (bijv. https://github.com/RokidSuuport/glass3_sdk_demo.git – goed om te weten: dit is wel degelijk de officiële Git-repository, ook al is Support verkeerd gespeld) of naar de Git-repository die je leverancier heeft verstrekt. Klik op de groene knop Code en vervolgens op Download ZIP. Klik in File Explorer > Downloads met de rechtermuisknop op het ZIP-bestand en kies Extract All > Extract. Bewaar de uitgepakte map op een door het bedrijf goedgekeurde ontwikkellocatie.
· Open het smartphoneproject: Klik in het welkomstscherm van Android Studio op Open. Blader naar de uitgepakte map, selecteer glass3sdkphonedemo en klik op OK. Verschijnt er een vraag om het project te vertrouwen, controleer dan eerst of dit de officiële bron is die je hebt gedownload. De buitenste map van de repository is niet het Android-project.
· Open het brilproject: Kies File > Open, selecteer de naastgelegen map glassdemo en kies New Window wanneer daarom wordt gevraagd. Houd beide vensters open. Elk project heeft een eigen Gradle-configuratie en een app-module, het onderdeel dat de installeerbare applicatie aanmaakt.
· Gebruik de bestandsweergave: Open in elk venster View > Tool Windows > Project. Kies in het keuzemenu bovenaan het linkerpaneel Project. Zo zie je de echte mappen en bestanden die hieronder worden gebruikt. Meldt de eerste synchronisatie een fout, voer dan eerst stap 4 en 5 uit en probeer het daarna opnieuw.
Stap 4 JDK 17 selecteren voor beide projecten
· Open de Gradle-instellingen: Kies in het venster van het smartphoneproject File > Settings > Build, Execution, Deployment > Build Tools > Gradle. Zoek het keuzemenu Gradle JDK. Dit bepaalt welke Java-versie wordt gebruikt om het project te bouwen, los van de Java-runtime waarmee Android Studio zelf wordt gestart.
· Selecteer of download Java 17: Kies een geïnstalleerde JDK met het label 17. Staat er geen in de lijst, kies dan Download JDK, selecteer Version 17, kies een leverancier die door IT is goedgekeurd en klik op Download. Selecteer de gedownloade JDK bij Gradle JDK en klik vervolgens op Apply > OK. Herhaal dit in het venster van het brilproject.
· Behoud de bestaande codedoelen: De instellingen sourceCompatibility, targetCompatibility en Kotlin-jvmTarget van de demo gebruiken 1.8. Die beschrijven de compatibiliteit van de gecompileerde code; ze betekenen niet dat Gradle op JDK 8 moet draaien. Laat ze voor deze demo ongewijzigd. De Java-buildhandleiding van Google maakt onderscheid tussen deze instellingen.
Stap 5 Maven-dependencies controleren en de buildtools op elkaar afstemmen
Een Maven-repository is een server waar Gradle bibliotheekpakketten vindt, waaronder de SDK van Rokid.
· Controleer de repository: Dubbelklik in het linkerpaneel van elk project op settings.gradle. Zoek dependencyResolutionManagement > repositories en controleer of de onderstaande Maven-URL van Rokid aanwezig is. Voeg alleen de ontbrekende regel toe binnen het bestaande blok. Behoud de andere repository's van de demo voor de overige dependencies; vraag IT om toegang goed te keuren als een bedrijfsproxy ze blokkeert.
// Binnen settings.gradle > dependencyResolutionManagement
repositories {
google()
mavenCentral()
maven { url = uri("https://maven.rokid.com/repository/maven-public/") }
}
· Controleer de twee SDK-pakketten: Open app > build.gradle in elk venster. Behoud in dependencies één actieve regel voor de juiste SDK. De onderstaande fragmenten zijn in Groovy geschreven, de syntaxis die deze demo gebruikt. Voeg de bril-SDK niet toe aan het smartphoneproject en plak geen tweede dependencies-blok. org.slf4j is een groep loggingbibliotheken; de uitsluiting voorkomt dubbele loggingklassen.
// 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"
}
· Stem AGP en Gradle op elkaar af: Kotlin is de programmeertaal die deze demo's gebruiken. Open voor de onderzochte snapshot in beide projecten gradle > libs.versions.toml. Wijzig onder [versions] alleen agp in 8.4.2 als dat nog niet het geval is; behoud kotlin = "2.2.0". Open daarna gradle > wrapper > gradle-wrapper.properties en vervang alleen distributionUrl door de onderstaande regel. De wrapper downloadt de gekozen Gradle-versie. Google documenteert welke Gradle- en JDK-versies bij AGP 8.10 horen.
# 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
· Synchroniseer en controleer het resultaat: Sla de bewerkte bestanden op en kies vervolgens in beide vensters File > Sync Project with Gradle Files. Open View > Tool Windows > Build en controleer de uitvoer van de synchronisatie. Aanvaard geen automatische upgrades die hier niets mee te maken hebben. De demo bevat al verpakkingsregels voor native bibliotheken; behoud die. Een native bibliotheek is gecompileerde toestelcode die samen met de APK wordt verpakt.
Stap 6 Een lokale zakelijke demo configureren
· Schakel online diensten uit voor deze test: Open in het smartphoneproject app > src > main > java > com > rokid > phone > ui > MainPhoneActivity.kt. Behoud bovenaan MainPhoneActivity.kt de bestaande import van NetServiceType. Ontbreekt die, voeg dan de volgende regel toe bij de andere imports:
Kotlin
import com.rokid.security.phone.sdk.base.data.NetServiceType
Zoek daarna banServiceList binnen initSDK(). Vervang de actieve declaratie ervan door de onderstaande regel. Behoud de bestaande lege UserAuthInfo-velden en de client-ID's. De bron documenteert deze optie om netwerkdiensten uit te schakelen; de lokale Bluetooth-test wordt er niet door uitgeschakeld.
val banServiceList: List<NetServiceType> = arrayListOf(NetServiceType.ALL)
· Houd toekomstige inloggegevens gescheiden: AK is een toegangssleutel (access key) en SK is de bijbehorende geheime sleutel. Vraag voor latere geauthenticeerde diensten de enterprise-servicegegevens aan bij je sales- of zakelijke contactpersoon bij Rokid. In UserAuthInfo krijgt appId de AK en secret de SK. Gebruik een beveiligde projectconfiguratie voor testgegevens en commit nooit echte sleutels. Deze eerste lokale run heeft die onlinefuncties niet nodig.
· Voeg Engelstalige initialisatielogs toe: in het smartphoneproject open je app > src > main > java > com > rokid > phone > ui > MainPhoneActivity.kt. Voeg in initSDK() binnen de success-callback een Engelstalige log toe:
Kotlin
Log.d(TAG, “Phone SDK ready”)
Open in het brilproject app > src > main > java > com > rokid > glass > HomeActivity.kt. initSDK() roept GlassSdkUtils.initSdk() aan en verzamelt daarna GlobalData.sdkInitState; voeg binnen die collector, direct na de regel Log.d(TAG, “SDK 初始化成功”), de Engelstalige log toe:
Kotlin
Log.d(TAG, “Glasses SDK ready”)
(Opmerking: Als Android Studio klasseverwijzingen rood markeert, druk dan op Alt + Enter om de vereiste pakketten automatisch te importeren.)
· Wijzig het opstartgedrag niet: Open in het brilproject app > src > main > java > com > rokid > glass > HomeActivity.kt. Zet binnen onCreate() de volgende bestaande regel in commentaar door er // voor te plaatsen. Die regel zorgt ervoor dat de app automatisch start na een herstart; dat is overbodig voor een eerste test op een bedrijfstoestel.
// DeviceUtil.setSystemProp("persist.vendor.boot.pkg", this.packageName)
· Beperk de ontvangsttest tot tekst: Open in dezelfde map com > rokid > glass het bestand MessageReceiveActivity.kt. Vervang alleen de functie onTextMessage binnen mMessageListener door de onderstaande code. De ontvangen tekst blijft zichtbaar en wordt gelogd, zonder dat spraakdiensten worden aangeroepen. Een callback is een functie die de SDK aanroept wanneer er een gebeurtenis binnenkomt.
override fun onTextMessage(msg: String) {
log(msg)
}
Stap 7 De smartphone-app bouwen en uitvoeren
· Schakel USB-foutopsporing in op de smartphone: Open op de testsmartphone Settings en gebruik het zoekveld om Build number te vinden. Open de bijbehorende pagina met toestelinformatie en tik zeven keer op Build number; voer de pincode van het toestel in als daarom wordt gevraagd. Ga terug naar Settings, zoek naar Developer options, open die en schakel USB debugging in. De menulocaties verschillen per smartphonefabrikant.
· Verbind en geef toestemming: Verbind de smartphone met de computer via de bijbehorende USB-datakabel. Controleer in het dialoogvenster Allow USB debugging? op de smartphone of dit de ontwikkelcomputer is en tik op Allow. Kies in de bovenste werkbalk van het smartphoneproject app als runconfiguratie en selecteer de verbonden smartphone in het keuzemenu voor toestellen ernaast.
· Start de app: Klik op het groene driehoekje Run of kies Run > Run app. Android Studio bouwt, installeert en opent de smartphonedemo. Het onderzochte app-label kan Rokid Enterprise Demo of rokid白板 zijn, en de interface van de demo is waarschijnlijk in het Chinees. Sta in de toestemmingsvensters de gevraagde toegang tot Nearby devices en wifi toe die voor deze test nodig is; oudere Android-versies kunnen om Location vragen. Heb je die eerder geweigerd, wijzig de betreffende toestemming dan via Settings > Apps > de demo > Permissions.
· Controleer de initialisatie: Open View > Tool Windows > Logcat, selecteer de smartphone en voer package:com.rokid.phone in het filterveld in. Zoek naar Phone SDK ready, wat betekent dat de initialisatie van de smartphone-SDK gelukt is. Laat de app open. Als het beleid van de testsmartphone foutopsporing of vereiste toestemmingen blokkeert, laat IT dit aparte ontwikkeltoestel dan configureren voordat je verdergaat.
Stap 8 De bril-app verbinden en uitvoeren
Controleer de ontwikkelaarsinstellingen van de bril: Ga op de Rokid Glass3 naar Settings > System > Developer Options en controleer of USB Debugging op ON staat. Is het optiemenu op je enterprise-build vergrendeld of verborgen, neem dan contact op met je hardwaredistributeur om firmware met ontwikkelaarstoegang te laten flashen/inrichten voordat je verdergaat.
· Controleer ADB via de juiste kabel: Sluit de ingeschakelde bril aan met de Glass3-datadebugkabel. Kies in het brilproject View > Tool Windows > Terminal. Typ cd ", gevolgd door de SDK-locatie die je in stap 2 hebt genoteerd, en daarna \platform-tools", en druk op Enter. Voer in die map de onderstaande opdracht uit. Het serienummer is de toestel-ID die in de eerste kolom wordt weergegeven.
.\adb.exe devices -l
· Lees de toestelstatus af: Zoek het serienummer van de bril, gevolgd door device, niet offline of unauthorized. Verschijnt er op de bril een autorisatievenster, keur deze ontwikkelcomputer dan goed. Verschijnt er niets, controleer dan eerst de kabel en de USB-poort. Enterprise-builds kunnen foutopsporing beperken; vraag de leverancier om de gedocumenteerde ontwikkeltoegang in te richten als die geblokkeerd is. Vervang deze stappen niet door instructies voor de companion-app voor consumenten.
· Installeer en start: Selecteer in de werkbalk van het brilproject app, kies het brildoel, bijvoorbeeld Rokid RG-glasses, en klik op Run. Het app-label is glassdemo. Open Logcat, selecteer de bril en filter op package:com.rokid.glesse. Zoek naar Glasses SDK ready, de log die in stap 6 is toegevoegd om te bevestigen dat de SDK-initialisatie gelukt is.
· Spiegel de interface: scrcpy is een Android-tool om het scherm te bekijken en te bedienen; bekabeld gebruik wordt door Rokid gedocumenteerd. Open de officiële Windows-instructies van scrcpy, download de ZIP voor Windows 64-bit en gebruik Extract All in File Explorer. Open de uitgepakte map en dubbelklik op open_a_terminal_here.bat. Voer adb devices uit en daarna de onderstaande opdracht, waarbij je GLASSES_SERIAL vervangt door het serienummer van de bril. In het spiegelvenster kun je met de muis van de computer op de interface van de bril klikken.
scrcpy -s GLASSES_SERIAL --no-audio
Stap 9 De enterprise-demo's koppelen
· Open het verbindingsscherm op de smartphone: Tik in Rokid Enterprise Demo op het pictogram + rechtsboven om Discover Bluetooth te openen. Tik in de Chinese versie van de smartphonedemo (rokid 白板) op de pagina 设备 (Device) op het pictogram + rechtsboven om 发现蓝牙 (Discover Bluetooth) te openen. In de actieve lay-out van deze bronrevisie is er onderaan geen tabblad Device. Er start een scan; kies de vermelding Glass3_… die overeenkomt met je bril. Blijft de scan hangen, tik dan op het vernieuwpictogram op dat scherm.
· Rond het koppelen af: Keur elk Android-dialoogvenster voor Bluetooth-koppeling dat verschijnt goed en kijk op de bril of er een verbindingsverzoek is. Wacht tot de verbindingsindicator op het Device-scherm van de smartphone aangeeft dat Classic Bluetooth verbonden is. Blijft de zoek- of verbindingspagina na het koppelen open, tik dan op de Android-knop Back om terug te keren naar Device. Op beide toestellen moet Bluetooth ingeschakeld zijn en de bril mag niet met een andere smartphone verbonden zijn. De Bluetooth-probleemoplossingspagina van Rokid somt deze controles op.
· Houd de eerste test klein: De demo kan ook Wi-Fi P2P opzetten en toont die verbinding afzonderlijk. Bluetooth volstaat voor de teksttest hieronder. Is P2P niet verbonden, beschouw dat dan niet als een mislukte Bluetooth-verbinding. Grote bestanden en live media vereisen een aparte P2P-validatie.
Stap 10 Een werkbericht versturen en de werkende demo bevestigen
· Stel het testbericht in: Open in het smartphoneproject app > src > main > java > com > rokid > phone > SendMessageActivity.kt. Zoek binding.btSendTextBtn.setOnClickListener en vervang dat volledige listener-blok door de onderstaande code.
(Opmerking: behoud in SendMessageActivity.kt de bestaande import van PSecuritySDK. Ontbreekt die, voeg dan de volgende regel bovenaan het bestand toe, bij de andere imports: import com.rokid.security.phone.sdk.api.PSecuritySDK).
GlassSample is de ontvangende client-ID die de brildemo al registreert; laat die aan beide kanten ongewijzigd.
binding.btSendTextBtn.setOnClickListener {
val message = "Work item 001 ready"
PSecuritySDK.getMessageService()
?.sendTextMessageByClassicBT(message, "GlassSample")
log(message)
}
· Voer de gewijzigde smartphone-app uit: Selecteer in het venster van het smartphoneproject in Android Studio de verbonden smartphone en klik op Run > Run app om de aangepaste applicatie opnieuw te bouwen en te installeren. Wacht tot de SDK-initialisatie gelukt is en controleer of Bluetooth opnieuw verbinding maakt. Navigeer daarna met scrcpy op de bril naar Message Receive. Klik rechtstreeks in het actieve scrcpy-venster op je computer om het de focus te geven. Omdat de bril hardwarematige D-pad-knoppen emuleert, gebruik je de toets Pijl-rechts of Pijl-links op het toetsenbord van je computer om door het menu te navigeren tot Message Receive of 消息接收 (Message Receive), het tweede menu-item, gemarkeerd is, en druk je vervolgens op Enter om de activity te openen. De demo koppelt deze toetsen aan de menuselectie in HomeActivity.kt. Laat deze ontvangstpagina zichtbaar; ze registreert de berichtlistener die deze test gebruikt.
· Verstuur vanaf de smartphone: Scrol op de pagina Device of 设备 van de smartphone naar de kaart Message Send of 消息发送 en tik erop. Tik op de volgende pagina op Send text via Bluetooth of 蓝牙发送文本. Deze knop verstuurt de vaste tekenreeks van hierboven; er is geen tekstveld om in te vullen. Zoek naar Work item 001 ready op de ontvangstpagina van de bril.
· Leg de slaagvoorwaarde vast: Filter in Logcat van de bril op package:com.rokid.glesse tag:MessageActivity en controleer of hetzelfde bericht is aangekomen. De verzendlog van de smartphone zelf bewijst nog niet dat het bericht ontvangen is. Bewaar de SDK-versies, de firmwarebuild, de bronrevisie en de wijzigingen aan de buildtools samen met je resultaat. Geslaagd betekent dat beide apps draaien, Bluetooth verbinding maakt en de bril het testbericht zichtbaar ontvangt.
Veelvoorkomende problemen bij de configuratie
· De bril laadt op maar wordt niet gedetecteerd: Gebruik de datadebugkabel en herhaal de ADB-controle uit stap 8. De gewone oplaadkabel is het eerste wat je moet uitsluiten.
· Gradle kan een bibliotheek niet downloaden: Klap in Build de foutmelding open en noteer het exacte pakket en de server-URL. Controleer de repository-vermeldingen uit stap 5 en de toegang via de bedrijfsproxy. De demo bevat naast de twee SDK's van Rokid nog andere repository's en dependencies; verwijder die niet zomaar en voeg geen willekeurige mirror toe.
· Fouten met dubbele logging of native bibliotheken: Controleer op dubbele SDK-vermeldingen en op de uitsluiting van org.slf4j. Behoud de bestaande packagingOptions-regels voor libr2aud.so in de bril-app en libc++_shared.so in de smartphone-app. Een fout over een dubbele bibliotheek betekent dat twee dependencies hetzelfde bestand hebben verpakt.
· Koppelen lukt, maar er komt geen bericht aan: Houd de ontvangstpagina op de bril open en controleer of GlassSample ongewijzigd is. Controleer in Logcat beide meldingen van geslaagde initialisatie voordat je verstuurt. Kan het toestel niet worden gevonden, controleer dan de toestemmingen voor Nearby devices op de smartphone en verbreek eerst de verbinding met elke andere smartphone.
Conclusie
Het opzetten van een ontwikkelomgeving voor Rokid Glass3 begint met een enterprise-compatibele bril en de juiste datadebugkabel, en loopt vervolgens via Android Studio, JDK 17, Maven-dependencies en een consistente buildconfiguratie. Door de smartphone- en brildemo uit te voeren en te verifiëren dat een werkbericht ontvangen wordt, leg je een praktische basis voordat je bedrijfslogica of online diensten toevoegt. Voor bedrijven kan dit proces vermijdbare vertragingen bij de configuratie beperken, pilots gemakkelijker reproduceerbaar maken en ontwikkelaars een duidelijkere basis geven voor applicaties die nuttige informatie leveren terwijl medewerkers hun handen vrij houden.
Controleer of de enterprise-hardware, de datadebugkabel en de firmware ondersteund worden voordat je een development kit aankoopt of een bedrijfspilot aanvraagt.
























