Amici

Utilizza le API Friends per integrare e migliorare il sistema di amici in-game esistente e altri sistemi social a cui il tuo gioco potrebbe accedere. In questo modo, i giocatori possono:

  • Trova i suoi amici nel tuo gioco.

  • Confrontare i punteggi con quelli dei loro amici nelle classifiche.

  • Combina l'elenco degli amici di Play Giochi con gli elenchi di amici esistenti nel gioco.

  • Identifica un altro giocatore con un popup del profilo in-game. Questo popup mostra un nickname che il giocatore attuale ha dato al suo amico, così sa con chi sta giocando.

Importare amici

Nozioni 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 amici. Se l'accesso viene concesso, puoi ottenere un elenco di oggetti Player corrispondenti agli amici del giocatore autenticato.
  • Avvia una visualizzazione del profilo Play Giochi di un altro giocatore: puoi aprire questa visualizzazione per mostrare il nome assegnato all'altro giocatore dal giocatore autenticato. Questa visualizzazione offre anche controlli di gestione dell'amicizia e non fa uscire il giocatore dal gioco.
  • Fornisci controlli utente: l'utente ha controlli per gestire la visibilità del proprio profilo Play Giochi per gli amici e la visibilità della propria lista di amici per i giochi. Per l'accesso all'elenco di amici, l'utente può scegliere di concedere automaticamente l'accesso per tutti i giochi o approvare individualmente 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 utilizzare le API Friends per ottenere un elenco degli amici Play Giochi dei tuoi giocatori e aggiungerli al tuo elenco di amici in-game.

I nuovi utenti avranno un elenco iniziale di amici con cui giocare, mentre gli utenti esistenti possono importare i loro amici di Play Giochi in qualsiasi elenco di amici in-game. Di conseguenza, i tuoi utenti avranno il più ampio insieme possibile di giocatori con cui giocare o contro cui competere.

Aggiungere amici di Play Giochi al tuo gioco

Aggiungi gli 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 di Play Giochi accanto a questi amici, che mostra il profilo dell'altro giocatore quando viene premuto, in modo che i tuoi utenti possano sapere chi sono gli amici.

Quando utilizzi l'elenco degli amici da un server di backend, caricalo in modo sicuro utilizzando l'API REST anziché passare il risultato dell'API Android. Assicurati di utilizzare l'ID giocatore restituito da players.get(me) nell'API REST per il giocatore attualmente autenticato, in quanto sarà coerente con l'ID visualizzato dagli altri giocatori.

Se l'elenco di amici aumentato non viene memorizzato (ma viene utilizzato solo al momento della visualizzazione), non sono necessarie ulteriori operazioni.

Concedere l'accesso a Play Giochi

Se il tuo gioco non ha già accesso a Play Giochi, un buon momento per chiedere agli utenti il consenso è quando visualizzano l'elenco degli amici nel gioco. Ad esempio, puoi aggiungere un pulsante chiamato Importa amici di Play Giochi, che chiede il consenso all'utente quando viene toccato. (Assicurati di utilizzare il logo di Play Giochi su qualsiasi pulsante che menziona il servizio.)

Visualizzare il profilo di un altro giocatore

Puoi consentire al tuo giocatore autenticato di visualizzare il profilo Play Giochi di un altro giocatore. In questo modo, il giocatore autenticato può vedere il nome che ha dato all'altro giocatore e se sono già amici, il che gli fornisce un contesto aggiuntivo sulla relazione. Se i giocatori non sono ancora amici, il giocatore autenticato vedrà i controlli di gestione dell'amicizia nella visualizzazione del profilo. Quando le amicizie vengono create all'interno del gioco, i nomi predefiniti dei due giocatori sono i loro nomi in-game (se forniti). Viene visualizzato anche il nome del gioco in cui è stata avviata l'amicizia.

Visualizzare il profilo di un altro giocatore

Classifiche social

Le API Friends possono essere utilizzate anche per le classifiche. Utilizza questa funzionalità per mostrare la classifica del giocatore attuale tra i suoi amici di Play Giochi. Tieni presente che questo vale solo per gli utenti che hanno scelto di condividere queste informazioni con la tua applicazione e se gli utenti sono amici in Play Giochi. Per supportare questa funzionalità, il gioco espone un controllo all'utente. Questo controllo utilizza l'argomento collection per selezionare la visualizzazione social della classifica. Per saperne di più, consulta la sezione sulle classifiche pubbliche e social.

Se implementi la raccolta delle classifiche social, la chiamata per caricare i punteggi della classifica potrebbe restituire un'eccezione di risoluzione che richiede il consenso simile a quella di loadFriends(). Se implementi la UI predefinita fornita da Play Giochi (ad esempio, getLeaderboardIntent()), questa operazione viene gestita automaticamente.

Passaggi successivi

Prima di iniziare a utilizzare le API Friends, segui questi passaggi: