Shrnutí
Díky vývojovému prostředí pro Rokid Glass3 může firemní tým vytvářet aplikace pro Android pro [Rokid AI Glasses Enterprise](https://ai.vr-expert.com/en/ai-glasses/rokid-ai-glasses) a testovat komunikaci s telefonem s Androidem. Začněte s podnikovým firmwarem, Android Studiem, JDK 17, repozitářem Maven společnosti Rokid a datovým ladicím kabelem Glass3. Běžným nabíjecím kabelem aplikaci pro brýle nainstalovat ani ladit nelze.
Tento postup pro Windows 11 otevře dva oficiální demo projekty společnosti Rokid, zkontroluje jejich konfiguraci sestavení, nainstaluje obě aplikace a odešle do brýlí ukázkovou pracovní zprávu. Využívá podnikové SDK a místní test komunikace. Online hlasové služby a služby AI jsou samostatné integrace. Pokyny byly ověřeny podle oficiální dokumentace a zdrojového kódu dema; test na fyzickém zařízení proveden nebyl.
Kontext k hardwaru najdete na produktové stránce Rokid AI Glasses Enterprise. Rokid dokumentuje architekturu a běhové prostředí tohoto podnikového zařízení v rámci Glass3 Enterprise SDK. Než budete jiný produkt Rokid považovat za kompatibilní, ověřte si u dodavatele dodané zařízení a firmware.
Požadavky na vývoj pro Rokid Glass3
Hardware: PC s Windows 11, Rokid Glass3 Enterprise (podnikový firmware), vyhrazený testovací telefon s Androidem (doporučen Android 13+) a datový ladicí kabel pro Glass3.
Software: Android Studio s Android SDK Platform 34 a Build-Tools 35.0.0.
Prostředí sestavení: JDK 17, AGP 8.4.2, Gradle 8.6 a Kotlin 2.2.0.
SDK: Glasses SDK a Phone SDK 2.2.0-E.
Krok 1 Připravte podnikový hardware
· Ověřte systém: Firmware je vestavěný systémový software brýlí. Vyžádejte si od dodavatele model brýlí, verzi nainstalovaného podnikového firmwaru a informace o kompatibilitě se SDK. Podle FAQ společnosti Rokid obsahuje označení verze pracovních sestavení obvykle písmeno e. S podnikovým firmwarem používejte podnikové demo. Samotný název produktu kompatibilitu nezaručuje.
· Zkontrolujte kabel: Výslovně si obstarejte datový ladicí kabel Glass3. Při instalaci dema jej připojte přímo k vývojovému počítači. Úspěšné nabíjení nedokazuje, že funguje přenos dat přes USB.
· Připravte test: Nabijte obě zařízení a mějte je blízko sebe. Použijte vyhrazený telefon a ukázkovou zprávu z kroku 10. Před párováním odpojte jakýkoli jiný telefon, který byl s těmito brýlemi dříve spojen.
Datový ladicí kabel Glass3, jak je zobrazen v Rokid Quick Start. Tento kabel je nutný pro vývoj s kabelovým připojením.
Běžný nabíjecí kabel Glass3, jak jej zobrazuje Rokid. Datový ladicí kabel nahradit nemůže. Funkci dodaného kabelu si ověřte u prodejce.
Krok 2 Nainstalujte Android Studio a Android SDK (pokud je již máte nainstalované, přejděte k dalšímu kroku)
· Stáhněte instalační program: Stáhněte a nainstalujte Android Studio z https://developer.android.com/studio.
· Otevřete aplikaci: Spusťte Android Studio. Při prvním spuštění zvolte, pokud se nabídne, možnost Do not import settings, poté zvolte Standard jako typ nastavení. Projděte licence SDK, přijměte ty, které vaše společnost schválila, a dokončete stahování komponent.
· Nainstalujte potřebné balíčky: Na úvodní obrazovce klikněte na More Actions > SDK Manager. V části SDK Platforms vyberte Android 14 / API 34. V části SDK Tools vyberte Android SDK Platform-Tools. Zapněte Show Package Details, rozbalte Android SDK Build-Tools a vyberte 35.0.0. Za zmínku stojí, že plugin Android Gradle v demu si při první synchronizaci sám nainstaluje potřebné nástroje sestavení verze 34.0.0. Klikněte na Apply, zkontrolujte seznam balíčků a poté klikněte na OK, čímž spustíte instalaci.
· Uložte si umístění SDK: Poznamenejte si cestu Android SDK Location pro nastavení ADB v kroku 8.
Krok 3 Stáhněte a otevřete oba demo projekty
· Získejte zdrojový kód: V prohlížeči přejděte do oficiálního repozitáře podnikového dema Glass3 (např. https://github.com/RokidSuuport/glass3_sdk_demo.git – za zmínku stojí, že jde skutečně o oficiální repozitář Git, přestože je v něm slovo Support napsáno chybně) nebo do repozitáře Git poskytnutého dodavatelem. Klikněte na zelené tlačítko Code a poté na Download ZIP. V File Explorer > Downloads klikněte na soubor ZIP pravým tlačítkem a vyberte Extract All > Extract. Rozbalenou složku uložte do vývojového umístění schváleného vaší společností.
· Otevřete projekt pro telefon: Na úvodní obrazovce Android Studia klikněte na Open. V rozbalené složce vyberte glass3sdkphonedemo a klikněte na OK. Pokud se zobrazí dotaz na důvěryhodnost projektu, před potvrzením ověřte, že jde o oficiální zdroj, který jste stáhli. Vnější složka repozitáře není projektem pro Android.
· Otevřete projekt pro brýle: Zvolte File > Open, vyberte sousední složku glassdemo a na dotaz zvolte New Window. Nechte obě okna otevřená. Každý projekt má vlastní konfiguraci Gradle a modul app, tedy část, která vytváří instalovatelnou aplikaci.
· Použijte zobrazení souborů: V každém okně otevřete View > Tool Windows > Project. V rozbalovací nabídce v horní části levého panelu zvolte Project. Zobrazí se tak skutečné složky a soubory, se kterými se dále pracuje. Pokud první synchronizace ohlásí chybu, dokončete před dalším pokusem kroky 4 a 5.
Krok 4 Vyberte JDK 17 pro oba projekty
· Otevřete nastavení Gradle: V okně projektu pro telefon zvolte File > Settings > Build, Execution, Deployment > Build Tools > Gradle. Najděte rozbalovací nabídku Gradle JDK. Ta určuje verzi Javy použitou k sestavení projektu, nezávisle na běhovém prostředí Javy, ve kterém se spouští samotné Android Studio.
· Vyberte nebo stáhněte Javu 17: Zvolte nainstalované JDK s označením 17. Pokud v seznamu žádné není, zvolte Download JDK, vyberte Version 17, zvolte dodavatele schváleného IT oddělením a klikněte na Download. Stažené JDK vyberte v Gradle JDK a poté klikněte na Apply > OK. Totéž zopakujte v okně projektu pro brýle.
· Ponechte stávající cíle kódu: Nastavení sourceCompatibility, targetCompatibility a kotlinovské jvmTarget v demu používají hodnotu 1.8. Popisují kompatibilitu zkompilovaného kódu; neznamenají, že by Gradle měl běžet na JDK 8. Pro toto demo je ponechte beze změny. Průvodce sestavením v Javě od Googlu tato nastavení rozlišuje.
Krok 5 Zkontrolujte závislosti Maven a sjednoťte nástroje sestavení
Repozitář Maven je server, na kterém Gradle hledá balíčky knihoven, včetně SDK společnosti Rokid.
· Zkontrolujte repozitář: V levém panelu každého projektu dvakrát klikněte na settings.gradle. Najděte dependencyResolutionManagement > repositories a ověřte, že je zde uvedena níže uvedená adresa URL repozitáře Maven společnosti Rokid. Do stávajícího bloku přidejte pouze chybějící řádek. Ostatní repozitáře dema ponechte kvůli jeho dalším závislostem; pokud je blokuje firemní proxy, požádejte IT o schválení přístupu.
// Uvnitř settings.gradle > dependencyResolutionManagement
repositories {
google()
mavenCentral()
maven { url = uri("https://maven.rokid.com/repository/maven-public/") }
}
· Zkontrolujte oba balíčky SDK: V každém okně otevřete app > build.gradle. V bloku dependencies ponechte jednu aktivní položku pro správné SDK. Níže uvedené úryvky jsou v jazyce Groovy, tedy v syntaxi, kterou toto demo používá. Nepřidávejte SDK pro brýle do projektu pro telefon a nevkládejte druhý blok dependencies. org.slf4j je skupina knihoven pro logování; vyloučení zabraňuje duplicitním třídám pro logování.
// 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"
}
· Sjednoťte AGP a Gradle: Kotlin je programovací jazyk, ve kterém jsou tato dema napsána. U prověřené verze zdrojového kódu otevřete v obou projektech gradle > libs.versions.toml. V části [versions] změňte pouze agp na 8.4.2, pokud tuto hodnotu ještě nemá; ponechte kotlin = "2.2.0". Poté otevřete gradle > wrapper > gradle-wrapper.properties a nahraďte pouze distributionUrl níže uvedeným řádkem. Wrapper stáhne zvolenou verzi Gradle. Google dokumentuje párování Gradle a JDK pro 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
· Synchronizujte a zkontrolujte výsledek: Uložte upravené soubory a poté v obou oknech zvolte File > Sync Project with Gradle Files. Otevřete View > Tool Windows > Build a zkontrolujte výstup synchronizace. Nepřijímejte nesouvisející automatické aktualizace. Demo již obsahuje pravidla pro balení nativních knihoven; ponechte je. Nativní knihovna je zkompilovaný kód pro zařízení, který se balí spolu s APK.
Krok 6 Nakonfigurujte místní firemní demo
· Pro tento test vypněte online služby: V projektu pro telefon otevřete app > src > main > java > com > rokid > phone > ui > MainPhoneActivity.kt. Na začátku souboru MainPhoneActivity.kt ponechte stávající import NetServiceType. Pokud chybí, přidejte k ostatním importům následující řádek:
Kotlin
import com.rokid.security.phone.sdk.base.data.NetServiceType
Poté najděte banServiceList uvnitř initSDK(). Jeho aktivní deklaraci nahraďte níže uvedeným řádkem. Ponechte stávající prázdná pole UserAuthInfo i ID klientů. Zdrojový kód dokumentuje tuto možnost pro vypnutí síťových služeb; místní test přes Bluetooth nevypíná.
val banServiceList: List<NetServiceType> = arrayListOf(NetServiceType.ALL)
· Budoucí přihlašovací údaje uchovávejte odděleně: AK je přístupový klíč a SK je jeho tajný klíč. Pro pozdější ověřované služby si vyžádejte přihlašovací údaje k podnikovým službám od svého obchodního kontaktu u společnosti Rokid. V UserAuthInfo se do appId zadává AK a do secret SK. Pro testovací přihlašovací údaje používejte chráněnou konfiguraci projektu a skutečné klíče nikdy necommitujte. Tento první místní běh tyto online funkce nepotřebuje.
· Přidejte anglické inicializační logy: V projektu pro telefon otevřete app > src > main > java > com > rokid > phone > ui > MainPhoneActivity.kt. V initSDK() přidejte do callbacku úspěchu anglický log:
Kotlin
Log.d(TAG, “Phone SDK ready”)
V projektu pro brýle otevřete app > src > main > java > com > rokid > glass > HomeActivity.kt. initSDK() volá GlassSdkUtils.initSdk() a poté sbírá GlobalData.sdkInitState; uvnitř tohoto collectoru přidejte hned za řádek Log.d(TAG, “SDK 初始化成功”) anglický log:
Kotlin
Log.d(TAG, “Glasses SDK ready”)
(Poznámka: Pokud Android Studio zvýrazní odkazy na třídy červeně, stiskněte Alt + Enter a potřebné balíčky se automaticky naimportují.)
· Neměňte chování při spuštění: V projektu pro brýle otevřete app > src > main > java > com > rokid > glass > HomeActivity.kt. V metodě onCreate() zakomentujte následující stávající řádek tak, že na jeho začátek vložíte //. Tento řádek nastavuje automatické spuštění po restartu; pro první test na firemním zařízení není potřeba.
// DeviceUtil.setSystemProp("persist.vendor.boot.pkg", this.packageName)
· Omezte test příjmu jen na text: Ve stejné složce com > rokid > glass otevřete MessageReceiveActivity.kt. Nahraďte pouze jeho funkci onTextMessage uvnitř mMessageListener níže uvedeným kódem. Přijatý text zůstane viditelný a zalogovaný, aniž by se volaly hlasové služby. Callback je funkce, kterou SDK zavolá, když nastane událost.
override fun onTextMessage(msg: String) {
log(msg)
}
Krok 7 Sestavte a spusťte aplikaci pro telefon
· Zapněte na telefonu ladění přes USB: Na testovacím telefonu otevřete Settings a pomocí vyhledávacího pole najděte Build number. Otevřete příslušnou stránku s informacemi o zařízení a sedmkrát klepněte na Build number; pokud budete vyzváni, zadejte PIN zařízení. Vraťte se do nastavení, vyhledejte Developer options, otevřete je a zapněte USB debugging. Umístění nabídek se u jednotlivých výrobců telefonů liší.
· Připojte a autorizujte: Připojte telefon k počítači jeho datovým kabelem USB. V dialogu telefonu Allow USB debugging? ověřte, že jde o vývojový počítač, a klepněte na Allow. Na horním panelu nástrojů projektu pro telefon zvolte jako konfiguraci spuštění app a v sousední rozbalovací nabídce zařízení vyberte připojený telefon.
· Spusťte aplikaci: Klikněte na zelený trojúhelník Run nebo zvolte Run > Run app. Android Studio sestaví, nainstaluje a otevře demo pro telefon. Název prověřené aplikace může být Rokid Enterprise Demo nebo rokid白板 a rozhraní dema bude pravděpodobně v čínštině. V dialozích oprávnění povolte požadované oprávnění Nearby devices a přístup k Wi-Fi, které tento test potřebuje; starší verze Androidu mohou požadovat přístup k poloze. Pokud jste oprávnění dříve zamítli, otevřete Settings > Apps > aplikace dema > Permissions a příslušné oprávnění změňte.
· Zkontrolujte inicializaci: Otevřete View > Tool Windows > Logcat, vyberte telefon a do pole filtru zadejte package:com.rokid.phone. Vyhledejte Phone SDK ready, což znamená, že inicializace SDK v telefonu proběhla úspěšně. Aplikaci nechte otevřenou. Pokud zásady testovacího telefonu blokují ladění nebo potřebná oprávnění, požádejte před pokračováním IT, aby toto vyhrazené vývojové zařízení nakonfigurovalo.
Krok 8 Připojte a spusťte aplikaci pro brýle
Ověřte vývojářská nastavení brýlí: Na Rokid Glass3 přejděte do Settings > System > Developer Options a ověřte, že je USB Debugging přepnuto na ON. Pokud je tato nabídka ve vašem podnikovém sestavení uzamčená nebo skrytá, obraťte se před pokračováním na distributora hardwaru, aby nahrál/zřídil firmware s povoleným vývojářským režimem.
· Ověřte ADB přes správný kabel: Zapnuté brýle připojte pomocí datového ladicího kabelu Glass3. V projektu pro brýle zvolte View > Tool Windows > Terminal. Zadejte cd ", za ním umístění SDK uložené v kroku 2, poté \platform-tools" a stiskněte Enter. V této složce spusťte níže uvedený příkaz. Sériové číslo je identifikátor zařízení vypsaný v prvním sloupci.
.\adb.exe devices -l
· Zjistěte stav zařízení: Vyhledejte sériové číslo brýlí, za kterým následuje device, nikoli offline nebo unauthorized. Pokud se na brýlích zobrazí dialog autorizace, schvalte tento vývojový počítač. Pokud se nic nezobrazí, zkontrolujte nejprve kabel a port USB. Podniková sestavení mohou ladění omezovat; pokud je blokováno, požádejte dodavatele o zřízení zdokumentovaného vývojářského přístupu. Nenahrazujte tento postup pokyny pro spotřebitelskou doprovodnou aplikaci.
· Nainstalujte a spusťte: Na panelu nástrojů projektu pro brýle vyberte app, zvolte cílové zařízení brýlí, například Rokid RG-glasses, a klikněte na Run. Název aplikace je glassdemo. Otevřete Logcat, vyberte brýle a použijte filtr package:com.rokid.glesse. Vyhledejte Glasses SDK ready – log přidaný v kroku 6, který potvrzuje úspěšnou inicializaci SDK.
· Zrcadlete rozhraní: scrcpy je nástroj pro zobrazení a ovládání obrazovky zařízení s Androidem; jeho použití přes kabel společnost Rokid dokumentuje. Otevřete oficiální pokyny ke scrcpy pro Windows, stáhněte 64bitový ZIP pro Windows a v Průzkumníku souborů použijte Extract All. Otevřete rozbalenou složku a dvakrát klikněte na open_a_terminal_here.bat. Spusťte adb devices a poté níže uvedený příkaz, v němž GLASSES_SERIAL nahradíte sériovým číslem brýlí. V okně zrcadlení můžete na rozhraní brýlí klikat myší počítače.
scrcpy -s GLASSES_SERIAL --no-audio
Krok 9 Spárujte podniková dema
· Otevřete na telefonu obrazovku připojení: V aplikaci Rokid Enterprise Demo klepněte na ikonu + vpravo nahoře a otevřete Discover Bluetooth. U čínské verze dema pro telefon (rokid 白板) klepněte na stránce 设备 (Device) na ikonu + vpravo nahoře a otevřete 发现蓝牙 (Discover Bluetooth). V aktivním rozvržení této revize zdrojového kódu není dole žádná karta Device. Spustí se vyhledávání; zvolte položku Glass3_…, která odpovídá vašim brýlím. Pokud se vyhledávání zasekne, klepněte na této obrazovce na ikonu obnovení.
· Dokončete párování: Potvrďte případný dialog párování Bluetooth v Androidu a zkontrolujte, zda se na brýlích nezobrazila žádost o připojení. Počkejte, až obrazovka Device na telefonu aktualizuje indikátor připojení a zobrazí, že je připojeno klasické Bluetooth. Pokud po spárování zůstane otevřená stránka vyhledávání nebo připojení, klepněte na ovládací prvek Androidu Back a vraťte se na Device. Obě zařízení musí mít zapnuté Bluetooth a brýle nesmí být připojeny k jinému telefonu. Stránka společnosti Rokid pro řešení potíží s Bluetooth tyto kontroly uvádí.
· První test udržte jednoduchý: Demo umí navázat také spojení Wi-Fi P2P a jeho stav zobrazuje samostatně. Pro níže popsaný textový test postačí Bluetooth. Pokud P2P není připojeno, nevykládejte to jako selhání připojení Bluetooth. Velké soubory a živá média vyžadují samostatné ověření P2P.
Krok 10 Odešlete pracovní zprávu a ověřte běžící demo
· Nastavte testovací zprávu: V projektu pro telefon otevřete app > src > main > java > com > rokid > phone > SendMessageActivity.kt. Najděte binding.btSendTextBtn.setOnClickListener a celý tento blok listeneru nahraďte níže uvedeným kódem.
(Poznámka: V souboru SendMessageActivity.kt ponechte stávající import PSecuritySDK. Pokud chybí, přidejte na začátek souboru k ostatním importům následující řádek: import com.rokid.security.phone.sdk.api.PSecuritySDK).
GlassSample je ID přijímajícího klienta, které už demo pro brýle zaregistrovalo; na obou stranách je ponechte beze změny.
binding.btSendTextBtn.setOnClickListener {
val message = "Work item 001 ready"
PSecuritySDK.getMessageService()
?.sendTextMessageByClassicBT(message, "GlassSample")
log(message)
}
· Spusťte upravenou aplikaci pro telefon: V okně projektu pro telefon v Android Studiu vyberte připojený telefon a klikněte na Run > Run app, čímž upravenou aplikaci znovu sestavíte a nainstalujete. Počkejte na úspěšnou inicializaci SDK a ověřte, že se Bluetooth znovu připojilo. Poté na brýlích pomocí scrcpy přejděte na Message Receive. Kliknutím přímo do aktivního okna scrcpy na ploše jej aktivujte. Protože brýle emulují hardwarové ovládání D-padem, procházejte nabídku šipkou vpravo nebo šipkou vlevo na klávesnici počítače, dokud není zvýrazněna položka Message Receive, případně 消息接收 (Message Receive), tedy druhá položka nabídky, a poté stiskněte Enter, čímž aktivitu otevřete. Demo mapuje tyto klávesy na výběr v nabídce v souboru HomeActivity.kt. Tuto stránku příjmu nechte zobrazenou; registruje listener zpráv, který tento test používá.
· Odešlete zprávu z telefonu: Na stránce telefonu Device nebo 设备 přejděte ke kartě Message Send nebo 消息发送 a klepněte na ni. Na další stránce klepněte na Send text via Bluetooth nebo 蓝牙发送文本. Toto tlačítko odešle výše uvedený pevný řetězec; žádné textové pole se nevyplňuje. Vyhledejte Work item 001 ready na stránce příjmu na brýlích.
· Zaznamenejte podmínku úspěchu: V nástroji Logcat pro brýle použijte filtr package:com.rokid.glesse tag:MessageActivity a ověřte, že dorazila stejná zpráva. Samotný log odeslání v telefonu přijetí neprokazuje. Spolu s výsledkem si uložte verze SDK, sestavení firmwaru, revizi zdrojového kódu a změny nástrojů sestavení. Úspěch znamená, že obě aplikace běží, Bluetooth se připojí a brýle viditelně přijmou testovací zprávu.
Časté problémy při nastavení
· Brýle se nabíjejí, ale nejsou rozpoznány: Použijte datový ladicí kabel a zopakujte kontrolu ADB z kroku 8. Běžný nabíjecí kabel je první věc, kterou je třeba vyloučit.
· Gradle nemůže stáhnout knihovnu: V okně Build rozbalte chybu a poznamenejte si přesný balíček a adresu URL serveru. Zkontrolujte položky repozitářů z kroku 5 a přístup přes firemní proxy. Demo obsahuje kromě dvou SDK společnosti Rokid i další repozitáře a závislosti; nemažte je bez rozmyslu ani nepřidávejte náhodný mirror.
· Chyby duplicitního logování nebo nativních knihoven: Zkontrolujte duplicitní položky SDK a vyloučení org.slf4j. Ponechte stávající pravidla packagingOptions pro libr2aud.so v aplikaci pro brýle a libc++_shared.so v aplikaci pro telefon. Chyba duplicitní knihovny znamená, že dvě závislosti zabalily stejný soubor.
· Párování funguje, ale žádná zpráva nedorazí: Nechte na brýlích otevřenou stránku příjmu a ověřte, že GlassSample zůstalo beze změny. Před odesláním ověřte v Logcatu obě zprávy o úspěšné inicializaci. Pokud zařízení nelze najít, zkontrolujte v telefonu oprávnění Nearby devices a nejprve odpojte jakýkoli jiný telefon.
Závěr
Nastavení vývojového prostředí pro Rokid Glass3 začíná podnikově kompatibilními brýlemi a správným datovým ladicím kabelem a pokračuje přes Android Studio, JDK 17 a závislosti Maven až ke konzistentní konfiguraci sestavení. Spuštění dem pro telefon a brýle a ověření přijaté pracovní zprávy vytváří praktický výchozí bod před přidáním obchodní logiky nebo online služeb. Firmám může tento postup omezit zbytečná zdržení při nastavení, usnadnit reprodukovatelnost pilotních projektů a dát vývojářům jasnější základ pro aplikace, které poskytují užitečné informace a zaměstnancům přitom ponechávají volné ruce.
Než zakoupíte vývojovou sadu nebo požádáte o firemní pilotní projekt, ověřte si podnikový hardware, datový ladicí kabel a podporu firmwaru.
