Le classifiche possono essere un modo divertente per stimolare la competizione tra i giocatori, sia per i fan più accaniti (che si batteranno per il primo posto in una classifica pubblica) sia per i giocatori più occasionali (che saranno interessati a confrontare i propri progressi con quelli dei loro amici).
Per scoprire come implementare le classifiche per la tua piattaforma, consulta Implementazioni client.
Informazioni sulle classifiche
Quando crei una classifica, Play Giochi Services si occuperà di gestire per te la maggior parte degli aspetti della classifica. La procedura tipica funziona nel seguente modo:
- Alla fine di una partita (o in un momento opportuno da te stabilito), il gioco invia il punteggio del giocatore a una o più classifiche che hai creato per il gioco.
- Play Services per i giochi controlla se questo punteggio è migliore rispetto all'attuale voce della classifica del giocatore per il punteggio giornaliero, settimanale o complessivo. In questo caso, i servizi per i giochi di Google Play aggiornano le classifiche corrispondenti con il nuovo punteggio.
- Play Services invia un report sul punteggio al client di gioco. Questo report indica al cliente se si tratta di un nuovo punteggio migliore giornaliero, settimanale o assoluto. In caso contrario, Play Games Services comunicherà al client il miglior punteggio giornaliero, settimanale o assoluto corrente per questo giocatore.
- Per recuperare i risultati di un giocatore per una classifica, puoi richiedere un periodo di tempo (giornaliero, settimanale o complessivo) e specificare se l'utente vuole o meno visualizzare una classifica social o pubblica. Play Games Services esegue tutti i filtri necessari e poi invia i risultati al client.
- Se ci sono molti punteggi da segnalare, Play Giochi Services invia solo i dati relativi ai migliori punteggi della classifica. Puoi anche recuperare i dati non elaborati dei punteggi migliori o dei punteggi adiacenti a quelli del giocatore.
Più classifiche
I giochi possono avere più classifiche, fino a un massimo di 70. Ad esempio, un gioco a più livelli potrebbe fornire una classifica diversa per ogni livello e un gioco di corse potrebbe avere una classifica separata per ogni traccia.
Periodi di tempo delle classifiche
L'SDK Play Games crea automaticamente versioni giornaliere, settimanali e complessive di ogni classifica creata. Non è necessario creare classifiche separate per ogni periodo di tempo.
Le classifiche giornaliere vengono reimpostate alle ore 00:00 UTC-7 (ovvero "mezzanotte del fuso orario del Pacifico USA") tutto l'anno.
Le classifiche settimanali vengono reimpostate a mezzanotte tra sabato e domenica, nello stesso fuso orario delle classifiche giornaliere (UTC-7).
Classifiche pubbliche e social
L'SDK Play Games può mostrare al giocatore due versioni diverse di ogni classifica:
La classifica social è composta da persone che fanno parte dei gruppi dell'utente (o, più precisamente, dai membri dei gruppi che l'utente ha scelto di condividere con la tua applicazione) che hanno deciso di condividere la propria attività di gioco con l'utente.
La classifica pubblica è composta da giocatori che hanno scelto di condividere pubblicamente la propria attività di gioco. Se il tuo giocatore non ha scelto di condividere pubblicamente la propria attività di gioco, non verrà visualizzato in questa classifica.
Visualizzare le classifiche
Nelle librerie client mobile, le librerie si occupano di tutta la formattazione e della visualizzazione delle classifiche. Puoi specificare se un giocatore può vedere una classifica specifica o un elenco di tutte le tue classifiche tra cui scegliere.
Puoi anche implementare le tue versioni delle classifiche accedendo ai dati direttamente dalle librerie client.
Attributi
Per creare e gestire le classifiche, è consigliabile conoscere questi attributi:
Nozioni di base
Questi elementi di base sono associati a ogni classifica:
- ID è una stringa univoca che verrà generata per te da Google Play Console. Utilizzerai questo ID univoco per fare riferimento alla classifica nei client di gioco.
- Nome è un nome breve della classifica (ad esempio "Migliori punteggi" o "Livello 3"). Può contenere fino a 100 caratteri.
- Icona è un'icona quadrata che verrà associata alla classifica. Per le migliori pratiche per la creazione delle icone della classifica, consulta le linee guida per le icone.
- L'ordine dell'elenco è l'ordine in cui la classifica viene visualizzata quando un giocatore visualizza le classifiche associate al tuo gioco.
- Limiti sono valori facoltativi che definiscono i limiti minimo e massimo dei
punteggi consentiti nella classifica. In questo modo puoi ignorare i punteggi
inviati che sono chiaramente fraudolenti. Puoi anche utilizzare
Players.hideper nascondere tutti i giocatori che ritieni abbiano inviato punteggi fraudolenti da tutte le classifiche della tua app.
Classifiche in ordine
Le classifiche possono avere uno dei due tipi di ordinamento:
- Le classifiche più grandi sono migliori sono l'impostazione predefinita. In genere, è ciò che vedresti nella maggior parte dei giochi in cui i giocatori guadagnano punti.
- Le classifiche meno è meglio vengono utilizzate occasionalmente nei casi in cui un punteggio inferiore sia preferibile. Gli esempi più comuni di questo tipo di classifica si trovano nei giochi di corse, in cui il punteggio rappresenta il tempo impiegato dal giocatore per completare la gara.
Formattazione punteggio
Sebbene tutti i punteggi vengano inviati alle classifiche e archiviati internamente come interi lunghi, i servizi per i giochi di Play possono presentarli all'utente in diversi formati:
Le classifiche numeriche presentano i punteggi come numeri. Possono essere visualizzati come interi o come numeri reali con un numero fisso di cifre decimali. Invii il punteggio come numeri interi e la virgola decimale viene inserita nella posizione specificata. Ad esempio, un punteggio di
314159viene visualizzato come3.14159,3141.59o314159, a seconda della cifra decimale specificata.Le classifiche Tempo presentano i punteggi in ore / minuti / secondi/centesimo di secondo. Devi inviare i punteggi in millisecondi, quindi
66032verrebbe interpretato come1:06.03.Le classifiche in valuta presentano i punteggi in un formato valuta. Invii gli score come 1/1.000.000 dell'unità di valuta principale. Ad esempio, un punteggio di 19.950.000 verrebbe interpretato come
$19.95, supponendo che tu abbia specificato la valuta come USD.
Le classifiche numeriche supportano anche le unità personalizzate. Ad esempio, se il tuo gioco misura i punteggi migliori in metri, puoi specificare "metri" come unità predefinita per la classifica.
Traduzioni e formattazione dei punteggi
Quando le librerie client mobile richiedono i dati della classifica da Google Play Services, specificano una lingua e un'impostazione internazionale in cui visualizzare questi punteggi. L'API REST ti consente anche di specificare una lingua basata sulle impostazioni internazionali. Play Games Services restituisce i punteggi della classifica formattati appropriati per la lingua e le impostazioni internazionali. Questi scorci formattati verranno visualizzati indipendentemente dal fatto che tu abbia aggiunto o meno traduzioni per la tabella di confronto.
Per le classifiche Numeriche, il formato numerico viene visualizzato in modo diverso in base alla lingua. Ad esempio, 12,345.78 negli Stati Uniti e 12 345,78 in Francia. Se utilizzi unità personalizzate e hai aggiunto traduzioni al tuo gioco, devi fornire le unità tradotte per ogni lingua che hai aggiunto. Il servizio mostrerà quindi queste unità tradotte, se opportuno.
A seconda della lingua scelta, potrebbe essere necessario fornire versioni diverse dei nomi delle unità. In inglese, dovrai avere una versione per un elemento e un'altra per tutto il resto (ad esempio, "metro" e "metri"). In polacco, invece, devi fornire una versione per una unità, alcune unità, molte unità e tutto il resto. Per scoprire di più sulle regole per il plurale, consulta Stringhe di quantità(plurali).
Per le classifiche Tempo, il formato dell'ora viene visualizzato in base alla lingua e alle impostazioni internazionali del giocatore. Questo sarà evidente soprattutto se utilizzi frazioni di secondo o hai un valore in ore con più di 3 cifre (ad es. 4,815:16:23.42 negli Stati Uniti e 4.815:16:23,42 in Germania).
Per le classifiche in valuta, il formato della valuta verrà visualizzato in base alla lingua e alle impostazioni internazionali del giocatore. Tuttavia, non puoi modificare la moneta. Ad esempio, se specifichi la valuta in dollari statunitensi, il gioco mostrerà $19.95 negli Stati Uniti e 19,95 $ in Francia. Tuttavia, non puoi specificare che il tuo gioco mostri i dollari negli Stati Uniti e gli euro in Francia.
Linee guida per le icone
Le icone devono essere create come file PNG o JPEG da 512 x 512 pixel. Le icone verranno ridotte nella maggior parte dei client di gioco, quindi ti consigliamo di evitare di creare icone con dettagli troppo fini. Puoi inviare icone con un canale alfa e la trasparenza verrà conservata. L'icona della classifica verrà mostrata su un sfondo grigio più scuro sui dispositivi Android, quindi scegli un'icona che possa funzionare bene in questa situazione.
La stessa icona viene utilizzata in tutte le lingue, pertanto ti consigliamo di non includere testo o contenuti localizzati in un'icona.
Creare una classifica
Questa sezione spiega come creare classifiche per giochi nuovi o esistenti.
Creare una classifica per un nuovo gioco
Per creare una classifica per un gioco nuovo e non pubblicato, vai alla voce di Google Play Console relativa al tuo gioco e vai a Crescita > Servizi per i giochi di Play > Configurazione e gestione > Classifiche, quindi fai clic sul pulsante Crea classifica.
Poi, compila le informazioni richieste per questa classifica.
Fai clic su Salva come bozza e la classifica sarà disponibile nello stato "Bozza". Una volta pubblicato il gioco, vengono pubblicate anche tutte le relative classifiche.
Creare una classifica per un gioco pubblicato
Per creare una classifica aggiuntiva per un gioco già pubblicato, segui gli stessi passaggi descritti sopra. Per ulteriori informazioni sul test di una versione aggiornata di un gioco, consulta Pubblicare le modifiche del gioco.
Una volta che hai testato la classifica e ti soddisfa, puoi ripubblicare il gioco con le nuove classifiche, che verranno distribuite a livello mondiale.
Modificare una classifica
Per modificare una classifica già creata, fai clic sulla classifica nella scheda Classifiche di Google Play Console. A questo punto, vedrai lo stesso modulo utilizzato per la prima creazione della classifica e potrai modificare i campi in base alle tue esigenze.
Al termine della modifica di una classifica, fai clic sul pulsante Salva come bozza. La classifica appena modificata sarà nello stato "Bozza", il che ti consente di testarla.
Se funziona correttamente, seleziona Pubblica le modifiche dalla casella nella parte superiore del modulo della classifica e potrai ripubblicare il gioco, insieme a tutte le classifiche aggiornate, per il pubblico.
Annullare una modifica
Se decidi che la classifica appena modificata non ti piace e vuoi tornare alla versione precedente, seleziona Ripristina dalla casella in alto nel modulo della classifica. La classifica torna alla versione già pubblicata.
Eliminare una classifica
Puoi eliminare le classifiche nello stato "Bozza" o quelle che sono state pubblicate. Per eliminare una classifica in Google Play Console, vai al relativo modulo e fai clic su Elimina classifica nella parte superiore del modulo.
In alternativa, puoi chiamare il numero Players.hide per nascondere la classifica di un giocatore nell'app.
Ripristino di una classifica
Puoi reimpostare i dati sui progressi dei giocatori solo per le classifiche della bozza.
- Per reimpostare le classifiche in Google Play Console, fai clic su Reimposta avanzamento nella parte superiore del modulo relativo all'evento.
- Per reimpostare i dati della classifica in modo programmatico, chiama i
Scoresmetodi dell'API di gestione.
Aggiungere traduzioni per le classifiche
Puoi specificare le tue traduzioni per le classifiche associate al tuo gioco. Prima di procedere, assicurati di completare i passaggi descritti in Aggiunta di traduzioni per il tuo gioco. Inoltre, devi aver creato almeno una classifica per il tuo gioco.
Per aggiungere le tue traduzioni per le classifiche, apri la scheda Classifiche per il tuo gioco in Google Play Console e seleziona una classifica esistente. Nella pagina dei dettagli della classifica, fai clic sulla scheda di una lingua che hai aggiunto in precedenza nella scheda Dettagli del gioco. Nella pagina dei dettagli della classifica per la lingua in questione, modifica il modulo con le tue traduzioni per la classifica. Fai clic su Salva per memorizzare i dettagli della classifica tradotta.
Nascondere i punteggi della classifica
Google Play Giochi Services fornisce una funzionalità di protezione da manomissione della classifica che controlla la presenza di punteggi presumibilmente manomessi e li nasconde automaticamente. Questa funzionalità è disponibile solo per i giochi Android.
La protezione dalle manomissioni è attiva per impostazione predefinita per le nuove classifiche che crei per il tuo gioco per Android, ma è disattivata per le classifiche esistenti. Per attivare la protezione dalle manomissioni per le classifiche esistenti già pubblicate, segui questi passaggi:
- In Google Play Console, apri la scheda Servizi per i giochi, quindi seleziona il tuo gioco dall'elenco.
- Apri la scheda Classifiche e seleziona l'istanza della classifica per la quale vuoi attivare la protezione antimanomissione.
- Imposta su ON l'opzione Attiva la protezione da manomissione della classifica.
- Fai clic su Salva e continua.
- Pubblica il tuo gioco.
Una volta attivata la protezione dalle manomissioni per una classifica in Google Play Console, potrebbero essere necessarie fino a 24 ore prima che questa funzionalità venga applicata. I punteggi inviati prima di attivare la protezione antimanomissione non vengono nascosti in modo retroattivo.
In alcuni casi, potresti voler disattivare la protezione antimanomissione (ad esempio, se il tuo gioco funziona anche sul web oltre che su Android e condivide le classifiche su queste piattaforme).
Implementazioni client
Per scoprire come implementare le classifiche per la tua piattaforma, consulta le seguenti risorse: