Utiliser l'outil de validation de session

Cet article explique comment utiliser l'outil de validation de session pour valider rapidement le flux de travail de la session dans l'éditeur et effectuer des exécutions de simulation à l'aide de fichiers EIF.

Avant de commencer

L'exécution de simulation utilise des fichiers EIF comme entrée, il est donc nécessaire d'enregistrer un fichier EIF avant de commencer :

• Référez-vous à Enregistrer un fichier EIF pour enregistrer un fichier EIF

Il est également nécessaire de comprendre :

• Les concepts de base de l'enregistrement d'un fichier EIF et de son utilisation pour la simulation
• Les concepts de base, la composition et le flux de travail d'une session AR

Outil de validation de session

L'outil de validation de session est conçu pour aider les développeurs à valider rapidement le flux de travail de la session dans l'éditeur Unity et à effectuer des exécutions de simulation à l'aide de fichiers EIF.

Par défaut, l'outil de validation de session est visible dans la fenêtre Inspector de l'objet AR Session (EasyAR), il fait partie de l'éditeur DiagnosticsController :

Cliquer sur le bouton ↗ en haut à droite de l'outil permet de l'extraire dans une fenêtre indépendante pour faciliter la visualisation et l'utilisation. Lorsque la fenêtre est fermée ou que le bouton ↘ est pressé, l'outil réapparaît dans la fenêtre Inspector.

L'effet de l'outil en cours d'exécution est illustré par la vidéo ci-dessous :

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

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

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

• Suivi de mouvement : fourni par le frame player, la sphère bleue est l'origine XR, le cône bleu représente la position de l'utilisateur.
• Cartographie dense de l'espace : on peut voir des maillages semi-transparents se générer continuellement lors du déplacement de la vue.
• Suivi spatial clairsemé : dans la vidéo, un sapin de Noël est suivi, et l'objet virtuel superposé est un nuage de points bleu clair.

Lancer l'outil

Cliquez sur le bouton ▶ en haut de l'outil pour le lancer. L'effet de ce bouton est le même que celui du bouton ▶ de la barre d'outils Unity.

Si l'outil est déjà lancé, le bouton devient ■, cliquer dessus arrête l'outil.

Lorsque l'outil est affiché dans une fenêtre indépendante, la case de sélection à droite du bouton ▶ permet de choisir l'objet session utilisé par l'outil. Si la fenêtre est réinitialisée et que la session est perdue, elle peut être réinitialisée à partir de là.

Contrôler la lecture EIF

Pour utiliser la fonctionnalité de lecture EIF de l'outil, il faut cocher l'option Frame Player de l'outil avant l'exécution. À ce moment, l'outil prend en charge la sélection de la source d'images lors de l'assemblage de la session, quelle que soit la valeur définie pour AssembleOptions.FrameSource, le composant frame player sera activé.

Par conséquent, une fenêtre contextuelle s'affichera pendant l'exécution, indiquant que la source d'images utilisée par la session 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 impact lors de l'exécution de l'application emballée.

Pendant une exécution normale, la fonction de contrôle de lecture EIF s'affiche dans la partie encadrée en haut de l'outil, comme indiqué dans l'image :

Ces boutons permettent de contrôler la lecture du fichier EIF :

• ▶ : Lecture, reprend la lecture depuis l'état de pause ou d'arrêt
• ▮▮ : Pause
• ■ : Arrêt
• ▮◀ : Sauter 5 secondes en arrière (si pris en charge par le fichier)
• ◀◀ : Réduire la vitesse de lecture (si pris en charge par le fichier)
• ▶▶ : Augmenter la vitesse de lecture (si pris en charge par le fichier)
• ▶▮ : Sauter 5 secondes en avant (si pris en charge par le fichier)
• ▲ : Ouvrir un fichier
• Barre de progression : cliquer pour sauter à une position de lecture (si pris en charge par le fichier)

Il est possible d'ajuster et d'optimiser le contenu et la logique d'interaction dans la scène pendant la lecture, permettant ainsi d'effectuer la majeure partie du travail de développement sur ordinateur et de visualiser les résultats de manière intuitive.

Note

Lors de la lecture de nouvelles données ou d'un saut de lecture, les données existantes dans la scène ne sont pas effacées. L'état des composants AR n'est pas non plus réinitialisé, ils se comporteront comme si les données de la caméra passaient soudainement de l'image précédente aux nouvelles données.

Bien que cela n'ait pas beaucoup d'impact sur certaines fonctionnalités, pour les fonctionnalités dépendant du suivi de mouvement (comme la cartographie dense de l'espace, Mega, etc.), cela peut entraîner des états anormaux des fonctionnalités, affectant ainsi les résultats de l'exécution.

Contrôler le flux de travail de la session

Pour utiliser la fonction de contrôle du flux de travail de session de l'outil, il faut cocher l'option Session Workflow de l'outil avant l'exécution, cette option est cochée par défaut.

Pendant une exécution normale, la fonction de contrôle du flux de travail de session s'affiche sous le contrôle de lecture de l'outil, dans la partie encadrée de l'image :

En haut de cette zone, deux informations d'état sont affichées : EasyARController.IsReady et ARSession.State.

En bas de cette zone, des boutons sont fournis pour contrôler le flux de travail de la session :

• Initialize : Initialiser la session, avec la possibilité de choisir la clé de licence configurée dans Project Settings ou de la saisir manuellement
• Assemble : Assembler sans démarrer la session
• StartSession (Assembled) : Démarrer une session déjà 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

Étant donné que ces fonctions de contrôle appellent directement les méthodes associées de ARSession et <xref:u:easyar.EasyARController