Ontwikkelen voor de RealWear Navigator 520 zonder SDK: zo werkt WearHF

Ontwikkelen voor de RealWear Navigator 520 zonder SDK: zo werkt WearHF

Samenvatting

RealWear Navigator 520-ontwikkeling vereist voor basale spraakinteractie geen aparte spraak-SDK. WearHF maakt deel uit van de toestelsoftware. Het kan een Android-scherm analyseren, ondersteunde interactieve views herkennen en er spraakcommando’s voor beschikbaar maken. Een standaard Android-knop met het label CONTINUE kan dus geactiveerd worden door “CONTINUE” te zeggen, zonder een RealWear-bibliotheek te importeren.

Begin met een standaard Android-app en test die op de firmware van de Navigator waarop je mikt. WearHF kan ondersteunde bedieningselementen op het scherm herkennen zonder spraakcode in de app. Voeg een view-directive toe in android:contentDescription wanneer een bedieningselement alternatieve zinnen of speciaal gedrag nodig heeft. Gebruik OVERRIDE_COMMANDS alleen wanneer de app de spraakherkenning moet overnemen en de commando’s zelf moet afhandelen. Deze werkwijzen hebben verschillende effecten, die hieronder worden beschreven.

Belangrijk: “geen SDK” betekent niet “geen code”. Je bouwt nog altijd zelf de Android-interface en de bedrijfslogica. De app heeft voor basale spraakbesturing geen aparte RealWear-spraak-SDK nodig, omdat WearHF die functionaliteit op toestelniveau levert.

Kernidee: voor basale spraakbesturing hoef je WearHF niet te openen of te installeren, en hoef je geen WearHF-SDK te importeren. WearHF draait op de achtergrond als onderdeel van het RealWear-besturingssysteem.

Wat is de RealWear Navigator 520?

De RealWear Navigator 520 is een robuuste monoculaire assisted-realitycomputer, ontworpen voor frontlinewerk zoals onderhoud, inspectie en buitendienst. Firmware 2.x van RealWear voor de Navigator 500/520 is gebaseerd op Android 13, en de onderhoudsrelease Ari OS 2.0 van 17-09-2026 (firmware 3.0, build 3.0.3-15, aangeboden aan toestellen met build 2.2.3-33) zet het toestel over naar Android 16. Firmwareroadmaps kunnen wijzigen, dus behandel het besturingssysteem van het toestel als een randvoorwaarde voor de uitrol: noteer in je releasematrix de geteste firmwarebuild, het Android API-niveau, de minSdk/targetSdk van de app en het toestelmodel. Leid minSdk of targetSdk niet uitsluitend af uit de Android-versie van de headset.

Voor ontwikkelaars betekent dit dat je een gewone Android-app bouwt en verpakt. WearHF draait op het toestel en kan ondersteunde bedieningselementen via spraak beschikbaar maken; het implementeert je workflow niet, autoriseert geen bedrijfsactie en vervangt geen validatie in de app.

Wat is WearHF?

WearHF is de ingebouwde spraak- en handsfree-interactieservice van RealWear. Het interpreteert ondersteunde Android-views en schermdirectives en activeert vervolgens een view of verstuurt een spraakevent, afhankelijk van de gekozen integratie. Voor basale interactie met views is geen aparte RealWear-spraakbibliotheek nodig. Ingebedde directives worden uit android:contentDescription gehaald; programmatische commando’s gebruiken gedocumenteerde Android-broadcastintents. Haal een klik op een view en een override van de spraakherkenning niet door elkaar: een override neemt de spraakherkenning over en kan ingebedde/gescripte commando’s onderdrukken tot de normale werking hersteld wordt.

Wat je nodig hebt voordat je de eerste app bouwt

· Een Navigator 520 met de firmwarebuild die je wilt ondersteunen; noteer de exacte build en Android-versie.

· Een computer met Windows, macOS of Linux.

· Android Studio met de Android SDK en Platform Tools (ADB). Gebruik het Android API-niveau dat je app vereist en valideer tegen de door RealWear ondersteunde firmware.

· Een USB-C-datakabel.

· Geen RealWear-SDK voor de eerste app.

