Vývoj pre RealWear Navigator 520 bez SDK: ako funguje WearHF

Vývoj pre RealWear Navigator 520 bez SDK: ako funguje WearHF

Zhrnutie

RealWear Navigator 520 pri vývoji aplikácií nevyžaduje na základnú hlasovú interakciu samostatné SDK na rozpoznávanie reči. WearHF je súčasťou softvéru zariadenia. Dokáže analyzovať obrazovku Androidu, identifikovať podporované interaktívne prvky view a sprístupniť pre ne hlasové príkazy. Štandardné tlačidlo Androidu s označením CONTINUE tak možno aktivovať vyslovením „CONTINUE“ bez importovania knižnice RealWear.

Začnite so štandardnou aplikáciou pre Android a otestujte ju na cieľovom firmvéri Navigatora. WearHF dokáže rozpoznať podporované ovládacie prvky na obrazovke bez kódu na rozpoznávanie reči v samotnej aplikácii. Ak ovládací prvok potrebuje alternatívne frázy alebo špeciálne správanie, pridajte direktívu view do android:contentDescription. OVERRIDE_COMMANDS používajte iba vtedy, keď musí aplikácia prevziať kontrolu nad rozpoznávačom a spracúvať príkazy sama. Tieto postupy majú rôzne účinky, ktoré opisujeme nižšie.

Dôležité: „Bez SDK“ neznamená „bez kódu“. Rozhranie Androidu a obchodnú logiku stále vytvárate vy. Aplikácia nepotrebuje na základné hlasové ovládanie samostatné SDK RealWear na rozpoznávanie reči, pretože túto schopnosť na úrovni zariadenia poskytuje WearHF.

Základný princíp: Na základné hlasové ovládanie WearHF neotvárate, neinštalujete ani neimportujete žiadne WearHF SDK. WearHF beží na pozadí ako súčasť operačného systému RealWear.

Čo je RealWear Navigator 520?

Zariadenie RealWear Navigator 520 je odolný monokulárny počítač pre asistovanú realitu určený na prácu v prvej línii, ako je údržba, inšpekcie a servis v teréne. Firmvér 2.x pre RealWear Navigator 500/520 je založený na Androide 13 a údržbové vydanie Ari OS 2.0 zo 17. 9. 2026 (firmvér 3.0, build 3.0.3-15 ponúkaný zariadeniam s buildom 2.2.3-33) prináša prechod zariadenia na Android 16. Plány vývoja firmvéru sa môžu meniť, preto operačný systém zariadenia považujte za obmedzenie nasadenia: do matice vydaní si zaznamenajte otestovaný build firmvéru, úroveň Android API, minSdk/targetSdk aplikácie a model zariadenia. Hodnoty minSdk ani targetSdk neodvodzujte iba z verzie Androidu v headsete.

Pre vývojárov to znamená, že vytvárate a balíte bežnú aplikáciu pre Android. WearHF beží v zariadení a dokáže sprístupniť podporované ovládacie prvky hlasovému ovládaniu; neimplementuje však váš pracovný postup, neautorizuje obchodnú akciu ani nenahrádza validáciu na strane aplikácie.

Čo je WearHF?

WearHF je vstavaná služba RealWear na rozpoznávanie reči a interakciu bez použitia rúk. Interpretuje podporované prvky view Androidu a direktívy obrazovky a potom aktivuje prvok view alebo odošle udalosť reči podľa zvoleného spôsobu integrácie. Základná interakcia s prvkami view nevyžaduje žiadnu samostatnú knižnicu RealWear na rozpoznávanie reči. Vložené direktívy sa načítavajú z android:contentDescription; programové príkazy využívajú zdokumentované broadcast intenty Androidu. Nezamieňajte kliknutie na prvok view s prepísaním rozpoznávača: prepísanie (override) preberá kontrolu nad rozpoznávačom a až do obnovenia môže potlačiť vložené alebo skriptované príkazy.

Čo potrebujete pred vytvorením prvej aplikácie

· Navigator 520 s buildom firmvéru, ktorý chcete podporovať; zaznamenajte si jeho presný build a verziu Androidu.

· Počítač so systémom Windows, macOS alebo Linux.

· Android Studio s Android SDK a Platform Tools (ADB). Použite úroveň Android API, ktorú vaša aplikácia vyžaduje, a overte ju voči firmvéru podporovanému spoločnosťou RealWear.

· Dátový kábel USB-C.

· Pre prvú aplikáciu žiadne SDK RealWear.

· Firemný pracovný postup na otestovanie, napríklad posun na ďalší krok inšpekcie alebo nahlásenie problému so zariadením.

