Резюме
XREAL One Pro не изпълнява самото персонализирано приложение. Приложението се създава в Unity на компютър, инсталира се като Android APK на XREAL Beam Pro или на друго поддържано Android хост устройство и след това се показва чрез очилата One Pro. Този модел с хост устройство е основното, което разработчиците трябва да разберат, преди да започнат.
Настройката следва ясен работен процес: подгответе Beam Pro, инсталирайте Unity и поддръжка за Android, добавете XREAL SDK, отворете и тествайте примера HelloMR, компилирайте APK, инсталирайте го на Beam Pro с ADB, свържете One Pro и стартирайте приложението чрез MyGlasses. За бизнеса тази архитектура улеснява разработването и тестването на персонализирани работни процеси с XREAL с познати инструменти за Android и Unity, като логиката на приложението остава на отделно хост устройство, което може да се управлява, актуализира и интегрира със съществуващите фирмени системи.
Грешката, която трябва да избегнете: Не планирайте проект, в който APK се инсталира директно на [XREAL One Pro](https://ai.vr-expert.com/en/ai-glasses/xreal-one-pro). APK се инсталира на Android хост устройството.
Какво е XREAL One Pro?
XREAL One Pro е AR дисплей с кабелна връзка, със зрително поле от 57 градуса, Micro-OLED дисплеи на Sony и чип за пространствена обработка X1 на XREAL. Чипът X1 осигурява вградена 3DoF, така че екранът остава на място, когато завъртите глава, а от SDK 3.1.0 серията One поддържа и 6DoF проследяване на главата с допълнителната камера XREAL Eye след актуализация на фърмуера. Нищо от това не прави очилата самостоятелен Android компютър.
При разработка на персонализирани приложения с XREAL SDK приложението се изпълнява от свързания Android хост. One Pro е носимият дисплей и крайната точка за проследяване.
Вижте продуктовата страница на XREAL One Pro във VR Expert AI
Какво ви е необходимо за това ръководство
· Компютър с Windows или macOS.
· XREAL Beam Pro или флагмански телефон Samsung, тестван от XREAL: Galaxy S24 с Android 14 или Galaxy S25 с Android 15. XREAL поддържа само флагмани на Samsung и моли разработчиците да не използват телефони, актуализирани до Android 16, докато е в сила съобщението му за съвместимост. Beam Pro е хостът, използван в основните стъпки.
· USB-C кабел за свързване на One Pro към Beam Pro.
· Unity Hub и поддържана LTS версия на Unity с Android Build Support. (Инструкции в статията)
· Актуалният XREAL SDK за Unity от страницата за изтегляне за разработчици на XREAL. (Инструкции в статията)
· Android Debug Bridge (ADB) за инсталиране на APK на Beam Pro. (Инструкции в статията)
Как да разработите първото си приложение за XREAL One Pro
Стъпка 1: Подгответе Beam Pro – устройството, на което ще работи приложението
Започнете с Beam Pro, защото на него ще бъде инсталирано готовото Android приложение. Beam Pro е физическо преносимо устройство, а не нещо, което се изтегля.
1. Сдобийте се с XREAL Beam Pro. Закупете хардуера Beam Pro от XREAL или от оторизиран търговец. Той е отделен от очилата One Pro.
2. Включете го и го свържете към Wi-Fi. Завършете обичайната първоначална настройка на Android/nebulaOS на Beam Pro.
3. Отворете MyGlasses на Beam Pro. MyGlasses е приложението на XREAL за управление на очилата, използвано на Beam Pro.
4. Актуализирайте Beam Pro и MyGlasses, ако бъдете подканени. SDK 3.1.0 работи в комбинация с MyGlasses 1.11.0. В бележките към изданието XREAL посочва първо да се актуализира MyGlasses и след това да се свържат очилата, което автоматично стартира актуализацията на фърмуера им. Beam Pro работи с nebulaOS на базата на Android 14, така че предупреждението на XREAL за Android 16 се отнася за телефоните, а не за Beam Pro.
5. Свържете One Pro към Beam Pro веднъж. Използвайте USB-C кабела на очилата. Ако се появи актуализация на фърмуера на очилата, завършете я преди разработката.
****
Стъпка 2: Инсталирайте Unity Hub на компютъра за разработка
1. Отворете уебсайта на Unity на компютъра. Изтеглете Unity Hub за Windows или macOS.
2. Инсталирайте и отворете Unity Hub. Unity Hub е отделна настолна програма, която се използва за инсталиране на Unity Editor.
3. Влезте или създайте акаунт в Unity, ако бъдете помолени. Това дава на Unity Hub достъп до процеса на инсталиране и лицензиране на редактора
Стъпка 3: Инсталирайте версия на Unity Editor с поддръжка за Android
XREAL SDK работи в Unity, затова Unity Editor трябва да бъде инсталиран, преди SDK да може да бъде импортиран.
1. Отворете Unity Hub > Installs. Изберете Install Editor.
2. Изберете поддържана LTS версия. XREAL поддържа Unity 2021.3.X, 2022.3.X и 6000.0.X LTS. Използвайте поддържана версия, посочена в актуалната документация на XREAL.
3. Изберете Android Build Support. Минималното изискване на XREAL е Android SDK API ниво 31 (Android 12) или по-ново, което включеният SDK покрива.
4. Завършете инсталацията. Изчакайте, докато Unity Hub покаже редактора в Installs.
Преминете към стъпка 4, когато: Unity Editor е инсталиран и Android Build Support е включен.
Стъпка 4: Изтеглете XREAL SDK на компютъра
XREAL SDK е файл, който по-късно се импортира в Unity. Не се опитвайте да го инсталирате на Beam Pro или на очилата.
1. Отворете страницата XREAL Developer Download. На компютъра за разработка отидете на developer.xreal.com/download.
2. Намерете XREAL SDK for Unity. Приемете условията за API на XREAL и изтеглете актуалния SDK.
3. Запазете изтегления файл. Пакетът се предоставя като файл, например com.xreal.xr.tar.gz.
Преминете към стъпка 5, когато: файлът на XREAL SDK е запазен на компютъра. Не отваряйте файла tar.gz ръчно.
Стъпка 5: Създайте проекта в Unity
Сега използвайте Unity Hub, за да създадете проекта, който по-късно ще стане Android приложението, инсталирано на Beam Pro.
1. Отворете Unity Hub > Projects. Изберете New project.
2. Изберете обикновен 3D шаблон. Дайте на проекта просто име, например XREAL-One-Pro-Test, и изберете къде да го запазите.
3. Създайте проекта. Изчакайте Unity Editor да се отвори.
4. Превключете проекта към Android. В Unity Editor отворете File > Build Settings. Изберете Android и щракнете върху Switch Platform. В Unity 6 използвайте File > Build Profiles, ако това е показаното меню.
Преминете към стъпка 6, когато: Android е активната платформа за компилиране в Unity.
Стъпка 6: Инсталирайте пакета за Unity, от който се нуждае XREAL
Останете в Unity Editor. Следващите инструменти се добавят към същия проект.
1. Отворете Window > Package Manager. В прозореца Package Manager задайте за източник на пакети Unity Registry. Така се показват пакетите, предоставяни от Unity.
2. Намерете XR Interaction Toolkit. Изберете го и щракнете върху Install. XREAL посочва версии 2.5.x и 3.0.x като поддържани; ако Package Manager инсталира по-нова версия и примерът не работи правилно, изберете 3.0.x от списъка с версии.
3. Отворете раздела Samples. Намерете Starter Assets и щракнете върху Import, след което импортирайте и Hands Interaction Demo. Според страницата за отстраняване на проблеми на XREAL без него HelloMR показва липсващи префаби.
Стъпка 7: Импортирайте XREAL SDK в същия проект на Unity
Все още сте в Unity. Сега използвайте файла на XREAL SDK, изтеглен в стъпка 4.
1. Останете в Window > Package Manager. Щракнете върху бутона + в горната лява част. След това изберете „Add package from tarball“.
2. Намерете файла на XREAL SDK, който изтеглихте по-рано. Отидете в папката Downloads, изберете файла с име, подобно на com.xreal.xr.tar.gz, и щракнете върху Open. Сега Unity ще добави XREAL XR Plugin към проекта ви.
3. Отворете XREAL XR Plugin в Package Manager > Samples. Импортирайте Interaction Basics. Така се добавя готовата примерна сцена HelloMR, с която ще проверите дали настройката на XREAL работи.
Стъпка 8: Активирайте XREAL в проекта
SDK вече е наличен, но Unity все още трябва да знае, че този Android проект трябва да използва плъгина на XREAL.
1. Отворете Edit > Project Settings > XR Plug-in Management. Изберете раздела Android.
2. Отметнете XREAL. Това активира XR доставчика на XREAL за Android компилацията.
3. Отворете Project Validation. Щракнете върху Fix All за всички необходими промени, свързани с XREAL.
4. Отворете XR Plug-in Management > XREAL. За One Pro без XREAL Eye задайте Initial Tracking Type на MODE_3DOF, Initial Input Source на Controller (Beam Pro или телефонът действа като 3DoF контролер) и Support Devices на XREAL_DEVICE_CATEGORY_VISION – категорията на XREAL за 3DoF очила като серията One. Оставете всичко останало със стойностите по подразбиране, докато примерът не заработи.
Преминете към стъпка 9, когато: Project Validation вече не показва нерешени задължителни настройки на XREAL.
Стъпка 9: Отворете примера HelloMR на XREAL
Преди да пишете собствено приложение, използвайте примера на XREAL. Така ще потвърдите, че Unity, XREAL SDK, Beam Pro и очилата могат да работят заедно.
1. Отворете панела Project в Unity. Отидете в Assets > Samples > XREAL XR Plugin > [вашата версия на SDK] > Interaction Basics.
2. Намерете HelloMR.unity. Щракнете два пъти върху сцената, за да я отворите.
3. Все още не я променяйте. Първо компилирайте непроменения пример, за да сте сигурни, че средата за разработка работи.
Стъпка 10: Компилирайте Android APK на компютъра
Сега Unity превръща проекта HelloMR във файл на Android приложение. Този файл се нарича APK.
1. Отворете File > Build Settings или Build Profiles. Изберете Add Open Scenes, за да бъде включена HelloMR.
2. Уверете се, че Android е активна платформа. Ако не е, превключете към Android.
3. Щракнете върху Build. Задайте Player Settings, след което компилирайте. В Player Settings попълнете Company Name и Product Name (MyGlasses показва Product Name, затова използвайте XREAL-HelloMR) и проверете дали Scripting Backend е IL2CPP, а целевата архитектура е ARM64; XREAL изисква и двете. След това щракнете върху Build, изберете папка на компютъра и запазете файла като XREAL-HelloMR.apk
4. Изчакайте компилирането да приключи. APK файлът вече е на компютъра, но все още не е на Beam Pro.
Какво е APK: APK е файлът, който се използва за инсталиране на Android приложение. В този работен процес APK файлът се инсталира на Beam Pro, а не на [XREAL One Pro](https://ai.vr-expert.com/en/ai-glasses/xreal-one-pro).
Стъпка 11: Инсталирайте APK на Beam Pro
ADB: Android Debug Bridge – компютърен инструмент за инсталиране и тестване на Android приложения на Beam Pro или на телефон.
Приложението е компилирано. Следващата стъпка прехвърля този APK от компютъра на Beam Pro.
1. Свържете Beam Pro към компютъра чрез USB-C.
2. Отворете Terminal или PowerShell на компютъра.
3. Активирайте отстраняването на грешки през USB на Beam Pro. Ръководството на XREAL посочва само да се активират опциите за програмисти (Developer options) и отстраняването на грешки през USB (USB debugging) на хоста; в Android това означава да докоснете седем пъти „Build number“ в „About“, за да отключите опциите за програмисти, и след това да включите там отстраняването на грешки през USB. Ако Beam Pro покаже съобщение с въпрос дали да се разреши отстраняване на грешки през USB от този компютър, изберете Allow.
4. Проверете дали компютърът разпознава Beam Pro. В PowerShell въведете:
adb devices
Ако Beam Pro се показва като device, връзката работи и можете да продължите.
5. Инсталирайте APK. Първо намерете файла XREAL-HelloMR.apk на компютъра си. Например, ако сте го запазили в папка с име XREAL Test на работния плот, пътят в Windows може да изглежда така:
C:\Users\YourName\Desktop\XREAL Test\XREAL-HelloMR.apk
В PowerShell въведете:
adb install -r "C:\Users\YourName\Desktop\XREAL Test\XREAL-HelloMR.apk"
Заменете примерния път с действителното местоположение на вашия APK, след което натиснете Enter.
6. Изчакайте Success. Когато ADB отчете Success, приложението е инсталирано на Beam Pro.
Преминете към стъпка 12, когато: инсталирането на APK отчете Success на компютъра.:
Стъпка 12: Свържете One Pro към Beam Pro и отворете приложението
Android приложението вече е на Beam Pro. Едва сега премествате USB-C връзката от компютъра към очилата.
1. Изключете Beam Pro от компютъра.
2. Свържете [XREAL One Pro](https://ai.vr-expert.com/en/ai-glasses/xreal-one-pro) към Beam Pro. Използвайте USB-C кабела на XREAL.
3. Отворете MyGlasses на Beam Pro. Това е средата на XREAL, която се използва за управление на свързаните очила и стартиране на 3D приложения на XREAL.
4. Намерете приложението си в MyGlasses. То е посочено с Product Name от Player Settings, а не с името на APK файла. Изберете го и го отворете. Ако липсва или MyGlasses съобщи, че приложението не се поддържа на това устройство, докоснете десет пъти иконата на очилата в горния ляв ъгъл на MyGlasses, докато очилата са изключени, за да отворите режима за разработчици, след което използвайте „select other MR App“, за да го изберете.
5. Одобрете разрешенията, ако бъдете попитани.
6. Погледнете през One Pro. Сцената HelloMR вече трябва да се появи в очилата, докато Beam Pro изпълнява приложението.
Стъпка 13: Направете първата малка персонализирана промяна
След като непромененият пример HelloMR заработи, върнете се в Unity и променете едно нещо. Така избягвате да отстранявате грешки в собствения си код, преди основната настройка на XREAL да е доказано работеща.
1. Върнете се в Unity на компютъра. Отворете сцената HelloMR. Отворете раздела Scene. Тук можете да изградите интерфейса и да позиционирате обектите, които ще се виждат през XREAL One Pro.
2. Добавете Cube. Изберете GameObject > 3D Object > Cube и го поставете на около метър пред камерата. По-късно текст, бутони, панели и импортирани модели се добавят по същия начин. (HelloMR не съдържа Cube; примерът на XREAL показва обекта с логото си, така че Cube от точки 6 и 7 трябва да бъде създаден тук.)
3. Изберете обект в Hierarchy. Използвайте Inspector, за да промените позицията, размера, ротацията и другите му настройки.
4. Подредете оформлението на приложението. Изградете интерфейса, необходим за проекта, например инструкции, модел на продукт, панел за състоянието или бутон Start Inspection.
5. Добавяйте C# код само когато е необходимо персонализирано поведение. Не е нужен код само за поставяне и оформяне на обекти. Създайте скрипт в Assets > Scripts само когато даден обект трябва да се движи, да реагира на въвеждане, да променя информация или да се свързва с външни данни.
Например този незадължителен скрипт кара обект да се върти:
using UnityEngine;
public class SpinObject : MonoBehaviour
{
public float speed = 30f;
void Update()
{
transform.Rotate(0f, speed * Time.deltaTime, 0f);
}
}
6. Прикачете скрипта към Cube. Плъзнете SpinObject от Assets > Scripts върху Cube в Hierarchy.
7. Компилирайте и инсталирайте отново. Повторете стъпки от 10 до 12. Cube трябва да се върти, когато приложението работи на Beam Pro и се показва чрез One Pro.
Какво показва това: Вашият персонализиран C# код се изпълнява от Android приложението на Beam Pro. Очилата показват резултата.
Ако искате да използвате Android телефон вместо Beam Pro
Важи същата обща архитектура, но хост става поддържан Android телефон. При този вариант не използвате MyGlasses.
· Използвайте телефон, одобрен от XREAL. SDK 3.1.0 посочва Samsung Galaxy S25 с Android 15; страницата за съвместимост на XREAL посочва и Galaxy S24 с Android 14 и уточнява, че се поддържат само флагмани на Samsung. Проверете версията на Android на телефона, преди да го купите или актуализирате: XREAL моли разработчиците да не преминават с устройствата за разработка към Android 16, а Samsung разпространява Android 16 (One UI 8) и за двата модела от септември 2025 г. Изключете Samsung DeX по време на разработката.
· Инсталирайте APK на телефона вместо на Beam Pro.
· Свържете XREAL One Pro към телефона чрез USB-C.
· Отворете ControlGlasses, намерете инсталираното приложение за XREAL и го стартирайте.
Не смесвайте двата варианта: Beam Pro използва MyGlasses. Поддържаният Android телефон използва ControlGlasses.
Чести грешки при разработката
- Опит APK да се инсталира на очилата: Инсталирайте го на Beam Pro или на поддържания Android телефон.
- Мнението, че Beam Pro е приложение: Beam Pro е отделен физически хардуер. MyGlasses е приложението на XREAL, използвано на Beam Pro.
- Използване на MyGlasses на обикновен Android телефон: При разработка с телефон вместо него се използва ControlGlasses.
- Започване с персонализиран код, преди HelloMR да работи: Първо стартирайте непроменения пример, след това персонализирайте.
- Оставяне на Beam Pro свързан с компютъра при опит да се използват очилата: След като инсталирате APK, изключете Beam Pro от компютъра и свържете One Pro към Beam Pro.
Заключение
Разработката за XREAL One Pro започва с разграничаването на трите части на системата: на компютъра се създава проектът в Unity, на Beam Pro или на поддържан Android телефон реално работи Android APK, а XREAL One Pro е носимото устройство за показване и проследяване. Като използвате Beam Pro като най-ясния път, първо настройте физическото устройство Beam Pro, инсталирайте Unity Hub и поддържан Unity Editor на компютъра, изтеглете и импортирайте XREAL SDK, активирайте плъгина на XREAL, отворете примера HelloMR, компилирайте APK, инсталирайте този APK на Beam Pro с ADB, след това изключете Beam Pro от компютъра, свържете One Pro и стартирайте приложението чрез MyGlasses. За бизнеса разбирането на тази архитектура преди началото на разработката помага да се определи правилният план за хардуер, сигурност и внедряване, улеснява отстраняването на проблеми в пилотните проекти и предпазва екипите от загуба на време в разработка за модел със самостоятелни очила, какъвто One Pro не използва.
Планирате приложение за XREAL One Pro? Започнете с едно устройство Beam Pro, едни очила One Pro и примера HelloMR, първо докажете работния процес от хоста към очилата и едва след това добавете само функциите на Unity, необходими за бизнес сценария.
























