Classifiche

Le classifiche possono essere un modo divertente per stimolare la competizione tra i tuoi giocatori, sia per i tuoi fan più appassionati (che si batteranno per il primo posto in una classifica pubblica) sia per i tuoi giocatori più occasionali (che saranno interessati a confrontare i loro progressi con quelli dei loro amici).

Per informazioni su come implementare le classifiche per la tua piattaforma, consulta Implementazioni dei client.

Informazioni sulle classifiche

Quando crei una classifica, i servizi per i giochi di Play si occupano di gestire per te la maggior parte degli aspetti della classifica. La procedura tipica funziona nel seguente modo:

1. Alla fine di una partita (o in un momento appropriato da te stabilito), il gioco invia il punteggio del giocatore a una o più classifiche che hai creato per il gioco.
2. I servizi per i giochi di Play controlla se questo punteggio è migliore dell'attuale voce in classifica del giocatore per il punteggio complessivo, settimanale o giornaliero. In caso affermativo, i servizi per i giochi di Play aggiornano le classifiche corrispondenti con il nuovo punteggio.
3. I servizi per i giochi di Play inviano un report sul punteggio al client del gioco. Questo report indica al cliente se si tratta di un nuovo record giornaliero, settimanale o storico. In caso contrario, i servizi per i giochi di Play comunicano al cliente qual è il punteggio migliore attuale, giornaliero, settimanale o storico per questo giocatore.
4. Per recuperare i risultati di un giocatore per una classifica, puoi richiedere un periodo di tempo (giornaliero, settimanale o dall'inizio) e specificare se l'utente vuole o meno visualizzare una classifica social o pubblica. I servizi per i giochi di Play eseguono tutti i filtri necessari, quindi inviano i risultati al client.
5. Nei casi in cui siano molti i punteggi da segnalare, i servizi per i giochi di Play restituiscono solo i dati relativi ai punteggi più alti in classifica. Puoi anche recuperare i dati non elaborati dei punteggi migliori o dei punteggi adiacenti a quelli del giocatore.

Classifiche multiple

I giochi possono avere più classifiche, fino a un massimo di 70. Ad esempio, un gioco multilivello potrebbe fornire una classifica diversa per ogni livello, mentre un gioco di corse potrebbe avere una classifica separata per ogni traccia.

Intervalli di tempo delle classifiche

L'SDK di Play Giochi crea automaticamente versioni giornaliere, settimanali e dall'inizio di ogni classifica che crei. Non c'è bisogno di creare classifiche separate per ogni intervallo di tempo.

Le classifiche giornaliere vengono reimpostate alle ore UTC-7 (ossia "mezzanotte dell'ora legale del Pacifico") 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 di Play Giochi può mostrare al giocatore due versioni diverse di ogni classifica:

La classifica social è una classifica costituita da persone nelle cerchie dell'utente (o, più precisamente, dai membri delle cerchie che l'utente ha scelto di condividere con la tua applicazione) che hanno deciso di condividere la loro attività di gameplay con l'utente.

La classifica pubblica è composta da giocatori che hanno scelto di condividere pubblicamente la loro attività di gioco. Se il giocatore non ha scelto di condividere pubblicamente la sua attività di gioco, non verrà visualizzato in questa classifica.

Nota: le classifiche social saranno vuote inizialmente finché non pubblichi quella corrispondente tramite Google Play Console. Per scoprire come pubblicare la classifica, consulta l'articolo Pubblicare le modifiche al gioco.

Visualizzazione delle classifiche

Nelle librerie client per dispositivi mobili, le librerie si occupano della formattazione e della visualizzazione delle classifiche. Puoi specificare se un giocatore può visualizzare una determinata classifica o visualizzare 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.

Avviso: i nomi dei player recuperati direttamente dalle librerie client possono contenere caratteri Unicode (ad esempio, se il nome contiene caratteri non inglesi). Se implementi la tua versione dell'interfaccia utente leaderboard che utilizza caratteri decorativi, assicurati che l'interfaccia utente possa visualizzare questi nomi correttamente.

Attributi

Per creare e gestire le classifiche, devi avere dimestichezza con i seguenti attributi:

Nozioni di base

Questi elementi di base sono associati a ogni classifica:

• ID è una stringa univoca che Google Play Console genererà per te. Utilizzerai questo ID univoco per fare riferimento alla classifica nei tuoi client di gioco.
• Nome è un nome breve della classifica (ad esempio, "Miglior punteggio" o "Livello 3"). Può contenere un massimo di 100 caratteri.
• L'icona è un'icona quadrata che verrà associata alla tua classifica. Per le best practice durante la creazione delle icone delle classifiche, consulta la sezione Linee guida per le icone di seguito.
• L'ordine dell'elenco è l'ordine in cui viene visualizzata la classifica quando un giocatore visualizza le classifiche associate al tuo gioco.
• I limiti sono valori facoltativi che definiscono i limiti inferiore e superiore dei punteggi consentiti nella classifica. Questo può aiutarti a ignorare i punteggi inviati che sono chiaramente fraudolenti. Puoi anche utilizzare Players.hide per nascondere i giocatori che ritieni abbiano inviato punteggi fraudolenti da tutte le classifiche della tua app.

