Vezetői összefoglaló
Az XREAL One Pro nem maga futtatja az egyedi alkalmazást. Az alkalmazás számítógépen, Unityben készül, Android APK-ként települ az XREAL Beam Pro-ra vagy egy másik támogatott androidos gazdaeszközre, majd a One Pro szemüvegen keresztül jelenik meg. Ez a gazdaeszköz-alapú modell a legfontosabb, amit a fejlesztőknek a munka megkezdése előtt meg kell érteniük.
A beállítás világos munkafolyamatot követ: készítse elő a Beam Pro-t, telepítse a Unityt és az Android-támogatást, adja hozzá az XREAL SDK-t, nyissa meg és tesztelje a HelloMR mintát, buildelje le az APK-t, telepítse a Beam Pro-ra ADB-vel, csatlakoztassa a One Pro-t, és indítsa el az alkalmazást a MyGlassesen keresztül. A vállalatok számára ez az architektúra megkönnyíti az egyedi XREAL-munkafolyamatok fejlesztését és tesztelését ismerős Android- és Unity-eszközökkel, miközben az alkalmazáslogika egy különálló gazdaeszközön marad, amely felügyelhető, frissíthető és integrálható a meglévő vállalati rendszerekkel.
Az elkerülendő hiba: ne tervezzen olyan projektet, amelyben az APK közvetlenül az [XREAL One Pro](https://ai.vr-expert.com/en/ai-glasses/xreal-one-pro) eszközre települ. Az APK az androidos gazdaeszközre kerül.
Mi az XREAL One Pro?
Az XREAL One Pro egy kábellel csatlakoztatott AR-kijelző 57 fokos látómezővel, Sony Micro-OLED kijelzőkkel és az XREAL X1 térbeli feldolgozó chipjével. Az X1 chip natív 3DoF-ot biztosít, így a kép a helyén marad, amikor elfordítja a fejét, az SDK 3.1.0 óta pedig a One sorozat firmware-frissítés után az opcionális XREAL Eye kamerával 6DoF fejkövetést is támogat. Mindez azonban nem teszi a szemüveget önálló androidos számítógéppé.
Egyedi XREAL SDK-fejlesztés esetén az alkalmazást a csatlakoztatott androidos gazdaeszköz kezeli. A One Pro a viselhető kijelző és a követés végpontja.
Tekintse meg az XREAL One Pro termékoldalát a VR Expert AI oldalán
Amire szüksége lesz ehhez az útmutatóhoz
· Windows vagy macOS rendszerű számítógép.
· XREAL Beam Pro, vagy egy, az XREAL által tesztelt Samsung csúcstelefon: Galaxy S24 Android 14-gyel vagy Galaxy S25 Android 15-tel. Az XREAL csak a Samsung csúcsmodelleket támogatja, és arra kéri a fejlesztőket, hogy amíg a kompatibilitási közleménye érvényben van, ne használjanak Android 16-ra frissített telefont. A fő lépésekben a Beam Pro szolgál gazdaeszközként.
· USB-C kábel a One Pro és a Beam Pro összekapcsolásához.
· Unity Hub és egy támogatott Unity LTS verzió Android Build Supporttal. (Útmutató a cikkben)
· Az XREAL SDK for Unity aktuális verziója az XREAL fejlesztői letöltési oldaláról. (Útmutató a cikkben)
· Android Debug Bridge (ADB) az APK Beam Pro-ra telepítéséhez. (Útmutató a cikkben)
Így fejlesztheti első XREAL One Pro-alkalmazását
1. lépés: A Beam Pro, vagyis az alkalmazást futtató eszköz előkészítése
Kezdje a Beam Pro-val, mert ide települ majd a kész androidos alkalmazás. A Beam Pro egy kézben tartható fizikai eszköz, nem pedig letölthető szoftver.
1. Szerezze be az XREAL Beam Pro-t. Vásárolja meg a Beam Pro hardvert az XREAL-tól vagy egy hivatalos viszonteladótól. Ez a One Pro szemüvegtől különálló eszköz.
2. Kapcsolja be, és csatlakoztassa Wi-Fi-hálózathoz. Végezze el a Beam Pro szokásos első Android/nebulaOS-beállítását.
3. Nyissa meg a MyGlasses alkalmazást a Beam Pro-n. A MyGlasses az XREAL szemüvegkezelő alkalmazása, amelyet a Beam Pro-n használnak.
4. Ha a rendszer kéri, frissítse a Beam Pro-t és a MyGlassest. Az SDK 3.1.0 a MyGlasses 1.11.0-s verziójával párosul. Az XREAL kiadási megjegyzése szerint először a MyGlassest kell frissíteni, majd csatlakoztatni a szemüveget, ami automatikusan elindítja annak firmware-frissítését. A Beam Pro Android 14-alapú nebulaOS-t futtat, így az XREAL Android 16-tal kapcsolatos figyelmeztetése a telefonokra vonatkozik, nem a Beam Pro-ra.
5. Csatlakoztassa egyszer a One Pro-t a Beam Pro-hoz. Használja a szemüveg USB-C kábelét. Ha szemüveg-firmwarefrissítés jelenik meg, a fejlesztés előtt végezze el.
****
2. lépés: A Unity Hub telepítése a fejlesztői számítógépre
1. Nyissa meg a Unity webhelyét a számítógépen. Töltse le a Unity Hubot Windowsra vagy macOS-re.
2. Telepítse és nyissa meg a Unity Hubot. A Unity Hub egy különálló asztali program, amellyel a Unity Editor telepíthető.
3. Ha a rendszer kéri, jelentkezzen be, vagy hozzon létre Unity-fiókot. Így a Unity Hub hozzáfér a szerkesztő telepítési és licencelési folyamatához
3. lépés: Androidtámogatással rendelkező Unity Editor-verzió telepítése
Az XREAL SDK a Unityn belül fut, ezért a Unity Editort telepíteni kell, mielőtt az SDK importálható lenne.
1. Nyissa meg a Unity Hub > Installs menüpontot. Válassza az Install Editor lehetőséget.
2. Válasszon egy támogatott LTS verziót. Az XREAL a Unity 2021.3.X, 2022.3.X és 6000.0.X LTS verzióit támogatja. Az aktuális XREAL-dokumentációban felsorolt támogatott verziók egyikét használja.
3. Jelölje be az Android Build Supportot. Az XREAL minimális követelménye az Android SDK 31-es API-szintje (Android 12) vagy újabb, ezt a mellékelt SDK lefedi.
4. Fejezze be a telepítést. Várjon, amíg a Unity Hub megjeleníti a szerkesztőt az Installs alatt.
Akkor lépjen tovább a 4. lépésre, ha: a Unity Editor telepítve van, és az Android Build Support is benne van.
4. lépés: Az XREAL SDK letöltése a számítógépre
Az XREAL SDK egy fájl, amelyet később a Unitybe importál. Ne próbálja meg a Beam Pro-ra vagy a szemüvegre telepíteni.
1. Nyissa meg az XREAL Developer Download oldalt. A fejlesztői számítógépen látogasson el a developer.xreal.com/download címre.
2. Keresse meg az XREAL SDK for Unity csomagot. Fogadja el az XREAL API feltételeit, és töltse le az aktuális SDK-t.
3. Őrizze meg a letöltött fájlt. A csomag fájlként érkezik, például com.xreal.xr.tar.gz néven.
Akkor lépjen tovább az 5. lépésre, ha: az XREAL SDK-fájl el van mentve a számítógépen. A tar.gz fájlt ne nyissa meg kézzel.
5. lépés: A Unity-projekt létrehozása
Most a Unity Hubbal hozza létre azt a projektet, amelyből később a Beam Pro-ra telepített androidos alkalmazás lesz.
1. Nyissa meg a Unity Hub > Projects menüpontot. Válassza a New project lehetőséget.
2. Válasszon egy hagyományos 3D-sablont. Adjon a projektnek egyszerű nevet, például XREAL-One-Pro-Test, és válassza ki, hová mentse.
3. Hozza létre a projektet. Várja meg, amíg megnyílik a Unity Editor.
4. Állítsa át a projektet Androidra. A Unity Editorban nyissa meg a File > Build Settings menüt. Válassza az Android lehetőséget, és kattintson a Switch Platform gombra. Unity 6-ban a File > Build Profiles menüt használja, ha az jelenik meg.
Akkor lépjen tovább a 6. lépésre, ha: a Unityben az Android az aktív buildplatform.
6. lépés: Az XREAL által igényelt Unity-csomag telepítése
Maradjon a Unity Editorban. A következő eszközöket ugyanehhez a projekthez kell hozzáadni.
1. Nyissa meg a Window > Package Manager menüt. A Package Manager ablakban állítsa a csomagforrást a(z) Unity Registry értékre. Így a Unity által biztosított csomagok jelennek meg.
2. Keresse meg az XR Interaction Toolkitet. Jelölje ki, és kattintson az Install gombra. Az XREAL a 2.5.x és a 3.0.x verziót tünteti fel támogatottként; ha a Package Manager újabbat telepít, és a minta hibásan működik, válassza helyette a 3.0.x verziót a verziólistából.
3. Nyissa meg a Samples lapját. Keresse meg a Starter Assets elemet, kattintson az Import gombra, majd importálja a Hands Interaction Demót is. Az XREAL hibaelhárítási oldala szerint enélkül a HelloMR hiányzó prefabokat jelez.
7. lépés: Az XREAL SDK importálása ugyanabba a Unity-projektbe
Még mindig a Unityben van. Most használja a 4. lépésben letöltött XREAL SDK-fájlt.
1. Maradjon a Window > Package Manager ablakban. Kattintson a bal felső részen található + gombra. Ezután válassza az „Add package from tarball” lehetőséget.
2. Keresse meg a korábban letöltött XREAL SDK-fájlt. Lépjen a Letöltések mappába, jelölje ki a com.xreal.xr.tar.gz-hez hasonló nevű fájlt, és kattintson az Open gombra. A Unity ezután hozzáadja az XREAL XR Plugint a projekthez.
3. Nyissa meg az XREAL XR Plugint a Package Manager > Samples részben. Importálja az Interaction Basics mintát. Ez hozzáadja a kész HelloMR mintajelenetet, amellyel ellenőrizheti, hogy az XREAL-beállítás működik-e.
8. lépés: Az XREAL engedélyezése a projektben
Az SDK már megvan, de a Unitynek még tudnia kell, hogy ez az androidos projekt az XREAL beépülő modult használja.
1. Nyissa meg az Edit > Project Settings > XR Plug-in Management menüt. Válassza az Android lapot.
2. Jelölje be az XREAL lehetőséget. Ez engedélyezi az XREAL XR-szolgáltatót az androidos buildhez.
3. Nyissa meg a Project Validation részt. Az összes szükséges XREAL-módosításhoz kattintson a Fix All gombra.
4. Nyissa meg az XR Plug-in Management > XREAL részt. XREAL Eye nélküli One Pro esetén állítsa az Initial Tracking Type beállítást MODE_3DOF értékre, az Initial Input Source beállítást Controller értékre (a Beam Pro vagy a telefon 3DoF-vezérlőként működik), a Support Devices beállítást pedig XREAL_DEVICE_CATEGORY_VISION értékre; ez az XREAL kategóriája a 3DoF szemüvegekhez, például a One sorozathoz. Minden mást hagyjon alapértelmezett értéken, amíg a minta nem működik.
Akkor lépjen tovább a 9. lépésre, ha: a Project Validation már nem jelez megoldatlan, kötelező XREAL-beállításokat.
9. lépés: Az XREAL HelloMR mintájának megnyitása
Mielőtt saját alkalmazást írna, használja az XREAL mintáját. Ez igazolja, hogy a Unity, az XREAL SDK, a Beam Pro és a szemüveg képes együttműködni.
1. Nyissa meg a Unityben a Project panelt. Lépjen az Assets > Samples > XREAL XR Plugin > [az Ön SDK-verziója] > Interaction Basics mappába.
2. Keresse meg a HelloMR.unity fájlt. Kattintson duplán a jelenetre a megnyitásához.
3. Még ne szabja testre. Először a változatlan mintát buildelje le, így tudni fogja, hogy a fejlesztői környezet működik.
10. lépés: Az androidos APK buildelése a számítógépen
A Unity most androidos alkalmazásfájllá alakítja a HelloMR projektet. Ezt a fájlt APK-nak nevezik.
1. Nyissa meg a File > Build Settings vagy a Build Profiles menüt. Válassza az Add Open Scenes lehetőséget, hogy a HelloMR bekerüljön.
2. Ellenőrizze, hogy az Android az aktív platform. Ha nem, váltson Androidra.
3. Kattintson a Build gombra. Állítsa be a Player Settings beállításait, majd buildeljen. A Player Settingsben töltse ki a Company Name és a Product Name mezőt (a MyGlasses a Product Name értékét jeleníti meg, ezért használja az XREAL-HelloMR nevet), és ellenőrizze, hogy a Scripting Backend IL2CPP, a célarchitektúra pedig ARM64; az XREAL mindkettőt megköveteli. Ezután kattintson a Build gombra, válasszon egy mappát a számítógépen, és mentse a fájlt XREAL-HelloMR.apk néven
4. Várja meg, amíg a build elkészül. Az APK most már a számítógépen van, de a Beam Pro-n még nincs.
Mi az APK: az APK az a fájl, amellyel androidos alkalmazás telepíthető. Ebben a munkafolyamatban az APK a Beam Pro-ra kerül, nem az [XREAL One Pro](https://ai.vr-expert.com/en/ai-glasses/xreal-one-pro) eszközre.
11. lépés: Az APK telepítése a Beam Pro-ra
ADB: Android Debug Bridge, számítógépes eszköz androidos alkalmazások telepítésére és tesztelésére a Beam Pro-n vagy telefonon.
Az alkalmazás elkészült. A következő lépésben az APK a számítógépről a Beam Pro-ra kerül.
1. Csatlakoztassa a Beam Pro-t USB-C-n keresztül a számítógéphez.
2. Nyissa meg a Terminált vagy a PowerShellt a számítógépen.
3. Engedélyezze az USB-hibakeresést a Beam Pro-n. Az XREAL útmutatója csak annyit ír, hogy a gazdaeszközön engedélyezni kell a Fejlesztői beállításokat és az USB-hibakeresést; Androidon ez azt jelenti, hogy a „Névjegy” alatt hétszer kell koppintani a „Buildszám” elemre a Fejlesztői beállítások feloldásához, majd ott be kell kapcsolni az USB-hibakeresést. Ha a Beam Pro megkérdezi, engedélyezi-e az USB-hibakeresést erről a számítógépről, válassza az Engedélyezés lehetőséget.
4. Ellenőrizze, hogy a számítógép látja-e a Beam Pro-t. Írja be a PowerShellbe:
adb devices
Ha a Beam Pro „device” állapotban jelenik meg, a kapcsolat működik, és folytathatja.
5. Telepítse az APK-t. Először keresse meg az XREAL-HelloMR.apk fájlt a számítógépen. Ha például az Asztalon egy XREAL Test nevű mappába mentette, a Windows-elérési út így nézhet ki:
C:\Users\YourName\Desktop\XREAL Test\XREAL-HelloMR.apk
Írja be a PowerShellbe:
adb install -r "C:\Users\YourName\Desktop\XREAL Test\XREAL-HelloMR.apk"
Cserélje le a példa elérési utat az APK tényleges helyére, majd nyomja meg az Enter billentyűt.
6. Várja meg a Success üzenetet. Amikor az ADB a Success üzenetet adja, az alkalmazás telepítve van a Beam Pro-n.
Akkor lépjen tovább a 12. lépésre, ha: az APK telepítése Success üzenettel zárul a számítógépen.:
12. lépés: A One Pro csatlakoztatása a Beam Pro-hoz és az alkalmazás megnyitása
Az androidos alkalmazás már a Beam Pro-n van. Csak most helyezze át az USB-C-kapcsolatot a számítógépről a szemüvegre.
1. Válassza le a Beam Pro-t a számítógépről.
2. Csatlakoztassa az [XREAL One Pro](https://ai.vr-expert.com/en/ai-glasses/xreal-one-pro) szemüveget a Beam Pro-hoz. Használja az XREAL USB-C kábelét.
3. Nyissa meg a MyGlasses alkalmazást a Beam Pro-n. Ez az az XREAL-környezet, amellyel a csatlakoztatott szemüveg kezelhető, és az XREAL 3D-alkalmazások elindíthatók.
4. Keresse meg az alkalmazását a MyGlassesben. A Player Settingsben megadott Product Name néven szerepel, nem az APK-fájl nevén. Jelölje ki, és nyissa meg. Ha nem látható, vagy a MyGlasses azt jelzi, hogy az alkalmazás nem támogatott ezen az eszközön, leválasztott szemüveg mellett koppintson tízszer a MyGlasses bal felső sarkában lévő szemüveg ikonra a fejlesztői mód megnyitásához, majd a „select other MR App” lehetőséggel válassza ki.
5. Ha a rendszer kéri, hagyja jóvá az engedélyeket.
6. Nézzen bele a One Pro-ba. A HelloMR jelenetnek most meg kell jelennie a szemüvegben, miközben a Beam Pro futtatja az alkalmazást.
13. lépés: Az első kis egyedi módosítás
Ha a változatlan HelloMR minta működik, térjen vissza a Unitybe, és változtasson meg egy dolgot. Így nem kell a saját kódját hibakeresnie, mielőtt az alapvető XREAL-beállítás működése igazolódott volna.
1. Térjen vissza a Unitybe a számítógépen. Nyissa meg a HelloMR jelenetet. Nyissa meg a Scene lapot. Itt építheti fel a felületet, és helyezheti el azokat az objektumokat, amelyek az XREAL One Pro szemüvegen keresztül jelennek meg.
2. Adjon hozzá egy Cube objektumot. Válassza a GameObject > 3D Object > Cube menüpontot, és helyezze el körülbelül egy méterre a kamera előtt. A szövegek, gombok, panelek és importált modellek később ugyanígy adhatók hozzá. (A HelloMR nem tartalmaz Cube objektumot; az XREAL mintája a saját logóobjektumát jeleníti meg, ezért a 6. és 7. pontban szereplő Cube-ot itt kell létrehozni.)
3. Jelöljön ki egy objektumot a Hierarchy panelen. Az Inspectorban módosíthatja a pozícióját, méretét, elforgatását és egyéb beállításait.
4. Alakítsa ki az alkalmazás elrendezését. Építse fel a projekthez szükséges felületet, például utasításokat, termékmodellt, állapotpanelt vagy egy Start Inspection gombot.
5. C#-kódot csak akkor adjon hozzá, ha egyedi viselkedésre van szükség. Az objektumok elhelyezéséhez és megtervezéséhez nincs szükség kódra. Csak akkor hozzon létre szkriptet az Assets > Scripts alatt, ha egy objektumnak mozognia kell, reagálnia kell a bemenetre, információt kell módosítania vagy külső adatokhoz kell kapcsolódnia.
Ez az opcionális szkript például forgatja az objektumot:
using UnityEngine;
public class SpinObject : MonoBehaviour
{
public float speed = 30f;
void Update()
{
transform.Rotate(0f, speed * Time.deltaTime, 0f);
}
}
6. Csatolja a szkriptet a Cube objektumhoz. Húzza a SpinObject szkriptet az Assets > Scripts mappából a Hierarchy panelen lévő Cube-ra.
7. Buildelje és telepítse újra. Ismételje meg a 10–12. lépést. A Cube-nak forognia kell, amikor az alkalmazás a Beam Pro-n fut, és a One Pro-n keresztül jelenik meg.
Mit mutat ez: az egyedi C#-kódot a Beam Pro-n futó androidos alkalmazás hajtja végre. A szemüveg megjeleníti az eredményt.
Ha a Beam Pro helyett androidos telefont szeretne használni
Ugyanaz az általános architektúra érvényes, de a gazdaeszköz egy támogatott androidos telefon lesz. Ezen az úton nem a MyGlassest használja.
· Az XREAL által jóváhagyott telefont használjon. Az SDK 3.1.0 a Samsung Galaxy S25-öt Android 15-tel tünteti fel; az XREAL kompatibilitási oldala a Galaxy S24-et is felsorolja Android 14-gyel, és kijelenti, hogy csak a Samsung csúcsmodelleket támogatja. Vásárlás vagy frissítés előtt ellenőrizze a telefon Android-verzióját: az XREAL arra kéri a fejlesztőket, hogy a fejlesztői eszközöket ne frissítsék Android 16-ra, a Samsung pedig 2025 szeptembere óta mindkét modellre kiadta az Android 16-ot (One UI 8). Fejlesztés közben kapcsolja ki a Samsung DeX-et.
· Az APK-t a Beam Pro helyett a telefonra telepítse.
· Csatlakoztassa az XREAL One Pro szemüveget USB-C-n keresztül a telefonhoz.
· Nyissa meg a ControlGlasses alkalmazást, keresse meg a telepített XREAL-alkalmazást, és indítsa el.
Ne keverje a két utat: a Beam Pro a MyGlassest használja. A támogatott androidos telefon a ControlGlassest használja.
Gyakori fejlesztési hibák
- Az APK szemüvegre telepítésének kísérlete: Telepítse a Beam Pro-ra vagy a támogatott androidos telefonra.
- Azt hinni, hogy a Beam Pro egy alkalmazás: A Beam Pro különálló fizikai hardver. A MyGlasses az az XREAL-alkalmazás, amelyet a Beam Pro-n használnak.
- A MyGlasses használata hagyományos androidos telefonon: Telefonos fejlesztésnél helyette a ControlGlasses használatos.
- Egyedi kóddal kezdeni, mielőtt a HelloMR működne: Először a módosítatlan mintát futtassa, utána szabja testre.
- A Beam Pro számítógéphez csatlakoztatva hagyása, miközben a szemüveget próbálja használni: Az APK telepítése után válassza le a Beam Pro-t a számítógépről, és csatlakoztassa a One Pro-t a Beam Pro-hoz.
Összegzés
Az XREAL One Pro eszközre történő fejlesztés a rendszer három részének szétválasztásával kezdődik: a számítógépen jön létre a Unity-projekt, a Beam Pro-n vagy egy támogatott androidos telefonon fut ténylegesen az androidos APK, az XREAL One Pro pedig a viselhető kijelző és követőeszköz. A legegyértelműbb útként a Beam Pro-t használva először állítsa be a fizikai Beam Pro-t, telepítse a számítógépre a Unity Hubot és egy támogatott Unity Editort, töltse le és importálja az XREAL SDK-t, engedélyezze az XREAL beépülő modult, nyissa meg a HelloMR mintát, buildeljen APK-t, telepítse ezt az APK-t az ADB-vel a Beam Pro-ra, majd válassza le a Beam Pro-t a számítógépről, csatlakoztassa a One Pro-t, és indítsa el az alkalmazást a MyGlassesen keresztül. A vállalatok számára ennek az architektúrának a fejlesztés megkezdése előtti megértése segít meghatározni a megfelelő hardver-, biztonsági és telepítési tervet, megkönnyíti a pilotprojektek hibaelhárítását, és megakadályozza, hogy a csapatok egy olyan önálló szemüveges modellre fejlesszenek, amelyet a One Pro nem használ.
Egy XREAL One Pro-alkalmazást tervez? Kezdje egy Beam Pro-val, egy One Pro-val és a HelloMR mintával, először igazolja a gazdaeszköz–szemüveg munkafolyamat működését, majd csak az üzleti felhasználási esethez szükséges Unity-funkciókat adja hozzá.

























