Vezetői összefoglaló
A RealWear Navigator 520 eszközre történő fejlesztéshez az alapvető hangalapú interakció esetén nincs szükség külön beszédfelismerő SDK-ra. A WearHF az eszköz szoftverének része. Képes megvizsgálni egy Android-képernyőt, azonosítani a támogatott interaktív nézeteket, és hangutasításokat elérhetővé tenni hozzájuk. Egy CONTINUE feliratú szabványos Android-gomb így a „CONTINUE” kimondásával aktiválható, RealWear-könyvtár importálása nélkül.
Kezdjen egy szabványos Android-alkalmazással, és tesztelje a cél Navigator firmware-en. A WearHF az alkalmazásoldali beszédkód nélkül is felismeri a támogatott képernyővezérlőket. Ha egy vezérlőhöz alternatív kifejezésekre vagy különleges viselkedésre van szükség, adjon hozzá nézetdirektívát az android:contentDescription attribútumban. Az OVERRIDE_COMMANDS-ot csak akkor használja, ha az alkalmazásnak át kell vennie a felismerő irányítását, és saját magának kell kezelnie a parancsokat. Ezek az utak eltérő hatással járnak; alább ismertetjük őket.
Fontos: az „SDK nélkül” nem jelenti azt, hogy „kód nélkül”. Az Android-felületet és az üzleti logikát továbbra is Önnek kell elkészítenie. Az alkalmazásnak az alapvető hangvezérléshez azért nincs szüksége külön RealWear beszédfelismerő SDK-ra, mert ezt az eszközszintű képességet a WearHF biztosítja.
Alapkoncepció: az alapvető hangvezérléshez nem kell megnyitnia vagy telepítenie a WearHF-et, és WearHF SDK-t sem kell importálnia. A WearHF a háttérben fut, a RealWear operációs rendszer részeként.
Mi az a RealWear Navigator 520?
A RealWear Navigator 520 egy strapabíró, monokuláris asszisztált valóság (assisted reality) számítógép, amelyet frontvonalbeli munkára, például karbantartásra, ellenőrzésre és terepi szervizre terveztek. A RealWear Navigator 500/520 2.x firmware-e Android 13-ra épül, a 2026. szeptember 17-i Ari OS 2.0 karbantartási kiadás (3.0-s firmware, 3.0.3-15-ös build, amelyet a 2.2.3-33-as buildet futtató eszközök számára kínálnak fel) pedig Android 16-ra állítja át az eszközt. A firmware-ütemtervek változhatnak, ezért az eszköz operációs rendszerét telepítési korlátként kezelje: rögzítse a kiadási mátrixban a tesztelt firmware-buildet, az Android API-szintet, az alkalmazás minSdk/targetSdk értékét és az eszköz modelljét. A minSdk vagy a targetSdk értékére ne kizárólag a headset Android-verziójából következtessen.
Fejlesztői szempontból ez azt jelenti, hogy egy szokásos Android-alkalmazást kell elkészítenie és csomagolnia. A WearHF az eszközön fut, és a támogatott vezérlőket hanggal is elérhetővé teheti; ugyanakkor nem valósítja meg az Ön munkafolyamatát, nem engedélyez üzleti műveleteket, és nem helyettesíti az alkalmazásoldali validálást.
Mi az a WearHF?
A WearHF a RealWear beépített beszéd- és kéz nélküli interakciós szolgáltatása. Értelmezi a támogatott Android-nézeteket és képernyődirektívákat, majd a választott integrációtól függően aktivál egy nézetet vagy beszédeseményt küld. Az alapvető nézetinterakcióhoz nincs szükség külön RealWear beszédkönyvtárra. A beágyazott direktívákat az android:contentDescription attribútumból olvassa ki; a programozott parancsok dokumentált Android broadcast intenteket használnak. Ne keverje össze a nézetre kattintást a felismerő felülbírálásával: a felülbírálás átveszi a felismerő irányítását, és a visszaállításig elnyomhatja a beágyazott/szkriptelt parancsokat.
Amire az első alkalmazás elkészítése előtt szüksége lesz
· Egy Navigator 520, amelyen a támogatni kívánt firmware-build fut; jegyezze fel a pontos buildet és az Android-verziót.
· Egy Windows, macOS vagy Linux rendszerű számítógép.
· Android Studio az Android SDK-val és a Platform Tools csomaggal (ADB). Az alkalmazása által megkövetelt Android API-szintet használja, és validáljon a RealWear által támogatott firmware-rel.
· Egy USB-C adatkábel.
· Az első alkalmazáshoz nincs szükség RealWear SDK-ra.
· Egy tesztelendő üzleti munkafolyamat, például egy ellenőrzési lépés továbbléptetése vagy egy berendezéshiba bejelentése.
Hangvezérelt Android-alkalmazás készítése RealWear SDK nélkül
1. lépés: Hozzon létre egy szokásos Android-projektet
Ehhez az útmutatóhoz kezdjen egy Android Views-projekttel. Az Android Studióban válasszon egy Views-alapú Empty Activity sablont (ne kizárólag Compose-ra épülőt), majd válassza a Java vagy a Kotlin nyelvet. Az alábbi példák Javát használnak. A Compose is működhet a WearHF-fel a támogatott szoftververziókon, de a szemantikáját és az akadálymentességi fáját a célbuildön tesztelni kell.
1. Nyissa meg az Android Studiót, és válassza a New Project lehetőséget.
2. Válasszon egy Views-alapú Empty Activity sablont. Ha a varázsló felkínálja a nyelv és a minimális SDK mezőit, válassza a Javát, és a minSdk értékét állítsa arra a legalacsonyabb Android API-szintre, amelyet az alkalmazása ténylegesen támogat; ne másoljon át értéket ebből a példából a függőségek és az eszközflotta ellenőrzése nélkül.
3. Adja meg az alkalmazás adatait. Állítsa be az alkalmazás nevét, a csomagnevet és a mentési helyet, majd hozza létre a projektet.
4. Várja meg, amíg a projekt megnyílik. Az Android Studio befejezi a Gradle-szinkronizálást, és megnyitja a projektet.
Egyelőre ne adjon hozzá semmit: nem RealWear-projektsablont keres. Az első build célja annak bizonyítása, hogy egy szabványos Android-alkalmazás futtatható a Navigator 520-on.
2. lépés: Adjon hozzá egy Android-gombot, és kösse össze a Java-kóddal
Először hozzon létre egyetlen gombot. Hozzáadja az Android-elrendezését, Javában összeköti a kattintási műveletét, majd teszteli az eszközön.
1. Az Android Studio Project paneljén nyissa meg az app > res > layout > activity_main.xml fájlt. A teljes elérési út: app/src/main/res/layout/activity_main.xml.
2. Az elrendezésszerkesztőben válassza a Code nézetet. Cserélje le a fájl tartalmát az alább látható teljes XML-re.
XML: egy gomb WearHF-paranccsal
Illessze be a teljes elrendezést az activity_main.xml fájlba, majd mentse a fájlt:
<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>
Rövid magyarázat: a `LinearLayout` függőlegesen egymás alá rendezi a tartalmát. Az `android:text` a gomb látható felirata. Az `android:contentDescription` tartalmazza a WearHF-direktívát; ezt a mezőt az Android akadálymentességi szolgáltatásai is beolvassák, ezért tesztelje, hogy a vezérlő továbbra is érthető marad-e a felhasználók számára.
Ezután a Project panelen nyissa meg az app > java > az Ön csomagja > MainActivity.java fájlt. A teljes elérési út: app/src/main/java/<your.package.name>/MainActivity.java. Tartsa meg a generált Activity osztályt és az `onCreate()` metódust.
Ha hiányzik, adja hozzá az `import android.widget.Button;` sort a MainActivity.java tetején lévő importokhoz. A meglévő `onCreate()` metóduson belül illessze be ezeket a sorokat közvetlenül a `setContentView(R.layout.activity_main);` után:
Button continueButton = findViewById(R.id.continueButton); continueButton.setOnClickListener(v -> openNextStep());
Adja hozzá ezt a metódust az `onCreate()` alá, de még a MainActivity osztály záró kapcsos zárójele elé:
private void openNextStep() { // Navigálás a következő ellenőrzési vagy munkautasítás-lépésre. }
A testreszabás módja: módosítsa az `android:text` értékét a munkafolyamatához illő feliratra. A `hf_commands:CONTINUE` helyére írja azt a kifejezést, amelyet a dolgozóknak ki kell mondaniuk, például `hf_commands:Continue Work, Next Step`. A `continueButton` XML-azonosítónak egyeznie kell a Javában szereplő `R.id.continueButton` hivatkozással; ha átnevezi, mindkettőt frissítse. Az `openNextStep()` metódusban lévő megjegyzést cserélje le az alkalmazásához szükséges navigációs vagy üzleti műveletre. Az alapvető hangvezérléshez nincs szükség külön WearHF SDK-ra vagy `RECORD_AUDIO` engedélyre.
3. lépés: Készítse elő a Navigator 520-at az Android-fejlesztésre
A fejlesztői számítógépnek ADB-engedélyre van szüksége az alkalmazás telepítéséhez és hibakereséséhez. Adatátvitelre alkalmas USB-C kábelt használjon; a csak töltésre alkalmas kábelekkel az eszköz nem jelenik meg ADB-eszközként.
1. Nyissa meg az Advanced Settings menüt. A Navigator kezdőképernyőjén mondja ki a MY SETTINGS parancsot, hogy elérje az Android beállításlistáját.
2. Nyissa meg az About Device menüt. Mondja ki az ABOUT DEVICE, majd a PAGE DOWN parancsot, amíg a Build Number láthatóvá nem válik.
3. Engedélyezze a Developer Options beállításokat. Mondja ki többször egymás után – nagyjából hétszer – a BUILD NUMBER parancsot, amíg az eszköz meg nem erősíti, hogy a fejlesztői mód be van kapcsolva.
4. Nyissa meg a Developer Options menüt. Mondja ki a NAVIGATE BACK, majd a SYSTEM, végül a DEVELOPER OPTIONS parancsot.
5. Engedélyezze az USB-hibakeresést. A Developer Options menüben kapcsolja be az USB debugging opciót.
6. Csatlakoztassa az USB-C kábelt, és hagyja jóvá az eszközön megjelenő RSA hibakeresési kérést. Ellenőrizze a kapcsolatot az `adb devices` paranccsal; az eszköznek `device` állapotban kell megjelennie, nem `unauthorized` állapotban.
Ha az Android Studio nem listázza a headsetet, futtassa az `adb devices` parancsot. Ha `unauthorized` állapotot mutat, oldja fel a headset zárolását, és hagyja jóvá az RSA-kérést. Ismételt telepítéshez a projekt gyökérkönyvtárából használja az `adb install -r app/build/outputs/apk/debug/app-debug.apk` parancsot; ha a buildváltozat vagy az APK neve eltér, módosítsa az elérési utat. Az összeomlások és az alkalmazásnaplók vizsgálatához használja az Android Studio Logcat eszközét vagy az `adb logcat` parancsot.
Az USB-hibakeresés fejlesztői beállítás. A laboratóriumi tesztelés után kapcsolja ki, vagy kezelje a szervezet eszközbiztonsági szabályzata szerint; az éles flottában lévő eszközökön ne hagyja engedélyezve a fejlesztői hozzáférést.
4. lépés: Futtassa az alkalmazást a Navigator 520-on
1. Válassza ki a Navigatort az Android Studióban. A felső eszköztár eszközválasztójában válassza ki a csatlakoztatott RealWear eszközt.
2. Kattintson a Run gombra. Válassza a zöld Run háromszöget, vagy használja a Run > Run 'app' menüpontot.
3. Várja meg a telepítést. Az Android Studio elkészíti az APK-t, és ADB-n keresztül telepíti a Navigatorra.
4. Indítsa el a telepített alkalmazást az eszköz alkalmazásindítójából, vagy futtassa az `adb shell monkey -p your.application.id 1` parancsot egy fejlesztői terminálból. A `your.application.id` helyére az alkalmazásmodul Gradle buildfájljában szereplő applicationId értéket írja.
5. Ellenőrizze, hogy a CONTINUE gomb látható és engedélyezett-e.
5. lépés: Tesztelje a WearHF-et anélkül, hogy bármilyen SDK-t hozzáadna
A WearHF már fut a Navigator 520-on. Amikor csak a CONTINUE gomb van a képernyőn, először ezt a vezérlőt tesztelje:
1. Mondja ki a CONTINUE parancsot, és ellenőrizze, hogy az alkalmazás szokásos kattintásfigyelője pontosan egyszer fut-e le.
2. Mondja ki a SHOW HELP parancsot, hogy megnézze, milyen parancsot tesz elérhetővé a WearHF ezen a képernyőn. Ellenőrizze, hogy a CONTINUE megjelenik-e.
3. Ellenőrizze a WearHF jelzéseit, és ha elérhető, tesztelje a számalapú kiválasztást is. Biztonságkritikus műveletek azonosításakor ne hagyatkozzon kizárólag egy jelzésre.
Opcionális: Második művelet hozzáadása a CONTINUE teszt után
Miután az első gomb működik, hozzáadhatja a REPORT ISSUE gombot. Az activity_main.xml fájlban helyezze el ezt a Button elemet a LinearLayouton belül, a CONTINUE alatt és a </LinearLayout> előtt:
<Button android:id="@+id/reportIssueButton" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="REPORT ISSUE" />
A MainActivity.java fájlban adja hozzá ezt a figyelőt az onCreate() metóduson belül, a CONTINUE figyelője után:
Button reportIssueButton = findViewById(R.id.reportIssueButton); reportIssueButton.setOnClickListener(v -> openIssueReport());
Adja hozzá az openIssueReport() metódust az onCreate() alá, a MainActivity osztályon belül. A megjegyzést cserélje le az alkalmazása hibabejelentési munkafolyamatára:
private void openIssueReport() { // A berendezéshiba-bejelentő űrlap megnyitása. }
Építse újra és telepítse újra az alkalmazást, majd mondja ki a REPORT ISSUE parancsot. Ellenőrizze, hogy megnyílik-e a hibabejelentési munkafolyamat.
Összegzés
A RealWear Navigator 520 eszközre dedikált SDK nélkül történő fejlesztés azt bizonyítja, hogy a tiszta, szabványos Android-kód már eleve alkalmas a hangvezérlésre, mivel a beépített WearHF szolgáltatás a látható nézeteket és a contentDescription direktívákat intuitív, kéz nélküli vezérlőkké alakítja. A technikai csapatok számára ez elkerülhetővé teszi a külső könyvtárak okozta felesleges terhelést és a bonyolult beszédfelismerő motorokat, miközben az alapvető üzleti logika a szabványos Android-architektúrán belül marad. Üzleti szempontból ez a megközelítés felgyorsítja a piacra lépést és minimalizálja a bevezetési költségeket: a vállalatok közvetlenül építhetnek meglévő Android-alkalmazásaikra és belső fejlesztői tudásukra, elkerülhetik a saját fejlesztésű SDK-khoz való kötöttséget, és zökkenőmentesen modernizálhatják a frontvonalbeli munkafolyamatokat anélkül, hogy megbontanák szoftverkörnyezetüket.
Az első vállalati prototípushoz készítsen el egy ellenőrzési vagy karbantartási képernyőt, ellenőrizze a nézetek feliratait és akadálymentes leírásait, majd tesztelje a hangalapú aktiválást pontosan azon a Navigator 520 firmware-en, amelyet a pilotflotta használ. Beágyazott direktívákat a konkrét felhasználói felületi igényekhez adjon hozzá, felismerő-felülbírálást pedig csak akkor, ha a munkafolyamat a parancsok teljes körű kezelését igényli.

























