Резюме
RealWear Navigator 520 – при разработката за това устройство не е необходим отделен SDK за реч, за да се осигури основно гласово взаимодействие. WearHF е част от софтуера на устройството. Той може да анализира екран на Android, да идентифицира поддържаните интерактивни изгледи (views) и да предостави гласови команди за тях. Така стандартен бутон в Android с надпис CONTINUE може да бъде активиран с изричане на „CONTINUE“, без да се импортира библиотека на RealWear.
Започнете със стандартно Android приложение и го тествайте на целевия фърмуер на Navigator. WearHF може да разпознава поддържаните контроли на екрана без код за реч в самото приложение. Добавете директива за изглед в android:contentDescription, когато дадена контрола се нуждае от алтернативни фрази или специално поведение. Използвайте OVERRIDE_COMMANDS само когато приложението трябва да поеме контрола над разпознавателя и само да обработва командите. Тези подходи имат различен ефект, описан по-долу.
Важно: „Без SDK“ не означава „без код“. Все пак изграждате интерфейса и бизнес логиката на Android. Приложението не се нуждае от отделен SDK за реч на RealWear за основно гласово управление, защото WearHF осигурява тази възможност на ниво устройство.
Основна идея: За основно гласово управление не отваряте WearHF, не инсталирате WearHF и не импортирате WearHF SDK. WearHF работи във фонов режим като част от операционната система на RealWear.
Какво представлява RealWear Navigator 520?
Устройството RealWear Navigator 520 е здрав монокулярен компютър за асистирана реалност, предназначен за работа на първа линия като поддръжка, инспекции и сервиз на терен. Фърмуерът 2.x на RealWear за Navigator 500/520 е базиран на Android 13, а поддържащото издание Ari OS 2.0 от 17-09-2026 (фърмуер 3.0, компилация 3.0.3-15, предлагана на устройства с компилация 2.2.3-33) премества устройството на Android 16. Пътните карти за фърмуера могат да се променят, затова разглеждайте операционната система на устройството като ограничение при внедряването: записвайте в матрицата на изданията си тестваната компилация на фърмуера, нивото на Android API, minSdk/targetSdk на приложението и модела на устройството. Не извеждайте minSdk или targetSdk единствено от версията на Android на устройството.
За разработчиците това означава, че изграждате и пакетирате обикновено Android приложение. WearHF работи на устройството и може да направи поддържаните контроли достъпни за гласово управление; той не реализира вашия работен процес, не оторизира бизнес действия и не замества валидирането от страна на приложението.
Какво е WearHF?
WearHF е вградената услуга на RealWear за реч и взаимодействие със свободни ръце. Тя интерпретира поддържаните изгледи на Android и директивите на екрана, след което активира изглед или изпраща речево събитие според избрания начин на интеграция. Основното взаимодействие с изгледи не изисква отделна библиотека за реч на RealWear. Вградените директиви се извличат от android:contentDescription, а програмните команди използват документирани broadcast интенти на Android. Не бъркайте щракването върху изглед с отмяната на разпознавателя: отмяната (override) поема контрола над разпознавателя и може да потиска вградените/скриптовите команди, докато не бъде възстановен.
Какво ви трябва, преди да изградите първото приложение
· Navigator 520 с версията на фърмуера, която възнамерявате да поддържате; запишете точната компилация и версията на Android.
· Компютър с Windows, macOS или Linux.
· Android Studio с Android SDK и Platform Tools (ADB). Използвайте нивото на Android API, изисквано от приложението ви, и валидирайте спрямо поддържания от RealWear фърмуер.
· USB-C кабел за данни.
· Никакъв RealWear SDK за първото приложение.
· Бизнес процес за тестване, например преминаване към следващата стъпка на инспекция или докладване на проблем с оборудване.
Как да изградите Android приложение с гласово управление без RealWear SDK
Стъпка 1: Създайте обикновен Android проект
За това ръководство започнете с проект на Android Views. В Android Studio изберете Empty Activity, базирана на Views (а не шаблон само за Compose), след което изберете Java или Kotlin. Примерите по-долу използват Java. Compose също може да работи с WearHF на поддържан софтуер, но семантиката и дървото за достъпност трябва да се тестват на целевата компилация.
1. Отворете Android Studio и изберете New Project.
2. Изберете Empty Activity, базирана на Views. Ако съветникът предлага полета за език и минимален SDK, изберете Java и задайте за minSdk най-ниското ниво на Android API, което приложението ви действително поддържа; не копирайте стойност от този пример, без да проверите зависимостите и парка си от устройства.
3. Въведете данните за приложението. Задайте име на приложението, име на пакета и място за запис, след което създайте проекта.
4. Изчакайте проектът да се отвори. Android Studio завършва синхронизацията с Gradle и отваря проекта.
Засега не добавяйте нищо: не търсите шаблон за проект на RealWear. Целта на първата компилация е да докаже, че стандартно Android приложение може да работи на Navigator 520.
Стъпка 2: Добавете един бутон в Android и го свържете с Java
Първо създайте един бутон. Ще добавите оформлението му в Android, ще свържете действието при щракване в Java и след това ще го тествате на устройството.
1. В панела Project на Android Studio отворете app > res > layout > activity_main.xml. Пълният път до файла е app/src/main/res/layout/activity_main.xml.
2. Изберете Code в редактора на оформлението. Заменете съдържанието на файла с пълния XML код, показан по-долу.
XML: един бутон с команда на WearHF
Поставете пълното оформление в activity_main.xml и запазете файла:
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:layout_width="match_parent" android:layout_height="match_parent" android:orientation="vertical" android:padding="24dp">
<Button android:id="@+id/continueButton" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="CONTINUE" android:contentDescription="hf_commands:CONTINUE" />
</LinearLayout>
Кратко обяснение: `LinearLayout` подрежда съдържанието си вертикално. `android:text` е видимият надпис на бутона. `android:contentDescription` съдържа директивата на WearHF; услугите за достъпност на Android също четат това поле, затова проверете дали контролата остава разбираема за потребителите ви.
След това отворете app > java > вашия пакет > MainActivity.java в панела Project. Пълният път е app/src/main/java/<your.package.name>/MainActivity.java. Запазете генерирания клас Activity и метода `onCreate()`.
Ако липсва, добавете `import android.widget.Button;` към импортите в началото на MainActivity.java. В съществуващия метод `onCreate()` поставете тези редове непосредствено след `setContentView(R.layout.activity_main);`:
Button continueButton = findViewById(R.id.continueButton); continueButton.setOnClickListener(v -> openNextStep());
Добавете този метод под `onCreate()`, но преди последната затваряща скоба на класа MainActivity:
private void openNextStep() { // Преминаване към следващата стъпка на инспекцията или работната поръчка. }
Как да го адаптирате: променете `android:text` на надписа, който отговаря на работния ви процес. Променете `hf_commands:CONTINUE` на фразата, която работниците трябва да казват, например `hf_commands:Continue Work, Next Step`. XML ID `continueButton` трябва да съвпада с `R.id.continueButton` в Java; ако го преименувате, актуализирайте и двете. Заменете коментара в `openNextStep()` с навигацията или бизнес действието, от което се нуждае приложението ви. Основното гласово управление не изисква отделен WearHF SDK или разрешение `RECORD_AUDIO`.
Стъпка 3: Подгответе Navigator 520 за разработка под Android
Компютърът за разработка се нуждае от ADB оторизация, за да инсталира и дебъгва приложението. Използвайте USB-C кабел с поддръжка на пренос на данни; кабелите само за зареждане няма да бъдат разпознати като ADB устройство.
1. Отворете Advanced Settings. От началния екран на Navigator кажете MY SETTINGS, за да стигнете до списъка с настройки на Android.
2. Отворете About Device. Кажете ABOUT DEVICE, след това PAGE DOWN, докато се покаже Build Number.
3. Активирайте Developer Options. Кажете BUILD NUMBER многократно, около седем пъти, докато устройството потвърди, че режимът за разработчици е активиран.
4. Отворете Developer Options. Кажете NAVIGATE BACK, след това SYSTEM и накрая DEVELOPER OPTIONS.
5. Активирайте USB debugging. В Developer Options включете USB debugging.
6. Свържете USB-C кабела и одобрете RSA подканата за дебъгване на устройството. Потвърдете връзката с `adb devices`; устройството трябва да се показва като `device`, а не като `unauthorized`.
Ако Android Studio не показва устройството, изпълнете `adb devices`. Ако то се показва като `unauthorized`, отключете устройството и одобрете RSA подканата. За повторна инсталация от главната директория на проекта използвайте `adb install -r app/build/outputs/apk/debug/app-debug.apk`; заменете пътя, ако вариантът на компилацията или името на APK файла се различават. Използвайте Logcat в Android Studio или `adb logcat`, за да проверявате сривове и логове на приложението.
USB debugging е настройка за разработка. Деактивирайте я след лабораторните тестове или я управлявайте съгласно политиката за сигурност на устройствата в организацията; не оставяйте достъпа за разработка активиран на устройствата от производствения парк.
Стъпка 4: Стартирайте приложението на Navigator 520
1. Изберете Navigator в Android Studio. Използвайте селектора на устройства в горната лента с инструменти и изберете свързаното устройство RealWear.
2. Щракнете върху Run. Изберете зеления триъгълник Run или използвайте Run > Run 'app'.
3. Изчакайте инсталирането. Android Studio компилира APK файла и го инсталира на Navigator чрез ADB.
4. Стартирайте инсталираното приложение от стартовия панел за приложения на устройството или изпълнете `adb shell monkey -p your.application.id 1` от терминал за разработка. Заменете `your.application.id` с applicationId от файла за компилация на Gradle на модула на приложението.
5. Уверете се, че бутонът CONTINUE е видим и активен.
Стъпка 5: Тествайте WearHF, без да добавяте SDK
WearHF вече работи на Navigator 520. Докато на екрана е само бутонът CONTINUE, първо тествайте тази контрола:
1. Кажете CONTINUE и проверете дали обичайният слушател за щракване на приложението се изпълнява точно веднъж.
2. Кажете SHOW HELP, за да видите командата, която WearHF предоставя за този екран. Уверете се, че се показва CONTINUE.
3. Проверете индикаторите на WearHF и тествайте избора по номер, ако се предлага. Не разчитайте на индикатор като единствен начин за разпознаване на критично за безопасността действие.
По избор: добавете второ действие след теста с CONTINUE
След като първият бутон заработи, можете да добавите REPORT ISSUE. В activity_main.xml поставете този Button в LinearLayout, под CONTINUE и преди </LinearLayout>:
<Button android:id="@+id/reportIssueButton" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="REPORT ISSUE" />
В MainActivity.java добавете този слушател в onCreate(), след слушателя за CONTINUE:
Button reportIssueButton = findViewById(R.id.reportIssueButton); reportIssueButton.setOnClickListener(v -> openIssueReport());
Добавете openIssueReport() под onCreate(), в рамките на MainActivity. Заменете коментара с процеса за докладване на проблеми във вашето приложение:
private void openIssueReport() { // Отваряне на формуляра за проблем с оборудването. }
Компилирайте и инсталирайте приложението отново, след което кажете REPORT ISSUE. Уверете се, че процесът за докладване на проблем се отваря.
Заключение
Разработката за RealWear Navigator 520 без специален SDK доказва, че чистият стандартен Android код вече е готов за гласово управление, като разчита на вградената услуга WearHF, за да превърне видимите изгледи и директивите в contentDescription в интуитивни контроли със свободни ръце. За техническите екипи това означава избягване на излишните библиотеки на трети страни и сложните речеви машини, като основната бизнес логика остава в рамките на стандартната архитектура на Android. От бизнес гледна точка този подход ускорява излизането на пазара и свежда до минимум разходите за внедряване: предприятията могат директно да използват съществуващите си Android приложения и уменията на собствените си разработчици, да избегнат обвързването с патентован SDK и плавно да модернизират работните процеси на първа линия, без да нарушават софтуерния си стек.
За първи корпоративен прототип изградете един екран за инспекция или поддръжка, проверете етикетите на изгледите и описанията за достъпност, след което тествайте гласовото активиране на точно същия фърмуер на Navigator 520, който използва пилотният парк от устройства. Добавяйте вградени директиви за специфични нужди на интерфейса, а отмяна на разпознавателя – само когато работният процес изисква пълен контрол над командите.
























