Guide de démarrage rapide pour Google Cardboard pour Unity

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

Remarque :Veillez à 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 smartphone peut afficher des scènes 3D avec 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 de la visionneuse.

Pour commencer, vous utiliserez HelloCardboard, un jeu de démonstration qui présente les principales fonctionnalités du SDK Cardboard. Dans le jeu, les utilisateurs parcourent un monde virtuel pour trouver et collecter des objets. Il vous montre comment:

• Configurer l'environnement de développement
• Télécharger et créer l'application de démonstration
• Scannez le code QR d'une visionneuse Cardboard pour enregistrer ses paramètres
• Suivre les mouvements de la tête de l'utilisateur
• Réglez la distorsion pour chaque œil pour le rendu d'images stéréoscopiques
• Activer et désactiver le mode RV

Configurer l'environnement de développement

Configuration logicielle requise:

• Unity 2021.3.32f1 ou version ultérieure
  • Veillez à inclure la prise en charge des builds Android et iOS lors de l'installation.
• Git doit être installé et l'exécutable git doit se trouver sur la variable d'environnement PATH. Pour en savoir plus, consultez la documentation concernant l'assistance Git du 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 paquets).
3. Cliquez sur +, puis sélectionnez Add package from git URL (Ajouter un package à partir de l'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 Samples (Exemples), sélectionnez Import into Project (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 HelloCardboard pour ouvrir l'exemple de scène.
2. Ouvrez le menu Calques et sélectionnez Modifier les calques.
3. Définissez une nouvelle couche appelée "Interactive".
4. Cliquez sur le GameObject Treasure pour ouvrir la fenêtre de l'outil d'inspection. Définissez son calque sur "Interactif". Si une fenêtre pop-up apparaît vous demandant si vous souhaitez également définir le calque sur Interactif pour tous les objets enfants, cliquez sur "Oui, modifier les enfants".
5. Cliquez sur le GameObject Player > Camera > CarboardReticlePointer (Lecteur > Appareil photo > CarboardReticlePointer) pour ouvrir la fenêtre de l'inspecteur. Dans le script "Pointeur de réticule Carboard", sélectionnez "Interactive" pour le champ Reticle Interaction Layer Mask (Masque de couche d'interaction Reticle).

Configurer les paramètres d'un projet Android

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

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

Paramètres du lecteur

Résolution et présentation

Accédez à Project Settings > Player > Resolution and Presentation (Paramètres du projet > Lecteur > Résolution et présentation).

1. Définissez l'orientation par défaut sur Paysage à gauche ou Paysage à droite.
2. Désactivez l'option Optimized Frame Pacing (Frame pacing optimisé).

Remarque :Bien qu'elles soient compatibles avec le plug-in Card XR, les orientations Portrait et Portrait à l'envers peuvent ne pas laisser suffisamment d'espace pour le rendu visuel sur les appareils.

Autres paramètres

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

1. Choisissez OpenGLES2, OpenGLES3 ou Vulkan, ou une combinaison de ces éléments dans les API graphiques.
2. Sélectionnez Android 8.0 'Oreo' (API level 26) ou un niveau supérieur dans Minimum API Level (Niveau d'API minimal).
3. Sélectionnez API level 33 ou une version ultérieure dans Niveau d'API cible.
4. Sélectionnez IL2CPP dans Backend de script.
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. Indiquez le domaine de votre entreprise sous Package Name (Nom du package).
8. Si Vulkan a été sélectionné comme API Graphics :
   • Décochez la case Apply display rotation when revenue (Appliquer la rotation de l'écran pendant le rendu) dans les paramètres Vulkan.
   • Si la version Unity est 2021.2 ou ultérieure, sélectionnez ETC2 dans le champ Format de compression de texture.
9. Si Unity version 2023.1 ou ultérieure, sélectionnez Activity et effacez GameActivity dans Application Entry Point (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 la 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é avec les pilotes.

Remarque:OpenGL ES 2.0 n'est plus compatible avec les versions Vulkan 2023.1 et ultérieures d'Unity. Pour les versions Vulkan 2023.1 et ultérieures. Pour en savoir plus, consultez la page Configuration requise pour Android et compatibilité du manuel Unity.

Paramètres de publication

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

1. Dans la section Build (Compiler), 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.6.1'
     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 nécessaires peuvent varier d'une version à l'autre. Si vous souhaitez utiliser une version différente de la version la plus récente, consultez l'historique de la section des dépendances dans le fichier sdk/build.gradle pour le dépôt du SDK Cardboard.

Paramètres de gestion des plug-ins XR

Accédez à Project Settings (Paramètres du projet) > XR Plug-in Management (Gestion des plug-ins XR).

1. Sélectionnez Cardboard XR Plugin sous Plug-in Providers (Fournisseurs de plug-ins).

Compiler votre projet

Accédez à File > Build Settings (Fichier > 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 d'un projet iOS

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

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

Paramètres du lecteur

Résolution et présentation

Accédez à Project Settings > Player > Resolution and Presentation (Paramètres du projet > Lecteur > Résolution et présentation).

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

Remarque :Bien qu'elles soient compatibles avec le plug-in Card XR, les orientations Portrait et Portrait à l'envers peuvent ne pas laisser suffisamment d'espace pour le rendu visuel sur les appareils.

Autres paramètres

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

1. Dans Camera Usage Description (Description de l'utilisation de la caméra), saisissez Cardboard SDK requires camera permission to read the QR code (required to get the encoded device parameters)..
2. Dans le champ Version minimale cible d'iOS, écrivez 12.0.
3. Indiquez le domaine de votre entreprise sous Package Name (Nom du package).

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

Paramètres de gestion des plug-ins XR

Accédez à Project Settings (Paramètres du projet) > XR Plug-in Management (Gestion des plug-ins XR).

1. Sélectionnez Cardboard XR Plugin sous Plug-in Providers (Fournisseurs de plug-ins).

Compiler votre projet

Accédez à File > Build Settings (Fichier > 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 Head Tracker à l'aide de Recenter().

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

1. Déplacez l'appareil vers la position que vous souhaitez recentrer (utilisez-le comme nouvelle pose de tête orientée vers l'avant).
2. Maintenez le déclencheur de votre appareil Cardboard actif pendant au moins trois secondes.
3. Relâchez le déclencheur.
4. La posture initiale est maintenant dans la direction vers laquelle pointe l'appareil photo.

Activer et désactiver le mode RV

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

La scène VrMode de l'exemple HelloCardboard illustre une utilisation de base de l'API susmentionnée. Dans cette scène, vous pouvez désactiver le mode RV en appuyant sur Quitter . Vous pouvez le réactiver en appuyant n'importe où sur l'écran. Consultez VrModeController.cs pour en savoir plus sur cette procédure.

Étapes suivantes

• Consultez les Consignes relatives à la marque Cardboard.