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).
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 ambientePATH
. 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.
- Apri Unity e crea un nuovo progetto 3D.
- In Unity, vai a Finestra > Gestione pacchetti.
- Fai clic su + e seleziona Aggiungi pacchetto da URL Git.
- Incolla
https://github.com/googlevr/cardboard-xr-plugin.git
nel campo di immissione di testo.
Il pacchetto dovrebbe essere aggiunto ai pacchetti installati. - Vai al pacchetto Google Cardboard XR Plug for Unity. Nella sezione Samples, scegli Importa nel progetto.
Gli asset di esempio devono essere caricati inAssets/Samples/Google Cardboard/<version>/Hello Cardboard
.
X.Y.Z
Configurazione della scena HelloCardboard in corso...
- Vai a
Assets/Samples/Google Cardboard/<version>/Hello Cardboard/Scenes
, seleziona Aggiungi scene aperte, quindi scegli HelloCardboard per aprire la scena di esempio. - Apri il menu Livelli e seleziona Modifica livelli....
- Definisci un nuovo livello denominato "Interattivo".
- 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".
- 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.
- Seleziona Android e scegli Cambia piattaforma.
- Seleziona Add Open Scenes (Aggiungi scene aperte) e scegli HelloCardboard.
Impostazioni del player
Risoluzione e presentazione
Vai a Impostazioni progetto > Player > Risoluzione e presentazione.
- Imposta Orientamento predefinito su Orizzontale a sinistra o Orizzontale a destra.
- Disattiva l'opzione Pacing del frame ottimizzato.
Altre impostazioni
Vai a Impostazioni progetto > Player > Altre impostazioni.
- Scegli
OpenGLES2
,OpenGLES3
oVulkan
o una qualsiasi combinazione di queste opzioni nelle API grafiche. - Seleziona
Android 8.0 'Oreo' (API level 26)
o un livello superiore in Livello API minimo. - Seleziona
API level 33
o un livello superiore in Livello API target. - Seleziona
IL2CPP
in backend di script. - Seleziona le architetture desiderate scegliendo
ARMv7
,ARM64
o entrambe in Architetture di destinazione. - Seleziona
Require
in Accesso a internet. - Specifica il dominio della tua azienda in Package Name (Nome pacchetto).
- 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.
- Se la versione di Unity è la 2023.1 o successive, seleziona
Activity
e deselezionaGameActivity
in Punto di ingresso dell'applicazione.
Impostazioni di pubblicazione
Vai a Impostazioni progetto > Player > Impostazioni di pubblicazione.
- Nella sezione Crea, seleziona
Custom Main Gradle Template
eCustom Gradle Properties Template
. 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'
Aggiungi le seguenti righe a
Assets/Plugins/Android/gradleTemplate.properties
:android.enableJetifier=true android.useAndroidX=true
Impostazioni di gestione dei plug-in XR
Vai a Impostazioni progetto > Gestione plug-in XR.
- Seleziona
Cardboard XR Plugin
sotto Provider di plug-in.
Crea il tuo progetto
Vai a File > Impostazioni build.
- Seleziona Crea o scegli un dispositivo e seleziona Crea ed esegui.
Configurazione delle impostazioni del progetto iOS
Vai a File > Impostazioni build.
- Seleziona iOS e scegli Cambia piattaforma.
- Seleziona Add Open Scenes (Aggiungi scene aperte) e scegli HelloCardboard.
Impostazioni del player
Risoluzione e presentazione
Vai a Impostazioni progetto > Player > Risoluzione e presentazione.
- Imposta Orientamento predefinito su Orizzontale a sinistra o Orizzontale a destra.
Altre impostazioni
Vai a Impostazioni progetto > Player > Altre impostazioni.
- In Videocamera Usage Description, scrivi
Cardboard SDK requires camera permission to read the QR code (required to get the encoded device parameters).
. - In Versione iOS minima target, scrivi
12.0
. - Specifica il dominio della tua azienda in Package Name (Nome pacchetto).
Impostazioni di gestione dei plug-in XR
Vai a Impostazioni progetto > Gestione plug-in XR.
- Seleziona
Cardboard XR Plugin
sotto Provider di plug-in.
Crea il tuo progetto
Vai a File > Impostazioni build.
- 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:
- Sposta il dispositivo nella posizione che desideri ricentrare (utilizzalo come nuova posa della testa guardando avanti).
- Tieni attivo il grilletto del tuo dispositivo Cardboard per almeno tre secondi.
- Rilascia il trigger.
- 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.