Utvikling for RealWear Navigator 520 uten SDK: Slik fungerer WearHF

Sammendrag

RealWear Navigator 520-utvikling krever ikke en egen tale-SDK for grunnleggende stemmeinteraksjon. WearHF er en del av enhetens programvare. Den kan analysere en Android-skjerm, identifisere støttede interaktive visninger og gjøre dem tilgjengelige som talekommandoer. En vanlig Android-knapp merket CONTINUE kan derfor aktiveres ved å si «CONTINUE», uten at du må importere et RealWear-bibliotek.

Start med en vanlig Android-app, og test den på Navigator-fastvaren du sikter mot. WearHF kan gjenkjenne støttede skjermkontroller uten talekode i appen. Legg til et visningsdirektiv i android:contentDescription når en kontroll trenger alternative fraser eller spesiell oppførsel. Bruk OVERRIDE_COMMANDS bare når appen må ta kontroll over talegjenkjenneren og håndtere kommandoene selv. Disse tilnærmingene har ulike virkninger, som beskrevet nedenfor.

Viktig: «Ingen SDK» betyr ikke «ingen kode». Du må fortsatt bygge Android-grensesnittet og forretningslogikken. Appen trenger ikke en egen tale-SDK fra RealWear for grunnleggende stemmestyring, fordi WearHF leverer denne funksjonaliteten på enhetsnivå.

Kjernekonsept: Du verken åpner, installerer eller importerer en WearHF-SDK for grunnleggende stemmestyring. WearHF kjører i bakgrunnen som en del av RealWear-operativsystemet.

Hva er RealWear Navigator 520?

RealWear Navigator 520 er en robust, monokulær datamaskin for assistert virkelighet (assisted reality), utviklet for frontlinjearbeid som vedlikehold, inspeksjon og feltservice. RealWears fastvare 2.x for Navigator 500/520 er basert på Android 13, og vedlikeholdsutgivelsen Ari OS 2.0 av 17-09-2026 (fastvare 3.0, build 3.0.3-15, tilbudt enheter på build 2.2.3-33) flytter enheten over til Android 16. Fastvareplaner kan endres, så behandle enhetens operativsystem som en begrensning for utrulling: Registrer testet fastvarebuild, Android API-nivå, appens minSdk/targetSdk og enhetsmodell i utgivelsesmatrisen. Ikke utled minSdk eller targetSdk bare ut fra headsetets Android-versjon.

For utviklere betyr dette at du bygger og pakker en vanlig Android-app. WearHF kjører på enheten og kan gjøre støttede kontroller tilgjengelige for stemmestyring; den implementerer ikke arbeidsflyten din, autoriserer ikke forretningshandlinger og erstatter ikke validering i appen.

Hva er WearHF?

WearHF er RealWears innebygde tjeneste for tale og håndfri interaksjon. Den tolker støttede Android-visninger og skjermdirektiver, og aktiverer deretter en visning eller sender en talehendelse avhengig av valgt integrasjon. Grunnleggende interaksjon med visninger krever ikke noe eget talebibliotek fra RealWear. Innebygde direktiver leses fra android:contentDescription; programmatiske kommandoer bruker dokumenterte Android-broadcast-intents. Ikke bland sammen et klikk på en visning og en overstyring av gjenkjenneren: En overstyring tar kontroll over talegjenkjenneren og kan undertrykke innebygde/skriptede kommandoer til den gjenopprettes.

Dette trenger du før du bygger den første appen

· En Navigator 520 med fastvarebuilden du har tenkt å støtte; noter nøyaktig build og Android-versjon.

· En datamaskin med Windows, macOS eller Linux.

· Android Studio med Android SDK og Platform Tools (ADB). Bruk Android API-nivået appen din krever, og valider mot fastvare som RealWear støtter.

· En USB-C-kabel for dataoverføring.

· Ingen RealWear-SDK for den første appen.

· En forretningsarbeidsflyt å teste, for eksempel å gå videre til neste inspeksjonstrinn eller rapportere et problem med utstyr.

Slik bygger du en stemmestyrt Android-app uten RealWear-SDK

Trinn 1: Opprett et vanlig Android-prosjekt

