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 segno di spunta.

Annotazioni predefinite

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

• Scene: contiene l'identificatore della scena in riproduzione; è utile nei casi in cui la maggior parte dei 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

Definire e utilizzare 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 enum. Ad esempio, puoi fare un enumerazione della difficoltà del gioco.

3. Fai clic sul pulsante Add New Enum (Aggiungi nuova enum) dopo aver specificato i valori enum.

   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 Applica per consentire al plug-in di rigenerare i file e le classi del buffer di protocollo.

Per impostare questa annotazione nel tuo 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 (con un conseguente rendimento inferiore) o troppo basso (con una conseguente riduzione inutilmente della fedeltà).

Il tuo gioco potrebbe avere già diversi parametri di fedeltà, come i seguenti:

• Qualità delle ombre
• 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 Android Performance Tuner registri correttamente questi parametri e poi analizzarli e visualizzarli in Google Play Console, devi esporre i parametri al plug-in. Aggiungi i tuoi parametri di fedeltà nella scheda Parametri di fedeltà.

Figura 4. Scheda Parametri fedeltà nel plug-in

Seleziona Utilizza parametri personalizzati, 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à in modo appropriato 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 tuoi 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 più basso al più alto.

Figura 5. Scheda Livelli qualitativi nel plug-in