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, puoi consentire ai giocatori di:

  • Trovare i loro amici nel tuo gioco.

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

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

  • Identificare un altro giocatore con un popup del profilo in-game. Questo popup mostra un nickname che il giocatore corrente ha assegnato al suo amico, in modo che sappia 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 di amici. Se l'accesso viene concesso, puoi ottenere un elenco di oggetti Player corrispondente agli amici del giocatore che ha eseguito l'accesso.
  • Apri 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 controlli per la gestione delle amicizie e non fa uscire il giocatore dal gioco.
  • Fornire controlli per gli utenti: l'utente ha controlli per gestire la visibilità del suo profilo di Google Play per gli amici e la visibilità del suo elenco di amici per i 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 utilizzare 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, mentre gli utenti esistenti possono importare i propri amici di Play Giochi in qualsiasi elenco di amici in-game. Di conseguenza, i tuoi utenti avranno a disposizione il maggior numero possibile di giocatori con cui giocare o contro cui competere.

Aggiungere gli 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 mostri il profilo dell'altro giocatore quando viene premuto, in modo che gli utenti possano sapere chi sono.

Quando utilizzi l'elenco di 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 che ha eseguito l'accesso in quel momento, in quanto sarà coerente con l'ID visualizzato da altri giocatori.

Se l'elenco di amici aumentato non viene memorizzato (ma viene utilizzato solo al momento della visualizzazione), non è necessario alcun intervento aggiuntivo.

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 consenso è quando visualizzano il tuo elenco di amici in-game. Ad esempio, potresti aggiungere un pulsante denominato Importa amici di Google Play, che chiede all'utente il consenso quando viene toccato. Assicurati di utilizzare il logo di Play Giochi su tutti i pulsanti che menzionano il servizio.

Visualizzare il profilo di un altro giocatore

Puoi consentire al tuo profilo giocatore che ha eseguito l'accesso di visualizzare il profilo di un altro profilo Google Play. In questo modo, il giocatore che ha eseguito l'accesso può vedere il nome assegnato all'altro giocatore e sapere se sono già amici, ottenendo un contesto aggiuntivo sulla relazione. Se i giocatori non sono ancora amici, quello che ha eseguito l'accesso vedrà i controlli per la gestione delle amicizie nella visualizzazione del profilo. Quando le amicizie vengono create all'interno del gioco, i nomi predefiniti per i due giocatori sono i loro nomi in-game (se forniti). Viene mostrato anche il nome del gioco in cui è stata avviata l'amicizia.

Visualizzare il profilo di un altro giocatore

Classifiche social

Le API Amici possono essere utilizzate anche per le classifiche. Utilizza questa funzionalità per mostrare il ranking del giocatore corrente 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 sono amici in Play Giochi. Per supportare questa funzionalità, il gioco mostra un controllo all'utente. Questo controllo utilizza l'argomento collection per selezionare la visualizzazione social della classifica. Per scoprire di più, consulta la sezione sulle classifiche pubbliche e social.

Se implementi la raccolta dei leaderboard social, la chiamata per caricare i risultati del leaderboard potrebbe restituire un'eccezione di risoluzione che richiede il consenso simile a quella di loadFriends(). Se implementi l'interfaccia utente predefinita fornita da Play Giochi (ad esempio getLeaderboardIntent()), la gestione viene eseguita automaticamente.

Passaggi successivi

Prima di iniziare a utilizzare le API Amici: