Definisci le annotazioni, i parametri di fedeltà e i livelli qualitativi

Questo documento descrive come impostare annotazioni, parametri di fedeltà e livelli qualitativi nel tuo progetto Unity.

Annotazioni

Le annotazioni forniscono informazioni contestuali sull'attività del gioco quando viene registrato un tick.

Annotazioni predefinite

Il plug-in definisce un'annotazione predefinita per te:

• Scena: contiene l'identificatore della scena in riproduzione; utile nei casi in cui la maggior parte dei tuoi livelli sia mappata a una singola scena del progetto

Per visualizzare queste annotazioni nell'interfaccia utente:

1. Seleziona Google > Android Performance Tuner.

2. Seleziona la scheda Parametri di annotazione, quindi fai clic su Utilizza parametri personalizzati.

   Figura 1. Scheda Parametri di annotazione nel plug-in

Definisci e utilizza un'annotazione personalizzata

Per creare un'annotazione personalizzata:

1. Nella scheda Parametri di annotazione, fai clic sul pulsante + per creare una nuova annotazione.

2. Nella nuova riga, fai clic sulla colonna Tipo e seleziona Aggiungi o aggiorna enumerazione. Ad esempio, puoi fare un'enumerazione della difficoltà del gioco.

3. Fai clic sul pulsante Aggiungi nuova enumerazione dopo aver specificato i valori di enumerazione.

   Figura 2. Aggiungi una nuova enumerazione

4. Seleziona il nuovo tipo nella colonna Tipo. Inserisci un nome per il parametro nella colonna Nome parametro.

   Figura 3. Seleziona la nuova enumerazione

5. Fai clic sul pulsante Apply (Applica) per consentire al plug-in di rigenerare le classi e i file del buffer di protocollo.

Per impostare questa annotazione nel gioco, chiama SetCurrentAnnotation():

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

Definire i parametri di fedeltà e i livelli qualitativi

I parametri di fedeltà riflettono le prestazioni e le impostazioni grafiche del gioco. I livelli qualitativi vengono utilizzati per annotare le sessioni in modo da poter determinare se i dispositivi funzionano a un livello qualitativo troppo alto (che comporta prestazioni inferiori) o troppo basso (con una conseguente riduzione inutilmente della fedeltà).

Il tuo gioco potrebbe avere già diversi parametri di fedeltà, ad esempio quelli riportati di seguito:

• Qualità ombra
• Risoluzione texture
• Qualità degli effetti delle particelle

Questi parametri possono essere raggruppati in livelli qualitativi (ad esempio "basso", "medio" e "alto"). Per fare in modo che questi parametri vengano segnalati correttamente da Android Performance Tuner e poi analizzati e visualizzati in Google Play Console, devi esporre i parametri al plug-in. Aggiungi i tuoi parametri di fedeltà nella scheda Parametri fedeltà.

Figura 4. Scheda Parametri fedeltà nel plug-in

Seleziona Utilizza parametri personalizzati e poi definisci un insieme di parametri. Ogni parametro ha un tipo, ad esempio le annotazioni.

Usa la funzione SetFidelityParameters() per impostare i parametri di fedeltà appropriati nel tuo gioco:

tuner.SetFidelityParameters(new FidelityParams
{
    ParticleDetails = 1.0f,
    ShadowQuality = ShadowQuality.High,
    TextureResolution = 2048,
});

Successivamente, definisci i diversi livelli qualitativi che verranno utilizzati per raggruppare i dati in Google Play Console e ottenere informazioni migliori. Aggiungi i livelli qualitativi nella scheda Livelli qualitativi.

Fai clic sul pulsante Aggiungi livello per aggiungere il tuo primo livello. Definisci più livelli che seguono una tendenza. Ad esempio, definisci i livelli dal livello qualitativo più basso al più alto.

Figura 5. Scheda Livelli qualitativi nel plug-in