Utilisation de l'outil de validation de session

Cet article explique comment utiliser l'outil de validation de session pour valider rapidement les workflows de session dans l'éditeur et effectuer des simulations avec des fichiers EIF.

Avant de commencer

Les simulations utilisent des fichiers EIF comme entrée, vous devez donc enregistrer un fichier EIF avant de commencer :

• Reportez-vous à Enregistrement de fichier EIF pour enregistrer un fichier EIF

Vous devez également comprendre :

• Les concepts de base de l'enregistrement EIF et des simulations
• Les concepts fondamentaux, la composition et le workflow d'une session AR

Outil de validation de session

L'outil de validation de session aide les développeurs à valider rapidement les workflows de session dans l'éditeur Unity et à effectuer des simulations avec des fichiers EIF.

Par défaut, vous pouvez trouver l'outil dans la fenêtre Inspector de l'objet AR Session (EasyAR), qui fait partie de l'éditeur DiagnosticsController :

Cliquez sur le bouton ↗ en haut à droite de l'outil pour l'ouvrir dans une fenêtre indépendante. Lorsque la fenêtre est fermée ou que vous appuyez sur le bouton ↘, l'outil réapparaît dans la fenêtre Inspector.

L'outil en fonctionnement ressemble à la vidéo ci-dessous :

Cette vidéo montre l'utilisation de l'outil de validation de session, enregistrée en mode play de Unity. La partie supérieure montre à gauche la vue Hierarchy, au centre la vue Scene, et à droite la vue Game. La partie inférieure montre l'outil de validation de session. Le contenu de la vue Game correspond à ce que l'utilisateur verrait dans le monde réel sur un téléphone.

La partie supérieure gauche de l'outil affiche la barre de progression de la lecture EIF, qui évolue pendant la lecture. La partie inférieure gauche montre l'état actuel de la session. La partie droite affiche les composants de la session et les modes de centre disponibles.

Dans la scène, vous pouvez voir trois fonctionnalités AR fonctionnant simultanément :

• Suivi de mouvement : fourni par le frame player, la sphère bleue est le XR Origin, le cône bleu représente la position de l'utilisateur.
• Cartographie spatiale dense : vous voyez des maillages semi-transparents se générer au fur et à mesure que la vue se déplace.
• Suivi spatial clairsemé : dans la vidéo, un sapin de Noël est suivi, avec des objets virtuels superposés (nuage de points bleu clair).

Démarrer l'outil

Cliquez sur le bouton ▶ en haut de l'outil pour le démarrer. Ce bouton a le même effet que le bouton ▶ de la barre d'outils Unity.

Si l'outil est déjà démarré, le bouton devient ■, et un clic arrête l'outil.

Lorsque l'outil est affiché dans une fenêtre indépendante, la case déroulante à droite du bouton ▶ permet de sélectionner l'objet session utilisé par l'outil. Si la fenêtre est réinitialisée et que la session est perdue, vous pouvez la resélectionner ici.

Contrôler la lecture EIF

Pour utiliser la fonctionnalité de lecture EIF, cochez l'option Frame Player de l'outil avant l'exécution. Cela permet à l'outil de gérer la sélection de la source d'images pendant l'assemblage de la session, quelle que soit la valeur définie pour AssembleOptions.FrameSource.

Ainsi, un message s'affiche pendant l'exécution pour indiquer que la source d'images actuelle est gérée par l'outil :

Note

L'outil ne gère la sélection de la source d'images que dans l'éditeur Unity. Cette option n'a aucun effet lors de l'exécution de l'application compilée.

Pendant l'exécution normale, les contrôles de lecture EIF apparaissent dans la partie encadrée en haut de l'outil :

Utilisez ces boutons pour contrôler la lecture du fichier EIF :

