Includi scene indirizzi

Questa pagina descrive come configurare Android Performance Tuner per includere le scene Addressables in Unity.

Gli indirizzabili consentono agli sviluppatori di caricare dinamicamente i contenuti in fase di runtime. Ciò può includere scene non presenti nelle impostazioni di build di Unity durante la creazione del file .apk. Prima di Android Performance Tuner 1.5.1, queste scene non venivano riconosciute da Android Performance Tuner e non potevano essere esaminate in Play Console.

Requisiti

Il supporto delle scene Addressables presenta i seguenti requisiti:

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

Aggiungere scene Addressables

Per fare in modo che Android Performance Tuner riconosca le tue scene Addressables, svolgi i seguenti passaggi:

1. Quando è tutto pronto per testare l'app, vai a Window > Android Performance Tuner > Setup e apri la scheda Addressables Settings.

   Figura 1. Finestra Impostazioni degli indirizzi.

2. Fai clic sul pulsante Aggiorna scene indirizzabili.

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 loro valore salvato nel file proto.

Figura 2. Scene Addressables elencate da Android Performance Tuner.

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

1. Vai alla cartella Assets/AndroidPerformanceTuner_gen/Runtime/Resources e apri l'oggetto scriptable SetupConfig nell'inspector.

2. Inserisci il percorso dell'oggetto Impostazioni personalizzato nel campo Percorso dell'oggetto Impostazioni degli asset indirizzabili, incluso il nome del file.

Ti consigliamo di aggiornare le scene Addressables quando il layout delle scene è quasi definitivo per evitare problemi di compatibilità con le versioni precedenti.

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

Reimpostazione delle scene di Addressable

Puoi reimpostare le scene Addressables facendo clic su Reimposta scene Addressables nella scheda Impostazioni Addressables. Tuttavia, ciò 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, in quanto le relazioni tra scene e valori non verranno mantenute.

Impostazione delle scene indirizzabili nelle annotazioni

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

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