Guida rapida di Google Cardboard per Unity

Questa guida ti mostra come utilizzare il plug-in Google Cardboard XR per Unity per Unity per creare le tue esperienze di realtà virtuale (VR).

Nota: assicurati di leggere le linee guida per il branding di Cardboard prima di distribuire la tua app a un pubblico più ampio.

Puoi utilizzare l'SDK di Cardboard per trasformare un telefono cellulare in una piattaforma VR. Uno smartphone può visualizzare scene 3D con rendering stereoscopico, seguire e reagire ai movimenti della testa e interagire con le app rilevando quando l'utente preme il pulsante di visualizzazione.

Per iniziare, utilizzerai HelloCardboard, un gioco demo che dimostra le funzionalità principali dell'SDK di Cardboard. Nel gioco gli utenti esplorano il mondo virtuale per trovare e raccogliere oggetti. Ti mostra come:

• Configurazione dell'ambiente di sviluppo
• Scaricare e creare l'app demo
• Scansiona il codice QR di un visualizzatore Cardboard per salvarne i parametri
• Monitorare i movimenti della testa dell'utente.
• Visualizza le immagini stereoscopiche impostando la distorsione corretta per ogni occhio
• Attivare e disattivare la modalità VR

Configurazione dell'ambiente di sviluppo

Requisiti software:

• Unity 2021.3.32f1 o versioni successive
  • Assicurati di includere il Supporto Build per Android e iOS durante l'installazione.
• È necessario installare Git e l'eseguibile git deve essere nella variabile di ambiente PATH. Per ulteriori dettagli, consulta la documentazione relativa all'assistenza Git del gestore di pacchetti di Unity.

Importa l'SDK e crea un nuovo progetto

Segui questi passaggi per importare l'SDK Unity e creare un nuovo progetto.

1. Apri Unity e crea un nuovo progetto 3D.
2. In Unity, vai a Finestra > Gestione pacchetti.
3. Fai clic su + e seleziona Aggiungi pacchetto da URL Git.
4. Incolla https://github.com/googlevr/cardboard-xr-plugin.git nel campo di immissione di testo.
   Il pacchetto dovrebbe essere aggiunto ai pacchetti installati.
5. Vai al pacchetto Google Cardboard XR Plug for Unity. Nella sezione Samples, scegli Importa nel progetto.
   Gli asset di esempio devono essere caricati in Assets/Samples/Google Cardboard/<version>/Hello Cardboard.

Nota: <version> è il numero di versione semantico del pacchetto rilasciato (ad esempio 1.1.0).

X.Y.Z

Configurazione della scena HelloCardboard in corso...

1. Vai a Assets/Samples/Google Cardboard/<version>/Hello Cardboard/Scenes, seleziona Aggiungi scene aperte, quindi scegli HelloCardboard per aprire la scena di esempio.
2. Apri il menu Livelli e seleziona Modifica livelli....
3. Definisci un nuovo livello denominato "Interattivo".
4. Fai clic su GameObject Treasure per aprire la finestra Inspector. Imposta il livello su "Interattivo". Se viene visualizzata una finestra popup che ti chiede se vuoi impostare il livello su Interattivo anche per tutti gli oggetti secondari, fai clic su "Sì, modifica gli elementi secondari".
5. Fai clic su GameObject Giocatore > Fotocamera > CardboardReticlePointer per aprire la finestra Inspector. Nello script "Puntatore reticolo Carboard", seleziona "Interattiva" come Maschera di livello di interazione con il reticolo.

Configurazione delle impostazioni del progetto Android

Vai a File > Impostazioni build.

1. Seleziona Android e scegli Cambia piattaforma.
2. Seleziona Add Open Scenes (Aggiungi scene aperte) e scegli HelloCardboard.

Impostazioni del player

Risoluzione e presentazione

Vai a Impostazioni progetto > Player > Risoluzione e presentazione.

1. Imposta Orientamento predefinito su Orizzontale a sinistra o Orizzontale a destra.
2. Disattiva l'opzione Pacing del frame ottimizzato.

Nota: sebbene siano supportati dal plug-in Cardboard XR, gli orientamenti Ritratto e Ritratto capovolto potrebbero non offrire abbastanza spazio per la visualizzazione degli occhi sui dispositivi.

Altre impostazioni

Vai a Impostazioni progetto > Player > Altre impostazioni.

1. Scegli OpenGLES2, OpenGLES3 o Vulkan o una qualsiasi combinazione di queste opzioni nelle API grafiche.
2. Seleziona Android 8.0 'Oreo' (API level 26) o un livello superiore in Livello API minimo.
3. Seleziona API level 33 o un livello superiore in Livello API target.
4. Seleziona IL2CPP in backend di script.
5. Seleziona le architetture desiderate scegliendo ARMv7, ARM64 o entrambe in Architetture di destinazione.
6. Seleziona Require in Accesso a internet.
7. Specifica il dominio della tua azienda in Package Name (Nome pacchetto).
8. Se Vulkan è stato selezionato come API Graphic:
   • Deseleziona la casella di controllo Applica la rotazione dello schermo durante il rendering nelle Impostazioni Vulkan.
   • Se la versione di Unity è la 2021.2 o successive, seleziona ETC2 nel formato di compressione della texture.
