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 créer vos propres expériences de réalité virtuelle (RV).

Remarque :Veillez à consulter les consignes relatives au branding de Cardboard avant de distribuer votre application à un public 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 un rendu stéréoscopique, suivre et réagir aux mouvements de la tête, et interagir avec les applications en détectant quand l'utilisateur appuie sur le bouton du visualiseur.

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 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 code QR d'une visionneuse Cardboard pour enregistrer ses paramètres
• Suivre les mouvements de la tête de l'utilisateur
• Affichez 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 2021.3.44f1 ou version ultérieure
  • Veillez à inclure la prise en charge des builds Android et iOS lors de l'installation.
  • Assurez-vous d'installer le correctif 44f1 ou une version ultérieure.
• Git doit être installé et l'exécutable git doit se trouver dans la variable d'environnement PATH. Pour en savoir plus, consultez la documentation sur la prise en charge de Git par le gestionnaire de paquets d'Unity.

Importer le SDK et créer un projet

Pour importer le SDK Unity et créer un projet, procédez comme suit :

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 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 Samples (Échantillons), 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> est le 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 (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é "Interactif".
4. Cliquez sur l'objet de jeu Trésor pour ouvrir la fenêtre de l'outil d'inspection. Définissez son calque sur "Interactif". Si une fenêtre pop-up s'affiche pour vous demander si vous souhaitez définir le calque sur "Interactif" pour tous les objets enfants, cliquez sur "Oui, modifier les enfants".
5. Cliquez sur l'objet de jeu Player > Camera > CardboardReticlePointer pour ouvrir la fenêtre de l'outil d'inspection. Dans le script "Pointeur de réticule Cardboard", sélectionnez "Interactif" comme Masque de calque d'interaction du réticule.

Configurer les paramètres du projet Android

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

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

Paramètres du lecteur

Résolution et présentation

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

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

Remarque :Bien que compatibles avec le plug-in Cardboard XR, les orientations Portrait et Portrait à l'envers peuvent ne pas fournir suffisamment d'espace pour le rendu des yeux sur les appareils.

Autres paramètres

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

1. Choisissez OpenGLES2, OpenGLES3 ou Vulkan, ou toute combinaison de ces éléments dans les API graphiques.
2. Sélectionnez Android 8.0 'Oreo' (API level 26) ou une version ultérieure dans 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 Scripting Backend (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. Sélectionnez Input System Package (New) dans 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 graphique :
   • Décochez la case Appliquer la rotation de l'écran pendant le rendu dans les paramètres Vulkan.
   • Si la version d'Unity est 2021.2 ou ultérieure, sélectionnez ETC2 dans Texture compression format (Format de compression des textures).
10. Si la version d'Unity est 2023.1 ou ultérieure, sélectionnez Activity et effacez GameActivity dans Point d'entrée de l'application.

Remarque :Vous pouvez utiliser un niveau d'API minimum inférieur en modifiant la compatibilité de l'API de rendu. Pour en savoir plus, consultez la documentation 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é du pilote.

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.

Paramètres de publication

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

1. Dans la section Build (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 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 Fournisseurs de plug-ins.

Compiler votre projet

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

1. Sélectionnez Build (Générer), ou choisissez un appareil et sélectionnez Build and Run (Générer 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 Switch Platform (Changer de plate-forme).
2. Sélectionnez Ajouter des scènes ouvertes, puis HelloCardboard.

Paramètres du lecteur

Résolution et présentation

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

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

Remarque :Bien que compatibles avec le plug-in Cardboard XR, les orientations Portrait et Portrait à l'envers peuvent ne pas fournir suffisamment d'espace pour le rendu des yeux sur les appareils.

Autres paramètres

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

1. Dans 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 Version minimale d'iOS cible, saisissez 12.0.
3. Indiquez le domaine de votre entreprise sous Package Name (Nom du package).

Remarque :Si vous utilisez un iPhone X, sélectionnez l'option Masquer le bouton d'accueil sur 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 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).

Recentrage

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

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

1. Déplacez l'appareil vers la position que vous souhaitez recentrer (utilisez-le comme nouvelle position de la tête orientée 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 maintenant dans la direction de la caméra.

Activer et désactiver le mode VR

L'API de gestion des plug-ins XR Unity vous permet d'activer ou de désactiver le mode VR pour le plug-in XR Google Cardboard pour Unity. La documentation destinée aux utilisateurs finaux et les 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 mentionnée ci-dessus. Dans cette scène, vous pouvez désactiver le mode VR en appuyant sur Quitter , et l'activer à nouveau en appuyant n'importe où sur l'écran. Consultez VrModeController.cs pour savoir comment procéder.

Étapes suivantes

• Consultez les Consignes relatives au branding de Cardboard.