Guida rapida di Google Cardboard per Unity

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

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

Puoi utilizzare l'SDK Cardboard per trasformare un cellulare in una piattaforma VR. Un dispositivo mobile può visualizzare scene 3D con rendering stereoscopico, tracciare e reagire ai movimenti della testa e interagire con le app rilevando quando l'utente preme il pulsante del visore.

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

• Configurazione dell'ambiente di sviluppo
• Scaricare e creare l'app demo
• Scansionare il codice QR di un visore Cardboard per salvare i relativi parametri
• Tracciare i movimenti della testa dell'utente
• Esegui il rendering di immagini stereoscopiche impostando la distorsione corretta per ogni occhio
• Attivare e disattivare la modalità VR

Configurazione dell'ambiente di sviluppo

Requisiti software:

• Unity 6000.0.23f1 o versioni successive
  • Assicurati di includere il supporto per la compilazione di Android e iOS durante l'installazione.
  • Assicurati di installare la versione patch 23f1 o successive.
• Git deve essere installato e l'eseguibile git deve trovarsi nella variabile di ambiente PATH. Per ulteriori dettagli, consulta la documentazione relativa al supporto di git per il package manager di Unity.

Importa l'SDK e crea un nuovo progetto

Per importare l'SDK Unity e creare un nuovo progetto:

1. Apri Unity e crea un nuovo progetto 3D.
2. In Unity, vai a Window > Package Manager.
3. Fai clic su + e seleziona Aggiungi pacchetto dall'URL git.
4. Incolla https://github.com/googlevr/cardboard-xr-plugin.git nel campo di inserimento del testo.
   Il pacchetto deve essere aggiunto ai pacchetti installati.
5. Vai al pacchetto Google Cardboard XR Plugin for Unity. Nella sezione Campioni, 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 semantica X.Y.Z del pacchetto rilasciato (ad esempio, 1.1.0).

Configurare la scena HelloCardboard

1. Vai a Assets/Samples/Google Cardboard/<version>/Hello Cardboard/Scenes, seleziona Aggiungi scene aperte e 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 sull'oggetto di gioco Tesoro per aprire la finestra dell'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 i secondari".
5. Fai clic sull'oggetto di gioco Player > Camera > CardboardReticlePointer per aprire la finestra Inspector. Nello script "Cardboard reticle pointer", seleziona "Interactive" come Reticle Interaction Layer Mask.

Configurare le impostazioni di build di Android

Vai a File > Build Settings (Impostazioni build).

1. Seleziona Android e scegli Cambia piattaforma.
2. Seleziona Aggiungi Open Scenes e scegli HelloCardboard.

Impostazioni del player

Vai a Modifica > Impostazioni progetto….

Configurare le impostazioni di risoluzione e presentazione

Vai a Player > Risoluzione e presentazione.

1. Imposta l'orientamento predefinito su Orizzontale sinistra o Orizzontale destra.
2. Disattiva Ottimizzazione del pacing dei frame.

Nota: sebbene supportate dal plug-in Cardboard XR, le orientazioni Verticale e Verticale capovolto potrebbero non fornire spazio sufficiente per il rendering degli occhi sui dispositivi.

Configurare Altre impostazioni

Vai a Player > Altre impostazioni.

1. Scegli OpenGLES2, OpenGLES3 o Vulkan o qualsiasi combinazione di questi in API grafiche.
2. Seleziona Android 8.0 'Oreo' (API level 26) o versioni successive in Livello API minimo.
3. Seleziona API level 35 o un valore superiore in Livello API target.
4. Seleziona IL2CPP in Scripting Backend.
5. Seleziona le architetture che preferisci scegliendo ARMv7, ARM64 o entrambe in Architetture di destinazione.
6. Seleziona Require in Accesso a internet.
7. Seleziona Input System Package (New) in Gestione input attivo.
8. Specifica il dominio della tua azienda in Nome pacchetto.
9. Se Vulkan è stato selezionato come API Graphics:
   • Deseleziona la casella di controllo Applica la rotazione del display durante il rendering in Impostazioni Vulkan.
   • Seleziona ETC2 in Formato di compressione delle texture.
