Utilità e Suggerimenti
Utilità e Suggerimenti — LeonardoXR SDK
Utilità e Suggerimenti
Attivazione della modalità sviluppatore
Modalità sviluppatore È necessario abilitare questa funzione per installare app da fonti esterne e per trasferire file dal computer al LeonardoXR.
Per abilitare la Modalità sviluppatore, procedi come segue.
- Apri le Settings facendo clic sull’icona a forma di ingranaggio nel dock.
Seleziona la voce di menu “About This HMD” dal menu di navigazione a sinistra per visualizzare il pannello “About”.
Nel pannello Informazioni, fai clic sull’etichetta Versione SUI 7 volte senza interruzioni. Mentre fai clic sull’etichetta, verrà visualizzato un messaggio Toast che mostra il conto alla rovescia per l’attivazione della Modalità sviluppatore. Al termine, un messaggio Toast indicherà che LeonardoXR è in modalità sviluppatore.
NotA
Cerca di non fare pause tra un clic e l’altro sull’etichetta “software Version”, altrimenti il conto alla rovescia ripartirà.
- Nella parte inferiore della pagina Informazioni comparirà un nuovo pulsante “Modalità sviluppatore”. Fai clic sul pulsante “Modalità sviluppatore” per aprire il pannello della Modalità sviluppatore.
Nel pannello Modalità sviluppatore, assicurati che il USB debugging sia attivo.
La prima volta che colleghi il tuo LeonardoXR al computer, sul dispositivo apparirà una finestra di dialogo per confermare la connessione. Accetta la finestra di dialogo per connetterti al computer. Il LeonardoXR è ora in modalità sviluppatore e puoi installare applicazioni e copiare file da e verso il computer.
Debug ADB e USB
Android Debug Bridge, o adb, è un utile strumento da riga di comando utilizzato per comunicare da un PC a un dispositivo Android. Android Debug Bridge è molto utile per lo sviluppo di app con LeonardoXR. Per ulteriori informazioni su adb, visitare: https://developer.android.com/tools/adb
# Comandi ADB utili
Di seguito è riportato un elenco dei comandi ADB più comunemente utilizzati.
# Verifica della connessione a LeonardoXR
Per verificare se il computer è connesso al LeonardoXR, utilizzare il seguente comando. Il comando dovrebbe visualizzare il numero di serie del dispositivo.
adb devices
# App con caricamento laterale
Per installare app sul LeonardoXR tramite sideload, utilizzare il seguente comando.
Il flag -r indica di sostituire l’app se esiste già.
Il flag -g significa concedere tutti i privilegi all’app.
adb install -r -g <app-name>.apk
# Registrazione dello schermo
Per registrare lo schermo, utilizzare il seguente comando. Per interrompere la registrazione video, premere Ctrl-C nella riga di comando.
adb shell screenrecord /sdcard/<file-name>.mp4
Sostituisci `file-name` con il nome del tuo video. Ad esempio, se volessi chiamare il tuo file video.mp4, useresti il seguente comando:
adb shell screenrecord /sdcard/video.mp4
Dopo aver interrotto l’acquisizione premendo Ctrl-C, è possibile copiare il file video sul PC utilizzando il seguente comando:
adb pull /sdcard/video.mp4
# Mirroring dello schermo
Le app di mirroring dello schermo vengono utilizzate per duplicare i contenuti visualizzati in un visore su uno schermo del computer, in modo che altri possano vederli. Questi strumenti possono essere utilizzati per mostrare esperienze, eseguire il debug delle app durante una chiamata di assistenza o effettuare operazioni di configurazione di base.
Le due app più popolari per la duplicazione dello schermo sono Vysor e Scrcpy, o “Screen Copy”. Anche SideQuest può essere utilizzato per la duplicazione dello schermo, ma si avvale di Scrcpy per svolgere questa funzione.
# Vysor
Vysor è un’app di mirroring dello schermo per dispositivi Android utilizzabile con LeonardoXR. Si tratta di un’applicazione commerciale con un’interfaccia utente curata, disponibile in versione gratuita o a pagamento. La versione gratuita presenta alcune funzionalità disabilitate e visualizza annunci pubblicitari. La versione completa è disponibile con l’acquisto di una licenza mensile, annuale o a vita. È disponibile anche una licenza aziendale. Per saperne di più, visita il sito web di Vysor all’indirizzo https://www.vysor.io/.
# Scrcpy
Scrcpy, o “Screen Copy”, è un’applicazione open source per la duplicazione dello schermo su dispositivi Android. Può essere utilizzata anche con i dispositivi LeonardoXR. Il modo più semplice per iniziare a usare Scrcpy è scaricare la versione di rilascio, che contiene un file binario “.exe” per Windows.
https://github.com/Genymobile/scrcpy/releases
# Registrazione dello schermo
Quest’ultimo metodo, pur non essendo tecnicamente considerato una duplicazione dello schermo, può comunque risultare molto utile per chi desidera semplicemente registrare le immagini visualizzate sul LeonardoXR per poi guardarle o condividerle in un secondo momento come file mp4.
Per registrare lo schermo, utilizzare il seguente comando. Per interrompere la registrazione video, premere Ctrl-C nella riga di comando.
adb shell screenrecord /sdcard/<file-name>.mp4
Sostituisci `file-name` con il nome del tuo video. Ad esempio, se volessi chiamare il tuo file video.mp4, useresti il seguente comando:
adb shell screenrecord /sdcard/video.mp4
Dopo aver interrotto l’acquisizione premendo Ctrl-C, è possibile copiare il file video sul PC utilizzando il seguente comando:
adb pull /sdcard/video.mp4
# Consigli utili
Ecco alcuni suggerimenti per iniziare a usare Vysor o Scrcpy:
Abilita la modalità sviluppatore: Si prega di notare che le due opzioni sopra elencate richiedono che il dispositivo LeonardoXR venga posizionato in Developer Mode.
Connessione senza fili: Vysor, Scrcpy e ADB possono connettersi in modalità wireless tramite Wi-Fi. Per ulteriori informazioni, visita i siti web di Vysor, Scrcpy o Android Platform Tools.
Supporto per lo streaming PCVR
Lo streaming PCVR esegue l’applicazione XR sul PC e trasmette i frame renderizzati al visore in tempo reale, sfruttando la GPU e la CPU superiori del PC, mantenendo il visore senza fili. Ciò consente l’esecuzione di contenuti ad alta fedeltà e ad alta intensità di risorse che l’hardware standalone non è in grado di gestire. Facilita lo sviluppo, il test e la distribuzione rapidi di esperienze XR complesse, come addestramenti realistici, simulazioni dettagliate e demo di fascia alta, mantenendo al contempo la mobilità wireless.
LeonardoXR supporta lo streaming PCVR tramite una versione personalizzata di ALVR (streamer desktop e client Android) con supporto completo per controller e tracciamento delle mani.
Elenco dei download ALVR disponibili sul sito per sviluppatori di Youbiquo, nella sezione Tools:
ALVR Windows Streamer, version 1.0.0
ALVR Android Client, version 1.0.0
NOTE
Consulta ALVR GitHub la pagina GitHub di ALVR per maggiori dettagli sull’installazione e l’utilizzo.
Una volta stabilita la connessione tra ALVR e SteamVR, sarà possibile testare le app Unity nell’editor premendo il pulsante Play.
NOTA
L’SDK LeonardoXR al momento non supporta la funzionalità Passthrough tramite ALVR..
Supporto WebXR
All’interno della cartella Core Samples è presente una scena di esempio WebXR che contiene tutto il necessario per una distribuzione semplice e immediata su dispositivi compatibili con WebXR.
Per iniziare, è necessario scaricare il seguente software:
Questa utility permetterà agli sviluppatori di creare applicazioni destinate ai browser compatibili con WebXR su dispositivi compatibili (LeonardoXR include l’app browser Wolvic personalizzata preinstallata per il supporto delle applicazioni WebXR).