Gli obiettivi possono essere un ottimo modo per aumentare il coinvolgimento degli utenti all'interno del tuo gioco. Puoi implementare obiettivi nel gioco per incoraggiare i giocatori a sperimentare con funzionalità che potrebbero non usare o per approcciarti al gioco con stili di gioco completamente diversi. Gli obiettivi possono anche essere un modo divertente con cui i giocatori possono confrontare i loro progressi tra loro e partecipare a competizioni audaci.
Per informazioni su come implementare gli obiettivi per la tua piattaforma, consulta Implementazioni dei clienti.
Attributi
Per capire come funzionano gli obiettivi, devi acquisire familiarità con alcuni degli attributi associati.
Questi elementi di base sono associati a ogni obiettivo:
- Id è una stringa univoca generata da Google Play Console. Utilizzerai questo ID univoco per fare riferimento all'obiettivo nei tuoi client di gioco.
- Nome è un nome breve dell'obiettivo, ad esempio "Maestro Pieman". Il valore può contenere fino a 100 caratteri.
- La descrizione è una descrizione concisa del tuo obiettivo. Solitamente indica al giocatore come raggiungere l'obiettivo (ad esempio "Cucina una torta di meringa al limone prima del tramonto"). Il valore può contenere fino a 500 caratteri.
- L'icona è un'icona quadrata associata all'obiettivo. Per le best practice sulla creazione delle icone degli obiettivi, consulta la sezione Linee guida per le icone.
- L'ordine dell'elenco è l'ordine in cui gli obiettivi bloccati vengono visualizzati quando un giocatore visualizza gli obiettivi associati al tuo gioco. Puoi farlo nell'ordine che preferisci. Gli obiettivi sbloccati vengono visualizzati in cima all'elenco nell'ordine in cui sono stati raggiunti.
Stato
Gli obiettivi possono avere uno dei tre seguenti stati:
- Un obiettivo nascosto indica che i dettagli dell'obiettivo sono nascosti al giocatore. I servizi per i giochi di Play forniscono una descrizione segnaposto e un'icona generici per l'obiettivo quando lo stato è nascosto. Ti consigliamo di nascondere un obiettivo se contiene spoiler che non vuoi rivelare troppo presto sul gioco (ad esempio, "Scopri di essere un fantasma per tutto il tempo!").
- Un obiettivo rivelato indica che il giocatore è a conoscenza dell'obiettivo, ma non l'ha ancora ottenuto. La maggior parte degli obiettivi inizia nello stato mostrato.
- Un obiettivo sbloccato indica che il giocatore ha raggiunto l'obiettivo. Un obiettivo può essere sbloccato offline. Quando il gioco è online, si sincronizza con i servizi per i giochi di Play per aggiornare lo stato di sblocco dell'obiettivo.
Obiettivi incrementali
Gli obiettivi possono essere designati come standard o incrementali. In genere, un obiettivo incrementale implica che un giocatore compie progressi graduali verso l'ottenimento dell'obiettivo in un periodo di tempo più lungo. Man mano che il giocatore procede verso l'obiettivo incrementale, puoi segnalare i progressi parziali del giocatore ai servizi per i giochi di Play.
Il servizio Google Play tiene traccia delle informazioni sui progressi, avvisa il gioco quando il giocatore soddisfa i criteri necessari per sbloccare l'obiettivo e comunica al giocatore quanto manca per raggiungere l'obiettivo.
![Un esempio di obiettivo incrementale che mostra i progressi del giocatore al 40%.](https://developer.android.com/static/images/games/pgs/achievementIncremental.png?authuser=8&hl=it)
Gli obiettivi incrementali sono cumulativi tra le sessioni di gioco e i progressi non possono essere rimossi o reimpostati dall'interno del gioco. Ad esempio, "Vinci 50 partite" potrebbe essere un obiettivo incrementale. "Vincere 3 partite di fila" non, perché i progressi dei giocatori vengono azzerati quando perde una partita. Anche "Avere 5.000 fiches da poker" non sarebbe idoneo, in quanto un giocatore potrebbe guadagnare e perdere le fiches mentre gioca. Per gli ultimi due obiettivi, spetta a te monitorare lo stato "Vittorie di fila" o il totale delle fiches del giocatore e sbloccare gli obiettivi standard quando il giocatore li guadagna.
Quando crei un obiettivo incrementale, devi definire il numero totale di passaggi necessari per sbloccarlo (deve essere un numero compreso tra 2 e 10.000). Man mano che l'utente procede per sbloccare l'obiettivo, devi segnalare il numero di passaggi aggiuntivi effettuati dall'utente ai servizi per i giochi di Play. Quando il numero totale di passaggi raggiunge il valore di sblocco, l'obiettivo viene sbloccato (anche se era nascosto). Non è necessario archiviare i progressi cumulativi dell'utente.
Punti
Agli obiettivi è associato un valore in punti. Il punteggio del giocatore deve essere un multiplo di 5 e un gioco non può mai avere un totale di più di 1000 punti per tutti i suoi obiettivi (anche se può avere meno punti). Inoltre, nessun singolo risultato può avere più di 200 punti.
Traccia punti esperienza (XP)
I giocatori possono salire di livello nel loro profilo di gioco quando ottengono obiettivi nei giochi abilitati per Play Giochi. Per ogni punto associato a un obiettivo, il giocatore guadagna 100 punti esperienza (XP) quando raggiunge l'obiettivo. In altre parole:
XP for an achievement = 100 * (point value for the achievement)
I servizi di Play Giochi tengono traccia degli XP guadagnati da ogni giocatore e invia una notifica all'app Google Play Giochi quando il giocatore ha guadagnato abbastanza punti per "salire di livello". I giocatori possono visualizzare la cronologia del proprio livello e dei propri XP dalla pagina del profilo nell'app Google Play Giochi.
Numero minimo di obiettivi
Un gioco che integra obiettivi dovrebbe avere almeno cinque obiettivi prima di essere pubblicato. Puoi testare con meno di cinque obiettivi, ma ti consigliamo di crearne almeno cinque prima di pubblicare il gioco.
Numero massimo di obiettivi
Il numero di obiettivi è limitato dai limiti e dalla distribuzione di punti. Con un numero massimo di punti di 1000 e a ogni obiettivo sono stati assegnati 5 punti, il numero massimo di obiettivi è 200. Tuttavia, se agli obiettivi vengono assegnati più punti, il numero di obiettivi disponibili diminuisce di conseguenza.
Linee guida per le icone
Le icone devono essere create in formato PNG o JPG 512 x 512. Devi solo fornirci l'icona dell'obiettivo sbloccato. Verrà generata automaticamente una versione in scala di grigi per l'icona visualizzata. Per questo motivo, ti consigliamo di includere elementi colorati tra le icone degli obiettivi raggiunti, in modo che gli utenti possano distinguere facilmente gli obiettivi visualizzati da quelli sbloccati.
Quando l'icona di un obiettivo viene visualizzata in un toast Android, all'icona è sovrapposto un cerchio e gli angoli esterni sono nascosti. Assicurati che l'icona venga comunque visualizzata correttamente in queste circostanze.
![Esempio di icona di un risultato all'interno di un cerchio.](https://developer.android.com/static/images/games/pgs/achievementIconExample.png?authuser=8&hl=it)
In tutte le lingue viene utilizzata la stessa icona, perciò sconsigliamo di includere testo o contenuti localizzati in un'icona.
Crea un obiettivo
Questa sezione descrive come creare obiettivi per i giochi nuovi e pubblicati.
Nuova partita
Per creare un obiettivo per un gioco nuovo e non pubblicato, vai alla voce di Google Play Console relativa al tuo gioco nella scheda Giochi con servizi di giochi.
Seleziona la scheda Obiettivi a sinistra, quindi fai clic sul pulsante Aggiungi obiettivo.
![Il pulsante "Aggiungi obiettivo" nel riquadro principale degli obiettivi](https://developer.android.com/static/images/games/pgs/achievementAddButton.png?authuser=8&hl=it)
Quindi, compila le informazioni richieste per raggiungere questo obiettivo.
![Un esempio di modulo di obiettivo compilato per l'obiettivo "Ultimo luogo".](https://developer.android.com/static/images/games/pgs/achievementSampleForm.png?authuser=8&hl=it)
Fai clic su Salva e il tuo obiettivo verrà reso disponibile in modalità "Pronto per la pubblicazione". Dopo la pubblicazione del gioco, verranno pubblicati tutti i relativi obiettivi.
Gioco pubblicato
Per creare un obiettivo aggiuntivo per un gioco già pubblicato, segui gli stessi passaggi indicati sopra. L'unica differenza è che il pulsante Salva viene rietichettato come Salva come bozza e l'obiettivo sarà in modalità "Pronto per il test". Per ulteriori informazioni su come testare una versione aggiornata di un gioco, consulta la pagina Pubblicare le modifiche al gioco.
Dopo aver testato l'obiettivo e se ne sei soddisfatto, puoi ripubblicare il gioco con i nuovi obiettivi, che verranno resi disponibili per il mondo intero.
Modificare un obiettivo
Per modificare un obiettivo che hai già creato, selezionalo nella scheda Obiettivi di Google Play Console. A questo punto, vedrai lo stesso modulo che hai utilizzato la prima volta che hai creato l'obiettivo e puoi modificare qualsiasi campo come desideri.
Quando hai terminato di modificare un obiettivo, fai clic sul pulsante Salva come bozza. L'obiettivo appena modificato sarà in una fase di"pronto per il test" e potrai testarlo. Se funziona correttamente, seleziona Ripubblica dall'elenco a discesa. In questo modo, il gioco viene ripubblicato, insieme a tutti gli obiettivi aggiornati, per il pubblico.
Annullare una modifica
Se decidi che l'obiettivo attuale non ti piace e vuoi tornare com'era prima, seleziona Ripristina dall'elenco a discesa in Google Play Console e tutti i tuoi obiettivi torneranno alla versione pubblicata in precedenza.
Eliminare un obiettivo
Una volta pubblicato, l'obiettivo non può essere eliminato.
Puoi eliminare un obiettivo solo se è in uno stato precedente alla pubblicazione facendo clic sul pulsante Elimina nella parte inferiore del modulo relativo all'obiettivo.
Reimposta un obiettivo
Puoi reimpostare i dati di avanzamento dei giocatori solo per gli obiettivi in bozza.
- Per reimpostare gli obiettivi in Google Play Console, fai clic sul pulsante Reimposta l'avanzamento degli obiettivi nella parte inferiore del modulo per l'evento in questione.
- Per reimpostare i dati degli obiettivi in modo programmatico, chiama i
metodi
Achievements
dell'API di gestione.
Aggiungere traduzioni per gli obiettivi
Puoi specificare le tue traduzioni per gli obiettivi associati al gioco. Prima di farlo, assicurati di completare i passaggi descritti nella sezione Aggiungere traduzioni per il gioco. Devi anche aver creato uno o più obiettivi per il tuo gioco.
Per aggiungere le tue traduzioni per gli obiettivi, apri la scheda Obiettivi del tuo gioco in Google Play Console, quindi seleziona un obiettivo esistente. Nella pagina dei dettagli degli obiettivi, seleziona la scheda di una lingua che hai aggiunto in precedenza alla scheda Dettagli del gioco. Nella pagina dei dettagli dell'obiettivo di quella lingua, modifica il modulo con le traduzioni dell'obiettivo. Fai clic su Salva per memorizzare i dettagli degli obiettivi tradotti.
Implementazioni client
Per scoprire come implementare gli obiettivi per la tua piattaforma, consulta le seguenti risorse: