Includi scene indirizzi

In questa pagina viene descritto come configurare Android Performance Tuner in modo da includere le scene Addressables in Unity.

Gli indirizzi consentono agli sviluppatori di caricare dinamicamente i contenuti in fase di runtime. Possono essere incluse scene che non sono presenti nelle impostazioni di compilazione di Unity al momento della creazione del file .apk. Prima di Android Performance Tuner 1.5.1, queste scene non erano riconosciute da Android Performance Tuner e non potevano essere ispezionate in Play Console.

Requisiti

Il supporto per le scene Indirizzabili prevede i seguenti requisiti:

• Android Performance Tuner 1.5.1 o versioni successive
• Unity 2019.3 o versioni successive
• Pacchetto Addressables 1.19.4 o successivo

Aggiungi scene indirizzabili

Per fare in modo che Android Performance Tuner riconosca le scene Indirizzabili:

1. Quando è tutto pronto per testare l'app, vai su Finestra > Android Performance Tuner > Configurazione e apri la scheda Impostazioni indirizzi.

   Figura 1. Finestra Impostazioni indirizzabili.

2. Fai clic sul pulsante Aggiorna scene raggiungibili.

Per impostazione predefinita, tutte le scene contenute in AddressableAssetSettingsDefaultObject sono incluse in Android Performance Tuner. La finestra ora mostra un elenco di tutte le scene trovate insieme al relativo valore salvato nel file di protocollo.

Figura 2. Scene indirizzabili elencate da Android Performance Tuner.

Per modificare l'oggetto Impostazioni indirizzabili da cui vengono estratte le scene:

1. Vai alla cartella Assets/AndroidPerformanceTuner_gen/Runtime/Resources e apri l'oggetto script SetupConfig in Inspector.

2. Inserisci il percorso dell'oggetto Impostazioni personalizzato nel campo Indirizzo oggetto impostazioni indirizzi, incluso il nome del file.

Ti consigliamo di aggiornare le scene Indirizzabili quando il loro layout è semifinale per evitare problemi di compatibilità con le versioni precedenti.

Android Performance Tuner raccoglie i dati solo per le scene presenti nel file .apk caricato nella Play Console.

Reimpostazione delle scene indirizzabili

Puoi reimpostare le scene indirizzibili facendo clic su Reimposta scene raggiungibili nella scheda Impostazioni indirizzi. Tuttavia, questo interrompe la compatibilità con la versione attualmente pubblicata dell'app.

L'aggiornamento dinamico dell'oggetto SetupConfig nell'app senza pubblicare una nuova release comporterà errori in Play Console, poiché le relazioni tra valori scena non verranno conservate.

Impostazione di scene raggiungibili nelle annotazioni

Se usi le annotazioni predefinite, Android Performance Tuner imposta automaticamente la scena corretta. Se usi le annotazioni personalizzate, chiama ConvertAddressableScenePathToAPTSceneIndex():

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