Resumé
RealWear Navigator 520-udvikling kræver ikke et separat tale-SDK til grundlæggende stemmeinteraktion. WearHF er en del af enhedens software. Den kan analysere en Android-skærm, identificere understøttede interaktive views og gøre stemmekommandoer tilgængelige for dem. En almindelig Android-knap med teksten CONTINUE kan derfor aktiveres ved at sige »CONTINUE« uden at importere et RealWear-bibliotek.
Start med en almindelig Android-app, og test den på den Navigator-firmware, du sigter mod. WearHF kan genkende understøttede skærmkontroller uden talekode i appen. Tilføj et view-direktiv i android:contentDescription, når en kontrol skal have alternative fraser eller særlig adfærd. Brug kun OVERRIDE_COMMANDS, når appen skal overtage kontrollen med talegenkendelsen og selv håndtere kommandoerne. Disse fremgangsmåder har forskellige virkninger, som beskrives nedenfor.
Vigtigt: »Intet SDK« betyder ikke »ingen kode«. Du skal stadig bygge Android-brugerfladen og forretningslogikken. Appen har ikke brug for et separat RealWear-tale-SDK til grundlæggende stemmestyring, fordi WearHF leverer den funktion på enhedsniveau.
Kernebegreb: Du åbner ikke WearHF, installerer ikke WearHF og importerer ikke et WearHF-SDK for at få grundlæggende stemmestyring. WearHF kører i baggrunden som en del af RealWears styresystem.
Hvad er RealWear Navigator 520?
Enheden RealWear Navigator 520 er en robust monokulær computer til assisteret virkelighed (assisted reality), designet til frontlinjearbejde som vedligeholdelse, inspektion og feltservice. RealWears firmware 2.x til Navigator 500/520 er baseret på Android 13, og vedligeholdelsesudgivelsen Ari OS 2.0 fra 17-09-2026 (firmware 3.0, build 3.0.3-15, der tilbydes enheder på build 2.2.3-33) flytter enheden til Android 16. Firmware-køreplaner kan ændre sig, så betragt enhedens styresystem som en betingelse for udrulningen: Registrér det testede firmwarebuild, Android API-niveauet, appens minSdk/targetSdk og enhedsmodellen i din release-matrix. Udled ikke minSdk eller targetSdk alene ud fra headsettets Android-version.
For udviklere betyder det, at du bygger og pakker en almindelig Android-app. WearHF kører på enheden og kan gøre understøttede kontroller tilgængelige for stemmestyring; den implementerer ikke dit workflow, godkender ikke en forretningshandling og erstatter ikke validering i appen.
Hvad er WearHF?
WearHF er RealWears indbyggede tjeneste til tale og håndfri interaktion. Den fortolker understøttede Android-views og skærmdirektiver og aktiverer derefter et view eller sender en tale-event afhængigt af den valgte integration. Grundlæggende interaktion med views kræver ikke et separat RealWear-talebibliotek. Indlejrede direktiver læses fra android:contentDescription; programmatiske kommandoer bruger dokumenterede Android-broadcast-intents. Forveksl ikke et klik på et view med en override af talegenkendelsen: En override overtager kontrollen med talegenkendelsen og kan undertrykke indlejrede/scriptede kommandoer, indtil den gendannes.
Det skal du bruge, før du bygger den første app
· En Navigator 520 med det firmwarebuild, du vil understøtte; notér det nøjagtige build og Android-versionen.
· En Windows-, macOS- eller Linux-computer.
· Android Studio med Android SDK og Platform Tools (ADB). Brug det Android API-niveau, din app kræver, og valider op imod RealWears understøttede firmware.
· Et USB-C-datakabel.
· Intet RealWear-SDK til den første app.
· Et forretningsworkflow at teste, f.eks. at gå videre til næste inspektionstrin eller rapportere et problem med udstyr.
Sådan bygger du en stemmestyret Android-app uden et RealWear-SDK
Trin 1: Opret et almindeligt Android-projekt
Start med et Android Views-projekt i denne gennemgang. Vælg en Views-baseret Empty Activity i Android Studio (ikke en skabelon kun til Compose), og vælg derefter Java eller Kotlin. Eksemplerne nedenfor bruger Java. Compose kan også fungere med WearHF på understøttet software, men dets semantik og tilgængelighedstræ bør testes på det build, du sigter mod.
1. Åbn Android Studio, og vælg New Project.
2. Vælg en Views-baseret Empty Activity. Hvis guiden viser felter til sprog og minimum-SDK, så vælg Java, og sæt minSdk til det laveste Android API, din app faktisk understøtter; kopiér ikke en værdi fra dette eksempel uden at tjekke dine afhængigheder og din enhedsflåde.
3. Indtast appens oplysninger. Angiv appnavn, pakkenavn og placering, og opret derefter projektet.
4. Vent på, at projektet åbner. Android Studio gennemfører Gradle-synkroniseringen og åbner projektet.
Tilføj ikke noget endnu: Du leder ikke efter en RealWear-projektskabelon. Formålet med det første build er at bevise, at en almindelig Android-app kan køre på Navigator 520.
Trin 2: Tilføj én Android-knap, og forbind den med Java
Opret først én knap. Du tilføjer dens Android-layout, forbinder dens klikhandling i Java og tester den derefter på enheden.
1. Åbn app > res > layout > activity_main.xml i Android Studios Project-panel. Den fulde filsti er app/src/main/res/layout/activity_main.xml.
2. Vælg Code i layouteditoren. Erstat filens indhold med den komplette XML, der vises herunder.
XML: Én knap med en WearHF-kommando
Indsæt det komplette layout i activity_main.xml, og gem derefter 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 sit indhold lodret. `android:text` er knappens synlige tekst. `android:contentDescription` indeholder WearHF-direktivet; Androids tilgængelighedstjenester læser også dette felt, så test, at kontrollen stadig er forståelig for dine brugere.
Åbn derefter app > java > din pakke > MainActivity.java i Project-panelet. Den fulde sti er app/src/main/java/<your.package.name>/MainActivity.java. Behold den genererede Activity-klasse og metoden `onCreate()`.
Hvis den mangler, så tilføj `import android.widget.Button;` sammen med importerne øverst i MainActivity.java. Indsæt disse linjer i den eksisterende `onCreate()`-metode lige efter `setContentView(R.layout.activity_main);`:
Button continueButton = findViewById(R.id.continueButton); continueButton.setOnClickListener(v -> openNextStep());
Tilføj denne metode under `onCreate()`, men før den sidste afsluttende krøllede parentes i MainActivity-klassen:
private void openNextStep() { // Navigate to the next inspection or work-order step. }
Sådan tilpasser du det: Ret `android:text` til den tekst, der passer til dit workflow. Ret `hf_commands:CONTINUE` til den frase, medarbejderne skal sige, for eksempel `hf_commands:Continue Work, Next Step`. XML-ID'et `continueButton` skal svare til `R.id.continueButton` i Java; hvis du omdøber det, skal du opdatere begge. Erstat kommentaren i `openNextStep()` med den navigation eller forretningshandling, din app har brug for. Grundlæggende stemmestyring kræver hverken et separat WearHF-SDK eller tilladelsen `RECORD_AUDIO`.
Trin 3: Gør Navigator 520 klar til Android-udvikling
Udviklingscomputeren skal have ADB-autorisation for at kunne installere og debugge appen. Brug et USB-C-kabel, der kan overføre data; kabler, der kun kan oplade, bliver ikke registreret som en ADB-enhed.
1. Åbn Advanced Settings. Sig MY SETTINGS fra Navigators Home-skærm for at komme til listen over Android-indstillinger.
2. Åbn About Device. Sig ABOUT DEVICE og derefter PAGE DOWN, indtil Build Number er synligt.
3. Aktivér Developer Options. Sig BUILD NUMBER gentagne gange, cirka syv gange, indtil enheden bekræfter, at udviklertilstand er aktiveret.
4. Åbn Developer Options. Sig NAVIGATE BACK, derefter SYSTEM og så DEVELOPER OPTIONS.
5. Aktivér USB debugging. Slå USB debugging til under Developer Options.
6. Tilslut USB-C-kablet, og godkend RSA-fejlretningsprompten på enheden. Bekræft forbindelsen med `adb devices`; enheden skal vises som `device`, ikke `unauthorized`.
Hvis Android Studio ikke viser headsettet, så kør `adb devices`. Hvis det viser `unauthorized`, så lås headsettet op, og godkend RSA-prompten. Brug `adb install -r app/build/outputs/apk/debug/app-debug.apk` fra projektets rodmappe til en gentagen installation; erstat stien, hvis din build-variant eller dit APK-navn er anderledes. Brug Logcat i Android Studio eller `adb logcat` til at undersøge nedbrud og applikationslogs.
USB-fejlretning er en udviklingsindstilling. Deaktiver den efter test i laboratoriet, eller administrer den i henhold til organisationens sikkerhedspolitik for enheder; lad ikke udviklingsadgang være aktiveret på enheder i produktionsflåden.
Trin 4: Kør appen på Navigator 520
1. Vælg Navigator i Android Studio. Brug enhedsvælgeren i den øverste værktøjslinje, og vælg den tilsluttede RealWear-enhed.
2. Klik på Run. Vælg den grønne Run-trekant, eller brug Run > Run 'app'.
3. Vent på installationen. Android Studio bygger APK'en og installerer den på Navigator via ADB.
4. Start den installerede app fra enhedens app-starter, eller kør `adb shell monkey -p your.application.id 1` fra en udviklingsterminal. Erstat `your.application.id` med applicationId fra app-modulets Gradle-buildfil.
5. Bekræft, at CONTINUE-knappen er synlig og aktiveret.
Trin 5: Test WearHF uden at tilføje noget SDK
WearHF kører allerede på Navigator 520. Test først denne kontrol, mens kun CONTINUE-knappen er på skærmen:
1. Sig CONTINUE, og kontrollér, at appens normale klik-listener kører præcis én gang.
2. Sig SHOW HELP for at se den kommando, WearHF gør tilgængelig for denne skærm. Bekræft, at den viser CONTINUE.
3. Tjek WearHF-indikatorerne, og test numerisk valg, hvis det tilbydes. Stol ikke på en indikator som den eneste måde at identificere en sikkerhedskritisk handling på.
Valgfrit: Tilføj en ekstra handling efter CONTINUE-testen
Når den første knap virker, kan du tilføje REPORT ISSUE. I activity_main.xml skal du placere denne Button inde 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 skal du tilføje denne listener i onCreate() efter CONTINUE-listeneren:
Button reportIssueButton = findViewById(R.id.reportIssueButton); reportIssueButton.setOnClickListener(v -> openIssueReport());
Tilføj openIssueReport() under onCreate() inde i MainActivity. Erstat kommentaren med workflowet til problemrapportering i din app:
private void openIssueReport() { // Open the equipment issue form. }
Byg og geninstaller appen, og sig derefter REPORT ISSUE. Bekræft, at workflowet til problemrapportering åbner.
Konklusion
Udvikling til RealWear Navigator 520 uden et dedikeret SDK viser, at ren, standardiseret Android-kode allerede kan stemmestyres, fordi den indbyggede WearHF-tjeneste omdanner synlige views og contentDescription-direktiver til intuitive håndfri kontroller. For tekniske teams undgår man dermed oppustede tredjepartsbiblioteker og komplekse talemotorer, mens den centrale forretningslogik forbliver i en almindelig Android-arkitektur. Forretningsmæssigt fremskynder denne tilgang time-to-market og minimerer udrulningsomkostningerne: Virksomheder kan direkte udnytte eksisterende Android-apps og interne udviklerkompetencer, undgå fastlåsning til proprietære SDK'er og gnidningsfrit modernisere frontlinjens workflows uden at forstyrre deres softwarestak.
Til en første virksomhedsprototype kan du bygge én inspektions- eller vedligeholdelsesskærm, kontrollere view-tekster og tilgængelige beskrivelser og derefter teste stemmeaktivering på præcis den Navigator 520-firmware, som pilotflåden bruger. Tilføj indlejrede direktiver til specifikke UI-behov, og brug kun overrides af talegenkendelsen, når workflowet kræver fuldt ejerskab over kommandoerne.
