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

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

Annotazioni

Le annotazioni forniscono informazioni contestuali su ciò che sta facendo il gioco quando viene registrato un tick.

Annotazioni predefinite

Il plug-in definisce un'annotazione predefinita:

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

Per visualizzare queste annotazioni nella UI, segui questi passaggi:

  1. Seleziona Google > Android Performance Tuner.
  2. Seleziona la scheda Parametri di annotazione e poi fai clic su Utilizza parametri personalizzati.

    Scheda dei parametri di annotazione nel plug-in Unity di Android Performance Tuner che mostra il parametro della scena personalizzata
    Figura 1. Scheda Annotation parameters (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 enum. Ad esempio, puoi creare un'enumerazione per la difficoltà del gioco.

  3. Fai clic sul pulsante Aggiungi nuovo enum dopo aver specificato i valori enum.

    Nuova finestra di dialogo enum per Difficoltà con i valori FACILE, MEDIA e DIFFICILE
    Figura 2. Aggiungi un nuovo enum
  4. Seleziona il nuovo tipo nella colonna Tipo. Inserisci un nome per il parametro nella colonna Nome parametro.

    Scheda dei parametri di annotazione che mostra il parametro enum personalizzato Difficulty denominato game-difficulty
    Figura 3. Seleziona il nuovo enum
  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 gioco, chiama SetCurrentAnnotation:

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

Definisci i parametri di fedeltà e i livelli di qualità

I parametri di fedeltà riflettono le impostazioni grafiche e di rendimento del tuo gioco. I livelli di qualità vengono utilizzati per annotare le sessioni in modo da poter determinare se i dispositivi sono in esecuzione con un livello di qualità troppo elevato (con conseguente riduzione delle prestazioni) o troppo basso (con conseguente riduzione non necessaria della fedeltà).

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

  • Qualità delle ombre
  • Risoluzione texture
  • Qualità degli effetti particellari

Questi parametri possono essere raggruppati in livelli di qualità (ad esempio "bassa", "media" e "alta"). Per fare in modo che questi parametri vengano segnalati correttamente da Android Performance Tuner, quindi analizzati e visualizzati in Google Play Console, devi esporli al plug-in. Aggiungi i parametri di fedeltà nella scheda Parametri di fedeltà.

Scheda Parametri di fedeltà che mostra i parametri personalizzati texture_resolution, shadow_quality e particle_details
Figura 4. Scheda Parametri di fedeltà nel plug-in

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

Utilizza la funzione SetFidelityParameters per impostare i parametri di fedeltà in base alle esigenze del tuo gioco:

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

Successivamente, definisci i diversi livelli di qualità che verranno utilizzati per raggruppare i dati in Google Play Console e fornirti insight migliori. Aggiungi i livelli di qualità nella scheda Livelli di qualità.

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

Scheda dei livelli di qualità che mostra tre livelli di fedeltà con risoluzione delle texture, dettagli delle particelle e qualità delle ombre crescenti
Figura 5. Scheda Livelli di qualità nel plug-in