Настройване на среда за разработка за Rokid Glass3

Настройване на среда за разработка за Rokid Glass3

Резюме

С среда за разработка за Rokid Glass3 бизнес екипът може да създава Android приложения за [Rokid AI Glasses Enterprise](https://ai.vr-expert.com/en/ai-glasses/rokid-ai-glasses) и да тества комуникацията с Android телефон. Започнете с корпоративен фърмуер, Android Studio, JDK 17, Maven хранилището на Rokid и кабела за данни и дебъгване на Glass3. С обикновения кабел за зареждане не може да се инсталира приложението за очилата, нито да се дебъгва.

Този работен процес под Windows 11 отваря двата официални демо проекта на Rokid, проверява конфигурацията им за компилация, инсталира всяко от приложенията и изпраща примерно работно съобщение до очилата. Използват се корпоративният SDK и локален тест на комуникацията. Онлайн услугите за реч и изкуствен интелект са отделни интеграции. Инструкциите са проверени спрямо официалната документация и изходния код на демото; изпълнение на физическо устройство не е извършено.

За контекст относно хардуера вижте продуктовата страница на Rokid AI Glasses Enterprise. Rokid документира архитектурата и средата за изпълнение на това корпоративно устройство в рамките на Glass3 Enterprise SDK. Потвърдете доставеното устройство и фърмуера с вашия доставчик, преди да приемете друг продукт на Rokid за съвместим.

Изисквания за разработка за Rokid Glass3

Хардуер: компютър с Windows 11, Rokid Glass3 Enterprise (с корпоративен фърмуер), отделен тестов телефон с Android (препоръчва се Android 13+) и кабелът за данни и дебъгване на Glass3.

Софтуер: Android Studio с Android SDK Platform 34 и Build-Tools 35.0.0.

Среда за компилация: JDK 17, AGP 8.4.2, Gradle 8.6 и Kotlin 2.2.0.

SDK: Glasses SDK и Phone SDK 2.2.0-E.

Стъпка 1 Подгответе корпоративния хардуер

· Потвърдете системата: Фърмуерът е вграденият системен софтуер на очилата. Поискайте от доставчика си модела на очилата, версията на инсталирания корпоративен фърмуер и информация за съвместимостта със SDK. Според ЧЗВ на Rokid работните версии обикновено съдържат e в номера на версията. Използвайте корпоративното демо с корпоративен фърмуер. Само името на продукта не гарантира съвместимост.

· Проверете кабела: Изрично се снабдете с кабела за данни и дебъгване на Glass3. При инсталирането на демото го свържете директно към компютъра за разработка. Успешното зареждане не доказва, че USB преносът на данни работи.

· Подгответе теста: Заредете двете устройства и ги дръжте близо едно до друго. Използвайте отделен телефон и примерното съобщение от стъпка 10. Преди сдвояването прекъснете връзката с всеки друг телефон, който преди е бил свързан с тези очила.

Кабел за данни и дебъгване на Glass3, показан в ръководството Quick Start на Rokid. Това е кабелът, необходим за разработка с кабелна връзка.

Обикновен кабел за зареждане на Glass3, показан от Rokid. Той не може да замени кабела за данни и дебъгване. Потвърдете функцията на доставения кабел с доставчика.

Стъпка 2 Инсталирайте Android Studio и Android SDK (ако вече са инсталирани, преминете към следващата стъпка)

· Изтеглете инсталатора: Изтеглете и инсталирайте Android Studio от https://developer.android.com/studio.

· Отворете приложението: Отворете Android Studio. При първото стартиране изберете Do not import settings, ако ви бъде предложено, след което използвайте режима Standard за настройка. Прегледайте лицензите на SDK, приемете одобрените от вашата компания и изчакайте изтеглянето на компонентите да завърши.

· Инсталирайте необходимите пакети: На началния екран щракнете върху More Actions > SDK Manager. В SDK Platforms изберете Android 14 / API 34. В SDK Tools изберете Android SDK Platform-Tools. Включете Show Package Details, разгънете Android SDK Build-Tools и изберете 35.0.0. Струва си да се отбележи, че Android Gradle Plugin на демото сам инсталира необходимите му build tools 34.0.0 при първата синхронизация. Щракнете върху Apply, прегледайте списъка с пакети и след това натиснете OK за инсталиране.

· Запишете местоположението на SDK: Запишете пътя от Android SDK Location за настройката на ADB в стъпка 8.

Стъпка 3 Изтеглете и отворете двата демо проекта

· Вземете изходния код: В браузъра отворете официалното хранилище с корпоративното демо за Glass3 (напр. https://github.com/RokidSuuport/glass3_sdk_demo.git – струва си да се отбележи, че това наистина е официалното Git хранилище, въпреки че Support е изписано грешно) или Git хранилището, предоставено от вашия доставчик. Щракнете върху зеления бутон Code, след това върху Download ZIP. Във File Explorer > Downloads щракнете с десния бутон върху ZIP файла и изберете Extract All > Extract. Съхранявайте извлечената папка в одобрено от компанията място за разработка.

· Отворете проекта за телефона: На началния екран на Android Studio щракнете върху Open. Влезте в извлечената папка, изберете glass3sdkphonedemo и щракнете върху OK. Ако се появи запитване дали да се доверите на проекта, първо проверете дали това е официалният източник, който сте изтеглили. Външната папка на хранилището не е Android проектът.

· Отворете проекта за очилата: Изберете File > Open, посочете съседната папка glassdemo и при запитване изберете New Window. Оставете двата прозореца отворени. Всеки от тях има собствена конфигурация на Gradle и модул app – частта, която създава инсталируемото приложение.

· Използвайте файловия изглед: Във всеки прозорец отворете View > Tool Windows > Project. В падащото меню в горната част на левия панел изберете Project. Така се показват реалните папки и файлове, използвани по-долу. Ако първата синхронизация отчете грешка, изпълнете стъпки 4 и 5, преди да опитате отново.

Стъпка 4 Изберете JDK 17 за двата проекта

· Отворете настройките на Gradle: В прозореца на проекта за телефона изберете File > Settings > Build, Execution, Deployment > Build Tools > Gradle. Намерете падащото меню Gradle JDK. То определя версията на Java, с която се компилира проектът, независимо от средата за изпълнение на Java, която стартира Android Studio.

· Изберете или изтеглете Java 17: Изберете инсталиран JDK с означение 17. Ако в списъка няма такъв, изберете Download JDK, после Version 17, изберете доставчик, одобрен от ИТ отдела, и щракнете върху Download. Изберете изтегления JDK в Gradle JDK, след което щракнете върху Apply > OK. Повторете в прозореца на проекта за очилата.

· Запазете съществуващите целеви версии на кода: Настройките sourceCompatibility, targetCompatibility и Kotlin jvmTarget в демото използват 1.8. Те описват съвместимостта на компилирания код; не означават, че Gradle трябва да работи с JDK 8. Оставете ги непроменени за това демо. Ръководството на Google за компилиране с Java разграничава тези настройки.

Стъпка 5 Проверете зависимостите от Maven и съгласувайте инструментите за компилация

Maven хранилището е сървър, от който Gradle изтегля пакети с библиотеки, включително SDK на Rokid.

· Проверете хранилището: В левия панел на всеки проект щракнете двукратно върху settings.gradle. Намерете dependencyResolutionManagement > repositories и потвърдете, че посоченият по-долу URL адрес на Maven хранилището на Rokid присъства. Добавете само липсващия ред в съществуващия блок. Запазете другите хранилища на демото, нужни за останалите му зависимости; ако корпоративен прокси сървър ги блокира, помолете ИТ отдела да одобри достъпа.

// Вътре в settings.gradle > dependencyResolutionManagement

repositories {

google()

mavenCentral()

maven { url = uri("https://maven.rokid.com/repository/maven-public/") }

}

· Проверете двата SDK пакета: Отворете app > build.gradle във всеки прозорец. В dependencies оставете един активен запис за съответния SDK. Фрагментите по-долу са на Groovy – синтаксиса, използван в това демо. Не добавяйте SDK за очилата в проекта за телефона и не поставяйте втори блок dependencies. org.slf4j е група библиотеки за логване; изключването предотвратява дублирането на класове за логване.

// 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"

}

· Съгласувайте AGP и Gradle: Kotlin е езикът за програмиране, на който са написани тези демота. За проверената версия на кода отворете gradle > libs.versions.toml в двата проекта. В [versions] променете само agp на 8.4.2, ако стойността вече не е такава; запазете kotlin = "2.2.0". След това отворете gradle > wrapper > gradle-wrapper.properties и заменете само distributionUrl с реда по-долу. Wrapper-ът изтегля избраната версия на Gradle. Google документира съответствието между Gradle и JDK за 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

· Синхронизирайте и проверете резултата: Запазете редактираните файлове, след което изберете File > Sync Project with Gradle Files в двата прозореца. Отворете View > Tool Windows > Build и проверете изхода от синхронизацията. Не приемайте несвързани автоматични надграждания. Демото вече включва правила за пакетиране на нативни библиотеки; запазете ги. Нативната библиотека е компилиран код за устройството, пакетиран заедно с APK файла.

Стъпка 6 Конфигурирайте локално бизнес демо

· Изключете онлайн услугите за този тест: В проекта за телефона отворете app > src > main > java > com > rokid > phone > ui > MainPhoneActivity.kt. В началото на MainPhoneActivity.kt запазете съществуващия импорт на NetServiceType. Ако липсва, добавете следния ред при останалите импорти:

Kotlin

import com.rokid.security.phone.sdk.base.data.NetServiceType

След това намерете banServiceList в initSDK(). Заменете активната му декларация с реда по-долу. Запазете съществуващите празни полета на UserAuthInfo и клиентските идентификатори. Изходният код документира тази опция за изключване на мрежовите услуги; тя не изключва локалния Bluetooth тест.

val banServiceList: List<NetServiceType> = arrayListOf(NetServiceType.ALL)

· Съхранявайте бъдещите идентификационни данни отделно: AK е ключ за достъп, а SK е неговият таен ключ. За по-късни услуги с удостоверяване поискайте корпоративните идентификационни данни за услугите от вашия търговски или бизнес контакт в Rokid. В UserAuthInfo полето appId получава AK, а secret получава SK. Използвайте защитена конфигурация на проекта за тестовите идентификационни данни и никога не записвайте реални ключове в хранилището. Това първо локално изпълнение не изисква тези онлайн функции.

· Добавете инициализационни логове на английски: В проекта за телефона, отворете app > src > main > java > com > rokid > phone > ui > MainPhoneActivity.kt. В initSDK() добавете лог на английски в callback-а при успех:

Kotlin

Log.d(TAG, “Phone SDK ready”)

В проекта за очилата отворете app > src > main > java > com > rokid > glass > HomeActivity.kt. initSDK() извиква GlassSdkUtils.initSdk() и след това събира GlobalData.sdkInitState; в този колектор, непосредствено след реда Log.d(TAG, “SDK 初始化成功”), добавете лога на английски:

Kotlin

Log.d(TAG, “Glasses SDK ready”)

(Забележка: Ако Android Studio маркира препратки към класове в червено, натиснете Alt + Enter, за да импортирате автоматично необходимите пакети.)

· Не променяйте поведението при стартиране: В проекта за очилата отворете app > src > main > java > com > rokid > glass > HomeActivity.kt. В onCreate() коментирайте следния съществуващ ред, като поставите // в началото му. Този ред настройва автоматичното стартиране след рестартиране; той не е необходим за първи тест на фирмено устройство.

// DeviceUtil.setSystemProp("persist.vendor.boot.pkg", this.packageName)

· Ограничете теста за получаване само до текст: В същата папка com > rokid > glass отворете MessageReceiveActivity.kt. Заменете само функцията onTextMessage в mMessageListener с кода по-долу. Полученият текст остава видим и се записва в лога, без да се извикват гласови услуги. Callback е функция, която SDK извиква, когато пристигне събитие.

override fun onTextMessage(msg: String) {

log(msg)

}

Стъпка 7 Компилирайте и стартирайте приложението за телефона

· Включете USB дебъгването на телефона: На тестовия телефон отворете Settings и чрез полето за търсене намерете Build number. Отворете съответната страница с информация за устройството и докоснете Build number седем пъти; ако бъде поискан, въведете ПИН кода на устройството. Върнете се в Settings, потърсете Developer options, отворете ги и включете USB debugging. Разположението на менютата се различава според производителя на телефона.

· Свържете и разрешете: Свържете телефона към компютъра с неговия USB кабел за данни. В диалоговия прозорец Allow USB debugging? на телефона се уверете, че това е компютърът за разработка, и докоснете Allow. В горната лента с инструменти на проекта за телефона изберете app като конфигурация за изпълнение и посочете свързания телефон в съседното падащо меню с устройства.

· Стартирайте приложението: Щракнете върху зеления триъгълник Run или изберете Run > Run app. Android Studio компилира, инсталира и отваря демото за телефона. Името на приложението в проверената версия може да е Rokid Enterprise Demo или rokid白板, а интерфейсът на демото най-вероятно ще е на китайски. В диалоговите прозорци за разрешения разрешете исканите Nearby devices и достъп до Wi-Fi, необходими за този тест; по-старите версии на Android може да поискат достъп до местоположението (Location). Ако преди това сте отказали, използвайте Settings > Apps > демото > Permissions, за да промените съответното разрешение.

· Проверете инициализацията: Отворете View > Tool Windows > Logcat, изберете телефона и въведете package:com.rokid.phone в полето за филтриране. Потърсете Phone SDK ready, което означава, че инициализацията на SDK за телефона е успешна. Оставете приложението отворено. Ако политиката на тестовия телефон блокира дебъгването или необходимите разрешения, нека ИТ отделът конфигурира това отделно устройство за разработка, преди да продължите.

Стъпка 8 Свържете и стартирайте приложението за очилата

Проверете настройките за разработчици на очилата: На Rokid Glass3 отидете в Settings > System > Developer Options и потвърдете, че USB Debugging е превключено на ON. Ако менюто с опции е заключено или скрито във вашата корпоративна версия, свържете се с дистрибутора на хардуера, за да инсталира или осигури фърмуер с разрешени функции за разработчици, преди да продължите.

· Проверете ADB през правилния кабел: Свържете включените очила с кабела за данни и дебъгване на Glass3. В проекта за очилата изберете View > Tool Windows > Terminal. Въведете cd ", последвано от местоположението на SDK, записано в стъпка 2, след това \platform-tools", и натиснете Enter. В тази папка изпълнете командата по-долу. Серийният номер е идентификаторът на устройството, изведен в първата колона.

.\adb.exe devices -l

· Разчетете състоянието на устройството: Потърсете серийния номер на очилата, последван от device, а не от offline или unauthorized. Ако на очилата се появи диалогов прозорец за разрешение, одобрете този компютър за разработка. Ако не се появи нищо, първо проверете кабела и USB порта. Корпоративните версии може да ограничават дебъгването; ако то е блокирано, помолете доставчика да осигури документирания достъп за разработка. Не използвайте вместо това инструкции за потребителското придружаващо приложение.

· Инсталирайте и стартирайте: В лентата с инструменти на проекта за очилата изберете app, посочете очилата като целево устройство, например Rokid RG-glasses, и щракнете върху Run. Името на приложението е glassdemo. Отворете Logcat, изберете очилата и филтрирайте по package:com.rokid.glesse. Потърсете Glasses SDK ready – лога, добавен в стъпка 6, който потвърждава, че инициализацията на SDK е успешна.

· Огледално показване на интерфейса: scrcpy е инструмент за преглед и управление на екрана на Android устройства; използването му с кабел е документирано от Rokid. Отворете официалните инструкции за scrcpy под Windows, изтеглете ZIP архива за Windows 64-bit и използвайте Extract All във File Explorer. Отворете извлечената папка и щракнете двукратно върху open_a_terminal_here.bat. Изпълнете adb devices, а след това командата по-долу, като замените GLASSES_SERIAL със серийния номер на очилата. Огледалният прозорец ви позволява да щраквате в интерфейса на очилата с мишката на компютъра.

scrcpy -s GLASSES_SERIAL --no-audio

Стъпка 9 Сдвоете корпоративните демота

· Отворете екрана за връзка на телефона: В Rokid Enterprise Demo докоснете иконата + горе вдясно, за да отворите Discover Bluetooth. За китайската версия: в демото за телефона (rokid 白板) на страницата 设备 (Device) докоснете иконата + горе вдясно, за да отворите 发现蓝牙 (Discover Bluetooth). В активното оформление на тази версия на изходния код няма долен раздел Device. Това стартира сканиране; изберете записа Glass3_…, който съответства на вашите очила. Ако сканирането спре, докоснете иконата за опресняване на този екран.

· Завършете сдвояването: Одобрете всеки появил се диалогов прозорец на Android за сдвояване по Bluetooth и проверете дали на очилата има заявка за връзка. Изчакайте, докато индикаторът за връзка на екрана Device на телефона се обнови и покаже, че Classic Bluetooth е свързан. Ако страницата за откриване или за връзка остане отворена след сдвояването, докоснете бутона Back на Android, за да се върнете към Device. И на двете устройства трябва да е включен Bluetooth, а очилата не трябва да са свързани с друг телефон. Страницата на Rokid за отстраняване на проблеми с Bluetooth изброява тези проверки.

· Започнете с малък първи тест: Демото може да договори и връзка Wi-Fi P2P и показва нейното състояние отделно. За текстовия тест по-долу Bluetooth е достатъчен. Ако P2P не е свързан, не го тълкувайте като неуспешна Bluetooth връзка. Големите файлове и мултимедията в реално време изискват отделна проверка на P2P.

Стъпка 10 Изпратете работно съобщение и потвърдете, че демото работи

· Задайте тестовото съобщение: В проекта за телефона отворете app > src > main > java > com > rokid > phone > SendMessageActivity.kt. Намерете binding.btSendTextBtn.setOnClickListener и заменете целия блок на този listener с кода по-долу.

(Забележка: В SendMessageActivity.kt запазете съществуващия импорт на PSecuritySDK. Ако липсва, добавете следния ред в началото на файла при останалите импорти: import com.rokid.security.phone.sdk.api.PSecuritySDK).

GlassSample е идентификаторът на получаващия клиент, вече регистриран от демото за очилата; оставете го непроменен и от двете страни.

binding.btSendTextBtn.setOnClickListener {

val message = "Work item 001 ready"

PSecuritySDK.getMessageService()

?.sendTextMessageByClassicBT(message, "GlassSample")

log(message)

}

· Стартирайте промененото приложение за телефона: В прозореца на проекта за телефона в Android Studio изберете свързания телефон и щракнете върху Run > Run app, за да компилирате отново и инсталирате промененото приложение. Изчакайте успешната инициализация на SDK и потвърдете, че Bluetooth връзката се възстановява. След това чрез scrcpy отидете до Message Receive на очилата. Щракнете директно в активния прозорец на scrcpy на компютъра, за да го фокусирате. Тъй като очилата емулират хардуерни D-pad контроли, използвайте клавиша стрелка надясно или стрелка наляво на клавиатурата на компютъра, за да се движите в менюто, докато Message Receive или 消息接收 (Message Receive) – вторият елемент от менюто – не бъде маркиран, след което натиснете Enter, за да отворите активността. Демото свързва тези клавиши с избора в менюто в HomeActivity.kt. Оставете тази страница за получаване видима; тя регистрира слушателя на съобщения, използван в този тест.

· Изпратете от телефона: На страницата Device или 设备 на телефона превъртете до картата Message Send или 消息发送 и я докоснете. На следващата страница докоснете Send text via Bluetooth или 蓝牙发送文本. Този бутон изпраща фиксирания низ по-горе; няма поле за въвеждане на текст. Потърсете Work item 001 ready на страницата за получаване на очилата.

· Запишете условието за успех: В Logcat за очилата филтрирайте по package:com.rokid.glesse tag:MessageActivity и потвърдете, че същото съобщение е пристигнало. Самият лог за изпращане на телефона не доказва получаването. Запазете версиите на SDK, версията на фърмуера, ревизията на изходния код и промените в инструментите за компилация заедно с резултата. Успех означава, че двете приложения работят, Bluetooth се свързва и очилата видимо получават тестовото съобщение.

Чести проблеми при настройката

· Очилата се зареждат, но не се откриват: Използвайте кабела за данни и дебъгване и повторете проверката с ADB от стъпка 8. Обикновеният кабел за зареждане е първото, което трябва да изключите като причина.

· Gradle не може да изтегли библиотека: В Build разгънете грешката и запишете точния пакет и URL адреса на сървъра. Проверете записите за хранилища от стъпка 5 и достъпа през корпоративния прокси. Освен двата SDK на Rokid демото включва и допълнителни хранилища и зависимости; не ги изтривайте безразборно и не добавяйте случайно огледало.

· Грешки с дублирано логване или с нативни библиотеки: Проверете за дублирани записи на SDK и за изключването на org.slf4j. Запазете съществуващите правила packagingOptions за libr2aud.so в приложението за очилата и за libc++_shared.so в приложението за телефона. Грешка за дублирана библиотека означава, че две зависимости са пакетирали един и същ файл.

· Сдвояването работи, но съобщението не пристига: Дръжте страницата за получаване на очилата отворена и потвърдете, че GlassSample е непроменен. Преди изпращане проверете в Logcat и двете съобщения за успешна инициализация. Ако устройството не може да бъде открито, проверете разрешенията Nearby devices на телефона и първо прекъснете връзката с всеки друг телефон.

Заключение

Настройването на среда за разработка за Rokid Glass3 започва със съвместими корпоративни очила и правилния кабел за данни и дебъгване, след което преминава през Android Studio, JDK 17, зависимостите от Maven и последователна конфигурация за компилация. Стартирането на демотата за телефона и очилата и проверката на получено работно съобщение създават практическа отправна точка, преди да се добавят бизнес логика или онлайн услуги. За бизнеса този процес може да намали излишните забавяния при настройката, да улесни възпроизвеждането на пилотни проекти и да даде на разработчиците по-ясна основа за приложения, които предоставят полезна информация, докато ръцете на служителите остават свободни.

Потвърдете корпоративния хардуер, кабела за данни и дебъгване и поддръжката на фърмуера, преди да закупите комплект за разработка или да заявите пилотен проект за компанията.

Често задавани въпроси

Тази статия

Демото с два проекта изисква телефон, за да се тества обменът на съобщения между телефона и очилата. Самостоятелното приложение за очила е различна архитектура и само по себе си не изисква придружаващо приложение.

Не. JDK 17 изпълнява инструментите за компилация. Android SDK 34 предоставя API интерфейсите и ресурсите за компилация на Android. Нито едното от двете числа не описва пряко инсталираната на телефона версия на Android.

Това ръководство изключва онлайн услугите и тества локалния обмен на съобщения по Bluetooth. Функциите за реч или изкуствен интелект с удостоверяване изискват собствени корпоративни идентификационни данни и конфигурация.

Не. ЧЗВ на Rokid за Glass3 описват разработка за Android, а при този SDK подход не се поддържат iOS или нативен HarmonyOS.