Synthèse
RealWear Navigator 520 : pour développer sur cet appareil, nul besoin d'un SDK vocal distinct pour l'interaction vocale de base. WearHF fait partie du logiciel de l'appareil. Il peut analyser un écran Android, identifier les vues interactives prises en charge et leur associer des commandes vocales. Un bouton Android standard intitulé CONTINUE peut donc être activé en prononçant « CONTINUE », sans importer de bibliothèque RealWear.
Commencez par une application Android standard et testez-la sur le firmware Navigator cible. WearHF peut reconnaître les contrôles d'écran pris en charge sans code vocal côté application. Ajoutez une directive de vue dans android:contentDescription lorsqu'un contrôle nécessite des formulations alternatives ou un comportement particulier. N'utilisez OVERRIDE_COMMANDS que lorsque l'application doit prendre le contrôle du moteur de reconnaissance et traiter elle-même les commandes. Ces approches ont des effets différents, décrits ci-dessous.
Important : « sans SDK » ne signifie pas « sans code ». Vous développez toujours l'interface Android et la logique métier. L'application n'a pas besoin d'un SDK vocal RealWear distinct pour la commande vocale de base, car WearHF fournit cette capacité au niveau de l'appareil.
Concept clé : pour la commande vocale de base, vous n'ouvrez pas WearHF, vous n'installez pas WearHF et vous n'importez pas de SDK WearHF. WearHF s'exécute en arrière-plan et fait partie du système d'exploitation RealWear.
Qu'est-ce que le RealWear Navigator 520 ?
Le RealWear Navigator 520 est un ordinateur de réalité assistée monoculaire et robuste, conçu pour le travail de terrain, comme la maintenance, l'inspection et le service sur site. Le firmware 2.x des Navigator 500/520 de RealWear repose sur Android 13, et la version de maintenance Ari OS 2.0 du 17-09-2026 (firmware 3.0, build 3.0.3-15 proposé aux appareils en build 2.2.3-33) fait passer l'appareil à Android 16. Les feuilles de route du firmware pouvant évoluer, considérez le système d'exploitation de l'appareil comme une contrainte de déploiement : consignez dans votre matrice de versions le build de firmware testé, le niveau d'API Android, les minSdk/targetSdk de l'application et le modèle d'appareil. Ne déduisez pas minSdk ou targetSdk uniquement de la version Android du casque.
Pour les développeurs, cela signifie que vous créez et empaquetez une application Android normale. WearHF s'exécute sur l'appareil et peut rendre les contrôles pris en charge accessibles à la voix ; il n'implémente pas votre flux de travail, n'autorise pas une action métier et ne remplace pas la validation côté application.
Qu'est-ce que WearHF ?
WearHF est le service intégré de RealWear dédié à la reconnaissance vocale et à l'interaction mains libres. Il interprète les vues Android et les directives d'écran prises en charge, puis active une vue ou envoie un événement vocal selon l'intégration choisie. L'interaction de base avec les vues ne nécessite aucune bibliothèque vocale RealWear distincte. Les directives intégrées sont lues dans android:contentDescription ; les commandes programmatiques passent par des intents de diffusion (broadcast) Android documentés. Ne confondez pas un clic sur une vue et une prise de contrôle (override) du moteur de reconnaissance : une prise de contrôle s'approprie le moteur de reconnaissance et peut supprimer les commandes intégrées/scriptées jusqu'à leur rétablissement.
Ce qu'il vous faut avant de créer la première application
· Un Navigator 520 équipé du build de firmware que vous comptez prendre en charge ; notez son build exact et sa version d'Android.
· Un ordinateur sous Windows, macOS ou Linux.
· Android Studio avec le SDK Android et les Platform Tools (ADB). Utilisez le niveau d'API Android requis par votre application et validez-le par rapport au firmware pris en charge par RealWear.
· Un câble de données USB-C.
· Aucun SDK RealWear pour la première application.
· Un flux de travail métier à tester, comme le passage à l'étape suivante d'une inspection ou le signalement d'un problème d'équipement.
Comment créer une application Android à commande vocale sans SDK RealWear
Étape 1 : créer un projet Android classique
Pour ce tutoriel, partez d'un projet Android basé sur les Views. Dans Android Studio, choisissez une Empty Activity basée sur les Views (et non un modèle uniquement Compose), puis sélectionnez Java ou Kotlin. Les exemples ci-dessous utilisent Java. Compose peut aussi fonctionner avec WearHF sur les logiciels pris en charge, mais sa sémantique et son arbre d'accessibilité doivent être testés sur le build cible.
1. Ouvrez Android Studio et sélectionnez New Project.
2. Choisissez une Empty Activity basée sur les Views. Si l'assistant propose des champs pour le langage et le SDK minimum, sélectionnez Java et réglez minSdk sur l'API Android la plus basse que votre application prend réellement en charge ; ne recopiez pas une valeur de cet exemple sans vérifier vos dépendances et votre parc d'appareils.
3. Saisissez les informations de l'application. Définissez le nom de l'application, le nom du package et l'emplacement d'enregistrement, puis créez le projet.
4. Attendez l'ouverture du projet. Android Studio termine la synchronisation Gradle et ouvre le projet.
N'ajoutez rien pour l'instant : vous ne cherchez pas de modèle de projet RealWear. Le but du premier build est de prouver qu'une application Android standard peut tourner sur le Navigator 520.
Étape 2 : ajouter un bouton Android et le relier au code Java
Commencez par créer un seul bouton. Vous allez ajouter sa mise en page Android, relier son action de clic en Java, puis le tester sur l'appareil.
1. Dans le panneau Project d'Android Studio, ouvrez app > res > layout > activity_main.xml. Le chemin complet du fichier est app/src/main/res/layout/activity_main.xml.
2. Sélectionnez Code dans l'éditeur de mise en page. Remplacez le contenu du fichier par le XML complet présenté ci-après.
XML : un bouton avec une commande WearHF
Collez la mise en page complète dans activity_main.xml, puis enregistrez le fichier :
<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>
Explication rapide : `LinearLayout` empile son contenu verticalement. `android:text` est le libellé visible du bouton. `android:contentDescription` contient la directive WearHF ; les services d'accessibilité Android lisent aussi ce champ, vérifiez donc que le contrôle reste compréhensible pour vos utilisateurs.
Ouvrez ensuite app > java > votre package > MainActivity.java dans le panneau Project. Le chemin complet est app/src/main/java/<your.package.name>/MainActivity.java. Conservez la classe Activity générée et la méthode `onCreate()`.
S'il est absent, ajoutez `import android.widget.Button;` avec les autres imports en haut de MainActivity.java. Dans la méthode `onCreate()` existante, collez ces lignes juste après `setContentView(R.layout.activity_main);` :
Button continueButton = findViewById(R.id.continueButton); continueButton.setOnClickListener(v -> openNextStep());
Ajoutez cette méthode sous `onCreate()`, mais avant l'accolade fermante finale de la classe MainActivity :
private void openNextStep() { // Naviguer vers l'étape suivante de l'inspection ou de l'ordre de travail. }
Comment l'adapter : remplacez la valeur de `android:text` par le libellé adapté à votre flux de travail. Remplacez `hf_commands:CONTINUE` par la formule que les opérateurs doivent prononcer, par exemple `hf_commands:Continue Work, Next Step`. L'ID XML `continueButton` doit correspondre à `R.id.continueButton` dans Java ; si vous le renommez, mettez les deux à jour. Remplacez le commentaire dans `openNextStep()` par l'action de navigation ou l'action métier dont votre application a besoin. La commande vocale de base ne nécessite ni SDK WearHF distinct ni autorisation `RECORD_AUDIO`.
Étape 3 : préparer le Navigator 520 pour le développement Android
L'ordinateur de développement a besoin d'une autorisation ADB pour installer et déboguer l'application. Utilisez un câble USB-C prenant en charge les données ; les câbles de charge uniquement ne seront pas détectés comme appareil ADB.
1. Ouvrez les paramètres avancés (Advanced Settings). Depuis l'écran d'accueil du Navigator, dites MY SETTINGS pour accéder à la liste des paramètres Android.
2. Ouvrez About Device. Dites ABOUT DEVICE, puis PAGE DOWN jusqu'à ce que Build Number soit visible.
3. Activez les options pour les développeurs (Developer Options). Dites BUILD NUMBER à plusieurs reprises, environ sept fois, jusqu'à ce que l'appareil confirme que le mode développeur est activé.
4. Ouvrez Developer Options. Dites NAVIGATE BACK, puis SYSTEM, puis DEVELOPER OPTIONS.
5. Activez le débogage USB. Dans Developer Options, activez USB debugging.
6. Branchez le câble USB-C et acceptez la demande de débogage RSA sur l'appareil. Vérifiez la connexion avec `adb devices` ; l'appareil doit apparaître comme `device`, et non comme `unauthorized`.
Si Android Studio ne répertorie pas le casque, exécutez `adb devices`. S'il affiche `unauthorized`, déverrouillez le casque et acceptez la demande RSA. Pour réinstaller depuis la racine du projet, utilisez `adb install -r app/build/outputs/apk/debug/app-debug.apk` ; adaptez le chemin si votre variante de build ou le nom de l'APK diffère. Utilisez Logcat dans Android Studio ou `adb logcat` pour examiner les plantages et les journaux de l'application.
Le débogage USB est un paramètre de développement. Désactivez-le après les tests en laboratoire ou gérez-le conformément à la politique de sécurité des appareils de l'organisation ; ne laissez pas l'accès de développement activé sur les appareils du parc en production.
Étape 4 : exécuter l'application sur le Navigator 520
1. Sélectionnez le Navigator dans Android Studio. Utilisez le sélecteur d'appareils dans la barre d'outils supérieure et choisissez l'appareil RealWear connecté.
2. Cliquez sur Run. Sélectionnez le triangle vert Run ou utilisez Run > Run 'app'.
3. Attendez la fin de l'installation. Android Studio compile l'APK et l'installe sur le Navigator via ADB.
4. Lancez l'application installée depuis le lanceur d'applications de l'appareil, ou exécutez `adb shell monkey -p your.application.id 1` depuis un terminal de développement. Remplacez `your.application.id` par l'applicationId défini dans le fichier de build Gradle du module de l'application.
5. Vérifiez que le bouton CONTINUE est visible et activé.
Étape 5 : tester WearHF sans ajouter de SDK
WearHF tourne déjà sur le Navigator 520. Avec seulement le bouton CONTINUE à l'écran, testez d'abord ce contrôle :
1. Dites CONTINUE et vérifiez que l'écouteur de clic normal de l'application s'exécute une seule et unique fois.
2. Dites SHOW HELP pour examiner la commande que WearHF expose pour cet écran. Vérifiez qu'elle affiche CONTINUE.
3. Vérifiez les indicateurs WearHF et testez la sélection numérique si elle est proposée. Ne vous fiez pas à un indicateur comme seul moyen d'identifier une action critique pour la sécurité.
Facultatif : ajouter une deuxième action après le test de CONTINUE
Une fois le premier bouton fonctionnel, vous pouvez ajouter REPORT ISSUE. Dans activity_main.xml, placez ce Button à l'intérieur du LinearLayout, sous CONTINUE et avant </LinearLayout> :
<Button android:id="@+id/reportIssueButton" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="REPORT ISSUE" />
Dans MainActivity.java, ajoutez cet écouteur dans onCreate(), après celui de CONTINUE :
Button reportIssueButton = findViewById(R.id.reportIssueButton); reportIssueButton.setOnClickListener(v -> openIssueReport());
Ajoutez openIssueReport() sous onCreate(), à l'intérieur de MainActivity. Remplacez le commentaire par le flux de signalement de problèmes de votre application :
private void openIssueReport() { // Ouvrir le formulaire de signalement d'un problème d'équipement. }
Recompilez et réinstallez l'application, puis dites REPORT ISSUE. Vérifiez que le flux de signalement de problèmes s'ouvre.
Conclusion
Développer pour le RealWear Navigator 520 sans SDK dédié prouve qu'un code Android propre et standard est déjà compatible avec la voix, en s'appuyant sur le service WearHF intégré pour transformer les vues visibles et les directives contentDescription en commandes mains libres intuitives. Pour les équipes techniques, cela évite d'alourdir l'application avec des bibliothèques tierces et des moteurs vocaux complexes, tout en conservant la logique métier au sein d'une architecture Android standard. Sur le plan commercial, cette approche accélère la mise sur le marché et réduit au minimum les coûts de déploiement : les entreprises peuvent tirer parti directement de leurs applications Android existantes et des compétences de leurs développeurs internes, éviter l'enfermement dans un SDK propriétaire et moderniser en douceur les flux de travail de terrain sans bouleverser leur environnement logiciel.
Pour un premier prototype en entreprise, créez un seul écran d'inspection ou de maintenance, vérifiez les libellés des vues et les descriptions d'accessibilité, puis testez l'activation vocale sur le firmware exact du Navigator 520 utilisé par le parc pilote. Ajoutez des directives intégrées pour des besoins d'interface spécifiques, et ne recourez à la prise de contrôle du moteur de reconnaissance que lorsque le flux de travail exige une maîtrise totale des commandes.
