· Een bedrijfsworkflow om te testen, zoals naar de volgende inspectiestap gaan of een probleem met apparatuur melden.

Een spraakgestuurde Android-app bouwen zonder RealWear-SDK

Stap 1: maak een gewoon Android-project aan

Begin voor deze walkthrough met een Android Views-project. Kies in Android Studio een op Views gebaseerde Empty Activity (geen sjabloon dat alleen Compose gebruikt) en selecteer daarna Java of Kotlin. De voorbeelden hieronder gebruiken Java. Compose kan op ondersteunde software ook met WearHF werken, maar de semantiek en de toegankelijkheidsboom test je best op de doelbuild.

1. Open Android Studio en selecteer New Project.

2. Kies een op Views gebaseerde Empty Activity. Als de wizard velden voor taal en minimale SDK toont, selecteer dan Java en stel minSdk in op de laagste Android API die je app effectief ondersteunt; neem geen waarde uit dit voorbeeld over zonder je dependencies en je toestelvloot te controleren.

3. Vul de appgegevens in. Stel de appnaam, de packagenaam en de opslaglocatie in en maak dan het project aan.

4. Wacht tot het project geopend is. Android Studio voltooit de Gradle-synchronisatie en opent het project.

Voeg nog niets toe: je zoekt geen RealWear-projectsjabloon. De eerste build moet aantonen dat een standaard Android-app op de Navigator 520 kan draaien.

Stap 2: voeg één Android-knop toe en koppel die aan Java

Maak eerst één knop aan. Je voegt de Android-layout ervan toe, koppelt de klikactie in Java en test de knop daarna op het toestel.

1. Open in het Project-paneel van Android Studio app > res > layout > activity_main.xml. Het volledige bestandspad is app/src/main/res/layout/activity_main.xml.

2. Selecteer Code in de layout-editor. Vervang de inhoud van het bestand door de volledige XML hieronder.

XML: één knop met een WearHF-commando

Plak de volledige layout in activity_main.xml en sla het bestand op:

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

Korte uitleg: `LinearLayout` stapelt de inhoud verticaal. `android:text` is het zichtbare label van de knop. `android:contentDescription` bevat de WearHF-directive; Android-toegankelijkheidsservices lezen dit veld ook, dus test of het bedieningselement begrijpelijk blijft voor je gebruikers.

Open vervolgens app > java > je package > MainActivity.java in het Project-paneel. Het volledige pad is app/src/main/java/<your.package.name>/MainActivity.java. Behoud de gegenereerde Activity-klasse en de methode `onCreate()`.

Voeg, als die ontbreekt, `import android.widget.Button;` toe bij de imports bovenaan MainActivity.java. Plak deze regels in de bestaande methode `onCreate()`, direct na `setContentView(R.layout.activity_main);`:

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

Voeg deze methode toe onder `onCreate()`, maar vóór de laatste sluitende accolade van de klasse MainActivity:

