Guide de démarrage rapide pour Google Cardboard pour Unity

Ce guide vous explique comment utiliser le plug-in Google Cardboard XR pour Unity afin de créer vos propres expériences de réalité virtuelle (RV).

Remarque : Assurez-vous de consulter les Consignes relatives à la marque Cardboard avant de distribuer votre application à une audience plus large.

Vous pouvez utiliser le SDK Cardboard pour transformer un téléphone mobile en plate-forme de réalité virtuelle. Un appareil mobile peut afficher des scènes 3D avec un rendu stéréoscopique, suivre les mouvements de la tête et y réagir, et interagir avec les applications en détectant lorsque l'utilisateur appuie sur le bouton du casque.

Pour commencer, vous allez utiliser HelloCardboard, un jeu de démonstration qui illustre les principales fonctionnalités du SDK Cardboard. Dans le jeu, les utilisateurs explorent un monde virtuel pour trouver et collecter des objets. Il vous explique comment :

• Configurer l'environnement de développement
• Télécharger et compiler l'application de démonstration
• Scanner le QR code d'une visionneuse Cardboard pour enregistrer ses paramètres
• Suivre les mouvements de la tête de l'utilisateur
• Afficher des images stéréoscopiques en définissant la distorsion appropriée pour chaque œil
• Activer et désactiver le mode VR

Configurer l'environnement de développement

Configuration logicielle requise :

• Unity 6000.0.23f1 ou version ultérieure
  • Veillez à inclure la prise en charge des builds Android et iOS lors de l'installation.
  • Assurez-vous d'installer la version corrective 23f1 ou ultérieure.
• Git doit être installé et l'exécutable git doit figurer dans la variable d'environnement PATH. Pour en savoir plus, consultez la documentation sur la compatibilité de Git avec le gestionnaire de packages Unity.

Importer le SDK et créer un projet

Suivez ces étapes pour importer le SDK Unity et créer un projet.

1. Ouvrez Unity et créez un projet 3D.
2. Dans Unity, accédez à Window > Package Manager (Fenêtre > Gestionnaire de packages).
3. Cliquez sur +, puis sélectionnez Add package from git URL (Ajouter un package à l'aide d'une URL Git).
4. Collez https://github.com/googlevr/cardboard-xr-plugin.git dans le champ de saisie de texte.
    Le package doit être ajouté aux packages installés.
5. Accédez au package Google Cardboard XR Plugin for Unity. Dans la section Exemples, sélectionnez Importer dans le projet.
    Les exemples d'éléments doivent être chargés dans Assets/Samples/Google Cardboard/<version>/Hello Cardboard.

Remarque : <version> correspond au numéro de version sémantique X.Y.Z du package publié (par exemple, 1.1.0).

Configurer la scène HelloCardboard

1. Accédez à Assets/Samples/Google Cardboard/<version>/Hello Cardboard/Scenes, sélectionnez Add Open Scenes (Ajouter des scènes ouvertes), puis choisissez HelloCardboard pour ouvrir l'exemple de scène.
2. Ouvrez le menu Calques, puis sélectionnez Modifier les calques….
3. Définissez un nouveau calque appelé "Interactive".
4. Cliquez sur l'objet de jeu Treasure pour ouvrir la fenêtre de l'inspecteur. Définissez son calque sur "Interactive". Si une fenêtre pop-up vous demande si vous souhaitez définir le calque sur "Interactif" pour tous les objets enfants également, cliquez sur "Oui, modifier les enfants".
5. Cliquez sur l'objet de jeu Player > Camera > CardboardReticlePointer pour ouvrir la fenêtre "Inspector" (Inspecteur). Dans le script "Cardboard reticle pointer", sélectionnez "Interactive" comme Reticle Interaction Layer Mask.

Configurer les paramètres de compilation Android

Accédez à File (Fichier) > Build Settings (Paramètres de compilation).

1. Sélectionnez Android, puis cliquez sur Switch Platform (Changer de plate-forme).
2. Sélectionnez Add Open Scenes (Ajouter des scènes ouvertes), puis choisissez HelloCardboard.

Paramètres du lecteur

Accédez à Edit (Modifier) > Project Settings… (Paramètres du projet…).

Configurer les paramètres de résolution et de présentation

Accédez à Lecteur > Résolution et présentation.

1. Définissez l'orientation par défaut sur Paysage à gauche ou Paysage à droite.
2. Désactivez Optimiser le frame pacing.

Remarque : Bien que le plug-in Cardboard XR soit compatible avec les orientations Portrait et Portrait Upside Down, il est possible qu'elles ne laissent pas suffisamment de place pour le rendu des yeux sur les appareils.

Configurer d'autres paramètres

Accédez à Player > Other Settings (Lecteur > Autres paramètres).

