Резюме
Разработката на бизнес приложения за Rokid AI Glasses започва с документацията на Sprite Enterprise SDK на Rokid и демонстрационното приложение за Android към нея. Корпоративните често задавани въпроси насочват потребителите на корпоративен фърмуер към Rokid AI Enterprise или корпоративната демонстрация. Android Studio е работната среда за писане на код; Glasses SDK дава достъп до възможностите на устройството, а Phone SDK поддържа сдвоеното приложение за Android.
На първо място е съвместимостта. Тези публични инструкции са предназначени за Rokid Glass3 Enterprise. Търговско означение като „Rokid Enterprise RV101“ само по себе си не доказва съвместимост със SDK. Получете писмено потвърждение за конкретния си хардуер, фърмуер, регион и търговски права за SDK, преди да следвате стъпките за интеграция. Ако Rokid предостави различен корпоративен SDK за вашето устройство, използвайте този пакет и съответстващите му примери.
Ръководството доразвива официалната корпоративна демонстрация, така че тя да заснема една снимка, да показва статус и да тества диктувани бележки. Това е прототип за разработка. Качването на бизнес запис и управлението на парк от устройства изискват бекенд системата на вашата компания и отделно потвърден метод за корпоративно разпространение.
Документация на корпоративния SDK: Отворете официалния източник
Защо да създадете собствено приложение за Rokid AI Glasses
Собственото приложение може да свърже теренните проверки, поддръжката или складовите проверки с информацията, от която компанията действително се нуждае. Кратко съобщение на дисплея казва на служителя какво да направи, камерата заснема доказателства, а гласовото въвеждане може да намали писането при подходящи задачи.
Полезният резултат е надежден бизнес запис с правилния идентификатор на актива или работната поръчка и ясен статус на запазване. Първо изградете възможно най-малкия работен процес за заснемане и преглед, а след това го свържете с оперативната система, след като поведението на хардуера и обработката на данните бъдат тествани.
Изберете корпоративните компоненти
Android Studio, JDK и Gradle:
- Роля: Редактиране, компилиране и отстраняване на грешки в проекти за Android.
- Бизнес изискване: Използвайте управлявана работна станция за разработчици и одобрения инструментариум на проекта.
Sprite Enterprise Glasses SDK:
- Роля: Камера, реч, логика на приложението, свързана с дисплея, и услуги на устройството.
- Бизнес изискване: Изисква поддържан корпоративен хардуер и фърмуер; потвърдете търговските условия.
Sprite Enterprise Phone SDK:
- Роля: Сдвояване, съобщения и обмен на медийни файлове с телефон с Android.
- Бизнес изискване: Използвайте, когато архитектурата ви включва телефон, управляван от компанията.
Rokid AI Enterprise или корпоративна демонстрация:
- Роля: Корпоративна връзка и тестване по време на разработка.
- Бизнес изискване: Получете подходящата компилация и акаунти чрез корпоративния канал.
Бекенд на компанията:
- Роля: Удостоверяване и съхранение на бизнес записи.
- Бизнес изискване: Използвайте одобрени крайни точки, контроли за достъп и правила за съхранение.
Какво ви е необходимо, преди да започнете
Подгответе поддържаните корпоративни очила, кабел за данни и отстраняване на грешки за Glass3, тестов телефон с Android, Android Studio, JDK 17, Git и демонстрацията на SDK. Git изтегля изходния код; Gradle го компилира; APK е инсталационният файл за Android. Използвайте версиите от одобрената конфигурация на демонстрацията. Ръководството за бърз старт и често задаваните въпроси на Rokid се различават по отношение на минималните версии на Android, затова проверете изискването спрямо предоставения ви пакет, вместо да избирате по-ниската стойност.
Стъпка 1: потвърдете корпоративното устройство и достъпа
• Запишете целевото устройство. На очилата отворете „Настройки“ и запишете модела, версията на системата и серийния номер. Помолете Rokid да потвърди, че тази компилация поддържа Sprite Enterprise SDK и необходимите тук услуги за камера и реч.
• Получете корпоративния пакет. Поискайте Rokid AI Enterprise или корпоративната демонстрация, съответстващата версия на SDK и бизнес идентификационни данни от вашия доставчик или контакт в Rokid. Потвърдете правата за търговска разработка и внедряване; само публичното изтегляне не урежда лицензирането.
• Подгответе връзката. Заредете устройствата и свържете очилата с работната станция чрез кабела за данни и отстраняване на грешки. Използвайте предоставените за вашата компилация корпоративни инструкции за първоначална настройка, за да подготвите управлявания телефон и очилата.
• Съгласувайте потока на данните. Решете къде могат да се обработват и съхраняват снимките и диктуваните бележки. Докато валидирате демонстрацията, използвайте тестова среда на компанията и нечувствителни тестови материали.
Изисквания към корпоративната система и приложението: Отворете официалния източник
Стъпка 2: отворете и стартирайте корпоративната демонстрация за Android
• Изтеглете изходния код. В терминал на работната станция за разработка изпълнете командата по-долу. Запазете изтегленото копие в обичайната папка за разработка на екипа и запишете неговия commit с git rev-parse HEAD.
git clone https://github.com/RokidSuuport/glass3_sdk_demo.git
• Отворете проектите. В Android Studio изберете File > Open и посочете glass3_sdk_demo/glassdemo. Отворете glass3sdkphonedemo отделно за телефона. Изчакайте синхронизацията на Gradle, след което изберете JDK 17 в Settings > Build, Execution, Deployment > Build Tools > Gradle.
• Проверете зависимостите. В панела Project отворете settings.gradle и app/build.gradle във всеки проект. Запазете работещата конфигурация на демонстрацията. За отделен проект, базиран на Groovy, обединете тези записи за хранилища и зависимости със съществуващите блокове; не създавайте дублиращи се блокове. Публикуваното ръководство за бърз старт посочва 2.2.0-E, но използвайте версията, одобрена за вашия фърмуер.
// settings.gradle, в dependencyResolutionManagement {
repositories { maven { url 'https://maven.rokid.com/repository/maven-public/' }
}
}
// Приложение за очилата: app/build.gradle, в dependencies dependencies {
implementation('com.rokid.security:glass3.open.sdk:2.2.0-E') {
exclude group: 'org.slf4j'
}
}
// Само приложение за телефона: app/build.gradle, в dependencies dependencies {
implementation('com.rokid.security:phone.sdk:2.2.0-E') {
exclude group: 'org.slf4j'
}
}
• Конфигурирайте и стартирайте. В проекта за телефона отворете MainPhoneActivity и намерете UserAuthInfo. Въведете издадените за бизнеса AK и SK чрез одобрена локална конфигурация извън системата за контрол на версиите. Преди да стартирате демонстрацията за очилата, отворете HomeActivity.initSDK() и заменете примерното извикване setCameraLedEnable(false) със setCameraLedEnable(true). Рестартирайте, ако фърмуерът на устройството го изисква. Първо стартирайте приложението за телефона, след това изберете очилата като устройство в Android Studio и стартирайте glassdemo. Свържете се от демонстрацията за телефона и проверете инициализацията на SDK и изпращането на текстово съобщение, преди да редактирате.
• Коригирайте настройката. URL адресът на хранилището изтегля примера, а не инсталатор. Двете зависимости принадлежат на различни приложения. Променяйте версиите едновременно само след като проверите указанията на Rokid за съвместимост; запазете помощните функции за инициализация и необходимите импорти от демонстрацията.
Настройка на демонстрацията и пътища до изходния код: Отворете официалния източник
Хранилище и зависимости на SDK: Отворете официалния източник
Стъпка 3: направете първия бутон за заснемане ясен
• Намерете екрана. В проекта glassdemo отворете app/src/main/java/com/rokid/glass/SdkMediaActivity.kt. Файлът с оформлението му се намира в app/src/main/res/layout/activity_test_media.xml. Това е съществуващ нативен екран на Android с контроли за камерата, а не уеб страница.
• Първо редактирайте един бутон. В този XML файл намерете съществуващия елемент AppCompatButton с идентификатор android:id="@+id/btPhoto480P". Запазете оригиналния му идентификатор и ограниченията на оформлението, за да продължи съществуващото обвързване на изгледа в Kotlin (binding.btPhoto480P) да работи, без да се нарушават препратките.
• Оригиналното оформление на демонстрацията задава ширина на бутона 50dp и височина 36dp с надпис 10sp, което ще отреже новия текст. Променете само показаните по-долу атрибути и оставете останалата част от елемента непроменена (фона, цвета на текста, полетата и двата реда app: layout_constraint); без ограниченията си бутонът губи мястото си в ConstraintLayout:
XML
<androidx.appcompat.widget.AppCompatButton
android:id="@+id/btPhoto480P"
android:layout_width="120dp"
android:layout_height="wrap_content"
android:text="Capture"
android:contentDescription="Capture photo"
android:textSize="16sp" />
• Обяснение на надписа.
• android:text="Capture": Задава видимия надпис, показван директно на екрана.
• android:contentDescription="Capture photo": Предоставя описание за достъпност за екранни четци и за инспектиране на йерархията на потребителския интерфейс. Имайте предвид, че задаването на contentDescription на устройствата на Rokid не създава и не регистрира автоматично гласова команда; гласовото управление изисква изрична интеграция с услугата за реч/офлайн команди на Sprite Enterprise SDK.
• android:textSize="16sp": Осигурява четливост на монокулярния оптичен дисплей.
• Проектирайте работния екран. За бизнес версията поддържайте интерфейса минималистичен: ясен индикатор за статус, един основен бутон за заснемане и определен път за отказ или преглед. Следвайте указанията на Rokid за корпоративни дисплеи, като използвате текст с висок контраст (например четлив зелен текст върху реалната среда), и не разчитайте само на цвета, за да сигнализирате за грешки или състояния на заснемане. Винаги проверявайте позиционирането и отрязването на текста на физическия дисплей на очилата, вместо да разчитате единствено на прегледа на оформлението в Android Studio.
Указания за корпоративен дисплей и оформление: Отворете официалния източник
Стъпка 4: тествайте корпоративното гласово въвеждане
• Отворете примера за реч. В проекта за очилата отворете app/src/main/java/com/rokid/glass/SendMessageActivity.kt. Намерете клона R.id.btnOnlineAsr и функцията speechCallback(token). ASR означава автоматично разпознаване на реч: то преобразува речта в текст.
• Проведете една гласова сесия. Използвайте контрола за ASR от корпоративната демонстрация, за да стартирате сесия. Запазете обработката на токена на сесията и на обратното извикване. Примерът използва облачно ASR, което работи само след като демонстрацията за телефона е инициализирала SDK с вашите AK и SK, затова потвърдете правото на ползване на услугата, поддържания език, мрежовия достъп и условията за обработка на бизнес данни, преди да използвате речта на служителите.
• Дръжте крайния текст отделно от командите. В съществуващия блок за доставяне onAsrComplete обработете крайния текст с логика на приложението, като примера по-долу. Това е вмъкване в съществуващото обратно извикване, а не замяна на цялата имплементация на SpeechCallback. Кодът запазва бележка за преглед; той не задейства камерата и не стартира качване.
// Добавете това поле в SendMessageActivity: private var pendingBusinessNote: String? = null
// В съществуващия блок за доставяне на крайния резултат: pendingBusinessNote = content?.trim()?.takeIf { it.isNotEmpty() } // Покажете pendingBusinessNote в интерфейса за преглед, преди да запазите.
• Добавяйте команди обмислено. За заснемане без ръце използвайте корпоративния пример за офлайн команди или валидиран обработчик на крайния транскрипт, свързан с екрана за заснемане. И двата трябва да извикват същата функция за заснемане, която използва видимият бутон. Проверете езиковата и фонетичната конфигурация с предоставения SDK. Диктуваната бележка е свободен текст и не трябва да се третира като команда.
• Спиране и възстановяване. Запазете stopSpeech и почистването на сесията от примера, когато екранът излезе от преден план. Тествайте тишина, отказано разрешение за микрофона, загуба на мрежа и повтарящи се сесии. Осигурете резервен вариант с хардуерен бутон или видима контрола.
Корпоративен пример за ASR и офлайн команди: Отворете официалния източник
Стъпка 5: добавете обработчика на камерата и обратна връзка за резултата
• Използвайте повторно съществуващата инициализация. Върнете се към SdkMediaActivity.kt. Запазете настройката на SDK, импортите и обратното извикване за снимки от демонстрацията. В initView() заменете само блока binding.btPhoto480P.setOnClickListener с извикването по-долу, след което добавете функцията в същия клас Activity. Това използва съществуващия enum за резолюция 480P и общото местоположение Pictures от демонстрацията.
binding.btPhoto480P.setOnClickListener { captureBusinessPhoto() }
private fun captureBusinessPhoto() { val service = GlassSdk.getGlassMediaService() if (service == null) { binding.btPhoto480P.text = "Unavailable" return } val folder = Environment.getExternalStoragePublicDirectory( Environment.DIRECTORY_PICTURES ) if (!folder.exists() && !folder.mkdirs()) { binding.btPhoto480P.text = "Storage error" return } val output = File(folder, "inspection_${System.currentTimeMillis()}.png") binding.btPhoto480P.text = "Capturing" try { service.takePhoto(PhotoResolution.RESOLUTION_480P, output.absolutePath) } catch (e: Exception) { binding.btPhoto480P.text = "Try again" } }
• Показвайте успеха от обратното извикване. Намерете съществуващия обект mPhotoFileCallback. Добавете функцията по-долу в Activity, след което извикайте showBusinessPhoto(path) както от onTakePhoto, така и от onTakePhotoV2. Запазете getCallbackId и съществуващата регистрация на обратното извикване. В mICameraStateLister.onCameraError обновете контролата на „Try again“ в UI нишката.
private var capturedBusinessPhoto: String? = null
private fun showBusinessPhoto(path: String) { runOnUiThread { if (!isFinishing && !isDestroyed) { capturedBusinessPhoto = path binding.btPhoto480P.text = "Captured" } } }
• Разберете и персонализирайте. takePhoto изпраща заявка за заснемане; обратното му извикване предоставя пътя до файла. Captured означава, че съществува локален файл, а не че е запазен бизнес запис. За този екран за разработка разширете бутона, за да побере текста на статуса. В производствения екран използвайте отделен изглед за статус. Променяйте PhotoResolution само на стойности, поддържани от вашия SDK, и проверете кадрирането и действителните размери на изходния файл.
• Обработете разрешенията и жизнения цикъл. Използвайте процеса за разрешения от демонстрацията преди заснемане. Камерата и микрофонът изискват декларации в манифеста и съответното одобрение по време на изпълнение. Запазете removePhotoCallback и removeMediaStateLister в съществуващото почистване в onDestroy на Activity. Добавете защита за чакащо заснемане и времево ограничение, преди да свържете гласа, така че повтарящи се събития да не могат да предизвикат дублирани заснемания.
• Изберете безопасно съхранение. Демонстрацията използва споделено хранилище, което може да направи тестовите снимки достъпни за друг софтуер на устройството. Преди да обработвате реални записи, валидирайте с Rokid достъпа до услугата и подходящ дизайн на съхранението. Определете изтриването след преглед, качване или отказ. Не приемайте, че отделната услуга за камера на SDK може да записва в частната директория на приложението.
Корпоративен пример за медия: Отворете официалния източник
Съответстващ изходен код за камерата и импорти: Отворете официалния източник
Разрешения по време на изпълнение в Android: Отворете официалния източник
Стъпка 6: свържете прототипа с бизнес процес
• Определете записа. Съгласувайте с отговорника за бизнес системата идентификатора на актива, идентификатора на работната поръчка, самоличността на оператора, формата на снимката, полето за бележка, крайната точка и допустимия размер на файла. Използвайте тестов акаунт, управляван от компанията. Локалният път до файла не може да бъде изпратен към бекенда, сякаш е самото изображение.
• Въведете преглед преди качване. Създайте екран за преглед, съдържащ заснетата снимка и крайната бележка. Добавете контроли за потвърждение и отказ. Само потвърждението трябва да стартира качването. Отказът трябва да изчиства чакащия запис и да прилага съгласуваната политика за изтриване.
• Определете заявката. Имплементирайте API на компанията в приложението за телефона или за очилата, което отговаря за качването. Изпращайте байтовете на снимката със съгласуваните метаданни и удостоверяване. Използвайте мрежова операция във фонов режим, уникален идентификатор на изпращането и ограничен брой повторни опити. Съхранявайте дълготрайните идентификационни данни в бекенда; определете поддържания процес за удостоверяване на клиента съвместно с ИТ отдела.
• Показвайте правилното състояние. Използвайте Ready, Capturing, Captured, Review, Uploading, Saved и Retry. Преминавайте към Saved само след успешен отговор от сървъра с идентификатор на записа. Примерният код в това ръководство спира до локалното заснемане и събирането на бележки; качването изисква действителния ви API договор и имплементация.
Стъпка 7: проверете на корпоративния хардуер
• Компилирайте и стартирайте. От директорията glassdemo използвайте командата по-долу или контролата Run в Android Studio с избрани поддържани очила. В Windows използвайте gradlew.bat assembleDebug. Отстранете грешките на Gradle преди тестването на устройството; стандартен емулатор на Android не може да валидира услугите на устройството на Rokid.
./gradlew assembleDebug
• Тествайте заснемането и почистването. Изберете контролата за заснемане. Проверете файла с резултата, четливия статус, пътя при грешка на камерата и отказа на разрешение. Напуснете екрана и го отворете отново и проверете дали обратните извиквания се премахват и закачат отново без дублирани резултати. Уверете се, че индикаторът на камерата остава активен по време на заснемане.
• Тествайте речта отделно. Продиктувайте кратка тестова бележка, проверете крайния текст и откажете. Повторете при типичен шум на работното място и на всеки одобрен език. Ако добавяте команди, тествайте несвързана реч и повтарящи се изказвания спрямо защитата срещу дублирано заснемане.
• Тествайте интегрираната компилация. След като качването бъде имплементирано, тествайте прекъсвания на връзката, изтичане на времето, отнет достъп и повторно потвърждение. Проверете, че неуспешна заявка не показва Saved и че повторният опит за същото изпращане не създава нов запис.
Стъпка 8: пакетирайте и внедрете чрез бизнес канала
• Подгответе версия за издаване. Заменете брандирането на демонстрацията и премахнете несвързаните примерни функции и тестовите идентификационни данни. Прегледайте с Rokid условията за повторно използване на SDK и примерите. Използвайте контролирани от компанията имена на пакети, номериране на версии и идентификационни данни за подписване.
• Компилирайте подписан APK. В Android Studio отворете Build > Generate Signed Bundle / APK, изберете APK, посочете хранилището за ключове на компанията и компилирайте варианта за издаване. Пазете ключа за подписване сигурно: следващите актуализации трябва да използват правилната идентичност за подписване.
• Потвърдете частната инсталация. Използвайте начина за инсталиране и управление на приложения, който Rokid потвърди за вашия корпоративен фърмуер. Получете поддържания метод за доставяне на APK, процедурата за създаване на акаунти и процедурата за актуализация и връщане към предишна версия. Не приемайте, че общ софтуер за управление на устройства с Android поддържа този модел очила.
• Пилотен етап и повторно тестване. Внедрете в малка управлявана група, измерете качеството на заснемане, точността на разпознаване и времето за реакция, след което тествайте отново след промени в SDK или фърмуера. Записвайте версиите на компилациите и поддържайте работещ пакет за връщане назад, преди да разширите внедряването.
Подписване на приложения за Android: Отворете официалния източник
Чести грешки, които да избягвате
• Приемане на името на продукта като доказателство за съвместимост. Проверете действителния корпоративен фърмуер и поддържаната версия на SDK преди имплементацията.
• Пускане на демонстрацията без промени. Примерът демонстрира възможности. Споделеното му медийно хранилище, примерните фрази и несвързаните функции трябва да бъдат прегледани преди внедряване в бизнеса.
• Объркване на заснемането със запазването. Локалната снимка и транскриптът не са запазена работна поръчка. Потвърдете записа в бекенда, преди да покажете успех.
Заключение
Полезното бизнес приложение за Rokid започва с потвърден корпоративен хардуер и достъп до SDK, работеща демонстрация за Android и малък работен процес за заснемане и преглед. След това разработчиците добавят ясна обратна връзка на дисплея, валидирано гласово въвеждане и удостоверена интеграция с бекенда на компанията. Тестването на целевото устройство и внедряването чрез поддържания бизнес канал превръщат прототипа в инструмент, който може да подобри документирането на терен и да намали ръчното въвеждане.
























