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:
- Seleziona Google > Android Performance Tuner.
Seleziona la scheda Parametri di annotazione e poi fai clic su Utilizza parametri personalizzati.
Figura 1. Scheda Annotation parameters (Parametri di annotazione) nel plug-in
Definisci e utilizza un'annotazione personalizzata
Per creare un'annotazione personalizzata:
- Nella scheda Parametri di annotazione, fai clic sul pulsante + per creare una nuova annotazione.
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.
Fai clic sul pulsante Aggiungi nuovo enum dopo aver specificato i valori enum.
Figura 2. Aggiungi un nuovo enum Seleziona il nuovo tipo nella colonna Tipo. Inserisci un nome per il parametro nella colonna Nome parametro.
Figura 3. Seleziona il nuovo enum 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à.
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.