Dezvoltarea pentru RealWear Navigator 520 fără SDK: cum funcționează WearHF

Dezvoltarea pentru RealWear Navigator 520 fără SDK: cum funcționează WearHF

Rezumat

RealWear Navigator 520 nu necesită, în dezvoltarea aplicațiilor, un SDK separat de recunoaștere vocală pentru interacțiunea vocală de bază. WearHF face parte din software-ul dispozitivului. Acesta poate analiza un ecran Android, poate identifica elementele interactive acceptate și poate expune comenzi vocale pentru ele. Astfel, un buton Android standard etichetat CONTINUE poate fi activat rostind „CONTINUE”, fără a importa vreo bibliotecă RealWear.

Porniți de la o aplicație Android standard și testați-o pe firmware-ul Navigator vizat. WearHF poate recunoaște comenzile de ecran acceptate fără cod de recunoaștere vocală în aplicație. Adăugați o directivă de vizualizare în android:contentDescription atunci când un control are nevoie de expresii alternative sau de un comportament special. Folosiți OVERRIDE_COMMANDS doar atunci când aplicația trebuie să preia controlul asupra motorului de recunoaștere și să gestioneze ea însăși comenzile. Aceste abordări au efecte diferite, descrise mai jos.

Important: „fără SDK” nu înseamnă „fără cod”. Tot trebuie să construiți interfața Android și logica de business. Aplicația nu are nevoie de un SDK RealWear separat de recunoaștere vocală pentru controlul vocal de bază, deoarece WearHF furnizează această capacitate la nivelul dispozitivului.

Conceptul de bază: pentru controlul vocal de bază nu deschideți WearHF, nu instalați WearHF și nu importați un SDK WearHF. WearHF rulează în fundal, ca parte a sistemului de operare RealWear.

Ce este RealWear Navigator 520?

Dispozitivul RealWear Navigator 520 este un computer monocular robust de realitate asistată, conceput pentru munca din prima linie, cum ar fi mentenanța, inspecțiile și service-ul pe teren. Firmware-ul 2.x al RealWear pentru Navigator 500/520 se bazează pe Android 13, iar versiunea de mentenanță Ari OS 2.0 din 17-09-2026 (firmware 3.0, build 3.0.3-15, oferit dispozitivelor cu build-ul 2.2.3-33) trece dispozitivul la Android 16. Foile de parcurs pentru firmware se pot schimba, așa că tratați sistemul de operare al dispozitivului ca pe o constrângere de implementare: înregistrați în matricea de versiuni build-ul de firmware testat, nivelul API Android, valorile minSdk/targetSdk ale aplicației și modelul dispozitivului. Nu deduceți minSdk sau targetSdk exclusiv din versiunea Android a headsetului.

Pentru dezvoltatori, aceasta înseamnă că construiți și împachetați o aplicație Android obișnuită. WearHF rulează pe dispozitiv și poate expune comenzile acceptate controlului vocal; nu implementează fluxul dumneavoastră de lucru, nu autorizează o acțiune de business și nu înlocuiește validarea din aplicație.

Ce este WearHF?

WearHF este serviciul integrat al RealWear pentru recunoaștere vocală și interacțiune hands-free. Acesta interpretează vizualizările Android acceptate și directivele de ecran, apoi activează o vizualizare sau trimite un eveniment vocal, în funcție de integrarea aleasă. Interacțiunea de bază cu vizualizările nu necesită o bibliotecă RealWear separată de recunoaștere vocală. Directivele încorporate sunt extrase din android:contentDescription; comenzile programatice folosesc intenții broadcast Android documentate. Nu confundați un clic pe o vizualizare cu o suprascriere a motorului de recunoaștere: o suprascriere preia controlul asupra motorului de recunoaștere și poate suprima comenzile încorporate/scriptate până la restaurare.

De ce aveți nevoie înainte de a construi prima aplicație

· Un Navigator 520 care rulează build-ul de firmware pe care intenționați să-l suportați; notați build-ul exact și versiunea Android.

· Un computer cu Windows, macOS sau Linux.

· Android Studio cu Android SDK și Platform Tools (ADB). Folosiți nivelul API Android cerut de aplicația dumneavoastră și validați pe firmware-ul acceptat de RealWear.

· Un cablu de date USB-C.

· Niciun SDK RealWear pentru prima aplicație.

