Amici

Usa le API Friends per integrare e migliorare il tuo sistema di amici in-game esistente e altri sistemi social a cui il tuo gioco potrebbe accedere. In questo modo puoi consentire ai giocatori di:

  • Trova i loro amici nel gioco.

  • Confrontare i punteggi con i loro amici nelle classifiche.

  • Combina l'elenco dei suoi amici di Play Giochi con gli elenchi in-game esistenti di amici.

  • Identifica un altro giocatore con un popup del profilo in-game. Questo popup mostra il nickname che l'attuale giocatore ha dato all'amico, in modo che sappia chi con cui stanno giocando.

Importa amici

Nozioni di base

Queste API ti consentono di eseguire le seguenti azioni:

  • Carica amici: puoi verificare se il giocatore ha consentito l'accesso al gioco. Informazioni elenco di amici. Se viene concesso l'accesso, puoi ottenere un elenco di oggetti corrispondenti agli amici del giocatore che ha eseguito l'accesso.
  • Avvia una visualizzazione del profilo Play Giochi di un altro giocatore: puoi aprire in questa visualizzazione per mostrare il nome assegnato all'altro giocatore dopo che ha eseguito l'accesso un player. Questa visualizzazione offre anche controlli per la gestione dell'amicizia e non il giocatore per uscire dal gioco.
  • Fornire controlli agli utenti: l'utente ha i controlli per gestire il modo in cui la propria Il profilo Play Giochi è visibile agli amici e in che modo viene visualizzato il loro elenco di amici visibile ai giochi. Per accedere all'elenco di amici, l'utente può scegliere di: concedere automaticamente l'accesso a tutti i giochi o scegliere di farlo singolarmente approvare l'accesso per ogni gioco. Di conseguenza, quando carichi l'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 ricevere un elenco dei Play Giochi dei tuoi giocatori amici e aggiungerli al tuo elenco di amici nel gioco.

I nuovi utenti avranno un elenco iniziale di amici con cui giocare e 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 maggior numero possibile di giocatori con cui giocare o competere con loro.

Aggiungi amici di Play Giochi al tuo gioco

Aggiungi amici di Play Giochi a qualsiasi elenco di amici in-game esistente associando il suo ID Play Giochi alle informazioni del giocatore corrispondenti in del tuo database interno. Assicurati di avere un pulsante con 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 gli amici.

Quando usi l'elenco di amici da un server di backend, caricalo in modo sicuro usando l'API REST anziché passare il risultato dell'API Android. Assicurati che utilizzare l'ID player restituito da players.get(me) nell'API REST per che ha eseguito l'accesso, in quanto sarà coerente con l'ID visto da altri giocatori.

Se l'elenco di amici ampliato non è memorizzato (ma viene utilizzato solo quando visualizzazione), non occorre eseguire altre operazioni.

Concedere l'accesso a Play Giochi

Se il tuo gioco non dispone ancora dell'accesso a Play Giochi, è il momento giusto per la richiesta di consenso agli utenti si verifica quando visualizzano il tuo elenco di amici in-game. Per Ad esempio, potresti aggiungere un pulsante chiamato Importa amici di Play Giochi, che richiede il consenso all'utente quando lo tocca. (Assicurati di utilizzare Logo di Play Giochi su qualsiasi pulsante che menziona il servizio.

Visualizza il profilo di un altro giocatore

Puoi consentire al player su cui hai eseguito l'accesso di visualizzare profilo Play Giochi. In questo modo il giocatore che ha eseguito l'accesso può vedere il suo nome dato all'altro giocatore e se è già amico o meno, offrendo hanno aggiunto contesto sulla relazione. Se i giocatori non sono ancora amici, il giocatore che ha eseguito l'accesso vedrà i controlli di gestione dell'amicizia nel profilo vista. Quando vengono create amicizie all'interno del gioco, vengono usati i nomi predefiniti i due giocatori sono i loro nomi in-game (se ne fornisci uno). Il nome del viene mostrato anche il gioco in cui è stata avviata l'amicizia.

Visualizza il profilo di un altro giocatore

Classifiche social

Le API Friends possono essere utilizzate anche per le classifiche. Utilizza questa funzione per mostrare classifica del giocatore corrente tra i suoi amici di Play Giochi. Tieni presente che Ciò vale solo per gli utenti che hanno scelto di condividere queste informazioni con il tuo e se gli utenti sono amici in Play Giochi. Per supportare tutto questo il gioco espone un controllo all'utente. Questo controllo utilizza Argomento collection per selezionare la visualizzazione social della classifica. Per apprendere consulta la sezione dedicata classifiche pubbliche e social.

Amici in una classifica

Se implementi la raccolta delle classifiche social, la chiamata per caricare i punteggi della classifica potrebbero restituire un'eccezione di risoluzione richiesta per il consenso simile a: che da loadFriends() Se implementi l'interfaccia utente predefinita fornita da Play Giochi (ad esempio, getLeaderboardIntent()), questo viene gestito automaticamente.

Passaggi successivi

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