9. Se la versione di Unity è la 2023.1 o successive, seleziona Activity e deseleziona GameActivity in Punto di ingresso dell'applicazione.

Nota: è possibile utilizzare un livello API minimo inferiore modificando la compatibilità dell'API di rendering. Per maggiori informazioni, consulta l'SDK build.gradle.

Nota: se riscontri problemi quando selezioni Vulkan come API grafica, seleziona la casella Development Build in Build Settings e analizza i log di runtime per individuare errori di compatibilità dei driver.

Nota: OpenGL ES 2.0 non è più supportato nella versione OpenGL ES 2.0 o versioni successive. Per ulteriori informazioni, consulta la pagina Requisiti e compatibilità di Android nel manuale di Unity.

Impostazioni di pubblicazione

Vai a Impostazioni progetto > Player > Impostazioni di pubblicazione.

1. Nella sezione Crea, seleziona Custom Main Gradle Template e Custom Gradle Properties Template.

2. Aggiungi le seguenti righe alla sezione delle dipendenze di Assets/Plugins/Android/mainTemplate.gradle:

     implementation 'androidx.appcompat:appcompat:1.6.1'
     implementation 'com.google.android.gms:play-services-vision:20.1.3'
     implementation 'com.google.android.material:material:1.6.1'
     implementation 'com.google.protobuf:protobuf-javalite:3.19.4'
   

3. Aggiungi le seguenti righe a Assets/Plugins/Android/gradleTemplate.properties:

     android.enableJetifier=true
     android.useAndroidX=true
   

Nota: le dipendenze necessarie possono cambiare da una versione all'altra. Se vuoi utilizzare una versione diversa dalla release più recente, dai un'occhiata alla cronologia della sezione delle dipendenze in sdk/build.gradle del repository dell'SDK Cardboard.

Impostazioni di gestione dei plug-in XR

Vai a Impostazioni progetto > Gestione plug-in XR.

1. Seleziona Cardboard XR Plugin sotto Provider di plug-in.

Crea il tuo progetto

Vai a File > Impostazioni build.

1. Seleziona Crea o scegli un dispositivo e seleziona Crea ed esegui.

Configurazione delle impostazioni del progetto iOS

Vai a File > Impostazioni build.

1. Seleziona iOS e scegli Cambia piattaforma.
2. Seleziona Add Open Scenes (Aggiungi scene aperte) e scegli HelloCardboard.

Impostazioni del player

Risoluzione e presentazione

Vai a Impostazioni progetto > Player > Risoluzione e presentazione.

1. Imposta Orientamento predefinito su Orizzontale a sinistra o Orizzontale a destra.

Nota: sebbene siano supportati dal plug-in Cardboard XR, gli orientamenti Ritratto e Ritratto capovolto potrebbero non offrire abbastanza spazio per la visualizzazione degli occhi sui dispositivi.

Altre impostazioni

Vai a Impostazioni progetto > Player > Altre impostazioni.

1. In Videocamera Usage Description, scrivi Cardboard SDK requires camera permission to read the QR code (required to get the encoded device parameters)..
2. In Versione iOS minima target, scrivi 12.0.
3. Specifica il dominio della tua azienda in Package Name (Nome pacchetto).

Nota: se usi un iPhone X, seleziona l'opzione Nascondi il pulsante Home su iPhone X.

Impostazioni di gestione dei plug-in XR

Vai a Impostazioni progetto > Gestione plug-in XR.

1. Seleziona Cardboard XR Plugin sotto Provider di plug-in.

Crea il tuo progetto

Vai a File > Impostazioni build.

1. Seleziona Crea o Crea ed esegui.

Ultime novità

L'SDK Cardboard ti consente di ricentrare il tracker head utilizzando Recenter().

Segui questi passaggi per provare questa funzionalità utilizzando l'applicazione di esempio:

1. Sposta il dispositivo nella posizione che desideri ricentrare (utilizzalo come nuova posa della testa guardando avanti).
2. Tieni attivo il grilletto del tuo dispositivo Cardboard per almeno tre secondi.
3. Rilascia il trigger.
4. La posa iniziale è ora nella direzione in cui è rivolta la fotocamera.

Attivazione e disattivazione della modalità VR

L'API di gestione dei plug-in Unity XR ti consente di attivare o disattivare la modalità VR per il plug-in Google Cardboard XR per Unity. La documentazione per l'utente finale e gli esempi di utilizzo sono disponibili nella documentazione per l'utente finale di Unity.

La scena VrMode nell'esempio di HelloCardboard mostra un utilizzo di base dell'API modificata. In questa scena, è possibile disattivare la modalità VR toccando Esci e riattivarla semplicemente toccando un punto qualsiasi dello schermo. Visita VrModeController.cs per informazioni dettagliate su come viene eseguita questa operazione.

Passaggi successivi

• Leggi le linee guida per il branding di cardboard.