Amici

Utilizza le API Friends per integrare e migliorare il tuo sistema di amicizia 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 tuo gioco.

  • Confrontare i punteggi con gli amici nelle classifiche.

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

  • Identifica un altro giocatore tramite un popup in-game relativo al profilo. Questo popup mostra un soprannome che il giocatore attuale ha assegnato al proprio amico, in modo che possa sapere con chi sta giocando.

Importa amici

Nozioni di base

Queste API consentono di eseguire le azioni seguenti:

  • Carica amici: puoi controllare se il giocatore ha consentito al gioco di accedere alle informazioni dell'elenco di amici. Se l'accesso viene concesso, puoi ottenere un elenco di oggetti Player corrispondenti 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 visualizzazione offre anche i controlli di gestione dell'amicizia e non fa uscire il giocatore dal tuo gioco.
  • Fornire i controlli utente: l'utente ha controlli per gestire il modo in cui il suo profilo Play Giochi è visibile agli amici e come 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 individualmente 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.

Importa 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 avranno un elenco iniziale di amici con cui giocare e gli utenti esistenti possono importare i propri amici di Play Giochi in qualsiasi elenco di amici in-game. Di conseguenza, gli utenti disporranno del 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 di Play Giochi alle informazioni sui giocatori 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 gli amici.

Quando usi l'elenco di amici da un server di backend, caricalo in modo sicuro usando l'API REST, anziché trasmettere il risultato dell'API Android. Assicurati di utilizzare l'ID player restituito da players.get(me) nell'API REST per il player a cui hai eseguito l'accesso, perché sarà coerente con l'ID mostrato dagli altri giocatori.

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

Concedi l'accesso a Play Giochi

Se il tuo gioco non ha ancora accesso a Play Giochi, è il momento di chiedere agli utenti il loro consenso quando vedono il tuo elenco di amici in-game. Ad esempio, potresti aggiungere un pulsante Importa amici Play Giochi, che richiede il consenso dell'utente quando viene toccato. Assicurati di utilizzare il logo Play Giochi su qualsiasi pulsante che menziona il servizio.

Visualizza il profilo di un altro giocatore

Puoi consentire al giocatore che ha eseguito l'accesso di visualizzare il profilo Play Giochi di un altro giocatore. In questo modo, il giocatore che ha eseguito l'accesso può vedere il nome che ha dato all'altro giocatore e se è già amico o meno, fornendogli un contesto aggiuntivo sulla relazione. Se i giocatori non sono ancora amici, il giocatore che ha eseguito l'accesso vedrà i controlli di gestione dell'amicizia nella visualizzazione profilo. Quando vengono create amicizie all'interno del gioco, i nomi predefiniti dei due giocatori sono i nomi in-game (se ne fornisci uno). Viene mostrato anche il nome del 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. Usa questa funzionalità per far vedere il ranking del giocatore attuale 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 espone un controllo all'utente. Questo controllo utilizza l'argomento collection per selezionare la visualizzazione social della classifica. Per ulteriori informazioni, consulta la sezione sulle classi pubbliche e social.

Amici in una classifica

Se implementi la raccolta delle classifiche social, la chiamata per caricare i punteggi della classifica può restituire un'eccezione per la risoluzione che richiede 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: