Samenvatting
Met een ontwikkelomgeving voor Rokid Glass3 bouwt een zakelijk team Android-applicaties voor [Rokid AI Glasses Enterprise](https://ai.vr-expert.com/en/ai-glasses/rokid-ai-glasses) en test het de communicatie met een Android-telefoon. Begin met enterprise-firmware, Android Studio, JDK 17, de Maven-repository van Rokid en de Glass3-data-debugkabel. Met de gewone oplaadkabel kunt u de applicatie op de bril niet installeren of debuggen.
Dit werkproces voor Windows 11 opent de twee officiële demoprojecten van Rokid, controleert de buildconfiguratie, installeert beide apps en stuurt een voorbeeldwerkbericht naar de bril. Het maakt gebruik van de enterprise-SDK en een lokale communicatietest. Online spraak- en AI-diensten zijn aparte integraties. De instructies zijn gecontroleerd aan de hand van de officiële documentatie en de broncode van de demo; een test op een fysiek apparaat is niet uitgevoerd.
Zie voor meer informatie over de hardware de productpagina van Rokid AI Glasses Enterprise. Rokid documenteert de architectuur en runtime van dit enterprise-apparaat onder de Glass3 Enterprise SDK. Controleer het geleverde apparaat en de firmware bij uw leverancier voordat u een ander Rokid-product als compatibel beschouwt.
Vereisten voor Rokid Glass3-ontwikkeling
Hardware: Windows 11-pc, Rokid Glass3 Enterprise (enterprise-firmware), een aparte Android-testtelefoon (Android 13+ aanbevolen) en de Glass3-data-debugkabel.
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
· Controleer het systeem: Firmware is de ingebouwde systeemsoftware van de bril. Vraag uw leverancier naar het model van de bril, de geïnstalleerde versie van de enterprise-firmware en de SDK-compatibiliteit. Volgens de FAQ van Rokid bevatten zakelijke builds meestal een e in het versienummer. Gebruik de enterprise-demo met enterprise-firmware. Een productnaam alleen zegt niets over compatibiliteit.
· Controleer de kabel: Vraag expliciet om de Glass3-data-debugkabel. Sluit deze bij het installeren van de demo rechtstreeks aan op de ontwikkelcomputer. Dat de bril goed oplaadt, betekent niet dat USB-dataoverdracht werkt.
· Bereid de test voor: Laad beide apparaten op en houd ze dicht bij elkaar. Gebruik een aparte telefoon en het voorbeeldbericht uit stap 10. Verbreek vóór het koppelen de verbinding met andere telefoons die eerder met deze bril verbonden waren.
De Glass3-data-debugkabel zoals getoond in de Quick Start van Rokid. Deze kabel is nodig voor de bekabelde ontwikkelroute.
De gewone Glass3-oplaadkabel zoals getoond door Rokid. Deze kan de data-debugkabel niet vervangen. Controleer bij de leverancier welke functie de meegeleverde kabel heeft.
Stap 2 Android Studio en de Android SDK installeren (al geïnstalleerd? Ga dan door 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 verschijnt, en kies daarna de Standard-installatie. Bekijk de SDK-licenties, accepteer de licenties die uw bedrijf heeft goedgekeurd en rond het downloaden van de componenten af.
· Installeer de benodigde 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 uit en selecteer 35.0.0. Let op: de Android Gradle Plugin van de demo installeert bij de eerste sync zelf de build tools 34.0.0 die nodig zijn. Klik op Apply, controleer de pakketlijst en klik vervolgens op OK om te installeren.
· Noteer de SDK-locatie: Noteer het pad bij Android SDK Location voor het instellen van ADB in stap 8.
Stap 3 De twee demoprojecten downloaden en openen
· Haal de broncode op: Ga in uw browser naar de officiële Glass3-enterprise-demorepository (bijvoorbeeld https://github.com/RokidSuuport/glass3_sdk_demo.git – dit is echt de officiële Git-repository, ook al is Support verkeerd gespeld) of naar de Git-repository van uw leverancier. Klik op de groene knop Code en daarna 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 ontwikkellocatie die uw bedrijf heeft goedgekeurd.
· Open het telefoonproject: Klik in het welkomstscherm van Android Studio op Open. Blader naar de uitgepakte map, selecteer glass3sdkphonedemo en klik op OK. Verschijnt er een vraag of u het project vertrouwt? Controleer dan eerst of dit de officiële bron is die u 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 maakt.
· Gebruik de bestandsweergave: Open in elk venster View > Tool Windows > Project. Kies in de vervolgkeuzelijst bovenaan het linkerpaneel Project. Zo ziet u de werkelijke mappen en bestanden die hieronder worden gebruikt. Meldt de eerste sync een fout? Voer dan eerst stap 4 en 5 uit en probeer het opnieuw.
Stap 4 JDK 17 selecteren voor beide projecten
· Open de Gradle-instellingen: Kies in het venster van het telefoonproject File > Settings > Build, Execution, Deployment > Build Tools > Gradle. Zoek de vervolgkeuzelijst Gradle JDK. Hiermee bepaalt u met welke Java-versie het project wordt gebouwd, los van de Java-runtime waarmee Android Studio start.
· 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 IT heeft goedgekeurd en klik op Download. Selecteer de gedownloade JDK bij Gradle JDK en klik daarna op Apply > OK. Herhaal dit in het venster van het brilproject.
· Laat de bestaande codetargets ongewijzigd: De instellingen sourceCompatibility, targetCompatibility en Kotlin-jvmTarget van de demo staan op 1.8. Deze bepalen de compatibiliteit van de gecompileerde code; ze betekenen niet dat Gradle op JDK 8 moet draaien. Laat ze voor deze demo ongewijzigd. De Java-buildgids van Google legt het verschil tussen deze instellingen uit.
Stap 5 Maven-dependencies controleren en de build tools 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 Maven-URL van Rokid hieronder aanwezig is. Voeg binnen het bestaande blok alleen de ontbrekende regel toe. Laat de andere repository's van de demo staan, want die zijn nodig voor de overige dependencies. Blokkeert een bedrijfsproxy ze? Vraag IT dan om de toegang goed te keuren.
// 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. Houd in dependencies één actieve regel voor de juiste SDK aan. De onderstaande fragmenten zijn in Groovy, de syntaxis die deze demo gebruikt. Voeg de bril-SDK niet toe aan het telefoonproject en plak geen tweede dependencies-blok. org.slf4j is een groep logbibliotheken; de uitsluiting voorkomt dubbele logklassen.
// 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 naar 8.4.2 als dat nog niet zo is; laat kotlin = "2.2.0" staan. Open daarna gradle > wrapper > gradle-wrapper.properties en vervang alleen distributionUrl door de regel hieronder. 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 daarna File > Sync Project with Gradle Files in beide vensters. Open View > Tool Windows > Build en controleer de sync-uitvoer. Accepteer geen automatische upgrades die hier niets mee te maken hebben. De demo bevat al packagingregels voor native libraries; laat die staan. Een native library is gecompileerde apparaatcode die met de APK wordt meegeleverd.
Stap 6 Een lokale zakelijke demo configureren
· Schakel online diensten uit voor deze test: Open in het telefoonproject app > src > main > java > com > rokid > phone > ui > MainPhoneActivity.kt. Laat bovenaan MainPhoneActivity.kt de bestaande import van NetServiceType staan. 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 in initSDK(). Vervang de actieve declaratie door de regel hieronder. Laat de bestaande lege UserAuthInfo-velden en client-ID's staan. De broncode 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 access key en SK het bijbehorende secret. Vraag voor latere geauthenticeerde diensten de inloggegevens voor de enterprise-services aan bij uw 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 test heeft die online functies niet nodig.
· Voeg Engelstalige initialisatielogs toe: open in het telefoonproject app > src > main > java > com > rokid > phone > ui > MainPhoneActivity.kt. Voeg in initSDK() een Engelstalige log toe binnen de success-callback:
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 in die collector, direct na de regel Log.d(TAG, “SDK 初始化成功”), de Engelstalige log toe:
Kotlin
Log.d(TAG, “Glasses SDK ready”)
(Opmerking: Markeert Android Studio klasseverwijzingen in rood? Druk dan op Alt + Enter om de benodigde pakketten automatisch te importeren.)
· Wijzig het opstartgedrag niet: Open in het brilproject app > src > main > java > com > rokid > glass > HomeActivity.kt. Zet in onCreate() de volgende bestaande regel uit door er // voor te zetten. Die regel stelt automatisch starten na een herstart in; dat is niet nodig voor een eerste test op een bedrijfsapparaat.
// 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 code hieronder. 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 event binnenkomt.
override fun onTextMessage(msg: String) {
log(msg)
}
Stap 7 De telefoonapplicatie bouwen en uitvoeren
· Schakel USB-debugging in op de telefoon: Open op de testtelefoon Settings en zoek via het zoekveld naar Build number. Open de bijbehorende pagina met apparaatinformatie en tik zeven keer op Build number; voer de pincode van het apparaat in als daarom wordt gevraagd. Ga terug naar Settings, zoek naar Developer options, open dit menu en schakel USB debugging in. De menulocaties verschillen per telefoonfabrikant.
· Verbind en autoriseer: Sluit de telefoon met de USB-datakabel aan op de computer. Controleer in het dialoogvenster Allow USB debugging? op de telefoon of dit de ontwikkelcomputer is en tik op Allow. Kies in de bovenste werkbalk van het telefoonproject app als run-configuratie en selecteer de aangesloten telefoon in de apparaatlijst ernaast.
· Start de app: Klik op het groene driehoekje Run of kies Run > Run app. Android Studio bouwt, installeert en opent de telefoondemo. Het label van de onderzochte app is mogelijk Rokid Enterprise Demo of rokid白板, en de interface van de demo is waarschijnlijk in het Chinees. Sta in de toestemmingsdialogen de gevraagde toegang tot Nearby devices en wifi toe die voor deze test nodig is; oudere Android-versies vragen mogelijk om Location. Hebt u dit eerder geweigerd? Wijzig de betreffende toestemming dan via Settings > Apps > the demo > Permissions.
· Controleer de initialisatie: Open View > Tool Windows > Logcat, selecteer de telefoon en voer package:com.rokid.phone in het filterveld in. Zoek naar Phone SDK ready: dat betekent dat de phone SDK is geïnitialiseerd. Houd de app open. Blokkeert het beleid van de testtelefoon debugging of vereiste toestemmingen? Laat IT dit aparte ontwikkelapparaat dan configureren voordat u verdergaat.
Stap 8 De brilapplicatie 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 menu vergrendeld of verborgen in uw enterprise-build? Neem dan contact op met uw hardwaredistributeur om firmware met ontwikkelaarsopties te laten flashen/provisionen voordat u verdergaat.
· Controleer ADB via de juiste kabel: Sluit de ingeschakelde bril aan met de Glass3-data-debugkabel. Kies in het brilproject View > Tool Windows > Terminal. Typ cd ", gevolgd door de SDK-locatie die u in stap 2 hebt genoteerd, daarna \platform-tools", en druk op Enter. Voer in die map de onderstaande opdracht uit. Het serienummer is de apparaat-ID in de eerste kolom.
.\adb.exe devices -l
· Lees de apparaatstatus af: Zoek naar 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 debugging beperken; vraag de leverancier om de gedocumenteerde ontwikkeltoegang in te richten als deze geblokkeerd is. Gebruik geen instructies voor de companion-app voor consumenten als vervanging.
· Installeer en start: Selecteer in de werkbalk van het brilproject app, kies de bril als doel, 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 u in stap 6 hebt toegevoegd en die bevestigt dat de SDK is geïnitialiseerd.
· Spiegel de interface: scrcpy is een Android-tool om het scherm te bekijken en te bedienen; Rokid documenteert het bekabelde gebruik. Open de officiële Windows-instructies voor 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 u GLASSES_SERIAL vervangt door het serienummer van de bril. In het spiegelvenster kunt u 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 telefoon: Tik in Rokid Enterprise Demo op het pictogram + rechtsboven om Discover Bluetooth te openen. Bij de Chinese versie tikt u in de telefoondemo (rokid 白板) op de pagina 设备 (Device) op het pictogram + rechtsboven om 发现蓝牙 (Discover Bluetooth) te openen. In de actieve lay-out van deze bronrevisie is er geen Device-tabblad onderaan. Er start een scan; kies de vermelding Glass3_… die bij uw bril hoort. Loopt de scan vast? Tik dan op het vernieuwpictogram op dat scherm.
· Rond het koppelen af: Keur eventuele Bluetooth-koppelingsdialogen van Android goed en controleer of er op de bril een verbindingsverzoek verschijnt. Wacht tot de verbindingsindicator op het Device-scherm van de telefoon aangeeft dat Classic Bluetooth is verbonden. Blijft de zoek- of verbindingspagina na het koppelen open? Tik dan op de Android-knop Back om terug te gaan naar Device. Op beide apparaten moet Bluetooth zijn ingeschakeld en de bril mag niet met een andere telefoon verbonden zijn. De Bluetooth-pagina voor probleemoplossing van Rokid noemt deze controles.
· Houd de eerste test klein: De demo kan ook een Wi-Fi P2P-verbinding opzetten en toont die verbinding apart. Voor de teksttest hieronder is Bluetooth voldoende. 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 controleren
· Stel het testbericht in: Open in het telefoonproject app > src > main > java > com > rokid > phone > SendMessageActivity.kt. Zoek binding.btSendTextBtn.setOnClickListener en vervang dat hele listener-blok door de code hieronder.
(Opmerking: laat in SendMessageActivity.kt de bestaande import van PSecuritySDK staan. Ontbreekt die, voeg dan bovenaan het bestand, bij de andere imports, de volgende regel toe: import com.rokid.security.phone.sdk.api.PSecuritySDK).
GlassSample is de ontvangende client-ID die de brildemo al heeft geregistreerd; laat deze aan beide kanten ongewijzigd.
binding.btSendTextBtn.setOnClickListener {
val message = "Work item 001 ready"
PSecuritySDK.getMessageService()
?.sendTextMessageByClassicBT(message, "GlassSample")
log(message)
}
· Start de gewijzigde telefoonapp: Selecteer in het venster van het telefoonproject in Android Studio de aangesloten telefoon en klik op Run > Run app om de aangepaste applicatie opnieuw te bouwen en te installeren. Wacht tot de SDK is geïnitialiseerd en controleer of Bluetooth opnieuw verbinding maakt. Ga daarna met scrcpy op de bril naar Message Receive. Klik direct in het actieve scrcpy-venster op uw desktop om het te focussen. Omdat de bril hardwarematige D-pad-bediening emuleert, gebruikt u de toets pijl-rechts of pijl-links op uw toetsenbord om door het menu te navigeren tot Message Receive of 消息接收 (Message Receive), het tweede menu-item, is gemarkeerd. Druk dan op Enter om de activity te openen. De demo koppelt deze toetsen in HomeActivity.kt aan de menuselectie. Laat deze ontvangstpagina zichtbaar; die registreert de message listener voor deze test.
· Verstuur vanaf de telefoon: Scrol op de pagina Device of 设备 van de telefoon 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 tekst hierboven; er is geen invoerveld om tekst in te vullen. Zoek naar Work item 001 ready op de ontvangstpagina van de bril.
· Leg het slaagcriterium vast: Filter in Logcat van de bril op package:com.rokid.glesse tag:MessageActivity en controleer of hetzelfde bericht is aangekomen. Het verzendlog van de telefoon zelf bewijst niet dat het bericht is ontvangen. Sla de SDK-versies, de firmwarebuild, de bronrevisie en de wijzigingen aan de build tools op bij uw resultaat. De test is geslaagd als beide apps draaien, Bluetooth verbinding maakt en de bril het testbericht zichtbaar ontvangt.
Veelvoorkomende problemen bij de installatie
· De bril laadt op, maar wordt niet gedetecteerd: Gebruik de data-debugkabel en herhaal de ADB-controle uit stap 8. Sluit eerst de gewone oplaadkabel uit als oorzaak.
· Gradle kan een bibliotheek niet downloaden: Klap in Build de foutmelding uit en noteer het exacte pakket en de server-URL. Controleer de repository-regels 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 libraries: Controleer op dubbele SDK-regels en op de uitsluiting van org.slf4j. Laat de bestaande packagingOptions-regels voor libr2aud.so in de brilapp en libc++_shared.so in de telefoonapp staan. Een fout over een dubbele library betekent dat twee dependencies hetzelfde bestand hebben meegeleverd.
· Koppelen lukt, maar er komt geen bericht aan: Houd de ontvangstpagina op de bril open en controleer of GlassSample ongewijzigd is. Controleer in Logcat vóór het versturen of beide initialisatiemeldingen zijn verschenen. Kan het apparaat niet worden gevonden? Controleer dan de toestemmingen voor Nearby devices op de telefoon en verbreek eerst de verbinding met andere telefoons.
Conclusie
Een ontwikkelomgeving voor Rokid Glass3 opzetten begint met een bril die compatibel is met enterprise-software en de juiste data-debugkabel. Daarna volgen Android Studio, JDK 17, de Maven-dependencies en een consistente buildconfiguratie. Door de telefoon- en brildemo uit te voeren en te controleren of een werkbericht aankomt, legt u een praktische basis voordat u bedrijfslogica of online diensten toevoegt. Voor bedrijven kan dit proces vermijdbare vertraging bij de installatie beperken, pilots eenvoudiger reproduceerbaar maken en ontwikkelaars een duidelijker fundament geven voor applicaties die nuttige informatie leveren terwijl medewerkers hun handen vrij houden.
Controleer de enterprise-hardware, de data-debugkabel en de firmwareondersteuning voordat u een development kit aanschaft of een pilot voor uw bedrijf aanvraagt.
