Vývoj pre XREAL One Pro: aplikácia beží na hostiteľskom zariadení, nie na okuliaroch

Vývoj pre XREAL One Pro: aplikácia beží na hostiteľskom zariadení, nie na okuliaroch

Zhrnutie

XREAL One Pro samotnú vlastnú aplikáciu nespúšťa. Aplikácia sa vytvára v Unity na počítači, inštaluje sa ako Android APK do XREAL Beam Pro alebo iného podporovaného hostiteľského zariadenia s Androidom a potom sa zobrazuje prostredníctvom okuliarov One Pro. Tento model s hostiteľským zariadením je to hlavné, čo musia vývojári pochopiť skôr, než začnú.

Nastavenie má jasný postup: pripravte Beam Pro, nainštalujte Unity s podporou Androidu, pridajte XREAL SDK, otvorte a otestujte ukážku HelloMR, zostavte APK, nainštalujte ho do Beam Pro pomocou ADB, pripojte One Pro a spustite aplikáciu cez MyGlasses. Pre firmy táto architektúra uľahčuje vývoj a testovanie vlastných pracovných postupov s XREAL pomocou známych nástrojov Android a Unity, pričom aplikačná logika zostáva na samostatnom hostiteľskom zariadení, ktoré možno spravovať, aktualizovať a integrovať s existujúcimi firemnými systémami.