Start med et Android Views-prosjekt for denne gjennomgangen. I Android Studio velger du en Views-basert Empty Activity (ikke en mal som bare bruker Compose), og deretter Java eller Kotlin. Eksemplene nedenfor bruker Java. Compose kan også fungere med WearHF på støttet programvare, men semantikken og tilgjengelighetstreet bør testes på målbuilden.

1. Åpne Android Studio og velg New Project.

2. Velg en Views-basert Empty Activity. Hvis veiviseren har felt for språk og minimum SDK, velger du Java og setter minSdk til det laveste Android API-nivået appen din faktisk støtter; ikke kopier en verdi fra dette eksemplet uten å sjekke avhengighetene og enhetsparken din.

3. Fyll inn appdetaljene. Angi appnavn, pakkenavn og lagringsplassering, og opprett deretter prosjektet.

4. Vent til prosjektet åpnes. Android Studio fullfører Gradle-synkroniseringen og åpner prosjektet.

Ikke legg til noe ennå: Du er ikke ute etter en RealWear-prosjektmal. Poenget med den første builden er å vise at en vanlig Android-app kan kjøre på Navigator 520.

Trinn 2: Legg til én Android-knapp og koble den til Java

Lag én knapp først. Du legger til Android-layouten for den, kobler klikkhandlingen i Java og tester den deretter på enheten.

1. I Project-panelet i Android Studio åpner du app > res > layout > activity_main.xml. Full filbane er app/src/main/res/layout/activity_main.xml.

2. Velg Code i layoutredigeringsprogrammet. Erstatt filinnholdet med hele XML-koden som vises nedenfor.

XML: Én knapp med en WearHF-kommando

Lim inn hele layouten i activity_main.xml, og lagre filen:

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

Kort forklaring: `LinearLayout` stabler innholdet vertikalt. `android:text` er den synlige knappeteksten. `android:contentDescription` inneholder WearHF-direktivet; Androids tilgjengelighetstjenester leser også dette feltet, så test at kontrollen fortsatt er forståelig for brukerne dine.

Deretter åpner du app > java > pakken din > MainActivity.java i Project-panelet. Full bane er app/src/main/java/<your.package.name>/MainActivity.java. Behold den genererte Activity-klassen og `onCreate()`-metoden.

Hvis den mangler, legger du til `import android.widget.Button;` blant importene øverst i MainActivity.java. Inne i den eksisterende `onCreate()`-metoden limer du inn disse linjene rett etter `setContentView(R.layout.activity_main);`:

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

Legg til denne metoden under `onCreate()`, men før den siste avsluttende krøllparentesen i MainActivity-klassen:

private void openNextStep() { // Naviger til neste inspeksjons- eller arbeidsordretrinn. }

Slik tilpasser du det: Endre `android:text` til en etikett som passer arbeidsflyten din. Endre `hf_commands:CONTINUE` til frasen arbeiderne skal si, for eksempel `hf_commands:Continue Work, Next Step`. XML-ID-en `continueButton` må samsvare med `R.id.continueButton` i Java; hvis du gir den nytt navn, må du oppdatere begge. Erstatt kommentaren i `openNextStep()` med navigasjonen eller forretningshandlingen appen din trenger. Grunnleggende stemmestyring krever verken en egen WearHF-SDK eller tillatelsen `RECORD_AUDIO`.

Trinn 3: Klargjør Navigator 520 for Android-utvikling

Utviklingsdatamaskinen trenger ADB-autorisasjon for å installere og feilsøke appen. Bruk en USB-C-kabel som støtter dataoverføring; kabler som bare lader, blir ikke gjenkjent som en ADB-enhet.

1. Åpne Advanced Settings. Fra Navigator-startskjermen sier du MY SETTINGS for å komme til listen over Android-innstillinger.

2. Åpne About Device. Si ABOUT DEVICE, og deretter PAGE DOWN til Build Number vises.

3. Aktiver Developer Options. Si BUILD NUMBER gjentatte ganger, omtrent sju ganger, til enheten bekrefter at utviklermodus er aktivert.

4. Åpne Developer Options. Si NAVIGATE BACK, deretter SYSTEM og så DEVELOPER OPTIONS.

5. Aktiver USB-feilsøking. Slå på USB-feilsøking (USB debugging) i Developer Options.

6. Koble til USB-C-kabelen og godkjenn RSA-feilsøkingsforespørselen på enheten. Bekreft tilkoblingen med `adb devices`; enheten skal vises som `device`, ikke `unauthorized`.

Hvis Android Studio ikke viser headsetet, kjører du `adb devices`. Hvis det står `unauthorized`, låser du opp headsetet og godkjenner RSA-forespørselen. For en ny installasjon fra prosjektets rotmappe bruker du `adb install -r app/build/outputs/apk/debug/app-debug.apk`; endre banen hvis byggevarianten eller APK-navnet ditt er annerledes. Bruk Logcat i Android Studio eller `adb logcat` for å undersøke krasj og applikasjonslogger.

USB-feilsøking er en utviklingsinnstilling. Deaktiver den etter labtesting, eller administrer den i henhold til organisasjonens retningslinjer for enhetssikkerhet; ikke la utviklertilgang være aktivert på enheter i produksjonsparken.

Trinn 4: Kjør appen på Navigator 520

1. Velg Navigator i Android Studio. Bruk enhetsvelgeren i verktøylinjen øverst, og velg den tilkoblede RealWear-enheten.

2. Klikk på Run. Velg den grønne Run-trekanten, eller bruk Run > Run 'app'.

3. Vent på installasjonen. Android Studio bygger APK-filen og installerer den på Navigator via ADB.

4. Start den installerte appen fra enhetens appstarter, eller kjør `adb shell monkey -p your.application.id 1` fra en utviklingsterminal. Erstatt `your.application.id` med applicationId fra Gradle-byggefilen i app-modulen.

5. Bekreft at CONTINUE-knappen er synlig og aktivert.

Trinn 5: Test WearHF uten å legge til noen SDK

WearHF kjører allerede på Navigator 520. Med bare CONTINUE-knappen på skjermen tester du denne kontrollen først:

1. Si CONTINUE, og kontroller at appens vanlige klikklytter kjøres nøyaktig én gang.

2. Si SHOW HELP for å se hvilken kommando WearHF gjør tilgjengelig for denne skjermen. Bekreft at den viser CONTINUE.

3. Sjekk WearHF-indikatorene, og test numerisk valg hvis det tilbys. Ikke stol på en indikator som eneste måte å identifisere en sikkerhetskritisk handling på.

Valgfritt: Legg til en ny handling etter CONTINUE-testen

Når den første knappen fungerer, kan du legge til REPORT ISSUE. I activity_main.xml plasserer du denne Button-en inne i LinearLayout, under CONTINUE og før </LinearLayout>:

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

I MainActivity.java legger du til denne lytteren inne i onCreate(), etter CONTINUE-lytteren:

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

Legg til openIssueReport() under onCreate(), inne i MainActivity. Erstatt kommentaren med arbeidsflyten for problemrapportering i appen din:

private void openIssueReport() { // Åpne skjemaet for rapportering av utstyrsproblemer. }

Bygg og installer appen på nytt, og si deretter REPORT ISSUE. Bekreft at arbeidsflyten for problemrapportering åpnes.

Konklusjon

Utvikling for RealWear Navigator 520 uten en dedikert SDK viser at ren, standard Android-kode allerede er stemmeklar, ettersom den innebygde WearHF-tjenesten gjør synlige visninger og contentDescription-direktiver om til intuitive håndfrie kontroller. For tekniske team betyr dette at man slipper oppblåsing med tredjepartsbiblioteker og komplekse talemotorer, samtidig som kjernelogikken forblir innenfor standard Android-arkitektur. Fra et forretningsperspektiv gir denne tilnærmingen raskere tid til markedet og lavere utrullingskostnader: Virksomheter kan bruke eksisterende Android-apper og egen utviklerkompetanse direkte, unngå innlåsing i proprietære SDK-er og modernisere frontlinjearbeidsflyter smidig uten å forstyrre programvarestakken.

For en første bedriftsprototype bygger du én inspeksjons- eller vedlikeholdsskjerm, kontrollerer visningsetiketter og tilgjengelige beskrivelser, og tester deretter stemmeaktivering på nøyaktig den Navigator 520-fastvaren som brukes i pilotparken. Legg til innebygde direktiver for spesifikke behov i brukergrensesnittet, og overstyringer av gjenkjenneren bare når arbeidsflyten krever full kontroll over kommandoene.