· Un flux de lucru de business de testat, cum ar fi trecerea la următorul pas al unei inspecții sau raportarea unei probleme la un echipament.

Cum construiți o aplicație Android cu control vocal fără un SDK RealWear

Pasul 1: Creați un proiect Android obișnuit

Pentru acest ghid, porniți de la un proiect Android bazat pe Views. În Android Studio, alegeți un Empty Activity bazat pe Views (nu un șablon exclusiv Compose), apoi selectați Java sau Kotlin. Exemplele de mai jos folosesc Java. Și Compose poate funcționa cu WearHF pe software-ul acceptat, dar semantica și arborele de accesibilitate ar trebui testate pe build-ul vizat.

1. Deschideți Android Studio și selectați New Project.

2. Alegeți un Empty Activity bazat pe Views. Dacă asistentul oferă câmpuri pentru limbaj și SDK minim, selectați Java și setați minSdk la cel mai mic API Android pe care aplicația îl suportă efectiv; nu copiați o valoare din acest exemplu fără să verificați dependențele și flota de dispozitive.

3. Introduceți detaliile aplicației. Setați numele aplicației, numele pachetului și locația de salvare, apoi creați proiectul.

4. Așteptați deschiderea proiectului. Android Studio finalizează sincronizarea Gradle și deschide proiectul.

Nu adăugați încă nimic: nu căutați un șablon de proiect RealWear. Scopul primului build este să demonstreze că o aplicație Android standard poate rula pe Navigator 520.

Pasul 2: Adăugați un buton Android și conectați-l la Java

Creați mai întâi un singur buton. Veți adăuga layout-ul Android al acestuia, veți conecta acțiunea de clic în Java, apoi îl veți testa pe dispozitiv.

1. În panoul Project din Android Studio, deschideți app > res > layout > activity_main.xml. Calea completă a fișierului este app/src/main/res/layout/activity_main.xml.

2. Selectați Code în editorul de layout. Înlocuiți conținutul fișierului cu XML-ul complet prezentat mai jos.

XML: un buton cu o comandă WearHF

Lipiți layout-ul complet în activity_main.xml, apoi salvați fișierul:

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

Explicație rapidă: `LinearLayout` așază conținutul pe verticală. `android:text` este eticheta vizibilă a butonului. `android:contentDescription` conține directiva WearHF; serviciile de accesibilitate Android citesc și ele acest câmp, așa că testați dacă elementul rămâne ușor de înțeles pentru utilizatori.

Apoi, deschideți app > java > pachetul dumneavoastră > MainActivity.java în panoul Project. Calea completă este app/src/main/java/<your.package.name>/MainActivity.java. Păstrați clasa Activity generată și metoda `onCreate()`.

Dacă lipsește, adăugați `import android.widget.Button;` alături de celelalte importuri de la începutul fișierului MainActivity.java. În interiorul metodei `onCreate()` existente, lipiți aceste linii imediat după `setContentView(R.layout.activity_main);`:

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

Adăugați această metodă sub `onCreate()`, dar înainte de acolada finală de închidere a clasei MainActivity:

private void openNextStep() { // Navigați la următorul pas al inspecției sau al comenzii de lucru. }

Cum îl adaptați: modificați `android:text` cu eticheta potrivită fluxului dumneavoastră de lucru. Înlocuiți `hf_commands:CONTINUE` cu expresia pe care trebuie să o rostească lucrătorii, de exemplu `hf_commands:Continue Work, Next Step`. ID-ul XML `continueButton` trebuie să corespundă cu `R.id.continueButton` din Java; dacă îl redenumiți, actualizați-le pe amândouă. Înlocuiți comentariul din `openNextStep()` cu acțiunea de navigare sau de business de care are nevoie aplicația. Controlul vocal de bază nu necesită un SDK WearHF separat și nici permisiunea `RECORD_AUDIO`.

Pasul 3: Pregătiți Navigator 520 pentru dezvoltare Android

Computerul de dezvoltare are nevoie de autorizare ADB pentru a instala și depana aplicația. Folosiți un cablu USB-C care transferă date; cablurile doar pentru încărcare nu vor fi detectate ca dispozitiv ADB.

1. Deschideți Advanced Settings. Din ecranul Home al Navigator, rostiți MY SETTINGS pentru a ajunge la lista de setări Android.

2. Deschideți About Device. Rostiți ABOUT DEVICE, apoi PAGE DOWN până când devine vizibil Build Number.

3. Activați Developer Options. Rostiți BUILD NUMBER în mod repetat, de aproximativ șapte ori, până când dispozitivul confirmă că modul dezvoltator este activat.

4. Deschideți Developer Options. Rostiți NAVIGATE BACK, apoi SYSTEM, apoi DEVELOPER OPTIONS.

5. Activați USB debugging. În Developer Options, activați USB debugging.

6. Conectați cablul USB-C și aprobați pe dispozitiv solicitarea de depanare RSA. Confirmați conexiunea cu `adb devices`; dispozitivul ar trebui să apară ca `device`, nu ca `unauthorized`.

Dacă Android Studio nu afișează headsetul, rulați `adb devices`. Dacă apare `unauthorized`, deblocați headsetul și aprobați solicitarea RSA. Pentru o reinstalare din rădăcina proiectului, folosiți `adb install -r app/build/outputs/apk/debug/app-debug.apk`; înlocuiți calea dacă varianta de build sau numele APK-ului diferă. Folosiți Logcat din Android Studio sau `adb logcat` pentru a analiza blocările și jurnalele aplicației.

USB debugging este o setare de dezvoltare. Dezactivați-o după testarea în laborator sau gestionați-o conform politicii de securitate a dispozitivelor din organizație; nu lăsați accesul de dezvoltare activat pe dispozitivele din flota de producție.

Pasul 4: Rulați aplicația pe Navigator 520

1. Selectați Navigator în Android Studio. Folosiți selectorul de dispozitive din bara de instrumente de sus și alegeți dispozitivul RealWear conectat.

2. Faceți clic pe Run. Selectați triunghiul verde Run sau folosiți Run > Run 'app'.

3. Așteptați instalarea. Android Studio construiește APK-ul și îl instalează pe Navigator prin ADB.

4. Lansați aplicația instalată din lansatorul de aplicații al dispozitivului sau rulați `adb shell monkey -p your.application.id 1` dintr-un terminal de dezvoltare. Înlocuiți `your.application.id` cu applicationId din fișierul de build Gradle al modulului aplicației.

5. Confirmați că butonul CONTINUE este vizibil și activ.

Pasul 5: Testați WearHF fără a adăuga niciun SDK

WearHF rulează deja pe Navigator 520. Cu doar butonul CONTINUE pe ecran, testați mai întâi acest control:

1. Rostiți CONTINUE și verificați că listenerul de clic obișnuit al aplicației rulează exact o dată.

2. Rostiți SHOW HELP pentru a vedea comanda pe care WearHF o expune pentru acest ecran. Confirmați că apare CONTINUE.

3. Verificați indicatorii WearHF și testați selecția numerică, dacă este disponibilă. Nu vă bazați pe un indicator ca unic mod de identificare a unei acțiuni critice pentru siguranță.

Opțional: adăugați o a doua acțiune după testul CONTINUE

După ce primul buton funcționează, puteți adăuga REPORT ISSUE. În activity_main.xml, plasați acest Button în interiorul LinearLayout, sub CONTINUE și înainte de </LinearLayout>:

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

În MainActivity.java, adăugați acest listener în onCreate(), după listenerul pentru CONTINUE:

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

Adăugați openIssueReport() sub onCreate(), în interiorul MainActivity. Înlocuiți comentariul cu fluxul de raportare a problemelor din aplicația dumneavoastră:

private void openIssueReport() { // Deschideți formularul pentru probleme la echipamente. }

Reconstruiți și reinstalați aplicația, apoi rostiți REPORT ISSUE. Confirmați că se deschide fluxul de raportare a problemelor.

Concluzie

Dezvoltarea pentru RealWear Navigator 520 fără un SDK dedicat demonstrează că un cod Android curat și standard este deja compatibil cu controlul vocal, bazându-se pe serviciul integrat WearHF pentru a transforma vizualizările vizibile și directivele contentDescription în comenzi hands-free intuitive. Pentru echipele tehnice, această abordare evită încărcarea cu biblioteci terțe și motoarele complexe de recunoaștere vocală, păstrând totodată logica de business de bază în arhitectura Android standard. Din perspectiva afacerii, această abordare accelerează lansarea pe piață și reduce la minimum costurile de implementare: companiile pot valorifica direct aplicațiile Android existente și competențele dezvoltatorilor interni, pot evita dependența de SDK-uri proprietare și pot moderniza fără dificultăți fluxurile de lucru din prima linie, fără a perturba infrastructura software.

Pentru un prim prototip de întreprindere, construiți un ecran de inspecție sau de mentenanță, verificați etichetele vizualizărilor și descrierile de accesibilitate, apoi testați activarea vocală pe exact firmware-ul Navigator 520 folosit de flota pilot. Adăugați directive încorporate pentru nevoi specifice ale interfeței, iar suprascrieri ale motorului de recunoaștere doar atunci când fluxul de lucru necesită controlul complet asupra comenzilor.

Întrebări frecvente

Acest articol

Da. Aplicația rămâne o aplicație Android, așa că dezvoltatorii scriu interfața și logica de business în Java, Kotlin, XML Views sau alt toolkit UI Android acceptat. Interacțiunea de bază a WearHF cu vizualizările nu necesită un SDK RealWear separat de recunoaștere vocală.

Nu pentru comenzile de bază ale vizualizărilor. WearHF este integrat în software-ul RealWear și poate deriva comenzi din vizualizările Android acceptate. Pentru un comportament personalizat, folosiți directivele sau intențiile documentate.

Nu îl deschideți ca pe o aplicație separată. WearHF rulează în fundal, ca parte a software-ului Navigator 520.

Pentru vizualizările clicabile acceptate, WearHF poate deriva o comandă din textul vizualizării sau din descrierea conținutului, în funcție de directivă și de ierarhia vizualizărilor. Testați comanda expusă pe ecranul real; o etichetă vizibilă nu reprezintă o garanție pentru fiecare vizualizare personalizată.

Rostiți SHOW HELP pe Navigator 520. RealWear afișează comenzile asociate ecranului respectiv.

Într-o aplicație bazată pe Views, deschideți fișierul XML de layout (de exemplu, app/src/main/res/layout/activity_main.xml) și setați `android:contentDescription` pe vizualizare. Folosiți `hf_commands:Phrase One, Phrase Two` pentru mai multe expresii și `-` între mai multe directive.

`hf_commands` este o directivă WearHF la nivel de vizualizare. Plasați-o în contentDescription al vizualizării, urmată de expresii separate prin virgulă; fiecare expresie recunoscută declanșează un clic pe acea vizualizare.

Pentru directivele încorporate nu este nevoie de o bibliotecă WearHF separată. Acestea sunt șiruri de caractere din contentDescription Android, interpretate de serviciul dispozitivului. Deoarece contentDescription este folosit și de serviciile de accesibilitate, păstrați o etichetă de accesibilitate utilă și testați ambele comportamente.

Folosiți OVERRIDE_COMMANDS atunci când lista de comenzi a motorului de recunoaștere trebuie înlocuită în timpul rulării. Pentru comenzi la nivel de ecran care completează vizualizările, luați în considerare `hf_add_commands`. Rețineți că modul de suprascriere suprimă temporar comenzile încorporate/scriptate și trebuie restaurat sau reînregistrat în punctele documentate ale ciclului de viață.

Notele de lansare RealWear Collaborate din mai 2026 menționează că WearHF acceptă nativ Jetpack Compose. Aceasta este o dovadă a suportului platformei pentru Compose, dar nu înlocuiește testarea semanticii, a composable-urilor personalizate, a etichetelor de accesibilitate și a suprapunerilor de comenzi în propria aplicație. Acest tutorial folosește XML Views pentru ca maparea dintre vizualizări și comenzi să fie explicită. Referință: nota de lansare Collaborate 2.5.1 consemnează că WearHF acceptă nativ Compose (publicată pe 2026-05-07). Aplicați această afirmație doar software-ului de dispozitiv care include suportul corespunzător și verificați comportamentul pe build-ul vizat.

Versiunea de firmware 2.2 publicată pentru Navigator 500/520 se bazează pe Android 13. Politica de firmware a RealWear menționează planul de a trece dispozitivele acceptate la un sistem de operare bazat pe Android 16 în cursul anului 2026, însă un plan nu reprezintă o garanție de lansare. Consultați notele de lansare GA actuale și testați build-ul exact al flotei înainte de a alege compileSdk, targetSdk, minSdk, permisiunile sau comportamentul la lansare.