Rezumat
XREAL One Pro nu rulează el însuși aplicația personalizată. Aplicația este creată în Unity pe un computer, instalată ca APK Android pe XREAL Beam Pro sau pe un alt dispozitiv gazdă Android compatibil și apoi afișată prin ochelarii One Pro. Acest model bazat pe dispozitivul gazdă este principalul lucru pe care dezvoltatorii trebuie să-l înțeleagă înainte de a începe.
Configurarea urmează un flux de lucru clar: pregătești Beam Pro, instalezi Unity și suportul pentru Android, adaugi XREAL SDK, deschizi și testezi exemplul HelloMR, compilezi APK-ul, îl instalezi pe Beam Pro cu ADB, conectezi One Pro și lansezi aplicația prin MyGlasses. Pentru companii, această arhitectură facilitează dezvoltarea și testarea fluxurilor de lucru XREAL personalizate cu instrumente Android și Unity familiare, păstrând totodată logica aplicației pe un dispozitiv gazdă separat, care poate fi administrat, actualizat și integrat cu sistemele existente ale companiei.
Greșeala de evitat: nu planifica un proiect în care APK-ul se instalează direct pe [XREAL One Pro](https://ai.vr-expert.com/en/ai-glasses/xreal-one-pro). APK-ul se instalează pe dispozitivul gazdă Android.
Ce este XREAL One Pro?
XREAL One Pro este un afișaj AR cu fir, cu un câmp vizual de 57 de grade, afișaje Sony Micro-OLED și cipul de procesare spațială X1 de la XREAL. Cipul X1 oferă 3DoF nativ, astfel încât ecranul rămâne pe loc când întorci capul, iar începând cu SDK 3.1.0 seria One acceptă și urmărirea capului în 6DoF cu camera opțională XREAL Eye, după o actualizare de firmware. Nimic din toate acestea nu transformă ochelarii într-un computer Android autonom.
Pentru dezvoltarea personalizată cu XREAL SDK, gazda Android conectată se ocupă de aplicație. One Pro este afișajul purtabil și punctul final de urmărire.
De ce ai nevoie pentru acest ghid
· Un computer cu Windows sau macOS.
· XREAL Beam Pro sau un telefon Samsung de top testat de XREAL: Galaxy S24 cu Android 14 sau Galaxy S25 cu Android 15. XREAL acceptă doar telefoanele Samsung de top și le cere dezvoltatorilor să nu folosească telefoane actualizate la Android 16 cât timp este valabil avizul său de compatibilitate. Beam Pro este gazda folosită în pașii principali.
· Un cablu USB-C pentru conectarea One Pro la Beam Pro.
· Unity Hub și o versiune Unity LTS compatibilă, cu Android Build Support. (Instrucțiuni în articol)
· Versiunea actuală a XREAL SDK pentru Unity, de pe pagina de descărcări pentru dezvoltatori a XREAL. (Instrucțiuni în articol)
· Android Debug Bridge (ADB) pentru instalarea APK-ului pe Beam Pro. (Instrucțiuni în articol)
Cum să dezvolți prima aplicație pentru XREAL One Pro
Pasul 1: Pregătește Beam Pro, dispozitivul care va rula aplicația
Începe cu Beam Pro, deoarece aici va fi instalată aplicația Android finalizată. Beam Pro este un dispozitiv portabil fizic, nu ceva ce descarci.
1. Procură-ți XREAL Beam Pro. Cumpără dispozitivul Beam Pro de la XREAL sau de la un revânzător autorizat. Acesta este separat de ochelarii One Pro.
2. Pornește-l și conectează-l la Wi-Fi. Finalizează configurarea inițială obișnuită Android/nebulaOS pe Beam Pro.
3. Deschide MyGlasses pe Beam Pro. MyGlasses este aplicația XREAL de gestionare a ochelarilor folosită pe Beam Pro.
4. Actualizează Beam Pro și MyGlasses dacă ți se solicită. SDK 3.1.0 funcționează împreună cu MyGlasses 1.11.0. Nota de lansare XREAL indică să actualizezi mai întâi MyGlasses și apoi să conectezi ochelarii, ceea ce declanșează automat actualizarea firmware-ului acestora. Beam Pro rulează nebulaOS pe Android 14, așa că avertismentul XREAL privind Android 16 se aplică telefoanelor, nu și lui Beam Pro.
5. Conectează o dată One Pro la Beam Pro. Folosește cablul USB-C al ochelarilor. Dacă apare o actualizare de firmware pentru ochelari, finalizeaz-o înainte de a începe dezvoltarea.
****
Pasul 2: Instalează Unity Hub pe computerul de dezvoltare
1. Deschide site-ul Unity pe computer. Descarcă Unity Hub pentru Windows sau macOS.
2. Instalează și deschide Unity Hub. Unity Hub este un program desktop separat, folosit pentru instalarea Unity Editor.
3. Conectează-te sau creează un cont Unity dacă ți se cere. Astfel, Unity Hub are acces la procesul de instalare a editorului și de licențiere
Pasul 3: Instalează o versiune Unity Editor cu suport pentru Android
XREAL SDK rulează în Unity, așa că Unity Editor trebuie instalat înainte ca SDK-ul să poată fi importat.
1. Deschide Unity Hub > Installs. Selectează Install Editor.
2. Alege o versiune LTS compatibilă. XREAL acceptă Unity 2021.3.X, 2022.3.X și 6000.0.X LTS. Folosește o versiune compatibilă menționată în documentația XREAL actuală.
3. Selectează Android Build Support. Cerința minimă XREAL este nivelul API 31 al Android SDK (Android 12) sau mai recent, pe care SDK-ul inclus îl acoperă.
4. Finalizează instalarea. Așteaptă până când Unity Hub afișează editorul la Installs.
Treci la Pasul 4 când: Unity Editor este instalat și include Android Build Support.
Pasul 4: Descarcă XREAL SDK pe computer
XREAL SDK este un fișier care va fi importat ulterior în Unity. Nu încerca să-l instalezi pe Beam Pro sau pe ochelari.
1. Deschide pagina XREAL Developer Download. Pe computerul de dezvoltare, accesează developer.xreal.com/download.
2. Găsește XREAL SDK for Unity. Acceptă termenii API XREAL și descarcă SDK-ul actual.
3. Păstrează fișierul descărcat. Pachetul este furnizat sub forma unui fișier precum com.xreal.xr.tar.gz.
Treci la Pasul 5 când: fișierul XREAL SDK este salvat pe computer. Nu deschide manual fișierul tar.gz.
Pasul 5: Creează proiectul Unity
Acum folosește Unity Hub pentru a crea proiectul care va deveni ulterior aplicația Android instalată pe Beam Pro.
1. Deschide Unity Hub > Projects. Selectează New project.
2. Alege un șablon 3D obișnuit. Dă-i proiectului un nume simplu, cum ar fi XREAL-One-Pro-Test, și alege unde să-l salvezi.
3. Creează proiectul. Așteaptă să se deschidă Unity Editor.
4. Comută proiectul pe Android. În Unity Editor, deschide File > Build Settings. Selectează Android și dă clic pe Switch Platform. În Unity 6, folosește File > Build Profiles dacă acesta este meniul afișat.
Treci la Pasul 6 când: Android este platforma de build activă în Unity.
Pasul 6: Instalează pachetul Unity de care are nevoie XREAL
Rămâi în Unity Editor. Următoarele instrumente se adaugă în același proiect.
1. Deschide Window > Package Manager. În fereastra Package Manager, setează sursa pachetelor la Unity Registry. Astfel sunt afișate pachetele furnizate de Unity.
2. Găsește XR Interaction Toolkit. Selectează-l și dă clic pe Install. XREAL indică versiunile 2.5.x și 3.0.x drept compatibile; dacă Package Manager instalează o versiune mai nouă și exemplul nu funcționează corect, alege în schimb 3.0.x din lista de versiuni.
3. Deschide fila Samples a acestuia. Găsește Starter Assets și dă clic pe Import, apoi importă și Hands Interaction Demo. Pagina de depanare XREAL precizează că, fără acesta, HelloMR afișează prefab-uri lipsă.
Pasul 7: Importă XREAL SDK în același proiect Unity
Ești în continuare în Unity. Acum folosește fișierul XREAL SDK descărcat la Pasul 4.
1. Rămâi în Window > Package Manager. Dă clic pe butonul + din zona din stânga sus. Apoi selectează: „Add package from tarball”.
2. Găsește fișierul XREAL SDK descărcat anterior. Mergi în folderul Downloads, selectează fișierul cu un nume de tipul com.xreal.xr.tar.gz și dă clic pe Open. Unity va adăuga acum XREAL XR Plugin în proiectul tău.
3. Deschide XREAL XR Plugin în Package Manager > Samples. Importă Interaction Basics. Astfel se adaugă scena de exemplu gata făcută HelloMR, pe care o vei folosi pentru a verifica dacă configurarea XREAL funcționează.
Pasul 8: Activează XREAL în proiect
SDK-ul este prezent, dar Unity trebuie totuși să știe că acest proiect Android ar trebui să folosească plug-in-ul XREAL.
1. Deschide Edit > Project Settings > XR Plug-in Management. Selectează fila Android.
2. Bifează XREAL. Astfel se activează furnizorul XREAL XR pentru build-ul Android.
3. Deschide Project Validation. Dă clic pe Fix All pentru toate modificările XREAL necesare.
4. Deschide XR Plug-in Management > XREAL. Pentru un One Pro fără XREAL Eye, setează Initial Tracking Type la MODE_3DOF, Initial Input Source la Controller (Beam Pro sau telefonul funcționează ca un controler 3DoF) și Support Devices la XREAL_DEVICE_CATEGORY_VISION, categoria XREAL pentru ochelari 3DoF precum seria One. Lasă toate celelalte setări la valorile implicite până când exemplul funcționează.
Treci la Pasul 9 când: Project Validation nu mai afișează setări XREAL obligatorii nerezolvate.
Pasul 9: Deschide exemplul HelloMR de la XREAL
Înainte de a-ți scrie propria aplicație, folosește exemplul XREAL. Acesta confirmă că Unity, XREAL SDK, Beam Pro și ochelarii pot funcționa împreună.
1. Deschide panoul Project în Unity. Mergi la Assets > Samples > XREAL XR Plugin > [versiunea ta de SDK] > Interaction Basics.
2. Găsește HelloMR.unity. Dă dublu clic pe scenă pentru a o deschide.
3. Nu o personaliza încă. Mai întâi compilează exemplul nemodificat, ca să știi că mediul de dezvoltare funcționează.
Pasul 10: Compilează APK-ul Android pe computer
Unity transformă acum proiectul HelloMR într-un fișier de aplicație Android. Acest fișier se numește APK.
1. Deschide File > Build Settings sau Build Profiles. Selectează Add Open Scenes pentru ca HelloMR să fie inclus.
2. Confirmă că Android este activ. Dacă nu este, comută pe Android.
3. Dă clic pe Build. Configurează Player Settings, apoi compilează. În Player Settings, completează Company Name și Product Name (MyGlasses afișează Product Name, așa că folosește XREAL-HelloMR) și verifică dacă Scripting Backend este IL2CPP, cu ARM64 ca arhitectură țintă; XREAL le cere pe amândouă. Apoi dă clic pe Build, alege un folder de pe computer și salvează fișierul ca XREAL-HelloMR.apk
4. Așteaptă finalizarea build-ului. APK-ul există acum pe computer, dar nu se află încă pe Beam Pro.
Ce este un APK: un APK este fișierul folosit pentru a instala o aplicație Android. În acest flux de lucru, APK-ul ajunge pe Beam Pro, nu pe [XREAL One Pro](https://ai.vr-expert.com/en/ai-glasses/xreal-one-pro).
Pasul 11: Instalează APK-ul pe Beam Pro
ADB: Android Debug Bridge, un instrument pentru computer folosit pentru a instala și testa aplicații Android pe Beam Pro sau pe un telefon.
Aplicația este compilată. Următorul pas mută acel APK de pe computer pe Beam Pro.
1. Conectează Beam Pro la computer prin USB-C.
2. Deschide Terminal sau PowerShell pe computer.
3. Activează depanarea USB pe Beam Pro. Ghidul XREAL spune doar să activezi Opțiunile pentru dezvoltatori și depanarea USB pe gazdă; pe Android, asta înseamnă să atingi de șapte ori „Build number” în secțiunea „About” pentru a debloca Opțiunile pentru dezvoltatori, apoi să activezi acolo depanarea USB. Dacă Beam Pro afișează un mesaj care te întreabă dacă permiți depanarea USB de pe acest computer, selectează Allow.
4. Verifică dacă computerul detectează Beam Pro. În PowerShell, tastează:
adb devices
Beam Pro apare ca device, conexiunea funcționează și poți continua.
5. Instalează APK-ul. Mai întâi, găsește fișierul XREAL-HelloMR.apk pe computer. De exemplu, dacă l-ai salvat într-un folder numit XREAL Test pe desktop, calea în Windows ar putea arăta astfel:
C:\Users\YourName\Desktop\XREAL Test\XREAL-HelloMR.apk
În PowerShell, tastează:
adb install -r "C:\Users\YourName\Desktop\XREAL Test\XREAL-HelloMR.apk"
Înlocuiește calea din exemplu cu locația reală a APK-ului tău, apoi apasă Enter.
6. Așteaptă mesajul Success. Când ADB raportează Success, aplicația este instalată pe Beam Pro.
Treci la Pasul 12 când: instalarea APK-ului raportează Success pe computer.:
Pasul 12: Conectează One Pro la Beam Pro și deschide aplicația
Aplicația Android se află acum pe Beam Pro. Abia acum muți conexiunea USB-C de la computer la ochelari.
1. Deconectează Beam Pro de la computer.
2. Conectează [XREAL One Pro](https://ai.vr-expert.com/en/ai-glasses/xreal-one-pro) la Beam Pro. Folosește cablul USB-C XREAL.
3. Deschide MyGlasses pe Beam Pro. Acesta este mediul XREAL folosit pentru a gestiona ochelarii conectați și a porni aplicații 3D XREAL.
4. Găsește aplicația în MyGlasses. Este listată sub Product Name din Player Settings, nu sub numele fișierului APK. Selectează-o și deschide-o. Dacă lipsește sau MyGlasses spune că aplicația nu este acceptată pe acest dispozitiv, atinge de zece ori pictograma ochelarilor din colțul din stânga sus al MyGlasses, cu ochelarii deconectați, pentru a deschide modul dezvoltator, apoi folosește „select other MR App” pentru a o alege.
5. Aprobă permisiunile dacă ți se cere.
6. Privește prin One Pro. Scena HelloMR ar trebui să apară acum în ochelari, în timp ce Beam Pro rulează aplicația.
Pasul 13: Fă prima mică modificare personalizată
După ce exemplul HelloMR nemodificat funcționează, revino în Unity și schimbă un singur lucru. Astfel eviți să-ți depanezi propriul cod înainte ca configurarea XREAL de bază să fi fost validată.
1. Revino în Unity pe computer. Deschide scena HelloMR. Deschide fila Scene. Aici poți construi interfața și poziționa obiectele care vor apărea prin XREAL One Pro.
2. Adaugă un Cube. Alege GameObject > 3D Object > Cube și plasează-l la aproximativ un metru în fața camerei. Textul, butoanele, panourile și modelele importate se adaugă ulterior în același mod. (HelloMR nu include un Cube; exemplul XREAL afișează obiectul cu logoul său, așa că Cube-ul de la punctele 6 și 7 trebuie creat aici.)
3. Selectează un obiect în Hierarchy. Folosește Inspector pentru a-i modifica poziția, dimensiunea, rotația și alte setări.
4. Organizează aspectul aplicației. Construiește interfața necesară proiectului, de exemplu instrucțiuni, un model de produs, un panou de stare sau un buton Start Inspection.
5. Adaugă cod C# doar când este nevoie de un comportament personalizat. Codul nu este necesar doar pentru a plasa și a proiecta obiecte. Creează un script în Assets > Scripts numai atunci când un obiect trebuie să se miște, să răspundă la input, să schimbe informații sau să se conecteze la date externe.
De exemplu, acest script opțional face ca un obiect să se rotească:
using UnityEngine;
public class SpinObject : MonoBehaviour
{
public float speed = 30f;
void Update()
{
transform.Rotate(0f, speed * Time.deltaTime, 0f);
}
}
6. Atașează scriptul la Cube. Trage SpinObject din Assets > Scripts pe Cube în Hierarchy.
7. Compilează și instalează din nou. Repetă pașii 10–12. Cube-ul ar trebui să se rotească atunci când aplicația rulează pe Beam Pro și este afișată prin One Pro.
Ce demonstrează acest lucru: codul tău C# personalizat este executat de aplicația Android de pe Beam Pro. Ochelarii afișează rezultatul.
Dacă vrei să folosești un telefon Android în loc de Beam Pro
Se aplică aceeași arhitectură generală, dar gazda devine un telefon Android compatibil. Pentru această variantă nu folosești MyGlasses.
· Folosește un telefon aprobat de XREAL. SDK 3.1.0 menționează Samsung Galaxy S25 cu Android 15; pagina de compatibilitate XREAL menționează și Galaxy S24 cu Android 14 și precizează că sunt acceptate doar telefoanele Samsung de top. Verifică versiunea Android a telefonului înainte să-l cumperi sau să-l actualizezi: XREAL le cere dezvoltatorilor să nu treacă dispozitivele de dezvoltare la Android 16, iar Samsung a lansat Android 16 (One UI 8) pentru ambele modele începând cu septembrie 2025. Dezactivează Samsung DeX în timpul dezvoltării.
· Instalează APK-ul pe telefon în loc de Beam Pro.
· Conectează XREAL One Pro la telefon prin USB-C.
· Deschide ControlGlasses, găsește aplicația XREAL instalată și lanseaz-o.
Nu amesteca cele două variante: Beam Pro folosește MyGlasses. Un telefon Android compatibil folosește ControlGlasses.
Greșeli frecvente în dezvoltare
- Încercarea de a instala APK-ul pe ochelari: instalează-l pe Beam Pro sau pe telefonul Android compatibil.
- Credința că Beam Pro este o aplicație: Beam Pro este un hardware fizic separat. MyGlasses este aplicația XREAL folosită pe Beam Pro.
- Folosirea MyGlasses pe un telefon Android obișnuit: dezvoltarea pe telefon folosește în schimb ControlGlasses.
- Începerea cu cod personalizat înainte ca HelloMR să funcționeze: rulează mai întâi exemplul nemodificat, apoi personalizează-l.
- Lăsarea Beam Pro conectat la computer când încerci să folosești ochelarii: după instalarea APK-ului, deconectează Beam Pro de la computer și conectează One Pro la Beam Pro.
Concluzie
Dezvoltarea pentru XREAL One Pro începe prin separarea celor trei componente ale sistemului: computerul este locul unde se creează proiectul Unity, Beam Pro sau un telefon Android compatibil este locul unde rulează efectiv APK-ul Android, iar XREAL One Pro este dispozitivul purtabil de afișare și urmărire. Folosind Beam Pro drept calea cea mai clară, configurează mai întâi dispozitivul fizic Beam Pro, instalează Unity Hub și o versiune Unity Editor compatibilă pe computer, descarcă și importă XREAL SDK, activează plug-in-ul XREAL, deschide exemplul HelloMR, compilează un APK, instalează acel APK pe Beam Pro cu ADB, apoi deconectează Beam Pro de la computer, conectează One Pro și lansează aplicația prin MyGlasses. Pentru companii, înțelegerea acestei arhitecturi înainte de începerea dezvoltării ajută la definirea planului corect privind hardware-ul, securitatea și implementarea, face proiectele pilot mai ușor de depanat și împiedică echipele să piardă timp construind pentru un model de ochelari autonomi pe care One Pro nu îl folosește.
Planifici o aplicație pentru XREAL One Pro? Începe cu un Beam Pro, un One Pro și exemplul HelloMR, validează mai întâi fluxul de lucru dintre gazdă și ochelari, apoi adaugă doar funcțiile Unity necesare pentru cazul de utilizare al companiei tale.
