Ordine

Le classifiche possono avere due tipi di ordinamento:

• Le classifiche più grandi, meglio sono sono l'impostazione predefinita. Di solito questo è ciò che vedresti nella maggior parte dei giochi in cui i giocatori guadagnano punti.
• Le classifiche più piccolo, meglio è, vengono occasionalmente utilizzate nei casi in cui un punteggio minore sarebbe migliore. Gli esempi più comuni di questo tipo di classifica sono i giochi di corse, in cui il punteggio rappresenta il tempo a disposizione dei giocatori per finire la gara.

Nota: una volta pubblicata la classifica, il tipo di ordinamento ("Più grande è meglio" o "Più piccolo è meglio") diventa fisso e non può essere modificato. Puoi comunque modificare l'ordine dell'elenco di una classifica dopo la sua pubblicazione.

Formattazione punteggio

Tutti i punteggi vengono inviati alle classifiche e archiviati internamente come interi lunghi, ma i servizi per i giochi di Play possono presentarli all'utente in una serie di formati diversi:

• Le classifiche numeriche presentano i punteggi come numeri. Possono essere visualizzati come numeri interi o reali con un numero fisso di cifre decimali. Il punteggio viene inviato come numeri interi e il punto decimale viene inserito nella posizione specificata. Ad esempio, un punteggio pari a 314159 viene visualizzato come 3.14159, 3141.59 o 314159, a seconda della posizione decimale specificata.

• Le classifiche time mostrano i punteggi in ore / minuti / secondi / centesimi di un secondo formato. I punteggi devono essere inviati in millisecondi, quindi 66032 viene interpretato come 1:06.03.

• Le classifiche delle valuta mostrano i punteggi in un formato valuta. I punteggi inviati sono 1/1.000.000 dell'unità di valuta principale. Ad esempio, un punteggio di 19.950.000 viene interpretato come $19.95, supponendo che la valuta sia stata specificata come USD.

Le leaderboard 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 tua classifica.

Traduzioni e formattazione dei punteggi

Quando le librerie client per dispositivi mobili richiedono dati delle classifiche ai servizi per i giochi di Play, specificano la lingua e le impostazioni internazionali in cui visualizzare questi punteggi. L'API REST consente di specificare anche una lingua basata su impostazioni internazionali. I servizi per i giochi di Play restituiscono punteggi delle classifiche formattati per la lingua e le impostazioni internazionali scelte. Questi punteggi formattati verranno visualizzati indipendentemente dal fatto che tu abbia aggiunto o meno le traduzioni per la tua classifica.

Per le classifiche numeriche, il formato numerico viene visualizzato in modo diverso a seconda della lingua. Ad esempio, 12,345.78 negli Stati Uniti e 12 345,78 in Francia. Se usi unità personalizzate e hai aggiunto traduzioni al tuo gioco, devi fornire le unità tradotte per ogni lingua che hai aggiunto. Il servizio poi mostra queste unità tradotte ove appropriato.

In base alla lingua scelta, potrebbe essere necessario fornire versioni diverse dei nomi delle unità. In inglese, è necessaria una versione per un elemento e un'altra per tutto il resto (ad esempio, "meter" e "meters"). In polacco, invece, dovresti fornire una versione per un'unità, alcune unità, molte unità e tutto il resto. Per scoprire di più sulle regole plurali, consulta la sezione Stringhe di quantità(plurali).

Per le classifiche Ora, il formato dell'ora viene visualizzato in base alla lingua e alle impostazioni internazionali del giocatore. Ciò si nota principalmente se utilizzi frazioni di secondo o hai un valore ore con più di tre cifre (ad esempio, 4,815:16:23.42 negli Stati Uniti e 4.815:16:23,42 in Germania).

Per le classifiche Valuta, il formato della valuta verrà visualizzato in base alla lingua e alle impostazioni internazionali del player. Tuttavia, non puoi cambiare l'unità di valuta. Ad esempio, se specifichi la valuta in USD, il gioco mostrerà $19.95 negli Stati Uniti e 19,95 $ in Francia. ma non puoi specificare se il gioco mostra dollari negli Stati Uniti ed euro in Francia.

Linee guida per le icone

Le icone devono essere create come file PNG o JPEG 512 x 512. Le icone verranno ridimensionate nella maggior parte dei client di giochi, quindi evita di creare icone con troppi dettagli. Puoi inviare icone con un canale alfa e la trasparenza verrà mantenuta. L'icona della classifica verrà visualizzata su uno sfondo grigio più scuro sui dispositivi Android, quindi scegli un'icona adatta a questa situazione.