Ako vytvoriť hlasom ovládanú aplikáciu pre Android bez SDK RealWear

Krok 1: Vytvorte bežný projekt pre Android

Pre tento návod začnite s projektom Android Views. V Android Studiu zvoľte Empty Activity založenú na Views (nie šablónu iba pre Compose) a potom vyberte Javu alebo Kotlin. Nasledujúce príklady používajú Javu. Compose môže s WearHF na podporovanom softvéri fungovať tiež, jeho sémantiku a strom prístupnosti by ste však mali otestovať na cieľovom builde.

1. Otvorte Android Studio a vyberte New Project.

2. Zvoľte Empty Activity založenú na Views. Ak sprievodca ponúka polia pre jazyk a minimálne SDK, vyberte Javu a minSdk nastavte na najnižšiu úroveň Android API, ktorú vaša aplikácia skutočne podporuje; nepreberajte hodnotu z tohto príkladu bez kontroly závislostí a vašej flotily zariadení.

3. Zadajte údaje o aplikácii. Nastavte názov aplikácie, názov balíka a umiestnenie na uloženie a potom vytvorte projekt.

4. Počkajte, kým sa projekt otvorí. Android Studio dokončí synchronizáciu Gradle a otvorí projekt.

Zatiaľ nič nepridávajte: Nehľadáte šablónu projektu RealWear. Cieľom prvého buildu je overiť, že štandardná aplikácia pre Android dokáže bežať na zariadení Navigator 520.

Krok 2: Pridajte jedno tlačidlo Androidu a prepojte ho s Javou

Najprv vytvorte jedno tlačidlo. Pridáte jeho layout pre Android, v Jave prepojíte akciu kliknutia a potom ho otestujete na zariadení.

1. V paneli Project v Android Studiu otvorte app > res > layout > activity_main.xml. Úplná cesta k súboru je app/src/main/res/layout/activity_main.xml.

2. V editore layoutu vyberte Code. Obsah súboru nahraďte úplným XML uvedeným nižšie.

XML: Jedno tlačidlo s príkazom WearHF

Vložte celý layout do súboru activity_main.xml a súbor uložte:

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

Stručné vysvetlenie: `LinearLayout` usporiada svoj obsah vertikálne. `android:text` je viditeľný popis tlačidla. `android:contentDescription` obsahuje direktívu WearHF; toto pole čítajú aj služby prístupnosti Androidu, preto otestujte, či ovládací prvok zostáva pre vašich používateľov zrozumiteľný.

Potom v paneli Project otvorte app > java > váš balík > MainActivity.java. Úplná cesta je app/src/main/java/<your.package.name>/MainActivity.java. Vygenerovanú triedu Activity a metódu `onCreate()` ponechajte.

Ak chýba, pridajte `import android.widget.Button;` k importom na začiatku súboru MainActivity.java. Do existujúcej metódy `onCreate()` vložte tieto riadky hneď za `setContentView(R.layout.activity_main);`:

Button continueButton = findViewById(R.id.continueButton); continueButton.setOnClickListener(v -> openNextStep());

Túto metódu pridajte pod `onCreate()`, ale pred poslednú uzatváraciu zloženú zátvorku triedy MainActivity:

private void openNextStep() { // Prejdite na ďalší krok inšpekcie alebo pracovného príkazu. }

Ako ho upraviť: zmeňte `android:text` na popis, ktorý zodpovedá vášmu pracovnému postupu. Zmeňte `hf_commands:CONTINUE` na frázu, ktorú majú pracovníci vysloviť, napríklad `hf_commands:Continue Work, Next Step`. XML ID `continueButton` sa musí zhodovať s `R.id.continueButton` v Jave; ak ho premenujete, aktualizujte oboje. Komentár v `openNextStep()` nahraďte navigáciou alebo obchodnou akciou, ktorú vaša aplikácia potrebuje. Základné hlasové ovládanie nevyžaduje samostatné WearHF SDK ani povolenie `RECORD_AUDIO`.

Krok 3: Pripravte Navigator 520 na vývoj pre Android

Vývojový počítač potrebuje na inštaláciu a ladenie aplikácie autorizáciu ADB. Použite kábel USB-C s podporou prenosu dát; káble určené iba na nabíjanie sa ako zariadenie ADB nezobrazia.

1. Otvorte Advanced Settings. Na domovskej obrazovke Navigatora vyslovte MY SETTINGS, čím sa dostanete k zoznamu nastavení Androidu.

2. Otvorte About Device. Vyslovte ABOUT DEVICE a potom PAGE DOWN, kým sa nezobrazí Build Number.

3. Zapnite Developer Options. Opakovane, približne sedemkrát, vyslovte BUILD NUMBER, kým zariadenie nepotvrdí, že je režim pre vývojárov zapnutý.

4. Otvorte Developer Options. Vyslovte NAVIGATE BACK, potom SYSTEM a potom DEVELOPER OPTIONS.

5. Zapnite ladenie cez USB. V Developer Options zapnite USB debugging.

6. Pripojte kábel USB-C a na zariadení schváľte výzvu na ladenie RSA. Pripojenie overte príkazom `adb devices`; zariadenie by sa malo zobraziť ako `device`, nie `unauthorized`.

Ak Android Studio headset nezobrazuje, spustite `adb devices`. Ak sa zobrazí `unauthorized`, odomknite headset a schváľte výzvu RSA. Na opakovanú inštaláciu z koreňového adresára projektu použite `adb install -r app/build/outputs/apk/debug/app-debug.apk`; ak sa váš variant buildu alebo názov APK líši, cestu upravte. Na kontrolu pádov a protokolov aplikácie použite Logcat v Android Studiu alebo `adb logcat`.

Ladenie cez USB je vývojové nastavenie. Po testovaní v laboratóriu ho vypnite alebo ho spravujte podľa bezpečnostnej politiky zariadení vašej organizácie; na produkčných zariadeniach flotily nenechávajte vývojový prístup zapnutý.

Krok 4: Spustite aplikáciu na zariadení Navigator 520

1. V Android Studiu vyberte Navigator. Použite výber zariadenia na hornom paneli nástrojov a zvoľte pripojené zariadenie RealWear.

2. Kliknite na Run. Vyberte zelený trojuholník Run alebo použite Run > Run 'app'.

3. Počkajte na inštaláciu. Android Studio zostaví APK a cez ADB ho nainštaluje do Navigatora.

4. Spustite nainštalovanú aplikáciu zo spúšťača aplikácií v zariadení alebo z vývojového terminálu spustite `adb shell monkey -p your.application.id 1`. Hodnotu `your.application.id` nahraďte hodnotou applicationId zo súboru zostavenia Gradle v module aplikácie.

5. Overte, že tlačidlo CONTINUE je viditeľné a aktívne.

Krok 5: Otestujte WearHF bez pridania akéhokoľvek SDK

WearHF už v zariadení Navigator 520 beží. Keď je na obrazovke iba tlačidlo CONTINUE, otestujte najprv tento ovládací prvok:

1. Vyslovte CONTINUE a overte, že sa bežný listener kliknutia aplikácie spustí práve raz.

2. Vyslovte SHOW HELP a skontrolujte príkaz, ktorý WearHF pre túto obrazovku sprístupňuje. Overte, že sa zobrazuje CONTINUE.

3. Skontrolujte indikátory WearHF a ak je k dispozícii číselný výber, otestujte ho. Nespoliehajte sa na indikátor ako na jediný spôsob identifikácie akcie kritickej z hľadiska bezpečnosti.

Voliteľné: Po teste tlačidla CONTINUE pridajte druhú akciu

Keď prvé tlačidlo funguje, môžete pridať REPORT ISSUE. V súbore activity_main.xml vložte toto tlačidlo do LinearLayout pod CONTINUE a pred </LinearLayout>:

<Button android:id="@+id/reportIssueButton" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="REPORT ISSUE" />

V súbore MainActivity.java pridajte tento listener do metódy onCreate() za listener tlačidla CONTINUE:

Button reportIssueButton = findViewById(R.id.reportIssueButton); reportIssueButton.setOnClickListener(v -> openIssueReport());

Metódu openIssueReport() pridajte pod onCreate() v rámci triedy MainActivity. Komentár nahraďte pracovným postupom nahlasovania problémov vo vašej aplikácii:

private void openIssueReport() { // Otvorte formulár na nahlásenie problému so zariadením. }

Aplikáciu znova zostavte a nainštalujte a potom vyslovte REPORT ISSUE. Overte, že sa otvorí pracovný postup nahlasovania problému.

Záver

Vývoj pre zariadenie RealWear Navigator 520 bez vyhradeného SDK dokazuje, že čistý, štandardný kód pre Android už podporuje hlasové ovládanie, pričom sa spolieha na vstavanú službu WearHF, ktorá viditeľné prvky view a direktívy contentDescription mení na intuitívne ovládanie bez použitia rúk. Technickým tímom tento prístup umožňuje vyhnúť sa nadbytočným knižniciam tretích strán a zložitým rečovým enginom a zároveň ponechať kľúčovú obchodnú logiku v rámci štandardnej architektúry Androidu. Z obchodného hľadiska tento prístup skracuje čas uvedenia na trh a minimalizuje náklady na nasadenie: podniky môžu priamo využiť existujúce aplikácie pre Android a zručnosti interných vývojárov, vyhnúť sa závislosti od proprietárneho SDK a plynulo modernizovať pracovné postupy v prvej línii bez narušenia svojho softvérového ekosystému.

Pri prvom podnikovom prototype vytvorte jednu obrazovku na inšpekciu alebo údržbu, overte popisy prvkov view a popisy prístupnosti a potom otestujte hlasovú aktiváciu presne na tom firmvéri Navigatora 520, ktorý používa pilotná flotila. Vložené direktívy pridávajte pre špecifické potreby používateľského rozhrania a prepisovanie rozpoznávača iba vtedy, keď pracovný postup vyžaduje úplnú kontrolu nad príkazmi.

Často kladené otázky

Tento článok

Áno. Aplikácia je stále aplikáciou pre Android, takže vývojári píšu rozhranie a obchodnú logiku v Jave, Kotline, pomocou XML Views alebo iného podporovaného nástroja na tvorbu používateľského rozhrania pre Android. Základná interakcia WearHF s prvkami view nevyžaduje samostatné SDK RealWear na rozpoznávanie reči.

Pre základné príkazy prvkov view nie. WearHF je zabudovaný v softvéri RealWear a dokáže odvodiť príkazy z podporovaných prvkov view Androidu. Na vlastné správanie použite zdokumentované direktívy alebo intenty.

Neotvárate ho ako samostatnú aplikáciu. WearHF beží na pozadí ako súčasť softvéru zariadenia Navigator 520.

Pri podporovaných klikateľných prvkoch view dokáže WearHF odvodiť príkaz z textu prvku alebo z jeho content description, a to v závislosti od direktívy a hierarchie prvkov. Príkaz sprístupnený na skutočnej obrazovke otestujte – viditeľný popis nie je zárukou pri každom vlastnom prvku view.

Na zariadení Navigator 520 vyslovte SHOW HELP. RealWear zobrazí príkazy priradené k danej obrazovke.

V aplikácii založenej na Views otvorte XML layout (napríklad app/src/main/res/layout/activity_main.xml) a pri prvku view nastavte `android:contentDescription`. Pre viacero fráz použite `hf_commands:Phrase One, Phrase Two` a viacero direktív oddeľte znakom `-`.

`hf_commands` je direktíva WearHF na úrovni prvku view. Vložte ju do contentDescription prvku a za ňu uveďte frázy oddelené čiarkami; každá rozpoznaná fráza na daný prvok klikne.

Pre vložené direktívy nie je potrebná žiadna samostatná knižnica WearHF. Ide o reťazce v Android contentDescription, ktoré interpretuje služba zariadenia. Keďže contentDescription využívajú aj služby prístupnosti, zachovajte užitočný popis pre prístupnosť a otestujte obe správania.

OVERRIDE_COMMANDS použite, keď sa musí zoznam príkazov rozpoznávača počas behu nahradiť. Pre príkazy na úrovni obrazovky, ktoré dopĺňajú prvky view, zvážte `hf_add_commands`. Nezabudnite, že režim prepísania dočasne potláča vložené alebo skriptované príkazy a v zdokumentovaných bodoch životného cyklu ho treba obnoviť alebo znova zaregistrovať.

Poznámky k vydaniu RealWear Collaborate z mája 2026 uvádzajú, že WearHF natívne podporuje Jetpack Compose. To dokladá podporu Compose na platforme, nenahrádza to však testovanie sémantiky, vlastných composables, popisov prístupnosti a prekrytí príkazov vo vašej vlastnej aplikácii. Tento návod používa XML Views, aby bolo mapovanie prvkov view na príkazy jednoznačné. Zdroj: poznámka k vydaniu Collaborate 2.5.1 uvádza, že WearHF natívne podporuje Compose (zverejnené 7. 5. 2026). Toto tvrdenie uplatňujte iba na softvér zariadení, ktorý príslušnú podporu obsahuje; správanie overte na svojom cieľovom builde.

Zverejnené vydanie firmvéru 2.2 pre Navigator 500/520 je založené na Androide 13. Politika firmvéru RealWear uvádza plán previesť podporované zariadenia počas roka 2026 na OS založený na Androide 16 – plán však nie je zárukou vydania. Pred výberom compileSdk, targetSdk, minSdk, povolení alebo správania pri vydaní si skontrolujte aktuálne poznámky k vydaniu GA a otestujte presný build používaný vo vašej flotile.