10. Seleziona Activity e deseleziona GameActivity in Application Entry Point.

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

Nota: se riscontri problemi durante la selezione di Vulkan come API grafica, seleziona la casella Development Build in Build Settings e analizza i log di runtime alla ricerca di errori di compatibilità dei driver.

Nota: OpenGL ES 2.0 non è più supportato in Unity 2023.1 e versioni successive. Per le versioni più recenti, utilizza OpenGL ES 3.0 o Vulkan. Per ulteriori informazioni, consulta la pagina Requisiti e compatibilità di Android nel manuale di Unity.

Configurare le impostazioni di pubblicazione

Vai a Player > Impostazioni di pubblicazione.

1. Nella sezione Build, 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.12.0'
     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 variare tra le versioni. Se vuoi utilizzare una versione diversa da quella più recente, consulta la cronologia della sezione delle dipendenze in sdk/build.gradle del repository dell'SDK Cardboard.

Configurare le impostazioni di gestione dei plug-in XR

Vai a Gestione plug-in XR.

1. Seleziona Cardboard XR Plugin nella sezione Fornitori di plug-in.

Crea il tuo progetto

Vai a File > Build Settings (Impostazioni build).

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

Configurare le impostazioni del progetto iOS

Vai a File > Build Settings (Impostazioni build).

1. Seleziona iOS e scegli Cambia piattaforma.
2. Seleziona Aggiungi Open Scenes e scegli HelloCardboard.

Impostazioni del player

Vai a Modifica > Impostazioni progetto….

Configurare le impostazioni di risoluzione e presentazione

Vai a Player > Risoluzione e presentazione.

1. Imposta l'orientamento predefinito su Orizzontale sinistra o Orizzontale destra.

Nota: sebbene supportate dal plug-in Cardboard XR, le orientazioni Verticale e Verticale capovolto potrebbero non fornire spazio sufficiente per il rendering degli occhi sui dispositivi.

Configurare Altre impostazioni

Vai a Player > Altre impostazioni.

1. In Descrizione dell'utilizzo della videocamera, scrivi Cardboard SDK requires camera permission to read the QR code (required to get the encoded device parameters)..
2. In Versione minima di iOS di destinazione, scrivi 12.0.
3. Specifica il dominio della tua azienda in Nome pacchetto.
4. Controlla Top Edge, Left Edge e Right Edge in Posticipa i gesti di sistema sui bordi.

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

Configurare le impostazioni di gestione dei plug-in XR

Vai a Gestione plug-in XR.

1. Seleziona Cardboard XR Plugin nella sezione Fornitori di plug-in.

Crea il tuo progetto

Vai a File > Build Settings (Impostazioni build).

1. Seleziona Crea o Crea ed esegui.

Ricentra

L'SDK Cardboard ti consente di recentrare il rilevamento della testa utilizzando Recenter().

Per provarlo utilizzando l'applicazione di esempio, segui questi passaggi:

1. Sposta il dispositivo nella posizione in cui vuoi ricentrare (utilizza la nuova posa della testa in avanti).
2. Tieni premuto il grilletto del visore Cardboard per almeno tre secondi.
3. Rilascia il grilletto.
4. La posa iniziale è ora nella direzione in cui è puntata la videocamera.

Attivare e disattivare la modalità VR

L'API Unity XR Plugin Management 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 HelloCardboard mostra un utilizzo di base dell'API menzionata in precedenza. In questa scena, la modalità VR può essere disattivata toccando Esci e può essere riattivata semplicemente toccando un punto qualsiasi dello schermo. Per informazioni dettagliate su come viene eseguita questa operazione, consulta VrModeController.cs.

Passaggi successivi

• Consulta le linee guida per il branding di Cardboard.