Premiers pas avec le SDK Interaction

• Configuration d’Unity pour le développement XR pour créer un projet avec les dépendances nécessaires
• Configurer votre appareil pour configurer et tester votre projet sur un casque
• Suivre la configuration du SDK Interaction

1. Supprimez la caméra principale par défaut, car le SDK Interaction utilise son propre rig.
2. Faites un clic droit sur Hierarchy (Hiérarchie), puis sélectionnez Interaction SDK > action rapide Add OVR Interaction Rig (SDK Interaction > Ajouter le rig d’interaction OVR).
   
3. Si un prefab OVRCameraRig est déjà présent dans la scène, il apparaîtra dans l’assistant. Dans le cas contraire, cliquez sur Fix All (Tout résoudre) pour que l’assistant crée un prefab de rig de caméra.
   
4. Si vous n’avez pas besoin du déplacement fluide dans votre scène, désactivez l’option Smooth Locomotion (Déplacement fluide), autrement votre caméra pourrait subir une chute sans fin au démarrage de la scène en l’absence d’un collisionneur au sol.
5. Dans Unity, il est impossible d’enregistrer les modifications apportées à un prefab de rig directement dans un dossier de package, mais Unity 2022+ vous permet de créer une copie du prefab et d’y effectuer des remplacements selon vos besoins. Sélectionnez Generate as Editable Copy (Générer comme copie modifiable), puis définissez le chemin d’accès du prefab où conserver une copie intermédiaire du prefab de rig dans laquelle sauvegarder autant de remplacements que nécessaire.
6. Pour personnaliser davantage encore le rig, ajustez les paramètres dans l’assistant. Pour obtenir des détails sur les options disponibles, reportez-vous à la documentation OVR Interaction Rig Quick Action (Action rapide de rig d’interaction OVR).
7. Cliquez sur Create (Créer) pour ajouter le rig d’interaction OVR à la scène.
   
8. Dans le panneau Hierarchy (Hiérarchie), sélectionnez le prefab OVRCameraRig.
9. Sous l’onglet Inspector (Inspecteur), accédez à OVR Manager (Gestionnaire OVR) > Quest Features (Fonctionnalités Quest), puis, dans l’onglet General (Générales), dans la liste Hand Tracking Support (Prise en charge du suivi des mains), sélectionnez Controllers and Hands (Manettes et mains), Hands Only (Mains uniquement) ou Controllers Only (Manettes uniquement), selon vos besoins. L’option Hands Only (Mains uniquement) vous permet d’utiliser les mains comme méthode d’entrée sans aucune manette.

1. Dans le panneau Project (Projet), accédez à Packages > Meta XR Interaction SDK Essentials > Runtime > Sample > Objects > UISet > Prefabs > dossier Backplate et ajoutez un fond visuel pour l’UI en faisant glisser le prefab EmptyUIBackplateWithCanvas vers le panneau Hiérarchie.
   
   Le prefab du fond visuel contient un Canvas, un arrière-plan pour l’UI, quelques composants de disposition de base, et des composants interactifs de rayon et de poke permettant les interactions de toucher direct et de lancer de rayon avec l’UI.
   
2. Dans la hiérarchie, sélectionnez CanvasRoot. Dans l’Inspecteur, sous Rect Transform (Transformation rectangulaire), vous pouvez utiliser les propriétés Largeur et Hauteur pour définir la taille du canevas. Dans cet exemple, nous avons utilisé les paramètres suivants afin de définir une taille adaptée pour quelques composants :
   • Rect Transform (Transformation rectangulaire) > Largeur : 500
   • Rect Transform (Transformation rectangulaire) > Hauteur : 250
3. Dans la hiérarchie, sélectionnez UIBackplate. Dans l’Inspecteur, sous Rect Transform (Transformation rectangulaire), définissez des propriétés Largeur et Hauteur correspondant à celles du canevas, définies à l’étape précédente. Dans cet exemple, nous avons utilisé les paramètres suivants pour correspondre à la taille du canevas :
   • Rect Transform (Transformation rectangulaire) > Largeur : 500
   • Rect Transform (Transformation rectangulaire) > Hauteur : 250
4. Ajoutez des éléments d’UI au panneau avec lequel interagir en glissant et déposant des prefabs à partir du dossier Packages > Meta XR Interaction SDK Essentials > Runtime > Sample > Objects > UISet > dossier Prefabs. Par exemple, dans Buttons > dossier UnityUIButtonBased, faites glisser le prefab PrimaryButton_IconAndLabel_UnityUIButton vers l’objet UIBackplate dans la hiérarchie. L’élément de bouton apparaît dans l’UI. Ajoutez autant d’éléments que vous le souhaitez pour créer votre UI.
   

1. Cliquez avec le bouton droit sur l’objet Canvas pour votre UI et sélectionnez Interaction SDK > Add Grab Interaction (SDK Interaction > Ajouter une interaction de saisie). L’assistant de saisie apparaît.
   
2. Dans l’assistant de saisie, sélectionnez Fix All (Tout résoudre) pour résoudre toutes les erreurs. Cela aura pour effet d’ajouter des composants ou des champs manquants s’ils se révèlent nécessaires.
   
3. Pour personnaliser davantage l’interaction, ajustez ses paramètres dans l’assistant. Pour obtenir des détails sur les options disponibles, reportez-vous à la documentation Action rapide de saisie.
4. Sélectionnez Create (Créer). L’assistant ajoute automatiquement les composants nécessaires pour l’interaction au GameObject. Il ajoute également des composants au rig de caméra si ces composants n’étaient pas déjà présents.
   

1. Ouvrez l’application de bureau Link sur votre ordinateur.
2. Mettez votre casque et, lorsque vous y êtes invité·e, activez Link.
3. Sur votre machine de développement, dans l’éditeur Unity, sélectionnez le bouton Play (Lire).
4. Dans le casque, vous pouvez interagir avec l’UI directement ou à distance grâce au lancer de rayon. L’UI peut être déplacée en la saisissant.

1. Assurez-vous que votre casque est connecté à la machine de développement.
2. Dans l’éditeur Unity, accédez à File > Build Profiles (Fichier > Profils de build).
3. Cliquez sur Open Scene List (Ouvrir la liste des scènes) pour ouvrir la fenêtre Scene List (Liste des scènes).
4. Ajoutez votre scène à la liste Scenes In Build (Scènes dans Build) en la faisant glisser à partir du panneau Project (Projet) ou en cliquant sur Add Open Scenes (Ajouter des scènes ouvertes).
5. Cliquez sur Build and Run (Construire et exécuter) pour générer un fichier .apk et l’exécuter sur votre casque. Dans l’explorateur de fichiers qui apparaît, sélectionnez l’emplacement d’enregistrement du fichier .apk et attribuez-lui un nom. Le processus de build peut prendre quelques minutes.
6. Dans le casque, vous pouvez interagir avec l’UI directement ou à distance grâce au lancer de rayon. L’UI peut être déplacée en la saisissant.

• Pour en savoir plus sur les concepts clés du SDK Interaction, consultez la Présentation de l’architecture.
• Pour d’autres méthodes de configuration, consultez l’article Prise en main du SDK Interaction et de Unity XR.