Nouveautés
La vue de l'arborescence vous permet de sélectionner les données que vous souhaitez mesurer et d'obtenir des résultats en un coup d'œil.
Le système de session vous permet d'échantillonner plusieurs sources simultanément.
La barre de recherche vous permet de trouver rapidement la métrique requise.
Vous pouvez ouvrir plusieurs sessions enregistrées pour une comparaison plus facile, sans avoir à fermer la session que vous exécutez actuellement.
Vous pouvez effectuer des métriques simultanément à partir de plusieurs sources.
La vue en histogramme vous permet de plonger dans la répartition de chaque métrique sur la période d'échantillonnage.
Des préfixes sont automatiquement ajoutés à vos fichiers enregistrés pour faciliter l'identification des sessions.
L'Unreal Editor pour Fortnite (UEFN) vous donne les outils nécessaires pour comprendre et améliorer les performances de votre projet. Étant donné que Fortnite fonctionne sur de nombreuses plateformes, le fait de connaître les métriques spécifiques à votre projet vous permet de faire les ajustements nécessaires pour assurer des performances fluides dans vos expériences UEFN.
Passez à Lancer une session d'échantillonnage pour obtenir un aperçu du flux de travail ou poursuivez votre lecture pour obtenir un aperçu approfondi de l'outil Profileur spatial.
Termes utiles
Une métrique spatiale est mesurée pour toute propriété qui utilise une position spatiale 3D dans un monde. Elle se compose d'un certain nombre de valeurs spatiales, chacune ayant un numéro qui correspond à une mesure, avec une coordonnée associée qui donne la position spatiale où la valeur a été mesurée dans le monde.
Une valeur spatiale est une mesure concrète d'une métrique spatiale dans un emplacement 3D. Les valeurs spatiales ont trois valeurs de coordonnées spatiales X, Y, Z, ainsi qu'une valeur de résultat de mesure. Les valeurs spatiales sont agrégées dans un échantillon métrique spatial.
Un Échantillon de métrique spatiale est une mesure d'une métrique spatiale concrète sur une période définie. Il peut contenir plusieurs valeurs spatiales mesurées avec un résultat associé. Un échantillon comprend également d'autres données pertinentes, telles que les limites 3D englobant toutes les valeurs spatiales, la précision de la distance utilisée et la date à laquelle l'échantillon a été prélevé.
Les Propriétés des métriques spatiales représentent toutes les informations incluses dans un échantillon de métriques spatiales :
| Propriété | Définition |
|---|---|
Identifiant de métrique | Définit l'identificateur unique de la métrique, qui est directement lié à son type. |
Valeur min | La valeur minimale parmi les valeurs spatiales enregistrées. |
Valeur max | La valeur maximale parmi les valeurs spatiales enregistrées. |
Valeur seuil | La valeur maximale attendue pour la métrique. |
Précision spatiale | La taille de cellule 3D utilisée en unités du monde, pour que toutes les valeurs contenues contribuent à la même valeur spatiale. Généralement, la valeur la plus élevée est sélectionnée. |
Unité | L'unité utilisée par les valeurs enregistrées, par exemple la milliseconde pour la durée ou le mètre pour la distance. |
Le profileur spatial est un widget de visualisation qui vous fournit une carte de chaleur 2D des métriques spatiales. Il vous permet également d'enregistrer, d'enregistrer et de charger des échantillons de métriques spatiales. Il collecte les données à partir de la fonction de mise à jour des métriques spatiales. Les données sont donc régulièrement mises à jour.
Éditeur UEFN avec ancrage de la fenêtre de profileur spatial.
Le profileur spatial prend actuellement en charge sept métriques spatiales :
| Métrique | Définition | Unit (unité) |
|---|---|---|
Compte d'appels à générer | Suivi du nombre d'appels à générer sur une image | Appels à générer |
Compte de primitives | Suivi du nombre de primitives rendues sur une seule image. Les primitives sont les composantes d'affichage élémentaires utilisées pour afficher des objets en 3D. | Les primitives |
Durée de mise à jour du jeu | Suit le thread de jeu de la plateforme, en mesurant le temps pris pour mettre à jour une image. | Microsecondes |
Temps de rendu | Suit le thread de rendu de la plateforme, en mesurant le temps pris pour mettre à jour une image. | Microsecondes |
Temps d'image | Suivi du temps passé à mettre à jour une image. Les mesures du temps de mise à jour du jeu et du temps de rendu sont incluses dans cette mesure. | Microsecondes |
Temps GPU | Suit le temps du processeur graphique de la plateforme. | Microsecondes |
Temps RHI | Suit le temps de thread de l'interface de matériel de rendu de la plateforme. | Microsecondes |
Compte d'acteurs | Suivi du nombre d'acteurs dans le monde en tenant compte des événements de chargement dynamique. Cette métrique est particulièrement utile pour les mondes de l'UE pour lesquels le chargement dynamique World Partition est activé. Un compte d'acteurs incohérent dans le niveau peut mettre en évidence les domaines de gameplay les plus importants. Cependant, un compte d'acteurs très élevé peut également indiquer un nombre excessif de petits acteurs et un potentiel point d'effort dans l'expérience. Il est judicieux d'évaluer cette métrique avec la durée de mise à jour du jeu pour estimer la complexité de la logique du jeu ou avec la durée de rendu pour estimer la complexité du rendu. | Actors |
Compte de constructions | Une version spécialisée de la métrique Compte d'acteurs qui s'intéresse au nombre d'acteurs classés comme bâtiments. Cette catégorie comprend également d'autres types d'acteurs de maillage statique persistants. | Actors |
Compte de contenants de butin | Une version spécialisée de la métrique Compte d'acteurs qui suit le nombre d'acteurs classés comme conteneurs de butin. Cette catégorie comprend des acteurs tels que des coffres, des boîtes de munitions et d'autres générateurs de ramassage. | Actors |
Compte de ramassages | Une version spécialisée de la métrique Compte d'acteurs qui s'intéresse au nombre d'acteurs classés comme objets à ramasser. Cette catégorie comprend les objets de jeu pouvant être pillés. | Actors |
Utilisation de la mémoire | Suit l'utilisation de la mémoire exécutable de la plateforme. Vous pouvez l'utiliser pour évaluer les besoins en mémoire de chaque plateforme sur laquelle l'expérience doit s'exécuter. | Kilo-octets |
Mémoire disponible | Suit la mémoire physique disponible de la plateforme. Vous pouvez l'utiliser pour évaluer les besoins en mémoire de chaque plateforme sur laquelle l'expérience doit s'exécuter. | Kilo-octets |
IU du profileur spatial
Le profileur spatial est un widget autonome ancrable divisé en quatre zones :
Zones de widget du profileur spatial.
Barre d'outils de contrôle
Vue Carte de chaleur
Vue d'arborescence des métriques
Vue en histogramme
Barre d'outils de contrôle
Cette zone contient les principaux éléments interactifs permettant de faire fonctionner le profileur spatial. Elle fournit les contrôles nécessaires pour produire, visualiser et enregistrer des échantillons de métriques spatiales. Vous pouvez utiliser les échantillons capturés pour générer des données susceptibles d'améliorer votre expérience UEFN.
Éléments de la barre d'outils de contrôle du profileur spatial.
La barre d'outils de contrôle comprend les éléments suivants :
Démarrer l'échantillonnage : ce bouton démarre la capture de l'ensemble de métriques sélectionnées par l'utilisateur. Vous devez être connecté à une session UEFN pour permettre l'échantillonnage des métriques. Lors de l'échantillonnage, la carte de chaleur centre automatiquement la vue sur l'emplacement du pion du joueur de la session et se concentre sur les valeurs spatiales capturées.
Arrêter l'échantillonnage : ce bouton arrête la capture des métriques sélectionnées.
Ouvrir un échantillon de fichier : ce bouton permet d'ouvrir un exemple de fichier existant, qui peut contenir plusieurs métriques. Lorsque vous ouvrez le fichier, toutes les métriques contenues sont chargées dans le navigateur de métriques, ce qui vous permet d'évaluer les données.
Enregistrer un échantillon dans un fichier : ce bouton permet d'enregistrer les sessions de profilage actives. Une boîte de dialogue pour l'enregistrement s'ouvre et propose un nom de fichier avec l'horodatage de l'échantillon par défaut. Le profileur spatial enregistre toutes les métriques de la session d'échantillonnage en cours dans le fichier de destination.
Sélecteur de session UEFN : plusieurs clients peuvent être connectés à une même session. Le sélecteur permet de choisir la session à laquelle vous connecter et d'exécuter les métriques. Le profileur spatial se connecte automatiquement au client lors du lancement d'une session, puis met à jour le sélecteur de session avec le nom de l'utilisateur qui y est connecté.
Paramètres : ce bouton affiche les paramètres de préférence du profileur spatial. Vous pouvez l'utiliser pour activer la visibilité de certains éléments du widget.
Vue d'arborescence des métriques
Cette section vous permet de sélectionner et de désélectionner les métriques que vous souhaitez dans votre session d'échantillonnage en cliquant sur les cases à cocher à gauche des métriques.
Le menu déroulant supérieur permet de choisir entre une session en direct et une session précédemment enregistrée. Vous pouvez basculer entre votre session d'échantillonnage actuel et une session enregistrée en sélectionnant la session que vous souhaitez afficher dans le menu déroulant.
Avec le deuxième menu déroulant, vous pouvez basculer entre les cibles d'échantillonnage de votre session en direct, telles que les clients ou le serveur. Vous pouvez surveiller les métriques de tous les clients connectés et échantillonner plusieurs sources en même temps.
La barre de recherche vous permet de rechercher une métrique spécifique.
Lorsque vous cliquez sur une métrique pour la sélectionner, la vue Carte de chaleur s'actualise pour afficher tous les exemples de données, et la vue Statistiques est mise à jour pour afficher les statistiques agrégées des données. Les cercles colorés à côté de chaque métrique représentent leurs valeurs relatives en fonction des seuils que vous avez définis avant la session d'échantillonnage, affichant vos résultats en un coup d'œil.
Vue Carte de chaleur
La vue Carte de chaleur affiche une carte de chaleur de la métrique choisie et une superposition de toutes les valeurs spatiales de l'échantillon. Une couleur est attribuée à chaque valeur spatiale en fonction des données de l'échantillon. Vous pouvez rapidement fixer des valeurs seuils pour chaque métrique afin de définir la plage de valeurs attendues.
Vous pouvez interagir avec la carte de chaleur et la personnaliser selon vos préférences à l'aide des quatre boutons de la partie supérieure :
Menu latéral
Afficher les options
Centrer le joueur
Centrer les limites
Vous pouvez double-cliquer sur un emplacement de la vue Carte de chaleur pour placer la caméra de l'éditeur à l'emplacement correspondant dans le projet. Si une session est lancée, le pion du joueur se téléporte à l'endroit sur lequel vous double-cliquez.
Menu latéral
Ce bouton vous donne accès aux options de visualisation de la carte de chaleur, contenant deux sections :
Paramètres métriques
Paramètres de couleurs de la carte de chaleur
Options du menu latéral du profileur spatial.
Vous pouvez réinitialiser les paramètres de ces sections en cliquant sur la flèche de réinitialisation située à droite de chaque champ.
Paramètres métriques
Le groupe Paramètres de métriques regroupe tous les paramètres affectant la visualisation des métriques.
| Valeur | Définition |
|---|---|
Seuil | Une valeur de seuil définit la valeur maximale attendue pour un gameplay ordinaire. |
Unité d'affichage | Lorsqu'elle est spécifiée, cette option définit l'unité de visualisation préférée pour une métrique. Si aucune valeur n'est spécifiée, l'outil sélectionne l'unité la mieux adaptée à chaque métrique. L'unité d'affichage affecte les unités utilisées par la vue Carte de chaleur et la vue Résumé. |
Méthode des cellules | Ce paramètre spécifie la méthode de réduction que l'outil utilise pour calculer chaque valeur de cellule 2D à partir de la liste des valeurs qui se trouvent dans les limites de chaque cellule. Les méthodes de réduction disponibles sont :
|
Taille de cellule | Ce paramètre modifie la taille de la grille et peut augmenter ou diminuer le niveau de détail d'une zone d'échantillonnage particulière. |
Paramètres de couleurs de la carte de chaleur
Les paramètres de couleur de la carte de chaleur contiennent tous les paramètres affectant la visualisation des métriques.
Les couleurs de chaleur offrent une palette de couleurs lisible, avec des remarques liées au daltonisme. Vous pouvez définir les couleurs clés pour personnaliser la plage de couleurs de la carte de chaleur.
| Valeur | Définition |
|---|---|
Basse | Cette couleur représente le spectre faible de la plage de couleurs de la carte de chaleur et correspond à la valeur minimale d'un échantillon de métriques. |
Médiane | Cette couleur représente le milieu de la plage de couleurs de la carte de chaleur définie entre la couleur minimum et la couleur seuil. Si vous ne spécifiez pas la valeur seuil, elle sera mappée à la valeur spatiale médiane dans un échantillon. |
Élevée | Cette couleur représente toutes les valeurs supérieures au seuil défini. |
Max | Cette couleur représente la valeur maximale. Elle ne s'affiche que si les utilisateurs définissent une valeur de seuil pour la métrique représentée. Lorsque vous spécifiez une valeur de seuil, la carte de chaleur ajoute une plage qui dépasse le seuil, allant du blanc à la couleur définie pour la valeur Maximum. |
Alpha min | La valeur de départ donnée aux valeurs spatiales. La valeur alpha de toutes les valeurs spatiales d'un échantillon augmente en fonction de leur valeur, de la valeur minimale (en utilisant la valeur alpha min) aux valeurs maximales ou seuils avec la valeur alpha maximale. Utiliser une valeur alpha min faible rend les valeurs spatiales faibles moins visibles, ce qui met en évidence les valeurs spatiales plus proches des valeurs maximale ou de seuil. |
Alpha max | La valeur de départ maximale donnée aux valeurs spatiales. |
Les paramètres d'Alpha affichent des valeurs spatiales hors de la plage attendue. Ajuster ces options devient particulièrement utile si vous travaillez sur un échantillon de métriques avec des poches de valeurs spatiales à haute densité, car vous pouvez obtenir une lecture plus granulaire de ces métriques.
Axes
Cette option active la visualisation des axes 3D dans le coin inférieur gauche correspondant à l'orientation descendante de la vue Carte de chaleur. Cette orientation est en parité avec la vue de minicarte du client et non avec celle de l'éditeur.
Affichage des axes de la carte de chaleur
Grille
Active/désactive la visualisation de la grille de la carte de chaleur 2D et subdivise l'espace visible en plusieurs parties de l'étendue de la valeur de l'échantillon. La taille de la grille peut être modifiée dans le menu latéral.
Légende de la carte de chaleur
Cette option active/désactive la visualisation de la légende de la plage de couleurs de la carte de chaleur dans le coin inférieur droit de la vue Carte de chaleur.
Affichage de la légende de la palette de couleurs de la carte de chaleur
Limites
Cette option vous permet de basculer la boîte englobante 2D, qui comprend toutes les valeurs spatiales de l'échantillon.
Afficher les limites de l'échantillon (en blanc) sur la carte de chaleur
Centrer le joueur
Ce bouton centre la vue autour du pion du joueur dans la session connectée. Cette action requiert une session connectée.
Centrer les limites
Ce bouton centre la vue Carte de chaleur autour de la boîte englobante 2D.
Menu contextuel
Pour accéder au menu contextuel, faites un clic droit sur la zone Vue de la carte de chaleur. Ce menu contient les options suivantes :
se téléporter
Vue par défaut
Centrer les limites
Suivre l'emplacement de la mise au point
Menu contextuel de la vue Carte de chaleur du profileur spatial
se téléporter
Cette option permet de déplacer la vue de la caméra et le pion du joueur à un emplacement choisi par un clic droit dans la vue Carte de chaleur. Cette action requiert une session connectée pour téléporter le pion de joueur. Si aucune session n'est connectée, cela revient à double-cliquer sur un emplacement quelconque dans la vue Carte de chaleur. La caméra de l'éditeur est alors placée à l'endroit correspondant dans le projet.
Vue par défaut
Cette option rétablit les valeurs par défaut de mise au point et de zoom dans la vue Carte de chaleur.
Vue en histogramme
L'histogramme vous aide à visualiser les données au fur et à mesure de leur collecte en temps réel. Vous pouvez revenir sur votre test du niveau et évaluer chaque métrique à un moment précis de votre test. En faisant défiler l'histogramme de la session ouverte, vous pouvez identifier l'emplacement d'un relevé particulier que vous souhaitez étudier.
Le réglage des valeurs dans le menu latéral modifiera les différents points de coupure affichés dans l'histogramme.
Un clic droit sur l'histogramme vous permet de sélectionner Afficher les instructions de seuil, Défilement auto, Valeurs d'ombrage par cellule, de choisir les valeurs suivante et précédente, et Changer l'échelle de l'histogramme. Vous pouvez changer l'échelle de l'histogramme en maintenant la touche Maj et en faisant défiler la molette de la souris.
Vous pouvez également effectuer un zoom avant et arrière sur l'histogramme pour obtenir un aperçu plus détaillé de vos métriques.
Lorsque vous passez la souris sur un segment de l'échantillon, une infobulle affiche sa valeur.
Cliquer sur le segment de l'échantillon met en valeur l'emplacement du segment sur la carte de chaleur.
À droite de l'histogramme, vous pouvez voir un résumé des statistiques pour la métrique sélectionnée. Il affiche les statistiques suivantes, compilées à partir des valeurs spatiales de l'échantillon :
| Statistique | Définition |
|---|---|
Valeurs | Nombre total de valeurs spatiales incluses dans l'échantillon. |
Élevée | Nombre de valeurs spatiales dépassant la valeur seuil, si elle est définie. |
Valeur min | La plus petite valeur spatiale. |
Valeur max | La plus grande valeur spatiale. |
Valeur moyenne | La valeur spatiale moyenne. |
Valeur médiane | La valeur spatiale médiane. |
Lancer une session d'échantillonnage
Cette section explique comment lancer une session d'échantillonnage à l'aide du profileur spatial et comment enregistrer votre échantillon de métriques spatiales.
Accédez à Outils > Métriques spatiales > Profileur spatial. Le widget Profileur spatial s'ouvre alors.
Dans la vue d'arborescence, sélectionnez les métriques que vous souhaitez mesurer dans votre session d'échantillonnage.
Définissez vos paramètres d'échantillonnage dans le menu latéral.
Cliquez sur Lancer la session pour démarrer une partie via le client Fortnite.
(Facultatif) Une fois le client chargé, appuyez sur Fin de partie pour passer en mode Modification, ce qui permet à votre pion de traverser le niveau plus rapidement.
Appuyez sur Lancer l'échantillonnage.
Pendant la session de jeu, utilisez votre pion pour courir autour de l'île et jouer au jeu comme prévu. La carte de chaleur du profileur spatial se met à jour au fur et à mesure.
Appuyez sur le bouton Arrêter l'échantillonnage pour mettre fin à la session d'échantillonnage.
Appuyez sur l'icône Enregistrer du widget Profileur spatial et choisissez un emplacement dans le répertoire local de votre projet. Le profileur fournit un accès en lecture à tout échantillon enregistré dans le projet. Les échantillons sont organisés par type de métrique et par horodatage.
Vous pouvez cliquer sur l'icône Ouvrir pour accéder à tous les enregistrements d'échantillons de projets précédents.