In tutte le lingue viene utilizzata la stessa icona, perciò sconsigliamo di includere testo o contenuti localizzati in un'icona.

Crea 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 di Play Giochi > Configurazione e gestione > Classifiche, quindi fai clic sul pulsante Crea classifica.

Dopodiché, compila semplicemente le informazioni richieste per questa classifica.

Fai clic su Salva come bozza e la tua classifica sarà disponibile nello stato "Bozza". Quando pubblichi il gioco, vengono pubblicate 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 indicati sopra. Per ulteriori informazioni su come testare una versione aggiornata di un gioco, consulta la pagina Pubblicare le modifiche al gioco.

Dopo avere testato la classifica e se ne sei soddisfatto, puoi ripubblicare il gioco con le nuove classifiche, che saranno rese disponibili a tutto il mondo.

Modificare una classifica

Per modificare una classifica che hai già creato, fai clic sulla classifica nella scheda Classifiche di Google Play Console. A questo punto, vedrai lo stesso modulo utilizzato per la creazione della classifica iniziale e sarai in grado di modificare qualsiasi campo come desideri.

Quando hai terminato di modificare una classifica, fai clic sul pulsante Salva come bozza. La classifica appena modificata sarà nello stato "Bozza", che ti consente di testarla.

Se tutto funziona correttamente, seleziona Pubblica le modifiche nella casella nella parte superiore del modulo delle classifiche e potrai ripubblicare il gioco e le classifiche aggiornate che hai aggiornato.

Annullare una modifica

Se decidi che la classifica appena modificata non ti piace e vuoi tornare all'iterazione precedente, seleziona Ripristina dalla casella nella parte superiore del modulo Classifica. Viene ripristinata la versione già pubblicata della classifica.

Eliminare una classifica

Puoi eliminare le classifiche nello stato "Bozza" o che sono state pubblicate. Per eliminare una classifica in Google Play Console, vai al modulo della classifica e fai clic su Elimina classifica nella parte superiore del modulo.

In alternativa, puoi chiamare Players.hide per nascondere la classifica di un giocatore nell'app.

Ripristino di una classifica

Puoi reimpostare i dati di avanzamento dei giocatori solo per le bozze delle classifiche.

• Per reimpostare le classifiche in Google Play Console, fai clic su Reimposta i progressi nella parte superiore del modulo relativo all'evento in questione.
• Per reimpostare i dati della classifica in modo programmatico, chiama i metodi Scores dell'API di gestione.

Aggiunta di traduzioni per le classifiche

Puoi specificare le tue traduzioni per le classifiche associate al gioco. Prima di farlo, assicurati di completare i passaggi descritti nella sezione Aggiunta di traduzioni per il tuo gioco. Devi inoltre aver creato una o più classifiche per il tuo gioco.

Per aggiungere le tue traduzioni per le classifiche, apri la scheda Classifiche del tuo gioco in Google Play Console, quindi seleziona una classifica esistente. Nella pagina dei dettagli della classifica, fai clic sulla scheda di una lingua che hai aggiunto in precedenza alla scheda Dettagli del gioco. Nella pagina dei dettagli della classifica per quella lingua, modifica il modulo con le traduzioni. Fai clic su Salva per memorizzare i dettagli tradotti della classifica.

Nascondi punteggi della classifica

I servizi per i giochi di Google Play offrono una funzionalità di protezione dalla manomissione delle classifiche che controlla i punteggi potenzialmente manomessi e li nasconde automaticamente. Questa funzionalità è disponibile solo per i giochi Android.

La protezione manomissione è abilitata per impostazione predefinita per le nuove classifiche create per il gioco Android, ma è disattivata per le classifiche esistenti. Per attivare la protezione da manomissione per le classifiche esistenti già pubblicate, procedi nel seguente modo:

1. In Google Play Console, apri la scheda Servizi di giochi, quindi seleziona il tuo gioco dall'elenco.
2. Apri la scheda Classifiche, quindi seleziona l'istanza della classifica per la quale vuoi attivare la protezione da manomissione.
3. Attiva l'opzione Attiva protezione da manomissione della classifica.
4. Fai clic su Salva e continua.
5. Pubblica il gioco.

Dopo aver attivato la protezione da manomissione per una classifica in Google Play Console, potrebbero essere necessarie fino a 24 ore prima che questa funzionalità venga applicata. I punteggi inviati prima dell'attivazione della protezione da manomissione non vengono nascosti retroattivamente.

In alcuni casi potrebbe essere opportuno disattivare la protezione da manomissione (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:

• Android
• Web
• API C++
• Best practice per l'implementazione delle classifiche