Zusammenfassung
RealWear Navigator 520: Wer für dieses Gerät entwickelt, benötigt für grundlegende Sprachinteraktion kein separates Sprach-SDK. WearHF ist Teil der Gerätesoftware. Es kann einen Android-Bildschirm analysieren, unterstützte interaktive Views erkennen und dafür Sprachbefehle bereitstellen. Eine normale Android-Schaltfläche mit der Beschriftung CONTINUE lässt sich daher durch das Sprechen von „CONTINUE“ auslösen, ohne dass eine RealWear-Bibliothek importiert werden muss.
Beginnen Sie mit einer normalen Android-App und testen Sie sie auf der Ziel-Firmware des Navigator. WearHF kann unterstützte Bildschirmelemente ohne app-seitigen Sprachcode erkennen. Fügen Sie in android:contentDescription eine View-Direktive hinzu, wenn ein Steuerelement alternative Phrasen oder ein besonderes Verhalten benötigt. Verwenden Sie OVERRIDE_COMMANDS nur dann, wenn die App die Kontrolle über die Spracherkennung übernehmen und Befehle selbst verarbeiten muss. Diese Wege wirken unterschiedlich, wie im Folgenden beschrieben.
Wichtig: „Kein SDK“ bedeutet nicht „kein Code“. Sie erstellen weiterhin die Android-Oberfläche und die Geschäftslogik. Die App benötigt für grundlegende Sprachsteuerung kein separates RealWear-Sprach-SDK, weil WearHF diese Funktion auf Geräteebene bereitstellt.
Grundprinzip: Für grundlegende Sprachsteuerung müssen Sie WearHF weder öffnen noch installieren, und Sie importieren auch kein WearHF-SDK. WearHF läuft als Teil des RealWear-Betriebssystems im Hintergrund.
Was ist der RealWear Navigator 520?
Der RealWear Navigator 520 ist ein robuster monokularer Assisted-Reality-Computer für Arbeiten an vorderster Front wie Wartung, Inspektion und Außendienst. Die Firmware 2.x von RealWear für den Navigator 500/520 basiert auf Android 13, und das Ari OS 2.0 Maintenance Release vom 17.09.2026 (Firmware 3.0, Build 3.0.3-15, angeboten für Geräte mit Build 2.2.3-33) hebt das Gerät auf Android 16. Firmware-Roadmaps können sich ändern; betrachten Sie das Betriebssystem des Geräts daher als Rahmenbedingung für das Deployment: Halten Sie den getesteten Firmware-Build, das Android-API-Level, minSdk/targetSdk der App und das Gerätemodell in Ihrer Release-Matrix fest. Leiten Sie minSdk oder targetSdk nicht allein aus der Android-Version des Headsets ab.
Für Entwickler bedeutet das: Sie erstellen und paketieren eine ganz normale Android-App. WearHF läuft auf dem Gerät und kann unterstützte Steuerelemente per Sprache zugänglich machen; es setzt jedoch weder Ihren Workflow um noch autorisiert es eine geschäftliche Aktion oder ersetzt die app-seitige Validierung.
Was ist WearHF?
WearHF ist der integrierte Dienst von RealWear für Sprach- und Freihandinteraktion. Er interpretiert unterstützte Android-Views und Bildschirmdirektiven und aktiviert dann je nach gewählter Integration eine View oder sendet ein Sprachereignis. Für die grundlegende Interaktion mit Views ist keine separate RealWear-Sprachbibliothek nötig. Eingebettete Direktiven werden aus android:contentDescription ausgelesen; programmatische Befehle nutzen dokumentierte Android-Broadcast-Intents. Verwechseln Sie einen View-Klick nicht mit einem Override der Spracherkennung: Ein Override übernimmt die Kontrolle über die Spracherkennung und kann eingebettete bzw. per Skript definierte Befehle unterdrücken, bis der ursprüngliche Zustand wiederhergestellt ist.
Was Sie vor der Entwicklung der ersten App benötigen
· Einen Navigator 520 mit dem Firmware-Build, den Sie unterstützen möchten; notieren Sie den genauen Build und die Android-Version.
· Einen Computer mit Windows, macOS oder Linux.
· Android Studio mit dem Android SDK und den Platform Tools (ADB). Verwenden Sie das von Ihrer App benötigte Android-API-Level und validieren Sie es gegen die von RealWear unterstützte Firmware.
· Ein USB-C-Datenkabel.
· Kein RealWear-SDK für die erste App.
· Einen geschäftlichen Workflow zum Testen, etwa das Weiterschalten zu einem Inspektionsschritt oder das Melden eines Geräteproblems.
So erstellen Sie eine sprachgesteuerte Android-App ohne RealWear-SDK
Schritt 1: Ein normales Android-Projekt anlegen
Beginnen Sie für diese Anleitung mit einem Android-Views-Projekt. Wählen Sie in Android Studio eine Views-basierte Empty Activity (keine reine Compose-Vorlage) und anschließend Java oder Kotlin. Die folgenden Beispiele verwenden Java. Compose kann mit unterstützter Software ebenfalls mit WearHF funktionieren, die Semantik und der Accessibility-Baum sollten jedoch auf dem Ziel-Build getestet werden.
1. Öffnen Sie Android Studio und wählen Sie New Project.
2. Wählen Sie eine Views-basierte Empty Activity. Falls der Assistent Felder für Sprache und Mindest-SDK anbietet, wählen Sie Java und setzen Sie minSdk auf die niedrigste Android-API, die Ihre App tatsächlich unterstützt; übernehmen Sie keinen Wert aus diesem Beispiel, ohne Ihre Abhängigkeiten und Ihre Geräteflotte geprüft zu haben.
3. Geben Sie die App-Details ein. Legen Sie App-Namen, Paketnamen und Speicherort fest und erstellen Sie dann das Projekt.
4. Warten Sie, bis sich das Projekt öffnet. Android Studio schließt die Gradle-Synchronisierung ab und öffnet das Projekt.
Noch nichts hinzufügen: Sie suchen keine RealWear-Projektvorlage. Der erste Build soll lediglich nachweisen, dass eine normale Android-App auf dem Navigator 520 läuft.
Schritt 2: Eine Android-Schaltfläche hinzufügen und mit Java verbinden
Erstellen Sie zunächst eine einzige Schaltfläche. Sie fügen ihr Android-Layout hinzu, verbinden ihre Klickaktion in Java und testen sie anschließend auf dem Gerät.
1. Öffnen Sie im Project-Bereich von Android Studio app > res > layout > activity_main.xml. Der vollständige Dateipfad lautet app/src/main/res/layout/activity_main.xml.
2. Wählen Sie im Layout-Editor Code. Ersetzen Sie den Dateiinhalt durch das vollständige XML unten.
XML: Eine Schaltfläche mit einem WearHF-Befehl
Fügen Sie das vollständige Layout in activity_main.xml ein und speichern Sie die Datei:
<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>
Kurz erklärt: `LinearLayout` ordnet seinen Inhalt vertikal untereinander an. `android:text` ist die sichtbare Beschriftung der Schaltfläche. `android:contentDescription` enthält die WearHF-Direktive; da Android-Bedienungshilfen dieses Feld ebenfalls auslesen, sollten Sie testen, ob das Steuerelement für Ihre Nutzer verständlich bleibt.
Öffnen Sie anschließend im Project-Bereich app > java > Ihr Paket > MainActivity.java. Der vollständige Pfad lautet app/src/main/java/<your.package.name>/MainActivity.java. Behalten Sie die generierte Activity-Klasse und die Methode `onCreate()` bei.
Fügen Sie, falls noch nicht vorhanden, `import android.widget.Button;` zu den Imports am Anfang von MainActivity.java hinzu. Fügen Sie innerhalb der bestehenden Methode `onCreate()` die folgenden Zeilen direkt nach `setContentView(R.layout.activity_main);` ein:
Button continueButton = findViewById(R.id.continueButton); continueButton.setOnClickListener(v -> openNextStep());
Fügen Sie diese Methode unterhalb von `onCreate()`, aber vor der letzten schließenden geschweiften Klammer der Klasse MainActivity ein:
private void openNextStep() { // Zum nächsten Inspektions- oder Arbeitsauftragsschritt navigieren. }
So passen Sie es an: Ändern Sie `android:text` in die Beschriftung, die zu Ihrem Workflow passt. Ändern Sie `hf_commands:CONTINUE` in die Phrase, die Mitarbeitende sprechen sollen, zum Beispiel `hf_commands:Continue Work, Next Step`. Die XML-ID `continueButton` muss mit `R.id.continueButton` in Java übereinstimmen; wenn Sie sie umbenennen, aktualisieren Sie beide Stellen. Ersetzen Sie den Kommentar in `openNextStep()` durch die Navigation oder geschäftliche Aktion, die Ihre App benötigt. Grundlegende Sprachsteuerung erfordert weder ein separates WearHF-SDK noch die Berechtigung `RECORD_AUDIO`.
Schritt 3: Den Navigator 520 für die Android-Entwicklung vorbereiten
Der Entwicklungsrechner benötigt eine ADB-Autorisierung, um die App zu installieren und zu debuggen. Verwenden Sie ein datenfähiges USB-C-Kabel; reine Ladekabel werden nicht als ADB-Gerät erkannt.
1. Öffnen Sie die erweiterten Einstellungen. Sagen Sie auf dem Home-Bildschirm des Navigator MY SETTINGS, um zur Android-Einstellungsliste zu gelangen.
2. Öffnen Sie „Über das Gerät“. Sagen Sie ABOUT DEVICE und dann PAGE DOWN, bis die Build-Nummer sichtbar ist.
3. Aktivieren Sie die Entwickleroptionen. Sagen Sie wiederholt BUILD NUMBER, etwa siebenmal, bis das Gerät bestätigt, dass der Entwicklermodus aktiviert ist.
4. Öffnen Sie die Entwickleroptionen. Sagen Sie NAVIGATE BACK, dann SYSTEM und dann DEVELOPER OPTIONS.
5. Aktivieren Sie USB-Debugging. Schalten Sie in den Entwickleroptionen USB-Debugging ein.
6. Schließen Sie das USB-C-Kabel an und bestätigen Sie die RSA-Debugging-Abfrage auf dem Gerät. Prüfen Sie die Verbindung mit `adb devices`; das Gerät sollte als `device` erscheinen, nicht als `unauthorized`.
Wenn Android Studio das Headset nicht auflistet, führen Sie `adb devices` aus. Wird `unauthorized` angezeigt, entsperren Sie das Headset und bestätigen Sie die RSA-Abfrage. Für eine erneute Installation aus dem Projektstammverzeichnis verwenden Sie `adb install -r app/build/outputs/apk/debug/app-debug.apk`; passen Sie den Pfad an, wenn Ihre Build-Variante oder Ihr APK-Name abweicht. Nutzen Sie Logcat in Android Studio oder `adb logcat`, um Abstürze und Anwendungsprotokolle zu untersuchen.
USB-Debugging ist eine Entwicklungseinstellung. Deaktivieren Sie es nach den Labortests oder verwalten Sie es gemäß der Gerätesicherheitsrichtlinie Ihres Unternehmens; lassen Sie den Entwicklungszugang auf Geräten der Produktivflotte nicht aktiviert.
Schritt 4: Die App auf dem Navigator 520 ausführen
1. Wählen Sie den Navigator in Android Studio aus. Nutzen Sie die Geräteauswahl in der oberen Symbolleiste und wählen Sie das verbundene RealWear-Gerät.
2. Klicken Sie auf Run. Wählen Sie das grüne Run-Dreieck oder nutzen Sie Run > Run 'app'.
3. Warten Sie die Installation ab. Android Studio erstellt das APK und installiert es über ADB auf dem Navigator.
4. Starten Sie die installierte App über den App-Launcher des Geräts oder führen Sie in einem Entwicklungsterminal `adb shell monkey -p your.application.id 1` aus. Ersetzen Sie `your.application.id` durch die applicationId aus der Gradle-Build-Datei des App-Moduls.
5. Prüfen Sie, ob die Schaltfläche CONTINUE sichtbar und aktiviert ist.
Schritt 5: WearHF testen, ohne ein SDK hinzuzufügen
WearHF läuft bereits auf dem Navigator 520. Testen Sie zunächst dieses Steuerelement, während nur die Schaltfläche CONTINUE auf dem Bildschirm zu sehen ist:
1. Sagen Sie CONTINUE und prüfen Sie, ob der normale Click-Listener der App genau einmal ausgeführt wird.
2. Sagen Sie SHOW HELP, um den Befehl anzuzeigen, den WearHF für diesen Bildschirm bereitstellt. Prüfen Sie, ob CONTINUE angezeigt wird.
3. Prüfen Sie die WearHF-Indikatoren und testen Sie die numerische Auswahl, falls sie angeboten wird. Verlassen Sie sich bei sicherheitskritischen Aktionen nicht ausschließlich auf einen Indikator, um sie zu kennzeichnen.
Optional: Nach dem CONTINUE-Test eine zweite Aktion hinzufügen
Sobald die erste Schaltfläche funktioniert, können Sie REPORT ISSUE hinzufügen. Fügen Sie in activity_main.xml diesen Button innerhalb des LinearLayout unterhalb von CONTINUE und vor </LinearLayout> ein:
<Button android:id="@+id/reportIssueButton" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="REPORT ISSUE" />
Fügen Sie in MainActivity.java diesen Listener innerhalb von onCreate() nach dem CONTINUE-Listener ein:
Button reportIssueButton = findViewById(R.id.reportIssueButton); reportIssueButton.setOnClickListener(v -> openIssueReport());
Fügen Sie openIssueReport() unterhalb von onCreate() innerhalb von MainActivity ein. Ersetzen Sie den Kommentar durch den Workflow zur Problemmeldung in Ihrer App:
private void openIssueReport() { // Formular für Geräteprobleme öffnen. }
Erstellen und installieren Sie die App neu und sagen Sie dann REPORT ISSUE. Prüfen Sie, ob sich der Workflow zur Problemmeldung öffnet.
Fazit
Die Entwicklung für den RealWear Navigator 520 ohne dediziertes SDK zeigt, dass sauberer Standard-Android-Code bereits sprachfähig ist: Der integrierte WearHF-Dienst verwandelt sichtbare Views und contentDescription-Direktiven in intuitive Freihand-Steuerelemente. Technische Teams vermeiden so aufgeblähte Drittanbieter-Bibliotheken und komplexe Sprach-Engines, während die zentrale Geschäftslogik in der Standard-Android-Architektur verbleibt. Aus geschäftlicher Sicht verkürzt dieser Ansatz die Time-to-Market und minimiert die Bereitstellungskosten: Unternehmen können vorhandene Android-Apps und das Know-how ihrer eigenen Entwickler direkt nutzen, die Bindung an proprietäre SDKs umgehen und Workflows an vorderster Front reibungslos modernisieren, ohne ihren Software-Stack zu beeinträchtigen.
Erstellen Sie für einen ersten Unternehmensprototyp einen einzelnen Inspektions- oder Wartungsbildschirm, prüfen Sie View-Beschriftungen und barrierefreie Beschreibungen und testen Sie die Sprachaktivierung anschließend auf genau der Navigator-520-Firmware, die in der Pilotflotte eingesetzt wird. Fügen Sie eingebettete Direktiven für spezifische UI-Anforderungen hinzu und Overrides der Spracherkennung nur dann, wenn der Workflow die vollständige Kontrolle über die Befehle erfordert.
