Integrare il plug-in

In questa pagina viene descritto come scaricare, importare e configurare il plug-in Unity per Android Performance Tuner.

Requisiti

Per utilizzare il plug-in nel tuo gioco, usa una versione supportata di Unity:

  • Unity 2017.4 o versioni successive e .NET versione 4.6
  • Per utilizzare i file di espansione APK, è necessario Unity 2018.2
  • Per il miglioramento del pacing dei frame e delle misurazioni della GPU, è necessaria Unity 2019.3.14 o successive
  • Per il supporto delle scene Addressables, sono richiesti Unity 2019.3 o versioni successive e Addressables Package 1.19.4 o versioni successive.

Scarica il plug-in

Scarica il plug-in dal repository di 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. Si applica a Unity 2018.4 e versioni precedenti (le versioni successive di Unity contengono solo la versione 4 .6 di.NET).

  1. Seleziona File > Impostazioni build. Assicuratevi che Android sia selezionato come piattaforma attuale.
  2. Fai clic sul pulsante Impostazioni del player.
  3. In Altre impostazioni, individua Scripting runtime versione e seleziona .NET 4.6.

Il plug-in viene fornito come pacchetto Unity che puoi importare nel tuo progetto. Seleziona Risorse > Importa pacchetto > Pacchetto personalizzato e seleziona il file .unitypackage che hai scaricato.

Android Performance Tuner versione 1.5.1 o successiva con Unity 2017

Se utilizzi Android Performance Tuner versione 1.5.1 o successive con Unity 2017, sono necessari i seguenti passaggi aggiuntivi per l'importazione del plug-in:

  1. Vai alla cartella Assets/AndroidPerformanceTuner/Editor.
  2. Fai clic sul file Google.Android.PerformanceTuner.Editor per aprirlo in Inspector.
  3. Fai clic sul riferimento dell'assemblaggio mancante, quindi fai clic su - per rimuoverlo.
  4. Fai clic sul pulsante Applica.

    Figura 1. Riferimento all'assemblaggio mancante.

  5. Vai alla cartella Assets/AndroidPerformanceTuner/Runtime.

  6. Fai clic sul file Google.Android.PerformanceTuner per aprirlo in Inspector.

  7. Ripeti il passaggio 3 per rimuovere i due riferimenti all'assemblaggio mancanti.

  8. Riavvia Unity.

  9. 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 degli script.

Configura il plug-in

Per configurare il plug-in:

  1. Per Unity 2019.3.14 o versioni successive:

    • Attiva la libreria 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 libreria 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 dei frame con gli spazi vuoti verticali.

      Dalle impostazioni del player, seleziona la scheda Qualità e individua il menu Conteggio VSync. Utilizza qualsiasi selezione (tranne Non sincronizzare). Selezioni diverse da Non sincronizzare consentono misurazioni più precise in combinazione con la libreria di pacing dei frame Android.

  2. (Per le versioni di Unity precedenti al 2019) Imposta il sistema di compilazione su Gradle. Seleziona File > Impostazioni build. Trova Build System e seleziona Gradle.

  3. Aggiungi l'autorizzazione di accesso a internet. In Altre impostazioni, trova Accesso a internet e seleziona Richiedi.

  4. 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