Bonnes pratiques de création de scripts visuels mesh pour le débogage
Diagnostics au moment de la modification
Dans l’Éditeur Unity, vous pouvez afficher des conseils à la volée sur les erreurs et les goulots d’étranglement potentiels de la bande passante ou des performances de l’ordinateur de script que vous modifiez actuellement dans le panneau Diagnostics de script visuel Mesh en bas du panneau Inspecteur de l’éditeur Unity.
Le pointeur de la souris sur une erreur, un avertissement ou une notification dans le panneau Diagnostics affiche une info-bulle avec une explication détaillée :
Vous pouvez obtenir une compilation des mêmes diagnostics dans l’ensemble de votre environnement en consultant le contenu Analyseur de performances (CPA).
- Dans la barre de menus Unity, sélectionnez Contenu mesh Toolkit>Analyseur de performances.
- Dans le CPA, cliquez sur le bouton Exécuter tout .
Diagnostics du runtime dans l’émulateur Mesh
Lorsque vous testez votre environnement dans l’Éditeur Unity, cochez la case Statistiques Perf dans le coin supérieur droit de la fenêtre Jeu pour afficher les statistiques récapitulatives en temps réel sur tous les aspects de votre environnement :
La colonne la plus à droite dans le coin inférieur droit fournit des informations récapitulatives sur les performances des scripts visuels, avec des temps donnés en millisecondes par image :
- VS User affiche le temps consacré à l’exécution des flux de script visuel que vous avez créés, à l’exclusion de toute surcharge encourue par Mesh.
- VS Env affiche la surcharge engendrée par l’environnement d’exécution mesh Visual Scripting.
- VS Net affiche la surcharge engendrée par la pile de mise en réseau Mesh sous le runtime Mesh Visual Scripting, la répartition et la réception des mises à jour à l’état partagé.
Pour obtenir des informations plus détaillées sur les scripts visuels individuels en cours d’exécution dans l’environnement, vous pouvez activer les statistiques d’exécution en temps réel sur l’exécution de script visuel en sélectionnant la case à cocher Statistiques de script dans le coin supérieur droit de la fenêtre Jeu :
La section De charge de traitement la plus élevée répertorie les flux de script qui ont pris le plus de temps pour s’exécuter au cours de la dernière seconde, comme un coût moyen de temps par frame.
- Le nombre de flux de script apparaissant dans cette section et leur coût total de temps doit être aussi faible que possible.
- Dans l’idéal, lorsque l’environnement est inactif, il ne doit pas y avoir de flux de script s’exécutant du tout.
La section de chargement de mise à jour partagée la plus élevée répertorie les propriétés de scène partagée et les variables de script les plus fréquemment mises à jour au cours des dernières secondes. Une charge de 100 % signifie que la propriété ou la variable a été mise à jour dans chaque image de cette seconde.
- Le nombre de mises à jour de variables de script et de propriétés partagées et leur charge totale dans cette section doivent être aussi faibles que possible.
- Dans l’idéal, lorsque l’environnement est inactif, aucune propriété ou variable partagée ne doit être mise à jour du tout.
- Si vous remarquez des propriétés ou des variables de script affichées dans cette section que vous n’avez pas l’intention d’être synchronisées sur le réseau entre les clients, envisagez d’ajouter des composants d’étendue de script local pour les rendre locaux.
Vous pouvez cliquer sur n’importe quel nom d’objet de jeu dans la colonne centrale pour accéder directement à l’objet de jeu correspondant dans le panneau Hierarchy .
Si vous souhaitez examiner de plus près une situation, vous pouvez cliquer sur n’importe quelle autre partie du panneau Statistiques de script ou appuyer sur Maj+X pour arrêter temporairement ses mises à jour. Pour reprendre la mise à jour, cliquez à nouveau dessus ou appuyez à nouveau sur Maj+X.
Diagnostics d’exécution dans Mesh
Lors de l’exécution d’un environnement dans Mesh (par exemple, dans un événement Teams), vous pouvez appuyer sur Ctrl+Maj+F1 pour afficher la barre latérale des informations réseau, qui affiche de nombreuses informations techniques sur la session active. Faites défiler vers le bas pour trouver des informations détaillées sur les scripts visuels en cours d’exécution dans l’environnement :
La dernière (nombre) secondes, (nombre) d’instructions d’images directement sous le titre de section Script visuel affiche le nombre de secondes et les images agrégées pour les compteurs indiqués ci-dessous. Jusqu’à 90 secondes de données sont agrégées avant la réinitialisation des compteurs. Le tableau ci-dessous présente des informations sur le partage :
- Les lignes Prop, Var et Event décrivent les propriétés partagées, les variables de script partagé et les événements partagés, respectivement.
- La colonne Update compte la fréquence à laquelle les propriétés ou variables ont été mises à jour par des scripts visuels.
- Les colonnes Send et Bytes comptent la fréquence à laquelle les mises à jour des propriétés, des variables ou des événements ont été envoyées sur le réseau. Ce nombre peut être inférieur au nombre de mises à jour en raison de la limitation du débit et du fait que les mises à jour redondantes peuvent ne pas être envoyées du tout.
- Les colonnes Recv et Octets comptent la fréquence à laquelle les mises à jour des propriétés, des variables ou des événements ont été reçues sur le réseau d’autres clients.
- Les colonnes Octets de cette table ne comptent pas pour toutes les surcharges réseau et ne peuvent être utilisées que de manière significative pour comparer les exécutions. L’utilisation réelle de la bande passante peut être beaucoup plus élevée.
La table de temps d’exécution la plus longue répertorie tous les flux de script visuel en fonction du temps qu’ils ont pris pour s’exécuter. La ligne mise en surbrillance intitulée [all] affiche les données cumulatives sur toutes les lignes, y compris les lignes actuellement non affichées. Cliquez sur Afficher plus de lignes... pour afficher d’autres lignes.
- La colonne Count compte la fréquence à laquelle ce flux de script a été exécuté.
- La colonne Moyenne indique le coût moyen de temps par trame, en millisecondes, de ce flux de script.
- La colonne d’événements nomme le nœud d’événement qui a déclenché le flux de script.
- La colonne cible nomme l’ordinateur de script qui a exécuté le flux de script.
Les mises à jour partagées les plus fréquentes et les tables les plus fréquentes envoient des propriétés partagées et des variables de script partagé les plus fréquemment mises à jour par des scripts visuels ou qui avaient des mises à jour réparties sur le réseau, respectivement. Les lignes en surbrillance étiquetées [all] affichent les données cumulatives sur toutes les lignes, y compris les lignes actuellement non affichées. Cliquez sur Afficher plus de lignes... pour afficher d’autres lignes.
- La colonne Count compte la fréquence à laquelle cette propriété partagée ou cette variable partagée a été mise à jour ou a eu une mise à jour répartie sur le réseau, respectivement.
- La colonne Name nomme la propriété partagée ou la variable partagée.
- La colonne cible nomme le composant hébergeant la propriété ou la variable.
Appuyez sur Ctrl+Maj+F1 pour une seconde fois pour agrandir le panneau Informations réseau, qui affiche l’intégralité du chemin de transformation des objets de jeu cible dans les tableaux ci-dessus.
Pour fermer le panneau : appuyez sur Ctrl+Maj+F1 pour une troisième fois.