Sammanfattning
En utvecklingsmiljö för Rokid Glass3 gör det möjligt för ett företagsteam att bygga Android-appar för [Rokid AI Glasses Enterprise](https://ai.vr-expert.com/en/ai-glasses/rokid-ai-glasses) och testa kommunikationen med en Android-telefon. Börja med företagsfirmware, Android Studio, JDK 17, Rokids Maven-repository och datafelsökningskabeln för Glass3. Den vanliga laddkabeln kan inte användas för att installera eller felsöka appen på glasögonen.
Det här arbetsflödet för Windows 11 öppnar Rokids två officiella demoprojekt, kontrollerar deras byggkonfiguration, installerar respektive app och skickar ett exempel på ett arbetsmeddelande till glasögonen. Det använder företags-SDK:t och ett lokalt kommunikationstest. Onlinetjänster för tal och AI är separata integrationer. Instruktionerna har kontrollerats mot officiell dokumentation och demons källkod; någon körning på en fysisk enhet har inte genomförts.
För information om hårdvaran, se produktsidan för Rokid AI Glasses Enterprise. Rokid dokumenterar den här företagsenhetens arkitektur och körmiljö under Glass3 Enterprise SDK. Bekräfta den levererade enheten och firmwaren med din leverantör innan du betraktar en annan Rokid-produkt som kompatibel.
Krav för utveckling med Rokid Glass3
Hårdvara: Windows 11-dator, Rokid Glass3 Enterprise (företagsfirmware), en dedikerad Android-testtelefon (Android 13+ rekommenderas) och Glass3-datafelsökningskabeln.
Programvara: Android Studio med Android SDK Platform 34 och Build-Tools 35.0.0.
Byggmiljö: JDK 17, AGP 8.4.2, Gradle 8.6 och Kotlin 2.2.0.
SDK:er: Glasses SDK och Phone SDK 2.2.0-E.
Steg 1 Förbered företagshårdvaran
· Bekräfta systemet: Firmware är glasögonens inbyggda systemprogramvara. Be din leverantör om glasögonmodell, installerad version av företagsfirmwaren och SDK-kompatibilitet. Enligt Rokids FAQ innehåller versionsnumret för arbetsversioner vanligtvis ett e. Använd företagsdemon tillsammans med företagsfirmware. Enbart ett produktnamn räcker inte för att fastställa kompatibilitet.
· Kontrollera kabeln: Se uttryckligen till att skaffa datafelsökningskabeln för Glass3. Anslut den direkt till utvecklingsdatorn när du installerar demon. Att laddningen fungerar bevisar inte att USB-dataöverföringen fungerar.
· Förbered testet: Ladda båda enheterna och håll dem nära varandra. Använd en dedikerad telefon och exempelmeddelandet i steg 10. Koppla från alla andra telefoner som tidigare varit anslutna till glasögonen innan du parkopplar.
Datafelsökningskabeln för Glass3 som den visas i Rokids snabbstartsguide. Det är den här kabeln som krävs för den trådbundna utvecklingsvägen.
Vanlig laddkabel för Glass3 som den visas av Rokid. Den kan inte ersätta datafelsökningskabeln. Bekräfta den medföljande kabelns funktion med leverantören.
Steg 2 Installera Android Studio och Android SDK (om det redan är installerat, gå vidare till nästa steg)
· Ladda ned installationsprogrammet: Ladda ned och installera Android Studio från https://developer.android.com/studio.
· Öppna programmet: Öppna Android Studio. Vid första start väljer du Do not import settings om alternativet visas och använder sedan Standard-konfigurationen. Granska SDK-licenserna, godkänn de som är godkända för ditt företag och slutför nedladdningen av komponenterna.
· Installera de nödvändiga paketen: Klicka på More Actions > SDK Manager på välkomstskärmen. Under SDK Platforms väljer du Android 14 / API 34. Under SDK Tools väljer du Android SDK Platform-Tools. Aktivera Show Package Details, expandera Android SDK Build-Tools och välj 35.0.0. Observera att demons Android Gradle Plugin installerar de build tools i version 34.0.0 som den behöver vid den första synkroniseringen. Klicka på Apply, granska paketlistan och klicka sedan på OK för att installera.
· Spara SDK-platsen: Anteckna sökvägen under Android SDK Location för ADB-konfigurationen i steg 8.
Steg 3 Ladda ned och öppna de två demoprojekten
· Hämta källkoden: Gå i webbläsaren till det officiella demorepositoryt för Glass3 Enterprise (t.ex. https://github.com/RokidSuuport/glass3_sdk_demo.git – observera att detta verkligen är det officiella Git-repositoryt trots att Support är felstavat) eller till det Git-repository som din leverantör tillhandahållit. Klicka på den gröna knappen Code och sedan på Download ZIP. I File Explorer > Downloads, högerklickar du på ZIP-filen och väljer Extract All > Extract. Spara den extraherade mappen på en utvecklingsplats som är godkänd av företaget.
· Öppna telefonprojektet: På Android Studios välkomstskärm klickar du på Open. Bläddra in i den extraherade mappen, välj glass3sdkphonedemo och klicka på OK. Om en fråga om förtroende (trust) visas kontrollerar du att det är den officiella källkod du laddade ned innan du litar på den. Repositoryts yttre mapp är inte Android-projektet.
· Öppna glasögonprojektet: Välj File > Open, välj den intilliggande mappen glassdemo och välj New Window när du tillfrågas. Låt båda fönstren vara öppna. Vart och ett har sin egen Gradle-konfiguration och en app-modul, den del som skapar den installerbara appen.
· Använd filvyn: Öppna View > Tool Windows > Project i respektive fönster. I rullgardinsmenyn högst upp i den vänstra panelen väljer du Project. Då visas de faktiska mappar och filer som används nedan. Om den första synkroniseringen rapporterar ett fel slutför du steg 4 och 5 innan du försöker igen.
Steg 4 Välj JDK 17 för båda projekten
· Öppna Gradle-inställningarna: I telefonprojektets fönster väljer du File > Settings > Build, Execution, Deployment > Build Tools > Gradle. Leta upp rullgardinsmenyn Gradle JDK. Den styr vilken Java-version som används för att bygga projektet, oberoende av den Java-körmiljö som startar Android Studio.
· Välj eller ladda ned Java 17: Välj en installerad JDK märkt 17. Om ingen finns i listan väljer du Download JDK, väljer Version 17, väljer en leverantör som godkänts av IT och klickar på Download. Välj den nedladdade JDK:n i Gradle JDK och klicka sedan på Apply > OK. Upprepa i glasögonprojektets fönster.
· Behåll de befintliga kodmålen: Demons sourceCompatibility, targetCompatibility och Kotlin-inställningen jvmTarget använder 1.8. De anger den kompilerade kodens kompatibilitet; de betyder inte att Gradle ska köras på JDK 8. Låt dem vara oförändrade för den här demon. Googles guide för Java-byggen skiljer mellan dessa inställningar.
Steg 5 Kontrollera Maven-beroenden och anpassa byggverktygen
Ett Maven-repository är en server där Gradle hittar bibliotekspaket, däribland Rokids SDK.
· Kontrollera repositoryt: Dubbelklicka på settings.gradle i respektive projekts vänstra panel. Leta upp dependencyResolutionManagement > repositories och bekräfta att Rokids Maven-URL nedan finns med. Lägg bara till den saknade raden i det befintliga blocket. Behåll demons övriga repositoryn för dess andra beroenden; be IT godkänna åtkomst om en proxy i företaget blockerar dem.
// Inside settings.gradle > dependencyResolutionManagement
repositories {
google()
mavenCentral()
maven { url = uri("https://maven.rokid.com/repository/maven-public/") }
}
· Kontrollera de två SDK-paketen: Öppna app > build.gradle i respektive fönster. Under dependencies behåller du en enda aktiv post för rätt SDK. Kodexemplen nedan är skrivna i Groovy, den syntax som demon använder. Lägg inte till glasögon-SDK:t i telefonprojektet och klistra inte in ett andra dependencies-block. org.slf4j är en grupp av loggningsbibliotek; undantaget förhindrar dubbla loggningsklasser.
// 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"
}
· Anpassa AGP och Gradle: Kotlin är det programmeringsspråk som demoprojekten använder. För den granskade ögonblicksbilden öppnar du gradle > libs.versions.toml i båda projekten. Under [versions] ändrar du endast agp till 8.4.2 om den inte redan har det värdet; behåll kotlin = "2.2.0". Öppna sedan gradle > wrapper > gradle-wrapper.properties och ersätt endast distributionUrl med raden nedan. Wrappern laddar ned den valda Gradle-versionen. Google dokumenterar vilka Gradle- och JDK-versioner som hör ihop med 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
· Synkronisera och granska resultatet: Spara de redigerade filerna och välj sedan File > Sync Project with Gradle Files i båda fönstren. Öppna View > Tool Windows > Build och kontrollera synkroniseringsutdata. Godkänn inte orelaterade automatiska uppgraderingar. Demon innehåller redan paketeringsregler för native-bibliotek; behåll dem. Ett native-bibliotek är kompilerad enhetskod som paketeras med APK-filen.
Steg 6 Konfigurera en lokal affärsdemo
· Inaktivera onlinetjänster för det här testet: I telefonprojektet öppnar du app > src > main > java > com > rokid > phone > ui > MainPhoneActivity.kt. Högst upp i MainPhoneActivity.kt behåller du den befintliga NetServiceType-importen. Om den saknas lägger du till följande rad bland de andra importerna:
Kotlin
import com.rokid.security.phone.sdk.base.data.NetServiceType
Leta sedan upp banServiceList i initSDK(). Ersätt dess aktiva deklaration med raden nedan. Behåll de befintliga tomma UserAuthInfo-fälten och klient-ID:na. Källkoden dokumenterar det här alternativet för att inaktivera nätverkstjänster; det inaktiverar inte det lokala Bluetooth-testet.
val banServiceList: List<NetServiceType> = arrayListOf(NetServiceType.ALL)
· Håll framtida inloggningsuppgifter åtskilda: AK är en åtkomstnyckel (access key) och SK är dess hemlighet. För senare autentiserade tjänster begär du inloggningsuppgifterna för företagstjänsterna från din säljare eller affärskontakt hos Rokid. I UserAuthInfo tilldelas appId värdet AK och secret värdet SK. Använd skyddad projektkonfiguration för testuppgifter och checka aldrig in riktiga nycklar. Den här första lokala körningen behöver inte dessa onlinefunktioner.
· Lägg till engelska initieringsloggar: I telefonprojektet öppnar du app > src > main > java > com > rokid > phone > ui > MainPhoneActivity.kt. I initSDK() lägger du till en engelsk logg i success-callbacken:
Kotlin
Log.d(TAG, “Phone SDK ready”)
I glasögonprojektet öppnar du app > src > main > java > com > rokid > glass > HomeActivity.kt. initSDK() anropar GlassSdkUtils.initSdk() och samlar sedan in GlobalData.sdkInitState; i den insamlaren, direkt efter raden Log.d(TAG, “SDK 初始化成功”), lägger du till den engelska loggen:“
Kotlin
Log.d(TAG, “Glasses SDK ready”)
(Obs: Om Android Studio markerar klassreferenser i rött trycker du på Alt + Enter för att automatiskt importera de nödvändiga paketen.)
· Undvik att ändra startbeteendet: I glasögonprojektet öppnar du app > src > main > java > com > rokid > glass > HomeActivity.kt. I onCreate() kommenterar du bort följande befintliga rad genom att sätta // i början av den. Raden konfigurerar automatisk start efter omstart; det behövs inte för ett första test på en företagsenhet.
// DeviceUtil.setSystemProp("persist.vendor.boot.pkg", this.packageName)
· Gör mottagningstestet till enbart text: I samma mapp, com > rokid > glass, öppnar du MessageReceiveActivity.kt. Ersätt endast dess funktion onTextMessage i mMessageListener med koden nedan. Den mottagna texten visas och loggas fortfarande, utan att taltjänster anropas. En callback är en funktion som SDK:t anropar när en händelse inträffar.
override fun onTextMessage(msg: String) {
log(msg)
}
Steg 7 Bygg och kör telefonappen
· Aktivera USB-felsökning på telefonen: Öppna Settings på testtelefonen och använd sökrutan för att hitta Build number. Öppna motsvarande sida med enhetsinformation och tryck på Build number sju gånger; ange enhetens PIN-kod om du ombeds. Gå tillbaka till Settings, sök efter Developer options, öppna det och aktivera USB debugging. Menyernas placering varierar mellan telefontillverkare.
· Anslut och auktorisera: Anslut telefonen till datorn med dess USB-datakabel. I telefonens dialogruta Allow USB debugging? kontrollerar du att det är utvecklingsdatorn och trycker på Allow. I telefonprojektets övre verktygsfält väljer du app som körkonfiguration och väljer den anslutna telefonen i enhetsmenyn bredvid.
· Kör appen: Klicka på den gröna triangeln Run eller välj Run > Run app. Android Studio bygger, installerar och öppnar telefondemon. Den granskade appens namn kan vara Rokid Enterprise Demo eller rokid白板, och demons gränssnitt är sannolikt på kinesiska. I behörighetsdialogerna tillåter du den begärda åtkomsten till Nearby devices och Wi-Fi som behövs för testet; äldre Android-versioner kan begära Location. Om du nekade tidigare använder du Settings > Apps > demoappen > Permissions för att ändra den aktuella behörigheten.
· Kontrollera initieringen: Öppna View > Tool Windows > Logcat, välj telefonen och ange package:com.rokid.phone i filterfältet. Leta efter Phone SDK ready, vilket betyder att initieringen av telefon-SDK:t lyckades. Låt appen vara öppen. Om testtelefonens policy blockerar felsökning eller nödvändiga behörigheter ber du IT att konfigurera den här dedikerade utvecklingsenheten innan du fortsätter.
Steg 8 Anslut och kör glasögonappen
Kontrollera utvecklarinställningarna på glasögonen: På Rokid Glass3 går du till Settings > System > Developer Options och bekräftar att USB Debugging är satt till ON. Om alternativmenyn är låst eller dold i din företagsversion kontaktar du din hårdvarudistributör för att flasha/provisionera firmware med utvecklarläge aktiverat innan du fortsätter.
· Kontrollera ADB via rätt kabel: Anslut de påslagna glasögonen med datafelsökningskabeln för Glass3. I glasögonprojektet väljer du View > Tool Windows > Terminal. Skriv cd " följt av SDK-platsen som du sparade i steg 2, sedan \platform-tools" och tryck på Enter. Kör kommandot nedan i den mappen. Serienumret är enhetsidentifieraren som skrivs ut i den första kolumnen.
.\adb.exe devices -l
· Läs av enhetens status: Leta efter glasögonens serienummer följt av device, inte offline eller unauthorized. Om en auktoriseringsdialog visas på glasögonen godkänner du den här utvecklingsdatorn. Om inget visas kontrollerar du först kabeln och USB-porten. Företagsversioner kan begränsa felsökning; be leverantören att provisionera den dokumenterade utvecklaråtkomsten om den är blockerad. Använd inte instruktioner för konsumentversionens companion-app i stället.
· Installera och starta: I glasögonprojektets verktygsfält väljer du app, väljer glasögonen som mål, till exempel Rokid RG-glasses, och klickar på Run. Appens namn är glassdemo. Öppna Logcat, välj glasögonen och filtrera på package:com.rokid.glesse. Leta efter Glasses SDK ready, loggen som lades till i steg 6, för att bekräfta att SDK-initieringen lyckades.
· Spegla gränssnittet: scrcpy är ett verktyg för att visa och styra en Android-skärm; trådbunden användning är dokumenterad av Rokid. Öppna de officiella Windows-instruktionerna för scrcpy, ladda ned ZIP-filen för Windows 64-bitars och använd Extract All i Utforskaren. Öppna den extraherade mappen och dubbelklicka på open_a_terminal_here.bat. Kör adb devices och sedan kommandot nedan, där du ersätter GLASSES_SERIAL med glasögonens serienummer. I speglingsfönstret kan du klicka i glasögonens gränssnitt med datorns mus.
scrcpy -s GLASSES_SERIAL --no-audio
Steg 9 Parkoppla företagsdemoapparna
· Öppna anslutningsskärmen på telefonen: I Rokid Enterprise Demo trycker du på ikonen + uppe till höger för att öppna Discover Bluetooth. För den kinesiska versionen: i telefondemon (rokid 白板), på sidan 设备 (Device) trycker du på ikonen + uppe till höger för att öppna 发现蓝牙 (Discover Bluetooth). Det finns ingen Device-flik längst ned i den aktiva layouten för den här källkodsrevisionen. Den startar en sökning; välj posten Glass3_… som motsvarar dina glasögon. Om sökningen stannar upp trycker du på uppdateringsikonen på den skärmen.
· Slutför parkopplingen: Godkänn eventuella dialogrutor för Bluetooth-parkoppling i Android och kontrollera om det finns en anslutningsbegäran på glasögonen. Vänta tills telefonens Device-skärm uppdaterar anslutningsindikatorn och visar att Classic Bluetooth är anslutet. Om sök- eller anslutningssidan fortfarande är öppen efter parkopplingen trycker du på Androids Back-knapp för att gå tillbaka till Device. Bluetooth måste vara aktiverat på båda enheterna, och glasögonen får inte vara anslutna till någon annan telefon. Rokids felsökningssida för Bluetooth listar dessa kontroller.
· Håll det första testet litet: Demon kan även förhandla fram Wi-Fi P2P och visar den anslutningen separat. Bluetooth räcker för texttestet nedan. Om P2P inte är anslutet ska du inte tolka det som en misslyckad Bluetooth-anslutning. Stora filer och livemedia kräver en separat P2P-validering.
Steg 10 Skicka ett arbetsmeddelande och bekräfta att demon körs
· Ange testmeddelandet: I telefonprojektet öppnar du app > src > main > java > com > rokid > phone > SendMessageActivity.kt. Leta upp binding.btSendTextBtn.setOnClickListener och ersätt hela det lyssnarblocket med koden nedan.
(Obs: I SendMessageActivity.kt behåller du den befintliga PSecuritySDK-importen. Om den saknas lägger du till följande rad högst upp i filen, bland de andra importerna: import com.rokid.security.phone.sdk.api.PSecuritySDK).
GlassSample är det mottagande klient-ID som glasögondemon redan har registrerat; låt det vara oförändrat på båda sidor.
binding.btSendTextBtn.setOnClickListener {
val message = "Work item 001 ready"
PSecuritySDK.getMessageService()
?.sendTextMessageByClassicBT(message, "GlassSample")
log(message)
}
· Kör den ändrade telefonappen: I Android Studios fönster för telefonprojektet väljer du den anslutna telefonen och klickar på Run > Run app för att bygga om och installera den ändrade appen. Vänta tills SDK-initieringen har lyckats och bekräfta att Bluetooth återansluter. Navigera sedan till Message Receive på glasögonen med hjälp av scrcpy. Klicka direkt i det aktiva scrcpy-fönstret på skrivbordet för att ge det fokus. Eftersom glasögonen emulerar fysiska D-pad-kontroller använder du tangenten Högerpil eller Vänsterpil på datorns tangentbord för att navigera i menyn tills Message Receive eller 消息接收 (Message Receive), det andra menyalternativet, är markerat, och trycker sedan på Enter för att öppna aktiviteten. Demon mappar dessa tangenter till menyval i HomeActivity.kt. Låt den här mottagningssidan vara synlig; den registrerar den meddelandelyssnare som används i testet.
· Skicka från telefonen: På telefonens sida Device eller 设备 scrollar du till kortet Message Send eller 消息发送 och trycker på det. På nästa sida trycker du på Send text via Bluetooth eller 蓝牙发送文本. Knappen skickar den fasta strängen ovan; det finns inget textfält att fylla i. Leta efter Work item 001 ready på glasögonens mottagningssida.
· Registrera godkännandevillkoret: I glasögonens Logcat filtrerar du på package:com.rokid.glesse tag:MessageActivity och bekräftar att samma meddelande har kommit fram. Telefonens egen sändningslogg räcker inte som bevis på mottagning. Spara SDK-versionerna, firmwareversionen, källkodsrevisionen och ändringarna av byggverktygen tillsammans med resultatet. Godkänt innebär att båda apparna körs, Bluetooth ansluter och glasögonen synligt tar emot testmeddelandet.
Vanliga problem vid konfigurationen
· Glasögonen laddas men upptäcks inte: Använd datafelsökningskabeln och upprepa ADB-kontrollen i steg 8. Den vanliga laddkabeln är det första du ska utesluta.
· Gradle kan inte ladda ned ett bibliotek: I Build expanderar du felet och noterar exakt paket och server-URL. Kontrollera repositoryposterna från steg 5 och åtkomsten via företagets proxy. Demon innehåller ytterligare repositoryn och beroenden utöver Rokids två SDK:er; ta inte bort dem urskillningslöst och lägg inte till en slumpmässig spegel.
· Dubblettfel för loggning eller native-bibliotek: Kontrollera om det finns dubbla SDK-poster och kontrollera undantaget för org.slf4j. Behåll de befintliga packagingOptions-reglerna för libr2aud.so i glasögonappen och libc++_shared.so i telefonappen. Ett fel om dubblettbibliotek innebär att två beroenden har paketerat samma fil.
· Parkopplingen fungerar men inget meddelande kommer fram: Håll glasögonens mottagningssida öppen och bekräfta att GlassSample är oförändrat. Kontrollera i Logcat att båda meddelandena om lyckad initiering finns innan du skickar. Om enheten inte kan hittas kontrollerar du telefonens behörigheter för Nearby devices och kopplar först från alla andra telefoner.
Slutsats
Att konfigurera en utvecklingsmiljö för Rokid Glass3 börjar med företagskompatibla glasögon och rätt datafelsökningskabel och fortsätter sedan med Android Studio, JDK 17, Maven-beroenden och en konsekvent byggkonfiguration. Att köra telefon- och glasögondemona och verifiera ett mottaget arbetsmeddelande ger en praktisk utgångspunkt innan du lägger till affärslogik eller onlinetjänster. För företag kan den här processen minska onödiga förseningar vid konfigurationen, göra pilotprojekt lättare att återskapa och ge utvecklare en tydligare grund för appar som levererar användbar information medan medarbetarna har händerna fria.
Bekräfta företagshårdvaran, datafelsökningskabeln och stödet för firmware innan du köper ett utvecklingskit eller begär ett pilotprojekt för ditt företag.