Chyba, ktorej sa treba vyhnúť: neplánujte projekt, v ktorom sa APK inštaluje priamo do [XREAL One Pro](https://ai.vr-expert.com/en/ai-glasses/xreal-one-pro). APK sa inštaluje do hostiteľského zariadenia s Androidom.

Čo je XREAL One Pro?

XREAL One Pro je AR displej pripájaný káblom so zorným poľom 57 stupňov, displejmi Sony Micro-OLED a čipom XREAL X1 na priestorové spracovanie. Čip X1 zabezpečuje natívne 3DoF, takže obraz zostáva na mieste, keď otočíte hlavu, a od SDK 3.1.0 podporuje séria One po aktualizácii firmvéru aj sledovanie hlavy v 6DoF s voliteľnou kamerou XREAL Eye. Nič z toho však z okuliarov nerobí samostatný počítač s Androidom.

Pri vývoji vlastných aplikácií s XREAL SDK obsluhuje aplikáciu pripojené hostiteľské zariadenie s Androidom. One Pro je nositeľný displej a koncový bod sledovania pohybu.

Pozrite si produktovú stránku XREAL One Pro na VR Expert AI

Čo budete k tomuto návodu potrebovať

· Počítač so systémom Windows alebo macOS.

· XREAL One Pro.

· XREAL Beam Pro alebo vlajkový telefón Samsung, ktorý XREAL otestoval: Galaxy S24 s Androidom 14 alebo Galaxy S25 s Androidom 15. XREAL podporuje iba vlajkové modely Samsung a žiada vývojárov, aby nepoužívali telefóny aktualizované na Android 16, kým platí jeho upozornenie o kompatibilite. V hlavných krokoch sa ako hostiteľské zariadenie používa Beam Pro.

· Kábel USB-C na pripojenie One Pro k Beam Pro.

· Unity Hub a podporovaná verzia Unity LTS s modulom Android Build Support. (Postup v článku)

· Aktuálne XREAL SDK pre Unity zo stránky na stiahnutie pre vývojárov XREAL. (Postup v článku)

· Android Debug Bridge (ADB) na inštaláciu APK do Beam Pro. (Postup v článku)

Ako vyvinúť prvú aplikáciu pre XREAL One Pro

Krok 1: Pripravte Beam Pro – zariadenie, na ktorom bude aplikácia bežať

Začnite s Beam Pro, pretože práve doň sa nainštaluje hotová aplikácia pre Android. Beam Pro je fyzické vreckové zariadenie, nie niečo, čo si stiahnete.

1. Zaobstarajte si XREAL Beam Pro. Kúpte hardvér Beam Pro od spoločnosti XREAL alebo od autorizovaného predajcu. Ide o samostatné zariadenie, oddelené od okuliarov One Pro.

2. Zapnite ho a pripojte k Wi-Fi. Dokončite na Beam Pro bežné úvodné nastavenie systému Android/nebulaOS.

3. Otvorte na Beam Pro aplikáciu MyGlasses. MyGlasses je aplikácia XREAL na správu okuliarov, ktorá sa používa na Beam Pro.

4. Ak sa zobrazí výzva, aktualizujte Beam Pro aj MyGlasses. SDK 3.1.0 patrí k MyGlasses 1.11.0. Podľa poznámok k vydaniu od XREAL treba najprv aktualizovať MyGlasses a potom pripojiť okuliare, čím sa automaticky spustí aktualizácia ich firmvéru. Beam Pro používa nebulaOS postavený na Androide 14, takže upozornenie XREAL týkajúce sa Androidu 16 sa vzťahuje na telefóny, nie na Beam Pro.

5. Raz pripojte One Pro k Beam Pro. Použite kábel USB-C od okuliarov. Ak sa zobrazí aktualizácia firmvéru okuliarov, dokončite ju pred začatím vývoja.

****

Krok 2: Nainštalujte Unity Hub do vývojového počítača

1. Otvorte na počítači webovú stránku Unity. Stiahnite si Unity Hub pre Windows alebo macOS.

2. Nainštalujte a otvorte Unity Hub. Unity Hub je samostatný desktopový program, pomocou ktorého sa inštaluje Unity Editor.

3. Ak sa zobrazí výzva, prihláste sa alebo si vytvorte účet Unity. Unity Hub tak získa prístup k inštalácii editora a k procesu licencovania

Krok 3: Nainštalujte verziu Unity Editora s podporou Androidu

XREAL SDK beží v rámci Unity, preto musí byť Unity Editor nainštalovaný skôr, než SDK naimportujete.

1. Otvorte Unity Hub > Installs. Vyberte Install Editor.

2. Zvoľte podporovanú verziu LTS. XREAL podporuje Unity 2021.3.X, 2022.3.X a 6000.0.X LTS. Použite podporovanú verziu uvedenú v aktuálnej dokumentácii XREAL.

3. Vyberte Android Build Support. XREAL vyžaduje minimálne Android SDK s úrovňou API 31 (Android 12) alebo vyššou, čo pribalené SDK spĺňa.

4. Dokončite inštaláciu. Počkajte, kým Unity Hub nezobrazí editor v časti Installs.

Na krok 4 prejdite, keď: je Unity Editor nainštalovaný vrátane Android Build Support.

Krok 4: Stiahnite XREAL SDK do počítača

XREAL SDK je súbor, ktorý sa neskôr importuje do Unity. Nepokúšajte sa ho inštalovať do Beam Pro ani do okuliarov.

1. Otvorte stránku XREAL Developer Download. Na vývojovom počítači prejdite na developer.xreal.com/download.

2. Nájdite XREAL SDK for Unity. Prijmite podmienky XREAL API a stiahnite aktuálne SDK.

3. Stiahnutý súbor si uschovajte. Balík sa dodáva ako súbor, napríklad com.xreal.xr.tar.gz.

Na krok 5 prejdite, keď: je súbor XREAL SDK uložený v počítači. Súbor tar.gz neotvárajte ručne.

Krok 5: Vytvorte projekt v Unity

Teraz v Unity Hub vytvorte projekt, z ktorého sa neskôr stane aplikácia pre Android nainštalovaná do Beam Pro.

1. Otvorte Unity Hub > Projects. Vyberte New project.

2. Zvoľte bežnú 3D šablónu. Dajte projektu jednoduchý názov, napríklad XREAL-One-Pro-Test, a vyberte, kam ho uložiť.

3. Vytvorte projekt. Počkajte, kým sa otvorí Unity Editor.

4. Prepnite projekt na Android. V Unity Editore otvorte File > Build Settings. Vyberte Android a kliknite na Switch Platform. V Unity 6 použite File > Build Profiles, ak sa zobrazuje táto ponuka.

Na krok 6 prejdite, keď: je Android v Unity aktívnou platformou zostavenia.

Krok 6: Nainštalujte balík Unity, ktorý XREAL potrebuje

Zostaňte v Unity Editore. Ďalšie nástroje sa pridávajú do toho istého projektu.

1. Otvorte Window > Package Manager. V okne Package Manager nastavte zdroj balíkov na Unity Registry. Zobrazia sa tak balíky, ktoré poskytuje Unity.

2. Nájdite XR Interaction Toolkit. Vyberte ho a kliknite na Install. XREAL uvádza ako podporované verzie 2.5.x a 3.0.x; ak Package Manager nainštaluje novšiu verziu a ukážka sa nespráva správne, vyberte namiesto nej zo zoznamu verzií 3.0.x.

3. Otvorte jeho kartu Samples. Nájdite Starter Assets a kliknite na Import, potom importujte aj Hands Interaction Demo. Podľa stránky XREAL o riešení problémov HelloMR bez neho zobrazuje chýbajúce prefaby.

Krok 7: Importujte XREAL SDK do toho istého projektu v Unity

Stále ste v Unity. Teraz použite súbor XREAL SDK stiahnutý v kroku 4.

1. Zostaňte v okne Window > Package Manager. Kliknite na tlačidlo + v ľavej hornej časti. Potom vyberte „Add package from tarball“.

2. Nájdite súbor XREAL SDK, ktorý ste si predtým stiahli. Prejdite do priečinka Downloads, vyberte súbor s názvom podobným com.xreal.xr.tar.gz a kliknite na Open. Unity teraz do vášho projektu pridá XREAL XR Plugin.

3. V Package Manager > Samples otvorte XREAL XR Plugin. Importujte Interaction Basics. Pridá sa tak hotová ukážková scéna HelloMR, pomocou ktorej overíte, že nastavenie XREAL funguje.

Krok 8: Povoľte XREAL v projekte

SDK je už v projekte, no Unity ešte musí vedieť, že tento projekt pre Android má používať plug-in XREAL.

1. Otvorte Edit > Project Settings > XR Plug-in Management. Vyberte kartu Android.

2. Zaškrtnite XREAL. Tým sa pre zostavenie pre Android povolí poskytovateľ XREAL XR.

3. Otvorte Project Validation. Pri všetkých požadovaných zmenách pre XREAL kliknite na Fix All.

4. Otvorte XR Plug-in Management > XREAL. Pri One Pro bez XREAL Eye nastavte Initial Tracking Type na MODE_3DOF, Initial Input Source na Controller (Beam Pro alebo telefón slúži ako ovládač s 3DoF) a Support Devices na XREAL_DEVICE_CATEGORY_VISION, čo je kategória XREAL pre okuliare s 3DoF, ako je séria One. Všetko ostatné nechajte v predvolenom nastavení, kým ukážka nebude fungovať.

Na krok 9 prejdite, keď: Project Validation už nezobrazuje žiadne nevyriešené požadované nastavenia XREAL.

Krok 9: Otvorte ukážku HelloMR od XREAL

Skôr než začnete písať vlastnú aplikáciu, použite ukážku od XREAL. Overíte tak, že Unity, XREAL SDK, Beam Pro a okuliare dokážu spolupracovať.

1. Otvorte v Unity panel Project. Prejdite do Assets > Samples > XREAL XR Plugin > [vaša verzia SDK] > Interaction Basics.

2. Nájdite HelloMR.unity. Scénu otvorte dvojitým kliknutím.

3. Zatiaľ ju neupravujte. Najprv zostavte nezmenenú ukážku, aby ste vedeli, že vývojové prostredie funguje.

Krok 10: Zostavte Android APK na počítači

Unity teraz z projektu HelloMR vytvorí súbor aplikácie pre Android. Tento súbor sa nazýva APK.

1. Otvorte File > Build Settings alebo Build Profiles. Vyberte Add Open Scenes, aby bola zahrnutá scéna HelloMR.

2. Overte, že je aktívny Android. Ak nie je, prepnite na Android.

3. Kliknite na Build. Nastavte Player Settings a potom zostavte. V Player Settings vyplňte Company Name a Product Name (MyGlasses zobrazuje Product Name, preto použite XREAL-HelloMR) a skontrolujte, že Scripting Backend je IL2CPP a cieľová architektúra ARM64; XREAL vyžaduje oboje. Potom kliknite na Build, vyberte priečinok v počítači a uložte súbor ako XREAL-HelloMR.apk

4. Počkajte na dokončenie zostavenia. APK teraz existuje v počítači, ale v Beam Pro ešte nie je.

Čo je APK: APK je súbor, ktorý sa používa na inštaláciu aplikácie pre Android. V tomto postupe sa APK inštaluje do Beam Pro, nie do [XREAL One Pro](https://ai.vr-expert.com/en/ai-glasses/xreal-one-pro).

Krok 11: Nainštalujte APK do Beam Pro

ADB: Android Debug Bridge, počítačový nástroj na inštaláciu a testovanie aplikácií pre Android na Beam Pro alebo telefóne.

Aplikácia je zostavená. V ďalšom kroku presuniete APK z počítača do Beam Pro.

1. Pripojte Beam Pro k počítaču cez USB-C.

2. Na počítači otvorte Terminál alebo PowerShell.

3. Zapnite na Beam Pro ladenie cez USB. Návod XREAL uvádza len to, že na hostiteľskom zariadení treba zapnúť Možnosti pre vývojárov a ladenie cez USB; v Androide to znamená sedemkrát ťuknúť na „Číslo zostavy“ v časti „Informácie o zariadení“, čím sa odomknú Možnosti pre vývojárov, a tam zapnúť ladenie cez USB. Ak Beam Pro zobrazí správu s otázkou, či povoliť ladenie cez USB z tohto počítača, vyberte Povoliť.

4. Overte, že počítač vidí Beam Pro. V PowerShelli zadajte:

adb devices

Beam Pro sa zobrazí ako device – pripojenie funguje a môžete pokračovať.

5. Nainštalujte APK. Najprv nájdite v počítači súbor XREAL-HelloMR.apk. Ak ste ho napríklad uložili do priečinka XREAL Test na ploche, cesta vo Windows môže vyzerať takto:

C:\Users\YourName\Desktop\XREAL Test\XREAL-HelloMR.apk

V PowerShelli zadajte:

adb install -r "C:\Users\YourName\Desktop\XREAL Test\XREAL-HelloMR.apk"

Nahraďte vzorovú cestu skutočným umiestnením vášho APK a potom stlačte Enter.

6. Počkajte na hlásenie Success. Keď ADB ohlási Success, aplikácia je nainštalovaná v Beam Pro.

Na krok 12 prejdite, keď: inštalácia APK ohlási na počítači Success.

Krok 12: Pripojte One Pro k Beam Pro a otvorte aplikáciu

Aplikácia pre Android je teraz v Beam Pro. Až teraz presuňte pripojenie USB-C z počítača na okuliare.

1. Odpojte Beam Pro od počítača.

2. Pripojte [XREAL One Pro](https://ai.vr-expert.com/en/ai-glasses/xreal-one-pro) k Beam Pro. Použite kábel USB-C od XREAL.

3. Otvorte na Beam Pro aplikáciu MyGlasses. Ide o prostredie XREAL, ktoré slúži na správu pripojených okuliarov a spúšťanie 3D aplikácií XREAL.

4. Nájdite svoju aplikáciu v MyGlasses. Je uvedená pod názvom Product Name z Player Settings, nie pod názvom súboru APK. Vyberte ju a otvorte. Ak chýba alebo MyGlasses hlási, že aplikácia nie je na tomto zariadení podporovaná, pri odpojených okuliaroch desaťkrát ťuknite na ikonu okuliarov v ľavom hornom rohu MyGlasses, čím otvoríte režim pre vývojárov, a potom ju vyberte pomocou možnosti „select other MR App“.

5. Ak sa zobrazí výzva, udeľte povolenia.

6. Pozrite sa cez One Pro. Scéna HelloMR by sa teraz mala zobraziť v okuliaroch, zatiaľ čo aplikáciu spúšťa Beam Pro.

Krok 13: Urobte prvú malú vlastnú zmenu

Keď nezmenená ukážka HelloMR funguje, vráťte sa do Unity a zmeňte jednu vec. Vyhnete sa tak ladeniu vlastného kódu skôr, než sa overí, že základné nastavenie XREAL funguje.

1. Vráťte sa na počítači do Unity. Otvorte scénu HelloMR. Otvorte kartu Scene. Tu môžete vytvárať rozhranie a umiestňovať objekty, ktoré sa zobrazia prostredníctvom XREAL One Pro.

2. Pridajte kocku (Cube). Zvoľte GameObject > 3D Object > Cube a umiestnite ju asi meter pred kameru. Text, tlačidlá, panely a importované modely sa neskôr pridávajú rovnako. (HelloMR kocku neobsahuje; ukážka XREAL zobrazuje objekt s logom, preto kocku z bodov 6 a 7 treba vytvoriť tu.)

3. Vyberte objekt v okne Hierarchy. V okne Inspector meňte jeho polohu, veľkosť, otočenie a ďalšie nastavenia.

4. Usporiadajte rozloženie aplikácie. Vytvorte rozhranie, ktoré projekt potrebuje, napríklad pokyny, model produktu, stavový panel alebo tlačidlo Start Inspection.

5. Kód v C# pridajte, len keď potrebujete vlastné správanie. Na samotné umiestnenie a návrh objektov kód nie je potrebný. Skript v Assets > Scripts vytvorte, len keď sa má objekt pohybovať, reagovať na vstup, meniť informácie alebo sa pripájať k externým dátam.

Tento voliteľný skript napríklad roztočí objekt:

using UnityEngine;

public class SpinObject : MonoBehaviour

{

public float speed = 30f;

void Update()

{

transform.Rotate(0f, speed * Time.deltaTime, 0f);

}

}

6. Pripojte skript ku kocke. Presuňte SpinObject z Assets > Scripts na objekt Cube v okne Hierarchy.

7. Znova zostavte a nainštalujte. Zopakujte kroky 10 až 12. Kocka by sa mala otáčať, keď aplikácia beží na Beam Pro a zobrazuje sa cez One Pro.

Čo to ukazuje: váš vlastný kód v C# vykonáva aplikácia pre Android na Beam Pro. Okuliare zobrazujú výsledok.

Ak chcete namiesto Beam Pro použiť telefón s Androidom

Platí rovnaká celková architektúra, no hostiteľským zariadením je podporovaný telefón s Androidom. Pri tomto postupe sa MyGlasses nepoužíva.

· Použite telefón schválený spoločnosťou XREAL. SDK 3.1.0 uvádza Samsung Galaxy S25 s Androidom 15; stránka XREAL o kompatibilite uvádza aj Galaxy S24 s Androidom 14 a uvádza, že podporované sú iba vlajkové modely Samsung. Pred kúpou alebo aktualizáciou skontrolujte verziu Androidu v telefóne: XREAL žiada vývojárov, aby vývojové zariadenia neaktualizovali na Android 16, a Samsung od septembra 2025 distribuuje Android 16 (One UI 8) pre oba modely. Počas vývoja vypnite Samsung DeX.

· APK nainštalujte do telefónu namiesto Beam Pro.

· Pripojte XREAL One Pro k telefónu cez USB-C.

· Otvorte ControlGlasses, nájdite nainštalovanú aplikáciu XREAL a spustite ju.

Nemiešajte tieto dva postupy: Beam Pro používa MyGlasses. Podporovaný telefón s Androidom používa ControlGlasses.

Časté chyby pri vývoji

  • Pokus nainštalovať APK do okuliarov: Nainštalujte ho do Beam Pro alebo do podporovaného telefónu s Androidom.
  • Domnienka, že Beam Pro je aplikácia: Beam Pro je samostatný fyzický hardvér. MyGlasses je aplikácia XREAL používaná na Beam Pro.
  • Používanie MyGlasses na bežnom telefóne s Androidom: Pri vývoji s telefónom sa namiesto toho používa ControlGlasses.
  • Začatie s vlastným kódom skôr, než funguje HelloMR: Najprv spustite neupravenú ukážku, až potom ju prispôsobujte.
  • Ponechanie Beam Pro pripojeného k počítaču pri pokuse použiť okuliare: Po inštalácii APK odpojte Beam Pro od počítača a pripojte One Pro k Beam Pro.

Záver

Vývoj pre XREAL One Pro sa začína rozlíšením troch častí systému: na počítači sa vytvára projekt Unity, na Beam Pro alebo podporovanom telefóne s Androidom sa Android APK skutočne spúšťa a XREAL One Pro je nositeľné zariadenie na zobrazovanie a sledovanie pohybu. Ak zvolíte Beam Pro ako najprehľadnejšiu cestu, najprv nastavte fyzické zariadenie Beam Pro, nainštalujte na počítač Unity Hub a podporovaný Unity Editor, stiahnite a importujte XREAL SDK, povoľte plug-in XREAL, otvorte ukážku HelloMR, zostavte APK, nainštalujte ho pomocou ADB do Beam Pro, potom odpojte Beam Pro od počítača, pripojte One Pro a spustite aplikáciu cez MyGlasses. Pre firmy platí, že pochopenie tejto architektúry pred začatím vývoja pomáha stanoviť správny plán hardvéru, zabezpečenia a nasadenia, uľahčuje riešenie problémov v pilotných projektoch a bráni tímom míňať čas na vývoj pre model samostatných okuliarov, ktorý One Pro nepoužíva.

Plánujete aplikáciu pre XREAL One Pro? Začnite s jedným Beam Pro, jedným One Pro a ukážkou HelloMR, najprv si overte postup od hostiteľského zariadenia k okuliarom a potom pridajte iba tie funkcie Unity, ktoré si vyžaduje daný firemný prípad použitia.

Často kladené otázky

Tento článok

Beam Pro je samostatné fyzické vreckové zariadenie založené na Androide od spoločnosti XREAL. Kupuje sa ako hardvér, nie je to aplikácia. V tomto vývojovom postupe spúšťa APK, ktorého obraz sa zobrazuje cez One Pro.

Android APK nainštalujte do Beam Pro alebo do podporovaného telefónu s Androidom. Neinštalujte ho priamo do XREAL One Pro.

MyGlasses je aplikácia XREAL na správu okuliarov, ktorá sa používa na Beam Pro. Po nainštalovaní APK pripojte One Pro k Beam Pro, otvorte MyGlasses a odtiaľ spustite aplikáciu XREAL.

ControlGlasses je sprievodná aplikácia XREAL, ktorá sa používa, keď je hostiteľským zariadením namiesto Beam Pro podporovaný telefón s Androidom. Použite verziu zodpovedajúcu vášmu SDK – pre SDK 3.1.0 je to ControlGlasses 3.1.0, na ktorú odkazujú poznámky k vydaniu SDK 3.1.0 na docs.xreal.com. Keď v ControlGlasses vyberiete aplikáciu, okuliare sa prepnú do 3D režimu a aplikácia sa automaticky spustí pri každom ich pripojení.

XREAL SDK stiahnite do vývojového počítača a importujte ho do projektu v Unity cez Window > Package Manager > Add package from tarball.

APK je inštalačný súbor aplikácie pre Android. Unity vytvorí APK na počítači a vy ho potom nainštalujete do Beam Pro alebo do telefónu.

ADB je počítačový nástroj, ktorý dokáže nainštalovať APK do hostiteľského zariadenia s Androidom a pomáha pri testovaní a ladení.

Nie. X1 zabezpečuje spracovanie pre priestorové zobrazenie, napríklad natívne 3DoF, ale vlastná aplikácia pre Android aj tak beží na hostiteľskom zariadení.

Áno, s vlajkovým telefónom Samsung, ktorý XREAL otestoval (Galaxy S24 s Androidom 14, Galaxy S25 s Androidom 15) a ktorý nebol aktualizovaný na Android 16. Pri vývoji s telefónom sa namiesto MyGlasses používa verzia ControlGlasses zodpovedajúca verzii vášho SDK.