Intégrer le plug-in

Cette page explique comment télécharger, importer et configurer le plug-in Unity pour Android Performance Tuner.

Conditions requises

Pour utiliser le plug-in dans votre jeu, utilisez une version compatible d'Unity :

• Unity version 2017.4 ou ultérieure et .NET version 4.6
• Unity version 2018.2 pour pouvoir utiliser des fichiers d'extension pour APK
• Unity version 2019.3.14 ou ultérieure pour pouvoir améliorer le temps de rendu et les mesures de GPU
• Pour la prise en charge des scènes adressables, Unity version 2019.3 ou ultérieure et le package Addressables 1.19.4 ou version ultérieure sont requis.

Télécharger le plug-in

Téléchargez le plug-in à partir du dépôt GitHub. Sélectionnez le fichier .unitypackage à télécharger.

Importer le plug-in

Avant d'importer le plug-in, assurez-vous que votre projet utilise .NET version 4.6. Cela s'applique à Unity version 2018.4 et antérieures (les versions ultérieures d'Unity ne contiennent que .NET 4.6).

1. Sélectionnez Fichier > Paramètres de compilation. Assurez-vous qu'Android est sélectionné comme plate-forme actuelle.
2. Cliquez sur le bouton Paramètres du lecteur.
3. Sous Autres paramètres, recherchez Version d'exécution de script et sélectionnez .NET 4.6.

Le plug-in est fourni en tant que package Unity que vous pouvez importer dans votre projet. Cliquez sur Éléments > Importer un package > Package personnalisé, puis sélectionnez le fichier .unitypackage que vous avez téléchargé.

Android Performance Tuner 1.5.1 ou version ultérieure avec Unity 2017

Pour utiliser Android Performance Tuner 1.5.1 ou version ultérieure avec Unity 2017, vous devez suivre les étapes supplémentaires suivantes lors de l'importation du plug-in :

1. Accédez au dossier Assets/AndroidPerformanceTuner/Editor.
2. Cliquez sur le fichier Google.Android.PerformanceTuner.Editor pour l'ouvrir dans l'inspecteur.
3. Cliquez sur la référence d'assemblage manquante, puis sur - pour la supprimer.

4. Cliquez sur le bouton Appliquer.

   Figure 1 : Référence d'assemblage manquante.

5. Accédez au dossier Assets/AndroidPerformanceTuner/Runtime.

6. Cliquez sur le fichier Google.Android.PerformanceTuner pour l'ouvrir dans l'inspecteur.

7. Répétez l'étape 3 pour supprimer les deux références d'assemblage manquantes.

8. Redémarrez Unity.

9. Accédez à Fenêtre > AndroidPerformanceTuner > Configuration et vérifiez qu'aucune erreur ne s'affiche.

Réimporter le plug-in après sa suppression

Si vous réimportez le plug-in après l'avoir supprimé du projet, supprimez d'abord ANDROID_PERFORMANCE_TUNER_UTILITIES de Paramètres du lecteur > Symboles de définition de scripts.

Configurer le plug-in

Pour configurer le plug-in, procédez comme suit :

1. Pour Unity version 2019.3.14 ou ultérieure :

   • Activez la bibliothèque Android Frame Pacing. Android Performance Tuner utilise cette bibliothèque pour mesurer les performances de votre jeu, en effectuant notamment des mesures plus approfondies que celles rapportées par Unity.

     Sélectionnez Fichier > Paramètres de compilation, puis cliquez sur le bouton Paramètres du lecteur. Sous Résolution et présentation, cochez la case Temps de rendu optimisés.

   • Synchronisez le rendu des frames avec des blancs verticaux.

     Dans les paramètres du lecteur, sélectionnez l'onglet Qualité et recherchez le menu Nombre d'événements VSync. Utilisez n'importe quelle sélection (sauf Ne pas synchroniser). Les sélections autres que Ne pas synchroniser permettent d'obtenir des mesures plus précises conjointement avec la bibliothèque Android Frame Pacing.

2. (Pour les versions d'Unity antérieures à 2019) Définissez le système de compilation sur Gradle. Sélectionnez Fichier > Paramètres de compilation. Recherchez Système de compilation, puis sélectionnez Gradle.

3. Ajoutez l'autorisation d'accès à Internet. Sous Autres paramètres, recherchez Accès à Internet, puis sélectionnez Exiger.

4. Spécifiez votre clé d'API. Une fois le plug-in installé, vous pouvez la saisir dans le menu Fenêtre > Android Performance Tuner > Configuration. Dans cette boîte de dialogue, sélectionnez l'onglet Paramètres, puis saisissez la clé d'API de votre projet Google Cloud dans le champ Clé d'API.

   Remarque : Si vous ne saisissez pas votre clé d'API, Android Performance Tuner n'envoie pas les données sur les performances de votre jeu à la Google Play Console. Android Performance Tuner consigne cette erreur et vous pouvez la voir à l'aide de adb logcat. (Vous allez exécuter adb logcat dans la section suivante pour vérifier le bon fonctionnement d'Android Performance Tuner.)

   Figure 2 : Onglet "Paramètres" du plug-in