Usa le API Friends per integrare e migliorare il tuo sistema di amici in-game esistente e altri sistemi social a cui potrebbe accedere il tuo gioco. In questo modo puoi consentire ai giocatori di:
Trova i loro amici nel tuo gioco.
Confronta i punteggi con i loro amici nelle classifiche.
Combinare l'elenco dei suoi amici di Play Giochi con gli elenchi di amici esistenti in-game.
Identifica un altro giocatore con un popup del profilo in-game. Questo popup mostra un nickname che il giocatore corrente ha dato a un amico, in modo che sappia con chi sta giocando.
Concetti di base
Queste API ti consentono di eseguire le seguenti azioni:
- Carica amici. Puoi controllare se il giocatore ha consentito al gioco di accedere alle informazioni dell'elenco di amici. Se l'accesso viene consentito, puoi visualizzare un elenco di oggetti Player corrispondente agli amici del player che ha eseguito l'accesso.
- Avviare una visualizzazione del profilo Play Giochi di un altro giocatore. Puoi aprire questa visualizzazione per mostrare il nome assegnato all'altro giocatore dal giocatore che ha eseguito l'accesso. Questa vista offre anche controlli per la gestione dell'amicizia e non farà uscire il giocatore dal gioco.
- Fornire controlli agli utenti: l'utente ha controlli per gestire il modo in cui il suo profilo Play Giochi è visibile agli amici e il suo elenco di amici è visibile ai giochi. Per l'accesso all'elenco di amici, l'utente può scegliere di concedere automaticamente l'accesso a tutti i giochi o di approvare singolarmente l'accesso per ogni gioco. Di conseguenza, durante il caricamento dell'elenco di amici, il risultato potrebbe essere un callback per visualizzare una richiesta di accesso.
Importare un elenco di amici di Play Giochi
Puoi usare le API Friends per ottenere un elenco degli amici di Play Giochi dei tuoi giocatori e aggiungerli al tuo elenco di amici in-game.
I nuovi utenti disporranno di un elenco iniziale di amici con cui giocare e gli utenti esistenti potranno importare i propri amici di Play Giochi in qualsiasi elenco di amici in-game. Di conseguenza, gli utenti avranno a disposizione il maggior numero possibile di giocatori con cui giocare o competere.
Aggiungi amici di Play Giochi al tuo gioco
Aggiungi amici di Play Giochi a qualsiasi elenco di amici in-game esistente associando il loro ID Play Giochi alle informazioni del giocatore corrispondenti nel tuo database interno. Assicurati di avere un pulsante con l'icona Play Giochi accanto a questi amici, che mostra il profilo dell'altro giocatore quando viene premuto, in modo che gli utenti possano sapere chi sono.
Se utilizzi l'elenco di amici da un server di backend, caricalo in modo sicuro utilizzando l'API REST invece di trasmettere il risultato dell'API Android. Assicurati
di utilizzare l'ID player restituito da
players.get(me)
nell'API REST per il player su cui è stato eseguito l'accesso, perché sarà coerente
con l'ID visualizzato dagli altri giocatori.
Se l'elenco di amici esteso non è archiviato (ma viene utilizzato al momento della visualizzazione), non è necessario eseguire altre operazioni.
Concedi l'accesso a Play Giochi
Se il tuo gioco non ha ancora accesso a Play Giochi, un buon momento per chiedere agli utenti il loro consenso è quando visualizzano il tuo elenco di amici in-game. Ad esempio, potresti aggiungere un pulsante denominato Importa amici di Play Giochi, che chiede all'utente il consenso quando toccato. Assicurati di utilizzare il logo Play Giochi su ogni pulsante che menziona il servizio.
Visualizzare il profilo di un altro giocatore
Puoi consentire al giocatore su cui hai eseguito l'accesso di visualizzare il profilo Play Giochi di un altro giocatore. Ciò consente al giocatore che ha eseguito l'accesso di vedere il nome che ha dato all'altro giocatore e se è già amico o meno, fornendogli ulteriore contesto sulla relazione. Se i giocatori non sono ancora amici, il giocatore che ha eseguito l'accesso vedrà i controlli per la gestione dell'amicizia nella visualizzazione del profilo. Quando si creano amicizie all'interno del gioco, i nomi predefiniti per i due giocatori sono i loro nomi in-game (se ne fornisci uno). Viene mostrato anche il nome del gioco in cui è nata l'amicizia.
Classifiche social
Le API Friends possono essere utilizzate anche per le classifiche. Usa questa funzione per mostrare il
ranking del giocatore corrente tra i suoi amici di Play Giochi. Tieni presente che questo vale soltanto per gli utenti che hanno scelto di condividere queste informazioni con la tua applicazione e se sono amici in Play Giochi. Per supportare questa funzionalità, il gioco offre all'utente un controllo. Questo controllo utilizza l'argomento collection per selezionare la visualizzazione social della classifica. Per ulteriori informazioni, consulta la sezione sulle classifiche pubbliche e social.
Se implementi la raccolta di classifiche social, la chiamata per caricare i punteggi delle classifiche potrebbe restituire un'eccezione di risoluzione richiesta per il consenso simile a quella di loadFriends().
Se implementi l'UI predefinita fornita da Play Giochi (ad esempio getLeaderboardIntent()), questa viene gestita automaticamente.
Passaggi successivi
Prima di iniziare a utilizzare le API Friends, procedi nel seguente modo:
- Scarica ed esamina un esempio di codice:
- Acquisisci familiarità con i consigli descritti nell'elenco di controllo della qualità.
- Implementa le API Friends in un client Java.