Shrnutí
XREAL One Pro samotnou vlastní aplikaci nespouští. Aplikace se vytváří v Unity na počítači, instaluje se jako Android APK na XREAL Beam Pro nebo jiné podporované hostitelské zařízení s Androidem a teprve poté se zobrazuje prostřednictvím brýlí One Pro. Tento model s hostitelským zařízením je to hlavní, co musí vývojáři pochopit, než začnou.
Nastavení probíhá podle jasného postupu: připravte Beam Pro, nainstalujte Unity a podporu Androidu, přidejte XREAL SDK, otevřete a otestujte ukázku HelloMR, sestavte APK, nainstalujte ho na Beam Pro pomocí ADB, připojte One Pro a spusťte aplikaci přes MyGlasses. Firmám tato architektura usnadňuje vývoj a testování vlastních pracovních postupů pro XREAL pomocí známých nástrojů pro Android a Unity, přičemž aplikační logika zůstává na samostatném hostitelském zařízení, které lze spravovat, aktualizovat a integrovat se stávajícími firemními systémy.
Chyba, které se vyvarovat: Neplánujte projekt, v němž se APK instaluje přímo do [XREAL One Pro](https://ai.vr-expert.com/en/ai-glasses/xreal-one-pro). APK se instaluje na hostitelské zařízení s Androidem.
Co je XREAL One Pro?
XREAL One Pro je kabelem připojovaný AR displej se zorným polem 57 stupňů, displeji Sony Micro-OLED a čipem XREAL X1 pro prostorové zpracování. Čip X1 zajišťuje nativní 3DoF, takže obraz zůstává na místě, když otočíte hlavu, a od SDK 3.1.0 podporuje řada One po aktualizaci firmwaru také sledování hlavy v 6DoF s volitelnou kamerou XREAL Eye. Nic z toho však z brýlí nedělá samostatný počítač s Androidem.
Při vývoji vlastních aplikací s XREAL SDK obstarává aplikaci připojený hostitel s Androidem. One Pro slouží jako nositelný displej a koncový bod sledování.
Co budete k tomuto návodu potřebovat
· Počítač s Windows nebo macOS.
· XREAL Beam Pro nebo vlajkový telefon Samsung, který XREAL otestoval: Galaxy S24 s Androidem 14 nebo Galaxy S25 s Androidem 15. XREAL podporuje pouze vlajkové modely Samsung a žádá vývojáře, aby nepoužívali telefony aktualizované na Android 16, dokud platí jeho upozornění o kompatibilitě. V hlavních krocích se jako hostitel používá Beam Pro.
· Kabel USB-C k propojení One Pro s Beam Pro.
· Unity Hub a podporovaná verze Unity LTS s modulem Android Build Support. (Návod v článku)
· Aktuální XREAL SDK pro Unity ze stránky XREAL pro stahování pro vývojáře. (Návod v článku)
· Android Debug Bridge (ADB) k instalaci APK na Beam Pro. (Návod v článku)
Jak vyvinout svou první aplikaci pro XREAL One Pro
Krok 1: Připravte Beam Pro – zařízení, na kterém bude aplikace běžet
Začněte s Beam Pro, protože právě na něj se nainstaluje hotová aplikace pro Android. Beam Pro je fyzické kapesní zařízení, ne něco, co si stáhnete.
1. Pořiďte si XREAL Beam Pro. Kupte hardware Beam Pro od společnosti XREAL nebo od autorizovaného prodejce. Jde o samostatné zařízení, oddělené od brýlí One Pro.
2. Zapněte ho a připojte k Wi-Fi. Dokončete na Beam Pro běžné úvodní nastavení systému Android/nebulaOS.
3. Otevřete na Beam Pro aplikaci MyGlasses. MyGlasses je aplikace XREAL pro správu brýlí, která se používá na Beam Pro.
4. Pokud k tomu budete vyzváni, aktualizujte Beam Pro a MyGlasses. K SDK 3.1.0 patří MyGlasses 1.11.0. Podle poznámek k vydání od XREAL je třeba nejprve aktualizovat MyGlasses a poté připojit brýle, čímž se automaticky spustí aktualizace jejich firmwaru. Beam Pro používá nebulaOS na Androidu 14, takže varování XREAL ohledně Androidu 16 se týká telefonů, nikoli Beam Pro.
5. Jednou připojte One Pro k Beam Pro. Použijte kabel USB-C od brýlí. Pokud se objeví aktualizace firmwaru brýlí, dokončete ji před zahájením vývoje.
****
Krok 2: Nainstalujte Unity Hub na vývojový počítač
1. Otevřete na počítači web Unity. Stáhněte Unity Hub pro Windows nebo macOS.
2. Nainstalujte a otevřete Unity Hub. Unity Hub je samostatný desktopový program, který slouží k instalaci Unity Editoru.
3. Pokud budete vyzváni, přihlaste se nebo si vytvořte účet Unity. Unity Hub tak získá přístup k instalaci editoru a k procesu licencování
Krok 3: Nainstalujte verzi Unity Editoru s podporou Androidu
XREAL SDK běží uvnitř Unity, takže před importem SDK musí být nainstalovaný Unity Editor.
1. Otevřete Unity Hub > Installs. Vyberte Install Editor.
2. Zvolte podporovanou verzi LTS. XREAL podporuje Unity 2021.3.X, 2022.3.X a 6000.0.X LTS. Použijte podporovanou verzi uvedenou v aktuální dokumentaci XREAL.
3. Vyberte Android Build Support. XREAL vyžaduje minimálně Android SDK s úrovní API 31 (Android 12) nebo vyšší, což přibalené SDK splňuje.
4. Dokončete instalaci. Počkejte, až Unity Hub zobrazí editor v části Installs.
Na krok 4 přejděte, až: bude Unity Editor nainstalovaný včetně Android Build Support.
Krok 4: Stáhněte XREAL SDK do počítače
XREAL SDK je soubor, který se později importuje do Unity. Nepokoušejte se ho instalovat na Beam Pro ani do brýlí.
1. Otevřete stránku XREAL Developer Download. Na vývojovém počítači přejděte na developer.xreal.com/download.
2. Najděte XREAL SDK for Unity. Přijměte podmínky XREAL API a stáhněte aktuální SDK.
3. Stažený soubor si uschovejte. Balíček se dodává jako soubor, například com.xreal.xr.tar.gz.
Na krok 5 přejděte, až: bude soubor XREAL SDK uložený v počítači. Soubor tar.gz ručně neotevírejte.
Krok 5: Vytvořte projekt v Unity
Nyní pomocí Unity Hub vytvořte projekt, ze kterého se později stane aplikace pro Android nainstalovaná na Beam Pro.
1. Otevřete Unity Hub > Projects. Vyberte New project.
2. Zvolte běžnou 3D šablonu. Pojmenujte projekt jednoduše, například XREAL-One-Pro-Test, a vyberte, kam ho uložit.
3. Vytvořte projekt. Počkejte, až se otevře Unity Editor.
4. Přepněte projekt na Android. V Unity Editoru otevřete File > Build Settings. Vyberte Android a klikněte na Switch Platform. V Unity 6 použijte File > Build Profiles, pokud se zobrazuje tato nabídka.
Na krok 6 přejděte, až: bude Android v Unity aktivní platformou pro sestavení.
Krok 6: Nainstalujte balíček Unity, který XREAL potřebuje
Zůstaňte v Unity Editoru. Další nástroje se přidávají do téhož projektu.
1. Otevřete Window > Package Manager. V okně Package Manager nastavte zdroj balíčků na Unity Registry. Zobrazí se balíčky poskytované společností Unity.
2. Najděte XR Interaction Toolkit. Vyberte ho a klikněte na Install. XREAL uvádí jako podporované verze 2.5.x a 3.0.x; pokud Package Manager nainstaluje novější verzi a ukázka nefunguje správně, vyberte místo ní ze seznamu verzí 3.0.x.
3. Otevřete jeho kartu Samples. Najděte Starter Assets a klikněte na Import, poté importujte také Hands Interaction Demo. Podle stránky XREAL pro řešení potíží HelloMR bez něj hlásí chybějící prefaby.
Krok 7: Importujte XREAL SDK do stejného projektu Unity
Stále jste v Unity. Nyní použijte soubor XREAL SDK stažený v kroku 4.
1. Zůstaňte ve Window > Package Manager. Klikněte na tlačítko + v levé horní části. Poté vyberte „Add package from tarball“.
2. Najděte soubor XREAL SDK, který jste si dříve stáhli. Přejděte do složky Stažené soubory, vyberte soubor s názvem podobným com.xreal.xr.tar.gz a klikněte na Otevřít. Unity nyní přidá XREAL XR Plugin do vašeho projektu.
3. V Package Manager > Samples otevřete XREAL XR Plugin. Importujte Interaction Basics. Tím se přidá připravená ukázková scéna HelloMR, pomocí které ověříte, že nastavení XREAL funguje.
Krok 8: Povolte XREAL v projektu
SDK je k dispozici, ale Unity se ještě musí dozvědět, že tento projekt pro Android má používat plug-in XREAL.
1. Otevřete Edit > Project Settings > XR Plug-in Management. Vyberte kartu Android.
2. Zaškrtněte XREAL. Tím se pro sestavení pro Android povolí poskytovatel XREAL XR.
3. Otevřete Project Validation. U všech požadovaných změn XREAL klikněte na Fix All.
4. Otevřete XR Plug-in Management > XREAL. U One Pro bez XREAL Eye nastavte Initial Tracking Type na MODE_3DOF, Initial Input Source na Controller (Beam Pro nebo telefon funguje jako 3DoF ovladač) a Support Devices na XREAL_DEVICE_CATEGORY_VISION, což je kategorie XREAL pro 3DoF brýle, jako je řada One. Vše ostatní ponechte ve výchozím nastavení, dokud ukázka nebude fungovat.
Na krok 9 přejděte, až: Project Validation už nebude zobrazovat žádná nevyřešená požadovaná nastavení XREAL.
Krok 9: Otevřete ukázku HelloMR od XREAL
Než začnete psát vlastní aplikaci, použijte ukázku od XREAL. Ověříte tak, že Unity, XREAL SDK, Beam Pro a brýle dokážou spolupracovat.
1. Otevřete v Unity panel Project. Přejděte do Assets > Samples > XREAL XR Plugin > [vaše verze SDK] > Interaction Basics.
2. Najděte HelloMR.unity. Dvojitým kliknutím scénu otevřete.
3. Zatím ji neupravujte. Nejprve sestavte nezměněnou ukázku, abyste věděli, že vývojové prostředí funguje.
Krok 10: Sestavte na počítači Android APK
Unity nyní z projektu HelloMR vytvoří soubor aplikace pro Android. Tento soubor se nazývá APK.
1. Otevřete File > Build Settings nebo Build Profiles. Vyberte Add Open Scenes, aby byla scéna HelloMR zahrnuta.
2. Ověřte, že je aktivní Android. Pokud není, přepněte na Android.
3. Klikněte na Build. Nastavte Player Settings a poté sestavte. V Player Settings vyplňte Company Name a Product Name (MyGlasses zobrazuje Product Name, proto použijte XREAL-HelloMR) a zkontrolujte, že Scripting Backend je IL2CPP a cílová architektura ARM64; XREAL vyžaduje obojí. Poté klikněte na Build, vyberte složku v počítači a uložte soubor jako XREAL-HelloMR.apk
4. Počkejte na dokončení sestavení. APK je nyní v počítači, ale na Beam Pro ještě není.
Co je APK: APK je soubor, který slouží k instalaci aplikace pro Android. V tomto postupu se APK instaluje na Beam Pro, nikoli do [XREAL One Pro](https://ai.vr-expert.com/en/ai-glasses/xreal-one-pro).
Krok 11: Nainstalujte APK na Beam Pro
ADB: Android Debug Bridge, počítačový nástroj pro instalaci a testování aplikací pro Android na Beam Pro nebo v telefonu.
Aplikace je sestavená. Dalším krokem je přenést APK z počítače na Beam Pro.
1. Připojte Beam Pro k počítači kabelem USB-C.
2. Otevřete na počítači Terminál nebo PowerShell.
3. Povolte na Beam Pro ladění přes USB. Návod XREAL uvádí pouze to, že je na hostiteli třeba povolit Možnosti pro vývojáře a ladění přes USB; v Androidu to znamená sedmkrát klepnout na „Číslo sestavení“ v části „O zařízení“, čímž se odemknou Možnosti pro vývojáře, a poté v nich zapnout ladění přes USB. Pokud Beam Pro zobrazí zprávu s dotazem, zda povolit ladění přes USB z tohoto počítače, vyberte Povolit.
4. Zkontrolujte, že počítač Beam Pro vidí. V PowerShellu zadejte:
adb devices
Pokud se Beam Pro zobrazí jako device, připojení funguje a můžete pokračovat.
5. Nainstalujte APK. Nejprve v počítači najděte soubor XREAL-HelloMR.apk. Pokud jste ho například uložili do složky s názvem XREAL Test na ploše, cesta ve Windows může vypadat takto:
C:\Users\YourName\Desktop\XREAL Test\XREAL-HelloMR.apk
V PowerShellu zadejte:
adb install -r "C:\Users\YourName\Desktop\XREAL Test\XREAL-HelloMR.apk"
Nahraďte ukázkovou cestu skutečným umístěním vašeho APK a poté stiskněte Enter.
6. Počkejte na Success. Jakmile ADB ohlásí Success, je aplikace na Beam Pro nainstalovaná.
Na krok 12 přejděte, až: instalace APK na počítači ohlásí Success.:
Krok 12: Připojte One Pro k Beam Pro a otevřete aplikaci
Aplikace pro Android je nyní na Beam Pro. Teprve teď přepojte USB-C z počítače na brýle.
1. Odpojte Beam Pro od počítače.
2. Připojte [XREAL One Pro](https://ai.vr-expert.com/en/ai-glasses/xreal-one-pro) k Beam Pro. Použijte kabel XREAL USB-C.
3. Otevřete na Beam Pro aplikaci MyGlasses. Jde o prostředí XREAL, které slouží ke správě připojených brýlí a ke spouštění 3D aplikací XREAL.
4. Najděte svou aplikaci v MyGlasses. Je uvedena pod názvem Product Name z Player Settings, nikoli pod názvem souboru APK. Vyberte ji a otevřete. Pokud chybí nebo MyGlasses hlásí, že aplikace není na tomto zařízení podporována, klepněte s odpojenými brýlemi desetkrát na ikonu brýlí v levém horním rohu MyGlasses, čímž otevřete vývojářský režim, a poté ji vyberte pomocí volby „select other MR App“.
5. Pokud budete požádáni, schvalte oprávnění.
6. Podívejte se skrz One Pro. Scéna HelloMR by se nyní měla zobrazit v brýlích, zatímco aplikaci spouští Beam Pro.
Krok 13: Proveďte první drobnou vlastní úpravu
Jakmile nezměněná ukázka HelloMR funguje, vraťte se do Unity a změňte jednu věc. Vyhnete se tak ladění vlastního kódu dřív, než je ověřeno základní nastavení XREAL.
1. Vraťte se na počítači do Unity. Otevřete scénu HelloMR. Otevřete kartu Scene. Zde můžete vytvářet rozhraní a umisťovat objekty, které se zobrazí v XREAL One Pro.
2. Přidejte objekt Cube. Zvolte GameObject > 3D Object > Cube a umístěte ho asi metr před kameru. Text, tlačítka, panely a importované modely se později přidávají stejným způsobem. (HelloMR objekt Cube neobsahuje; ukázka XREAL zobrazuje objekt s jeho logem, takže Cube z bodů 6 a 7 je nutné vytvořit zde.)
3. Vyberte objekt v panelu Hierarchy. V Inspectoru měňte jeho polohu, velikost, natočení a další nastavení.
4. Uspořádejte rozvržení aplikace. Vytvořte rozhraní, které projekt potřebuje, například pokyny, model produktu, stavový panel nebo tlačítko Start Inspection.
5. Kód v C# přidávejte, jen když je potřeba vlastní chování. K pouhému umístění a návrhu objektů kód není potřeba. Skript v Assets > Scripts vytvořte jen tehdy, když se má objekt pohybovat, reagovat na vstup, měnit informace nebo se připojovat k externím datům.
Tento volitelný skript například zajistí, že se objekt otáčí:
using UnityEngine;
public class SpinObject : MonoBehaviour
{
public float speed = 30f;
void Update()
{
transform.Rotate(0f, speed * Time.deltaTime, 0f);
}
}
6. Připojte skript k objektu Cube. Přetáhněte SpinObject z Assets > Scripts na Cube v panelu Hierarchy.
7. Znovu sestavte a nainstalujte. Zopakujte kroky 10 až 12. Objekt Cube by se měl otáčet, když aplikace běží na Beam Pro a zobrazuje se prostřednictvím One Pro.
Co to ukazuje: Váš vlastní kód v C# spouští aplikace pro Android na Beam Pro. Brýle zobrazují výsledek.
Pokud chcete místo Beam Pro použít telefon s Androidem
Celková architektura zůstává stejná, ale hostitelem se stává podporovaný telefon s Androidem. U tohoto postupu se MyGlasses nepoužívá.
· Použijte telefon schválený společností XREAL. SDK 3.1.0 uvádí Samsung Galaxy S25 s Androidem 15; stránka XREAL o kompatibilitě uvádí také Galaxy S24 s Androidem 14 a uvádí, že podporuje pouze vlajkové modely Samsung. Před nákupem nebo aktualizací zkontrolujte verzi Androidu v telefonu: XREAL žádá vývojáře, aby vývojová zařízení neaktualizovali na Android 16, a Samsung od září 2025 distribuuje Android 16 (One UI 8) pro oba modely. Během vývoje vypněte Samsung DeX.
· Nainstalujte APK do telefonu místo na Beam Pro.
· Připojte XREAL One Pro k telefonu kabelem USB-C.
· Otevřete ControlGlasses, najděte nainstalovanou aplikaci XREAL a spusťte ji.
Nekombinujte oba postupy: Beam Pro používá MyGlasses. Podporovaný telefon s Androidem používá ControlGlasses.
Časté chyby při vývoji
- Pokus nainstalovat APK do brýlí: Nainstalujte ho na Beam Pro nebo do podporovaného telefonu s Androidem.
- Domněnka, že Beam Pro je aplikace: Beam Pro je samostatný fyzický hardware. MyGlasses je aplikace XREAL používaná na Beam Pro.
- Používání MyGlasses na běžném telefonu s Androidem: Při vývoji na telefonu se místo toho používá ControlGlasses.
- Začínání s vlastním kódem dřív, než funguje HelloMR: Nejprve spusťte neupravenou ukázku a teprve pak ji přizpůsobujte.
- Ponechání Beam Pro připojeného k počítači při pokusu používat brýle: Po instalaci APK odpojte Beam Pro od počítače a připojte One Pro k Beam Pro.
Závěr
Vývoj pro XREAL One Pro začíná rozdělením systému na tři části: na počítači vzniká projekt v Unity, na Beam Pro nebo podporovaném telefonu s Androidem APK pro Android skutečně běží a XREAL One Pro je nositelný displej a sledovací zařízení. Pokud zvolíte Beam Pro jako nejpřehlednější cestu, nejprve nastavte fyzické zařízení Beam Pro, nainstalujte na počítač Unity Hub a podporovaný Unity Editor, stáhněte a importujte XREAL SDK, povolte plug-in XREAL, otevřete ukázku HelloMR, sestavte APK, nainstalujte ho pomocí ADB na Beam Pro, poté Beam Pro odpojte od počítače, připojte One Pro a spusťte aplikaci přes MyGlasses. Pro firmy platí, že pochopení této architektury před zahájením vývoje pomáhá stanovit správný plán hardwaru, zabezpečení a nasazení, usnadňuje řešení potíží v pilotních projektech a brání týmům ztrácet čas vývojem pro model samostatných brýlí, který One Pro nepoužívá.
Plánujete aplikaci pro XREAL One Pro? Začněte s jedním Beam Pro, jedněmi One Pro a ukázkou HelloMR, nejprve ověřte postup od hostitele k brýlím a teprve pak přidávejte jen ty funkce Unity, které konkrétní firemní případ užití vyžaduje.
