Sintesi
XREAL One Pro non esegue direttamente l'applicazione personalizzata. L'app viene creata in Unity su un computer, installata come APK Android su XREAL Beam Pro o su un altro dispositivo host Android supportato e poi visualizzata tramite gli occhiali One Pro. Questo modello basato sul dispositivo host è il punto principale che gli sviluppatori devono comprendere prima di iniziare.
La configurazione segue un flusso di lavoro chiaro: preparare Beam Pro, installare Unity e il supporto Android, aggiungere l'XREAL SDK, aprire e testare l'esempio HelloMR, compilare l'APK, installarlo su Beam Pro con ADB, collegare il One Pro e avviare l'app tramite MyGlasses. Per le aziende, questa architettura rende più semplice sviluppare e testare flussi di lavoro XREAL personalizzati con strumenti Android e Unity già noti, mantenendo la logica applicativa su un dispositivo host separato che può essere gestito, aggiornato e integrato con i sistemi aziendali esistenti.
L'errore da evitare: non pianificare un progetto in cui l'APK venga installato direttamente su [XREAL One Pro](https://ai.vr-expert.com/en/ai-glasses/xreal-one-pro). L'APK si installa sul dispositivo host Android.
Che cos'è XREAL One Pro?
XREAL One Pro è un display AR cablato con un campo visivo di 57 gradi, display Sony Micro-OLED e il chip di elaborazione spaziale X1 di XREAL. Il chip X1 offre il 3DoF nativo, così lo schermo resta fermo quando giri la testa, e dalla versione 3.1.0 dell'SDK la serie One supporta anche il tracciamento della testa 6DoF con la fotocamera opzionale XREAL Eye, previo aggiornamento del firmware. Nulla di tutto ciò rende gli occhiali un computer Android autonomo.
Nello sviluppo personalizzato con l'XREAL SDK, è l'host Android collegato a gestire l'applicazione. Il One Pro è il display indossabile e il terminale di tracciamento.
Visualizza la pagina prodotto di XREAL One Pro su VR Expert AI
Cosa serve per questa guida
· Un computer Windows o macOS.
· XREAL Beam Pro, oppure uno smartphone Samsung di fascia alta testato da XREAL: il Galaxy S24 con Android 14 o il Galaxy S25 con Android 15. XREAL supporta solo i top di gamma Samsung e chiede agli sviluppatori di non usare telefoni aggiornati ad Android 16 finché resta valido il suo avviso di compatibilità. Beam Pro è l'host utilizzato nei passaggi principali.
· Un cavo USB-C per collegare il One Pro a Beam Pro.
· Unity Hub e una versione LTS di Unity supportata con Android Build Support. (Istruzioni nell'articolo)
· L'XREAL SDK per Unity aggiornato, dalla pagina di download per sviluppatori di XREAL. (Istruzioni nell'articolo)
· Android Debug Bridge (ADB) per installare l'APK su Beam Pro. (Istruzioni nell'articolo)
Come sviluppare la tua prima app per XREAL One Pro
Passaggio 1: prepara Beam Pro, il dispositivo che eseguirà l'app
Inizia da Beam Pro, perché è qui che verrà installata l'app Android finita. Beam Pro è un dispositivo portatile fisico, non qualcosa da scaricare.
1. Procurati XREAL Beam Pro. Acquista l'hardware Beam Pro da XREAL o da un rivenditore autorizzato. È separato dagli occhiali One Pro.
2. Accendilo e collegalo al Wi-Fi. Completa la normale configurazione iniziale di Android/nebulaOS su Beam Pro.
3. Apri MyGlasses su Beam Pro. MyGlasses è l'applicazione XREAL per la gestione degli occhiali utilizzata su Beam Pro.
4. Aggiorna Beam Pro e MyGlasses se richiesto. L'SDK 3.1.0 è abbinato a MyGlasses 1.11.0. Le note di rilascio di XREAL indicano di aggiornare prima MyGlasses e poi collegare gli occhiali, operazione che ne avvia automaticamente l'aggiornamento del firmware. Beam Pro esegue nebulaOS su Android 14, quindi l'avviso di XREAL su Android 16 riguarda i telefoni, non Beam Pro.
5. Collega una volta il One Pro a Beam Pro. Usa il cavo USB-C degli occhiali. Se compare un aggiornamento del firmware degli occhiali, completalo prima di iniziare lo sviluppo.
****
Passaggio 2: installa Unity Hub sul computer di sviluppo
1. Apri il sito web di Unity sul computer. Scarica Unity Hub per Windows o macOS.
2. Installa e apri Unity Hub. Unity Hub è un programma desktop separato che serve a installare Unity Editor.
3. Accedi o crea un account Unity, se richiesto. In questo modo Unity Hub ha accesso alla procedura di installazione dell'editor e di gestione delle licenze
Passaggio 3: installa una versione di Unity Editor con supporto Android
L'XREAL SDK funziona all'interno di Unity, quindi Unity Editor deve essere installato prima di poter importare l'SDK.
1. Apri Unity Hub > Installs. Seleziona Install Editor.
2. Scegli una versione LTS supportata. XREAL supporta Unity 2021.3.X, 2022.3.X e 6000.0.X LTS. Usa una versione supportata elencata nella documentazione XREAL aggiornata.
3. Seleziona Android Build Support. Il requisito minimo di XREAL è l'Android SDK con API level 31 (Android 12) o successivo, coperto dall'SDK incluso.
4. Completa l'installazione. Attendi che Unity Hub mostri l'editor in Installs.
Passa al Passaggio 4 quando: Unity Editor è installato e include Android Build Support.
Passaggio 4: scarica l'XREAL SDK sul computer
L'XREAL SDK è un file che verrà importato in Unity in seguito. Non cercare di installarlo su Beam Pro o sugli occhiali.
1. Apri la pagina XREAL Developer Download. Sul computer di sviluppo, vai su developer.xreal.com/download.
2. Trova XREAL SDK for Unity. Accetta i termini delle API XREAL e scarica l'SDK aggiornato.
3. Conserva il file scaricato. Il pacchetto viene fornito come file, ad esempio com.xreal.xr.tar.gz.
Passa al Passaggio 5 quando: il file dell'XREAL SDK è salvato sul computer. Non aprire manualmente il file tar.gz.
Passaggio 5: crea il progetto Unity
Ora usa Unity Hub per creare il progetto che diventerà poi l'app Android installata su Beam Pro.
1. Apri Unity Hub > Projects. Seleziona New project.
2. Scegli un normale template 3D. Dai al progetto un nome semplice, ad esempio XREAL-One-Pro-Test, e scegli dove salvarlo.
3. Crea il progetto. Attendi l'apertura di Unity Editor.
4. Imposta il progetto su Android. In Unity Editor apri File > Build Settings. Seleziona Android e fai clic su Switch Platform. In Unity 6, usa File > Build Profiles se è questo il menu visualizzato.
Passa al Passaggio 6 quando: Android è la piattaforma di build attiva in Unity.
Passaggio 6: installa il pacchetto Unity richiesto da XREAL
Resta in Unity Editor. Gli strumenti successivi vengono aggiunti a questo stesso progetto.
1. Apri Window > Package Manager. Nella finestra Package Manager, imposta come origine dei pacchetti Unity Registry. Vengono così mostrati i pacchetti forniti da Unity.
2. Trova XR Interaction Toolkit. Selezionalo e fai clic su Install. XREAL indica come supportate le versioni 2.5.x e 3.0.x; se il Package Manager installa una versione più recente e l'esempio non funziona correttamente, scegli invece la 3.0.x dall'elenco delle versioni.
3. Apri la relativa scheda Samples. Trova Starter Assets e fai clic su Import, quindi importa anche Hands Interaction Demo. Secondo la pagina di risoluzione dei problemi di XREAL, senza di esso HelloMR mostra prefab mancanti.
Passaggio 7: importa l'XREAL SDK nello stesso progetto Unity
Sei ancora in Unity. Ora usa il file dell'XREAL SDK scaricato nel Passaggio 4.
1. Resta in Window > Package Manager. Fai clic sul pulsante + nella parte in alto a sinistra. Quindi seleziona: “Add package from tarball”.
2. Trova il file dell'XREAL SDK scaricato in precedenza. Vai nella cartella Download, seleziona il file chiamato più o meno com.xreal.xr.tar.gz e fai clic su Apri. Unity aggiungerà ora XREAL XR Plugin al tuo progetto.
3. Apri XREAL XR Plugin in Package Manager > Samples. Importa Interaction Basics. In questo modo viene aggiunta la scena di esempio HelloMR già pronta, che userai per verificare che la configurazione XREAL funzioni.
Passaggio 8: abilita XREAL nel progetto
L'SDK è presente, ma Unity deve ancora sapere che questo progetto Android deve usare il plug-in XREAL.
1. Apri Edit > Project Settings > XR Plug-in Management. Seleziona la scheda Android.
2. Spunta XREAL. In questo modo si abilita il provider XR di XREAL per la build Android.
3. Apri Project Validation. Fai clic su Fix All per tutte le modifiche XREAL richieste.
4. Apri XR Plug-in Management > XREAL. Per un One Pro senza XREAL Eye, imposta Initial Tracking Type su MODE_3DOF, Initial Input Source su Controller (Beam Pro o il telefono funge da controller 3DoF) e Support Devices su XREAL_DEVICE_CATEGORY_VISION, la categoria di XREAL per gli occhiali 3DoF come la serie One. Lascia tutto il resto sui valori predefiniti finché l'esempio non funziona.
Passa al Passaggio 9 quando: Project Validation non mostra più impostazioni XREAL obbligatorie non risolte.
Passaggio 9: apri l'esempio HelloMR di XREAL
Prima di scrivere la tua app, usa l'esempio di XREAL. Così avrai la conferma che Unity, l'XREAL SDK, Beam Pro e gli occhiali funzionano insieme.
1. Apri il pannello Project in Unity. Vai su Assets > Samples > XREAL XR Plugin > [la tua versione dell'SDK] > Interaction Basics.
2. Trova HelloMR.unity. Fai doppio clic sulla scena per aprirla.
3. Non personalizzarlo ancora. Compila prima l'esempio senza modifiche, così saprai che l'ambiente di sviluppo funziona.
Passaggio 10: compila l'APK Android sul computer
Ora Unity trasforma il progetto HelloMR in un file di app Android. Questo file si chiama APK.
1. Apri File > Build Settings o Build Profiles. Seleziona Add Open Scenes in modo che HelloMR venga incluso.
2. Verifica che Android sia attivo. In caso contrario, passa ad Android.
3. Fai clic su Build. Configura le Player Settings, poi avvia la build. Nelle Player Settings, inserisci Company Name e Product Name (MyGlasses mostra il Product Name, quindi usa XREAL-HelloMR) e verifica che lo Scripting Backend sia IL2CPP con ARM64 come architettura di destinazione; XREAL li richiede entrambi. Quindi fai clic su Build, scegli una cartella sul computer e salva il file come XREAL-HelloMR.apk
4. Attendi il completamento della build. Ora l'APK si trova sul computer, ma non ancora su Beam Pro.
Che cos'è un APK: un APK è il file usato per installare un'app Android. In questo flusso di lavoro, l'APK va su Beam Pro, non su [XREAL One Pro](https://ai.vr-expert.com/en/ai-glasses/xreal-one-pro).
Passaggio 11: installa l'APK su Beam Pro
ADB: Android Debug Bridge, uno strumento per computer che serve a installare e testare app Android su Beam Pro o su un telefono.
L'app è compilata. Il passaggio successivo trasferisce l'APK dal computer a Beam Pro.
1. Collega Beam Pro al computer tramite USB-C.
2. Apri il Terminale o PowerShell sul computer.
3. Abilita il debug USB su Beam Pro. La guida di XREAL si limita a indicare di abilitare le Opzioni sviluppatore e il debug USB sull'host; su Android ciò significa toccare sette volte “Numero build” in “Info” per sbloccare le Opzioni sviluppatore, quindi attivare lì il debug USB. Se Beam Pro mostra un messaggio che chiede se consentire il debug USB da questo computer, seleziona Consenti.
4. Verifica che il computer rilevi Beam Pro. In PowerShell, digita:
adb devices
Beam Pro compare come device: la connessione funziona e puoi proseguire.
5. Installa l'APK. Per prima cosa, individua il file XREAL-HelloMR.apk sul computer. Ad esempio, se lo hai salvato in una cartella chiamata XREAL Test sul Desktop, il percorso Windows potrebbe essere:
C:\Users\YourName\Desktop\XREAL Test\XREAL-HelloMR.apk
In PowerShell, digita:
adb install -r "C:\Users\YourName\Desktop\XREAL Test\XREAL-HelloMR.apk"
Sostituisci il percorso di esempio con la posizione effettiva del tuo APK, quindi premi Invio.
6. Attendi il messaggio Success. Quando ADB restituisce Success, l'applicazione è installata su Beam Pro.
Passa al Passaggio 12 quando: l'installazione dell'APK restituisce Success sul computer.:
Passaggio 12: collega il One Pro a Beam Pro e apri l'app
L'app Android ora si trova su Beam Pro. Solo adesso sposti la connessione USB-C dal computer agli occhiali.
1. Scollega Beam Pro dal computer.
2. Collega [XREAL One Pro](https://ai.vr-expert.com/en/ai-glasses/xreal-one-pro) a Beam Pro. Usa il cavo USB-C XREAL.
3. Apri MyGlasses su Beam Pro. È l'ambiente XREAL utilizzato per gestire gli occhiali collegati e avviare le applicazioni 3D XREAL.
4. Trova la tua app in MyGlasses. Compare con il Product Name impostato nelle Player Settings, non con il nome del file APK. Selezionala e aprila. Se non compare, o se MyGlasses indica che l'app non è supportata su questo dispositivo, tocca dieci volte l'icona degli occhiali nell'angolo in alto a sinistra di MyGlasses con gli occhiali scollegati per aprire la modalità sviluppatore, quindi usa 'select other MR App' per selezionarla.
5. Concedi le autorizzazioni, se richiesto.
6. Guarda attraverso il One Pro. La scena HelloMR dovrebbe ora comparire negli occhiali mentre Beam Pro esegue l'applicazione.
Passaggio 13: apporta la prima piccola modifica personalizzata
Una volta che l'esempio HelloMR senza modifiche funziona, torna in Unity e cambia una sola cosa. In questo modo eviti di eseguire il debug del tuo codice prima di aver verificato la configurazione XREAL di base.
1. Torna in Unity sul computer. Apri la scena HelloMR. Apri la scheda Scene. Qui puoi creare l'interfaccia e posizionare gli oggetti che appariranno attraverso XREAL One Pro.
2. Aggiungi un Cube. Scegli GameObject > 3D Object > Cube e posizionalo a circa un metro davanti alla telecamera. Testo, pulsanti, pannelli e modelli importati si aggiungono in seguito allo stesso modo. (HelloMR non include un Cube; l'esempio di XREAL mostra l'oggetto con il suo logo, quindi il Cube dei punti 6 e 7 va creato qui.)
3. Seleziona un oggetto nella Hierarchy. Usa l'Inspector per modificarne posizione, dimensioni, rotazione e altre impostazioni.
4. Organizza il layout dell'applicazione. Crea l'interfaccia necessaria per il progetto, ad esempio istruzioni, un modello di prodotto, un pannello di stato o un pulsante Start Inspection.
5. Aggiungi codice C# solo quando serve un comportamento personalizzato. Non serve codice solo per posizionare e progettare gli oggetti. Crea uno script in Assets > Scripts solo quando un oggetto deve muoversi, rispondere all'input, modificare informazioni o collegarsi a dati esterni.
Ad esempio, questo script opzionale fa ruotare un oggetto:
using UnityEngine;
public class SpinObject : MonoBehaviour
{
public float speed = 30f;
void Update()
{
transform.Rotate(0f, speed * Time.deltaTime, 0f);
}
}
6. Associa lo script al Cube. Trascina SpinObject da Assets > Scripts sul Cube nella Hierarchy.
7. Compila e installa di nuovo. Ripeti i Passaggi da 10 a 12. Il Cube dovrebbe ruotare quando l'app viene eseguita su Beam Pro e visualizzata tramite il One Pro.
Cosa dimostra: il tuo codice C# personalizzato viene eseguito dall'applicazione Android su Beam Pro. Gli occhiali mostrano il risultato.
Se vuoi usare un telefono Android al posto di Beam Pro
Vale la stessa architettura generale, ma l'host diventa un telefono Android supportato. In questo caso non si usa MyGlasses.
· Usa un telefono approvato da XREAL. L'SDK 3.1.0 indica il Samsung Galaxy S25 con Android 15; la pagina di compatibilità di XREAL elenca anche il Galaxy S24 con Android 14 e afferma che sono supportati solo i top di gamma Samsung. Controlla la versione di Android del telefono prima di acquistarlo o aggiornarlo: XREAL chiede agli sviluppatori di non aggiornare i dispositivi di sviluppo ad Android 16, e Samsung distribuisce Android 16 (One UI 8) su entrambi i modelli da settembre 2025. Disattiva Samsung DeX durante lo sviluppo.
· Installa l'APK sul telefono anziché su Beam Pro.
· Collega XREAL One Pro al telefono tramite USB-C.
· Apri ControlGlasses, trova l'app XREAL installata e avviala.
Non mescolare i due percorsi: Beam Pro usa MyGlasses. Un telefono Android supportato usa ControlGlasses.
Errori comuni nello sviluppo
- Cercare di installare l'APK sugli occhiali: installalo su Beam Pro o sul telefono Android supportato.
- Pensare che Beam Pro sia un'app: Beam Pro è un hardware fisico separato. MyGlasses è l'app XREAL usata su Beam Pro.
- Usare MyGlasses su un normale telefono Android: per lo sviluppo su telefono si usa invece ControlGlasses.
- Partire con codice personalizzato prima che HelloMR funzioni: esegui prima l'esempio non modificato, poi personalizzalo.
- Lasciare Beam Pro collegato al computer quando si cerca di usare gli occhiali: dopo aver installato l'APK, scollega Beam Pro dal computer e collega il One Pro a Beam Pro.
Conclusione
Lo sviluppo per XREAL One Pro parte dalla distinzione tra le tre parti del sistema: il computer è dove si crea il progetto Unity, Beam Pro o un telefono Android supportato è dove viene effettivamente eseguito l'APK Android, e XREAL One Pro è il display indossabile e il dispositivo di tracciamento. Seguendo il percorso più chiaro, quello con Beam Pro, configura prima il Beam Pro fisico, installa Unity Hub e una versione supportata di Unity Editor sul computer, scarica e importa l'XREAL SDK, abilita il plug-in XREAL, apri l'esempio HelloMR, compila un APK, installalo su Beam Pro con ADB, poi scollega Beam Pro dal computer, collega il One Pro e avvia l'app tramite MyGlasses. Per le aziende, comprendere questa architettura prima di iniziare lo sviluppo aiuta a definire il giusto piano hardware, di sicurezza e di distribuzione, semplifica la risoluzione dei problemi nei progetti pilota ed evita che i team perdano tempo a sviluppare per un modello di occhiali autonomi che il One Pro non utilizza.
Stai pianificando un'applicazione per XREAL One Pro? Inizia con un Beam Pro, un One Pro e l'esempio HelloMR, verifica prima il flusso di lavoro dall'host agli occhiali, poi aggiungi solo le funzionalità Unity necessarie per il caso d'uso aziendale.