1. Choisissez OpenGLES2, OpenGLES3 ou Vulkan, ou toute combinaison de ces éléments dans API Graphics.
2. Sélectionnez Android 8.0 'Oreo' (API level 26) ou une version ultérieure dans Minimum API Level (Niveau d'API minimal).
3. Sélectionnez API level 35 ou une version ultérieure dans Niveau d'API cible.
4. Sélectionnez IL2CPP dans Scripting Backend.
5. Sélectionnez les architectures souhaitées en choisissant ARMv7, ARM64 ou les deux dans Architectures cibles.
6. Sélectionnez Require dans Accès à Internet.
7. Sélectionnez Input System Package (New) dans Active Input Handling (Gestion active des entrées).
8. Indiquez le domaine de votre entreprise sous Package Name (Nom du package).
9. Si Vulkan a été sélectionné comme API pour les graphismes :
   • Décochez la case Appliquer la rotation de l'écran pendant le rendu dans Paramètres Vulkan.
   • Sélectionnez ETC2 dans Format de compression de texture.
10. Sélectionnez Activity et supprimez GameActivity dans Point d'entrée de l'application.

Remarque : Il est possible d'utiliser un niveau d'API minimal inférieur en modifiant la compatibilité de l'API de rendu. Pour en savoir plus, consultez build.gradle du SDK.

Remarque : Si vous rencontrez des problèmes lors de la sélection de Vulkan comme API graphique, cochez la case Development Build dans Build Settings et analysez les journaux d'exécution à la recherche d'erreurs de compatibilité des pilotes.

Remarque : OpenGL ES 2.0 n'est plus pris en charge dans Unity 2023.1 et versions ultérieures. Pour les versions plus récentes, utilisez plutôt OpenGL ES 3.0 ou Vulkan. Pour en savoir plus, consultez la page Exigences et compatibilité Android du manuel Unity.

Configurer les paramètres de publication

Accédez à Player > Publishing Settings (Lecteur > Paramètres de publication).

1. Dans la section Compilation, sélectionnez Custom Main Gradle Template et Custom Gradle Properties Template.

2. Ajoutez les lignes suivantes à la section des dépendances de 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. Ajoutez les lignes suivantes à Assets/Plugins/Android/gradleTemplate.properties :

     android.enableJetifier=true
     android.useAndroidX=true
   

Remarque : Les dépendances requises peuvent varier d'une version à l'autre. Si vous souhaitez utiliser une version différente de la dernière version, consultez l'historique de la section des dépendances dans sdk/build.gradle du dépôt SDK Cardboard.

Configurer les paramètres de gestion des plug-ins XR

Accédez à XR Plug-in Management (Gestion des plug-ins XR).

1. Sélectionnez Cardboard XR Plugin sous Fournisseurs de plug-ins.

Compiler votre projet

Accédez à File (Fichier) > Build Settings (Paramètres de compilation).

1. Sélectionnez Build (Compiler), ou choisissez un appareil et sélectionnez Build and Run (Compiler et exécuter).

Configurer les paramètres du projet iOS

Accédez à File (Fichier) > Build Settings (Paramètres de compilation).

1. Sélectionnez iOS, puis cliquez sur Switch Platform (Changer de plate-forme).
2. Sélectionnez Add Open Scenes (Ajouter des scènes ouvertes), puis choisissez HelloCardboard.

Paramètres du lecteur

Accédez à Edit (Modifier) > Project Settings… (Paramètres du projet…).

Configurer les paramètres de résolution et de présentation

Accédez à Player > Resolution and Presentation (Lecteur > Résolution et présentation).

1. Définissez l'orientation par défaut sur Paysage à gauche ou Paysage à droite.

Remarque : Bien que le plug-in Cardboard XR soit compatible avec les orientations Portrait et Portrait Upside Down, il est possible qu'elles ne laissent pas suffisamment de place pour le rendu des yeux sur les appareils.

Configurer d'autres paramètres

Accédez à Player > Other Settings (Lecteur > Autres paramètres).

1. Dans Description de l'utilisation de l'appareil photo, saisissez Cardboard SDK requires camera permission to read the QR code (required to get the encoded device parameters)..
2. Dans Version minimale d'iOS cible, saisissez 12.0.
3. Indiquez le domaine de votre entreprise sous Package Name (Nom du package).
4. Cochez Top Edge, Left Edge et Right Edge dans Différer les gestes système sur les bords.

Remarque : Si vous utilisez un iPhone X, sélectionnez l'option Masquer le bouton d'accueil sur l'iPhone X.

Configurer les paramètres de gestion des plug-ins XR

Accédez à XR Plug-in Management (Gestion des plug-ins XR).

1. Sélectionnez Cardboard XR Plugin sous Fournisseurs de plug-ins.

Compiler votre projet

Accédez à File (Fichier) > Build Settings (Paramètres de compilation).

1. Sélectionnez Build (Compiler) ou Build and Run (Compiler et exécuter).

Recentrer

Le SDK Cardboard vous permet de recentrer le capteur de mouvements de la tête à l'aide de Recenter().

Pour tester la fonctionnalité à l'aide de l'exemple d'application, procédez comme suit :

1. Déplacez l'appareil vers la position que vous souhaitez recentrer (en utilisant une pose de tête vers l'avant).
2. Maintenez le déclencheur de votre appareil Cardboard enfoncé pendant au moins trois secondes.
3. Relâchez le déclencheur.
4. La pose initiale est désormais dans la direction vers laquelle pointe la caméra.

Activer et désactiver le mode VR

L'API Unity XR Plugin Management vous permet d'activer ou de désactiver le mode VR pour le plug-in Google Cardboard XR pour Unity. La documentation pour les utilisateurs finaux et des exemples d'utilisation sont disponibles dans la documentation pour les utilisateurs finaux d'Unity.

La scène VrMode de l'exemple HelloCardboard montre une utilisation de base de l'API susmentionnée. Dans cette scène, vous pouvez désactiver le mode VR en appuyant sur Quitter . Pour le réactiver, il vous suffit d'appuyer n'importe où sur l'écran. Pour en savoir plus sur la façon dont cela est effectué, consultez VrModeController.cs.

Étapes suivantes

• Consultez les Consignes relatives à la marque Cardboard.