• ▶ : Lecture (reprend la lecture depuis un état en pause ou arrêté)
• ▮▮ : Pause
• ■ : Arrêt
• ▮◀ : Reculer de 5 secondes (si le fichier le permet)
• ◀◀ : Ralentir la vitesse de lecture (si le fichier le permet)
• ▶▶ : Accélérer la vitesse de lecture (si le fichier le permet)
• ▶▮ : Avancer de 5 secondes (si le fichier le permet)
• ▲ : Ouvrir un fichier
• Barre de progression : Cliquez pour sauter à une position (si le fichier le permet)

Vous pouvez ajuster le contenu et la logique d'interaction pendant la lecture, permettant ainsi de travailler sur la majeure partie du développement sur ordinateur et de voir les résultats visuellement.

Note

Lors de la lecture de nouvelles données ou d'un saut de position, les données existantes de la scène ne sont pas effacées. L'état des composants AR n'est pas réinitialisé, ce qui simule un saut soudain d'une image à une autre.

Bien que cela n'affecte pas certaines fonctionnalités, pour celles qui dépendent du suivi de mouvement (comme la cartographie spatiale dense, Mega, etc.), cela peut entraîner des états anormaux et affecter les performances.

Contrôler le workflow de session

Pour utiliser le contrôle du workflow de session, cochez l'option Session Workflow de l'outil avant l'exécution. Cette option est cochée par défaut.

Pendant l'exécution normale, les contrôles du workflow apparaissent dans la partie encadrée sous les contrôles de lecture :

En haut de cette section s'affichent les états de EasyARController.IsReady et ARSession.State.

En bas se trouvent ces boutons pour contrôler le workflow de session :

• Initialize : Initialiser la session (clé de licence des paramètres du projet ou saisie manuelle)
• Assemble : Assembler sans démarrer la session
• StartSession (Assembled) : Démarrer la session assemblée
• StartSession : Assembler et démarrer la session
• StopSession : Arrêter la session
• StopSession (keep image) : Arrêter la session mais conserver l'image de fond
• Deinitialize : Désinitialiser la session

Note

Ces contrôles appellent directement les méthodes de ARSession et EasyARController. Vous pouvez ainsi vérifier l'impact des changements d'état de session sur le contenu, mais notez que si des méthodes similaires sont appelées dans les scripts de l'application, le flux d'exécution peut dépasser les attentes.

Contrôler les composants de session

Pour utiliser le contrôle des composants de session, cochez l'option Session Workflow de l'outil avant l'exécution. Cette option est cochée par défaut.

Pendant l'exécution normale, les contrôles des composants apparaissent en bas ou à droite de l'outil (selon la largeur de la fenêtre) :

Le contenu de cette section dépend de la session. Par exemple, la session utilisée ci-dessus comprend trois composants : suivi d'image, cartographie spatiale dense et suivi spatial clairsemé.

Cette section affiche généralement tous les composants de fonctionnalités AR disponibles dans la session et permet de contrôler leur activation/désactivation (enabled), notamment :

• AR Session : Activation/désactivation de la session
• Image Renderer : Activation/désactivation du rendu d'image de la caméra physique
• Camera : Activation/désactivation de la caméra virtuelle
• Frame Source : Activation/désactivation de la source d'images (uniquement si frame player n'est pas activé)
• Frame Filter : Activation/désactivation des fonctionnalités AR spécifiques
• Frame Recorder : Activation/désactivation du composant d'enregistrement EIF (uniquement visible si frame player n'est pas activé)

La section affiche également les modes de centre disponibles et le rapport de session.

Note

Les modes de centre et rapports affichés sont des résultats d'exécution dans l'éditeur et peuvent différer sur un appareil réel.

Sujets connexes

• Essayez d'exécuter des simulations avec des fichiers EIF en contrôlant la lecture via des scripts
• Essayez de contrôler l'exécution de session dans des scripts
• Essayez d'accéder aux composants de fonctionnalités AR dans des scripts
• Essayez d'obtenir les résultats d'exécution de session dans des scripts
• Essayez l'initialisation dans des scripts
• Essayez d'obtenir le rapport de session et d'évaluer la compatibilité des appareils dans des scripts