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. Questo può includere scene che non sono presenti nelle impostazioni di build 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 controllate 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 versioni successive

Aggiungi scene Indirizzabili

Per fare in modo che Android Performance Tuner riconosca le scene Indirizzabili, procedi nel seguente modo:

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

   Figura 1. Finestra Impostazioni 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 relativo valore salvato nel file proto.

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 Percorso oggetto impostazioni Indirizzo, incluso il nome del file.

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

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

Reimpostazione delle scene degli indirizzi

Puoi reimpostare le scene degli indirizzi facendo clic su Reimposta scene indirizzabili 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 causerà errori in Play Console, poiché le relazioni dei valori scena non verranno conservate.

Impostazione di scene Indirizzabili nelle annotazioni

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

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