Inclure des scènes adressables

Cette page explique comment configurer Android Performance Tuner pour inclure des scènes adressables dans Unity.

Les éléments adressables permettent aux développeurs de charger dynamiquement du contenu au moment de l'exécution. Cela peut inclure des scènes qui ne figurent pas dans les paramètres de compilation d'Unity lorsque le fichier .apk est créé. Avant la version 1.5.1 de cet outil, ces scènes n'étaient pas reconnues par Android Performance Tuner et ne pouvaient pas être inspectées dans la Play Console.

Conditions requises

La prise en charge des scènes adressables est soumise aux exigences suivantes :

  • Android Performance Tuner 1.5.1 ou version ultérieure
  • Unity 2019.3 ou version ultérieure
  • Package Addressables 1.19.4 ou version ultérieure

Ajouter des scènes adressables

Pour qu'Android Performance Tuner reconnaisse vos scènes adressables, procédez comme suit :

  1. Lorsque vous êtes prêt à tester votre application, accédez à Window > Android Performance Tuner > Setup (Fenêtre > Android Performance Tuner > Configuration), puis ouvrez l'onglet Addressables Settings (Paramètres des éléments adressables).

    Figure 1 : Fenêtre des paramètres des éléments Paramètres adressables

  2. Cliquez sur le bouton Update Addressables Scenes (Mettre à jour les scènes adressables).

Par défaut, toutes les scènes contenues dans AddressableAssetSettingsDefaultObject sont incluses dans Android Performance Tuner. La fenêtre affiche une liste de toutes les scènes trouvées, associées à la valeur correspondant à leur enregistrement dans le fichier .proto.

Figure 2 : Scènes adressables listées par Android Performance Tuner

Voici comment modifier l'objet des paramètres d'adressage à partir duquel les scènes sont extraites :

  1. Accédez au dossier Assets/AndroidPerformanceTuner_gen/Runtime/Resources, puis ouvrez l'objet scriptable SetupConfig dans l'inspecteur.

  2. Insérez le chemin d'accès à l'objet paramètres personnalisé dans le champ chemin des objets paramètres des éléments adressables, y compris le nom du fichier.

Nous vous recommandons de mettre à jour les scènes adressables lorsque la disposition de vos scènes est quasiment finalisée afin d'éviter tout problème de rétrocompatibilité.

Android Performance Tuner ne collecte des données que pour les scènes présentes dans le fichier .apk importé dans la Play Console.

Réinitialisation des scènes adressables

Vous pouvez réinitialiser vos scènes adressables en cliquant sur Reset Addressables Scenes (Réinitialiser les scènes adressables) dans l'onglet Addressables Settings (Paramètres des éléments adressables). Toutefois, cette opération met fin à la compatibilité avec la version de l'application actuellement publiée.

La mise à jour dynamique de l'objet SetupConfig dans l'application sans publication d'une nouvelle version entraîne des erreurs dans la Play Console, car les relations entre scènes et valeurs ne sont pas conservées.

Définir des scènes adressables dans les annotations

Si vous utilisez les annotations par défaut, Android Performance Tuner définit automatiquement la scène souhaitée. Si vous utilisez des annotations personnalisées, appelez ConvertAddressableScenePathToAPTSceneIndex() :

tuner.SetCurrentAnnotation(new Annotation
{
    Scene = (Scene) tuner.ConvertAddressableScenePathToAPTSceneIndex(scenePath),
    Difficulty = Difficulty.Medium
});