private void openNextStep() { // Navigate to the next inspection or work-order step. }

Zo pas je het aan: wijzig `android:text` in het label dat bij je workflow past. Wijzig `hf_commands:CONTINUE` in de zin die werknemers moeten uitspreken, bijvoorbeeld `hf_commands:Continue Work, Next Step`. De XML-ID `continueButton` moet overeenkomen met `R.id.continueButton` in Java; als je die hernoemt, pas je beide aan. Vervang de commentaarregel in `openNextStep()` door de navigatie of bedrijfsactie die je app nodig heeft. Basale spraakbesturing vereist geen aparte WearHF-SDK en geen `RECORD_AUDIO`-machtiging.

Stap 3: bereid de Navigator 520 voor op Android-ontwikkeling

De ontwikkelcomputer heeft ADB-autorisatie nodig om de app te installeren en te debuggen. Gebruik een USB-C-kabel die data ondersteunt; kabels die alleen kunnen opladen, worden niet herkend als ADB-toestel.

1. Open Advanced Settings. Zeg op het startscherm van de Navigator MY SETTINGS om naar de lijst met Android-instellingen te gaan.

2. Open About Device. Zeg ABOUT DEVICE en daarna PAGE DOWN tot Build Number zichtbaar is.

3. Schakel Developer Options in. Zeg herhaaldelijk BUILD NUMBER, ongeveer zeven keer, tot het toestel bevestigt dat de ontwikkelaarsmodus ingeschakeld is.

4. Open Developer Options. Zeg NAVIGATE BACK, dan SYSTEM en vervolgens DEVELOPER OPTIONS.

5. Schakel USB debugging in. Zet USB debugging aan in Developer Options.

6. Sluit de USB-C-kabel aan en keur de RSA-debugmelding op het toestel goed. Controleer de verbinding met `adb devices`; het toestel moet verschijnen als `device`, niet als `unauthorized`.

Als Android Studio de headset niet toont, voer dan `adb devices` uit. Staat er `unauthorized`, ontgrendel dan de headset en keur de RSA-melding goed. Gebruik voor een herhaalde installatie vanuit de projectroot `adb install -r app/build/outputs/apk/debug/app-debug.apk`; pas het pad aan als je buildvariant of APK-naam verschilt. Gebruik Logcat in Android Studio of `adb logcat` om crashes en applicatielogs te bekijken.

USB debugging is een ontwikkelinstelling. Schakel het uit na het testen in het lab of beheer het volgens het beveiligingsbeleid voor toestellen van de organisatie; laat ontwikkelaarstoegang niet ingeschakeld op toestellen in de productievloot.

Stap 4: voer de app uit op de Navigator 520

1. Selecteer de Navigator in Android Studio. Gebruik de toestelkiezer in de bovenste werkbalk en kies het aangesloten RealWear-toestel.

2. Klik op Run. Selecteer het groene Run-driehoekje of gebruik Run > Run 'app'.

3. Wacht tot de installatie klaar is. Android Studio bouwt de APK en installeert die via ADB op de Navigator.

4. Start de geïnstalleerde app vanuit de app-launcher van het toestel, of voer `adb shell monkey -p your.application.id 1` uit vanuit een ontwikkelterminal. Vervang `your.application.id` door de applicationId in het Gradle-buildbestand van de app-module.

5. Controleer of de knop CONTINUE zichtbaar en ingeschakeld is.

Stap 5: test WearHF zonder een SDK toe te voegen

WearHF draait al op de Navigator 520. Test, met alleen de knop CONTINUE op het scherm, eerst dit bedieningselement:

1. Zeg CONTINUE en controleer of de normale click listener van de app precies één keer wordt uitgevoerd.

2. Zeg SHOW HELP om te bekijken welk commando WearHF voor dit scherm beschikbaar maakt. Controleer of CONTINUE getoond wordt.

3. Controleer de WearHF-indicatoren en test numerieke selectie als die aangeboden wordt. Vertrouw niet op een indicator als enige manier om een veiligheidskritieke actie te herkennen.

Optioneel: voeg na de CONTINUE-test een tweede actie toe

Zodra de eerste knop werkt, kun je REPORT ISSUE toevoegen. Plaats in activity_main.xml deze Button binnen de LinearLayout, onder CONTINUE en vóór </LinearLayout>:

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

Voeg in MainActivity.java deze listener toe binnen onCreate(), na de listener voor CONTINUE:

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

Voeg openIssueReport() toe onder onCreate(), binnen MainActivity. Vervang de commentaarregel door de workflow voor probleemmeldingen in je app:

private void openIssueReport() { // Open the equipment issue form. }

Bouw en installeer de app opnieuw en zeg dan REPORT ISSUE. Controleer of de workflow voor probleemmeldingen opent.

Conclusie

Ontwikkelen voor de RealWear Navigator 520 zonder speciale SDK bewijst dat nette, standaard Android-code al spraakklaar is, dankzij de ingebouwde WearHF-service die zichtbare views en contentDescription-directives omzet in intuïtieve handsfree bediening. Voor technische teams vermijdt dit overbodige bibliotheken van derden en complexe spraakengines, terwijl de kern van de bedrijfslogica binnen de standaard Android-architectuur blijft. Vanuit zakelijk oogpunt versnelt deze aanpak de time-to-market en beperkt ze de uitrolkosten: bedrijven kunnen rechtstreeks voortbouwen op bestaande Android-apps en de vaardigheden van hun eigen ontwikkelaars, ontlopen lock-in door propriëtaire SDK’s en moderniseren frontlineworkflows vlot zonder hun softwarestack overhoop te gooien.

Bouw voor een eerste bedrijfsprototype één inspectie- of onderhoudsscherm, controleer de labels van de views en de toegankelijke beschrijvingen, en test daarna de spraakactivering op exact de Navigator 520-firmware die de pilotvloot gebruikt. Voeg ingebedde directives toe voor specifieke UI-behoeften, en overrides van de spraakherkenning alleen wanneer de workflow volledige controle over de commando’s vereist.

Veelgestelde vragen

Dit artikel

Ja. De app is nog altijd een Android-applicatie, dus ontwikkelaars schrijven de interface en de bedrijfslogica in Java, Kotlin, XML Views of een andere ondersteunde Android UI-toolkit. Basale WearHF-interactie met views vereist geen aparte RealWear-spraak-SDK.

Niet voor basale view-commando’s. WearHF is ingebouwd in de RealWear-software en kan commando’s afleiden uit ondersteunde Android-views. Gebruik de gedocumenteerde directives of intents voor aangepast gedrag.

Je opent het niet als aparte app. WearHF draait op de achtergrond als onderdeel van de software van de Navigator 520.

Voor ondersteunde klikbare views kan WearHF een commando afleiden uit de tekst of de content description van de view, afhankelijk van de directive en de viewhiërarchie. Test het commando dat op het eigenlijke scherm beschikbaar is; een zichtbaar label is geen garantie voor elke aangepaste view.

Zeg SHOW HELP op de Navigator 520. RealWear toont dan de commando’s die bij dat scherm horen.

Open in een op Views gebaseerde app de layout-XML (bijvoorbeeld app/src/main/res/layout/activity_main.xml) en stel `android:contentDescription` in op de view. Gebruik `hf_commands:Phrase One, Phrase Two` voor meerdere zinnen en `-` tussen meerdere directives.

`hf_commands` is een WearHF-directive op viewniveau. Plaats ze in de contentDescription van de view, gevolgd door zinnen gescheiden door komma’s; elke herkende zin klikt op die view.

Voor ingebedde directives is geen aparte WearHF-bibliotheek nodig. Het zijn strings in de Android-contentDescription die de service op het toestel interpreteert. Omdat contentDescription ook door toegankelijkheidsservices gebruikt wordt, behoud je best een bruikbaar toegankelijk label en test je beide gedragingen.

Gebruik OVERRIDE_COMMANDS wanneer de commandolijst van de spraakherkenning tijdens runtime vervangen moet worden. Overweeg `hf_add_commands` voor commando’s op schermniveau die views aanvullen. Onthoud dat de overridemodus ingebedde/gescripte commando’s tijdelijk onderdrukt en op de gedocumenteerde momenten in de lifecycle hersteld of opnieuw geregistreerd moet worden.

Volgens de release notes van RealWear Collaborate van mei 2026 ondersteunt WearHF Jetpack Compose native. Dat is een aanwijzing voor Compose-ondersteuning in het platform, maar het vervangt niet het testen van semantiek, aangepaste composables, toegankelijkheidslabels en commando-overlays in je eigen app. Deze tutorial gebruikt XML Views, zodat de koppeling tussen views en commando’s expliciet is. Referentie: de release note van Collaborate 2.5.1 vermeldt dat WearHF Compose native ondersteunt (gepubliceerd op 2026-05-07). Pas die bewering alleen toe op toestelsoftware die de overeenkomstige ondersteuning bevat; controleer het gedrag op je doelbuild.

De gepubliceerde firmwarerelease 2.2 voor de Navigator 500/520 is gebaseerd op Android 13. Het firmwarebeleid van RealWear vermeldt een plan om ondersteunde toestellen in de loop van 2026 over te zetten naar een besturingssysteem op basis van Android 16; een plan is geen garantie op een release. Raadpleeg de actuele GA-release notes en test de exacte build van je vloot voordat je compileSdk, targetSdk, minSdk, machtigingen of releasegedrag kiest.