In questa pagina viene descritto come scaricare, importare e configurare il plug-in Unity per Android Performance Tuner.
Requisiti
Per usare il plug-in nel tuo gioco, usa una versione supportata di Unity:
- Unity versione 2017.4 o successive e .NET versione 4.6
- Per utilizzare i file di espansione APK, è necessario Unity 2018.2
- Per migliorare il pacing del frame e le misurazioni della GPU, è necessaria la versione 2019.3.14 di Unity o una versione successiva
- Per il supporto delle scene Addressables, sono necessari Unity 2019.3 o versioni successive e il pacchetto Addressables 1.19.4 o versioni successive.
Scarica il plug-in
Scarica il plug-in dal repository GitHub. Seleziona il file .unitypackage scaricato.
Importa il plug-in
Prima di importare il plug-in, assicurati che il progetto utilizzi .NET versione 4.6. Questo vale per Unity 2018.4 e versioni precedenti (le versioni successive di Unity contengono solo la versione 4 .6 di.NET).
- Seleziona File > Impostazioni build. Assicurati che Android sia selezionato come piattaforma corrente.
- Fai clic sul pulsante Impostazioni del player.
- In Altre impostazioni, trova Versione runtime di script e seleziona .NET 4.6.
Il plug-in viene fornito come pacchetto Unity che puoi importare nel tuo progetto.
Seleziona Asset > Importa pacchetto > Pacchetto personalizzato e seleziona il
file .unitypackage che hai scaricato.
Android Performance Tuner versione 1.5.1 o successive con Unity 2017
Se utilizzi Android Performance Tuner versione 1.5.1 o successive con Unity 2017, durante l'importazione del plug-in sono necessari i seguenti passaggi aggiuntivi:
- Vai alla cartella Assets/AndroidPerformanceTuner/Editor.
- Fai clic sul file Google.Android.PerformanceTuner.Editor per aprirlo in Inspector.
- Fai clic sul riferimento all'assemblaggio mancante, quindi fai clic su - per rimuoverlo.
Fai clic sul pulsante Applica.
Figura 1. Riferimento all'assemblaggio mancante.Vai alla cartella Assets/AndroidPerformanceTuner/Runtime.
Fai clic sul file Google.Android.PerformanceTuner per aprirlo in Inspector.
Ripeti il passaggio 3 per rimuovere i due riferimenti all'assemblaggio mancanti.
Riavvia Unity.
Vai a Finestra > AndroidPerformanceTuner > Configurazione e verifica che non vengano visualizzati errori.
Reimportazione del plug-in dopo l'eliminazione
Se stai reimportando il plug-in dopo averlo rimosso dal progetto, rimuovi prima ANDROID_PERFORMANCE_TUNER_UTILITIES da Impostazioni del player > Definizione dei simboli tramite script.
Configura il plug-in
Per configurare il plug-in:
Per Unity 2019.3.14 o versioni successive:
Attiva la raccolta di pacing dei frame Android. Android Performance Tuner utilizzerà questa libreria per misurare le prestazioni del tuo gioco, incluse misure più approfondite rispetto a quanto riportato dalla sola Unity.
Seleziona File > Impostazioni build e fai clic sul pulsante Impostazioni del player. In Risoluzione e presentazione, seleziona la casella di controllo Pacing del frame ottimizzato.
Sincronizza il rendering del frame con spazi vuoti verticali.
Dalle impostazioni del player, seleziona la scheda Qualità e trova il menu VSync Count. Utilizza qualsiasi selezione (tranne Non sincronizzare). Le selezioni diverse da Non sincronizzare consentono misurazioni più precise in combinazione con la libreria di pacing del frame Android.
(Per le versioni di Unity precedenti al 2019) Imposta il sistema di compilazione su Gradle. Seleziona File > Impostazioni build. Trova Sistema di creazione e seleziona Gradle.
Aggiungi l'autorizzazione di accesso a internet. In Altre impostazioni, trova Accesso a internet e seleziona Richiedi.
Inserisci la chiave API. Una volta installato il plug-in, puoi inserirlo dal menu Finestra > Android Performance Tuner > Configurazione. In questa finestra di dialogo, seleziona la scheda Impostazioni e inserisci la chiave API del progetto Google Cloud nel campo Chiave API.
Figura 2. Scheda Impostazioni nel plug-in