Fejlesztés RealWear Navigator 520-ra SDK nélkül: így működik a WearHF

Fejlesztés RealWear Navigator 520-ra SDK nélkül: így működik a WearHF

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.

João Noronha

Írta

João Noronha

XR és immerzív tartalom specialista a VR Expertnél

João Noronha XR és immerzív tartalom specialista a VR Expertnél, akit erősen érdekelnek az új technológiák és azok valós alkalmazásai. Arra összpontosít, hogy a VR, AR, AI szemüvegek és immerzív technológiák összetett fejlesztéseit érthető, gyakorlatias tartalommá alakítsa a vállalatok és az XR iparág iránt érdeklődő szakemberek számára.

Gyakori kérdések

Ez a cikk

Igen. Az alkalmazás továbbra is Android-alkalmazás, így a fejlesztők a felületet és az üzleti logikát Javában, Kotlinban, XML Views-ban vagy más támogatott Android UI-eszközkészlettel írják meg. Az alapvető WearHF-nézetinterakcióhoz nincs szükség külön RealWear beszédfelismerő SDK-ra.

Az alapvető nézetparancsokhoz nem. A WearHF be van építve a RealWear szoftverébe, és a támogatott Android-nézetekből képes parancsokat származtatni. Egyedi viselkedéshez használja a dokumentált direktívákat vagy intenteket.

Nem különálló alkalmazásként kell megnyitni. A WearHF a háttérben fut, a Navigator 520 szoftverének részeként.

A támogatott kattintható nézeteknél a WearHF a nézet szövegéből vagy tartalomleírásából (content description) tud parancsot származtatni, a direktívától és a nézethierarchiától függően. Tesztelje a ténylegesen megjelenő képernyőn elérhetővé tett parancsot; a látható felirat nem garancia minden egyedi nézet esetében.

Mondja ki a SHOW HELP parancsot a Navigator 520-on. A RealWear megjeleníti az adott képernyőhöz tartozó parancsokat.

Views-alapú alkalmazásban nyissa meg az elrendezés XML-fájlját (például: app/src/main/res/layout/activity_main.xml), és állítsa be a nézet `android:contentDescription` attribútumát. Több kifejezéshez használja a `hf_commands:Phrase One, Phrase Two` formát, több direktíva között pedig a `-` jelet.

A `hf_commands` egy nézetszintű WearHF-direktíva. Helyezze el a nézet contentDescription attribútumában, utána pedig vesszővel elválasztott kifejezéseket; minden felismert kifejezés az adott nézetre kattint.

A beágyazott direktívákhoz nincs szükség külön WearHF-könyvtárra. Ezek az Android contentDescription attribútumában szereplő karakterláncok, amelyeket az eszköz szolgáltatása értelmez. Mivel a contentDescription attribútumot az akadálymentességi szolgáltatások is használják, őrizzen meg hasznos akadálymentes feliratot, és mindkét viselkedést tesztelje.

Az OVERRIDE_COMMANDS-ot akkor használja, ha a felismerő parancslistáját futásidőben le kell cserélni. A nézeteket kiegészítő, képernyőszintű parancsokhoz fontolja meg a `hf_add_commands` használatát. Ne feledje, hogy a felülbírálási mód ideiglenesen elnyomja a beágyazott/szkriptelt parancsokat, és a dokumentált életciklus-pontokon vissza kell állítani vagy újra kell regisztrálni.

A RealWear 2026. májusi Collaborate kiadási megjegyzései szerint a WearHF natívan támogatja a Jetpack Compose-t. Ez alátámasztja, hogy a platform támogatja a Compose-t, de nem helyettesíti a szemantika, az egyedi composable-ök, az akadálymentességi feliratok és a parancsátfedések tesztelését a saját alkalmazásában. Ez az oktatóanyag XML Views-t használ, hogy a nézetek és a parancsok közötti megfeleltetés egyértelmű legyen. Hivatkozás: a Collaborate 2.5.1 kiadási megjegyzése rögzíti, hogy a WearHF natívan támogatja a Compose-t (közzétéve: 2026-05-07). Ezt az állítást csak a megfelelő támogatást tartalmazó eszközszoftverre vonatkoztassa, és ellenőrizze a működést a célbuildön.

A Navigator 500/520 közzétett 2.2-es firmware-kiadása Android 13-ra épül. A RealWear firmware-szabályzata szerint a tervek között szerepel, hogy a támogatott eszközöket 2026 folyamán Android 16-alapú operációs rendszerre állítják át; egy terv azonban nem garantálja a kiadást. A compileSdk, targetSdk, minSdk, az engedélyek vagy a kiadási viselkedés megválasztása előtt nézze meg az aktuális GA kiadási megjegyzéseket, és tesztelje a flotta pontos buildjét.