Amici nei giochi Unity

Amici di Play Giochi consente ai giocatori di creare e gestire un elenco di amici tra i vari giochi. Puoi richiedere l'accesso a questo elenco di amici per aiutare i tuoi giocatori a giocare al tuo gioco con i loro amici. Per ulteriori dettagli sul sistema degli amici, consulta la pagina concettuale Amici.

Prima di iniziare

Consulta le linee guida sulle best practice per istruzioni sul modo migliore per implementare queste API.

Attiva amici

Per attivare gli amici, utilizza le seguenti funzioni:

  • Visualizza amici: Richiedi l'accesso all'elenco di amici di un giocatore, in modo da poter aggiungere i suoi amici di Play Giochi al tuo elenco di amici in-game.

  • Visualizzare il profilo di un giocatore: Consente a un giocatore di visualizzare il profilo Play Giochi di un altro giocatore. È essenziale per consentire a un giocatore di sapere chi sono i suoi amici e di connettersi con altri giocatori di Play Giochi nel tuo gioco. Questo deve essere collegato a un elemento dell'interfaccia utente per attivare il popup. Per maggiori dettagli, consulta le linee guida per gli amici.

Visualizzare gli amici

Esistono due modi per caricare gli amici: utilizzando il framework ISocial o direttamente con PlayGamesPlatform.

Caricare gli amici con il framework ISocial

Social.localUser.LoadFriends((success) =>  {
    Debug.Log("Friends loaded OK: " + ok));
    foreach(IUserProfile p in Social.localUser.friends) {
         Debug.Log(p.userName + " is a friend");
    }

Tuttavia, questa chiamata non andrà a buon fine se il giocatore attuale non ha ancora concesso l'autorizzazione al gioco per accedere a queste informazioni. Utilizza GetLastLoadFriendsStatus per verificare se LoadFriends non è riuscito a causa della mancata approvazione.

 PlayGamesPlatform.Instance.GetLastLoadFriendsStatus((status) => {
    // Check for consent
    if (status == LoadFriendsStatus.ResolutionRequired) {
        // Ask for resolution.
    }
});

Un gioco può chiedere al giocatore attuale di condividere l'elenco di amici chiamando AskForLoadFriendsResolution.

PlayGamesPlatform.Instance.AskForLoadFriendsResolution((result) => {
    if (result == UIStatus.Valid) {
        // User agreed to share friends with the game. Reload friends.
    } else {
        // User doesn’t agree to share the friends list.
    }
});

Questa funzione mostrerà l'interfaccia utente di condivisione con gli amici specifica della piattaforma. Questa UI chiede al giocatore se vuole condividere i suoi amici con il gioco.

Caricare gli amici con PlayGamesPlatform

Un altro modo per caricare gli amici è utilizzare LoadFriends e LoadMoreFriends:

PlayGamesPlatform.Instance.LoadFriends(pageSize, forceReload, (status) => {
    // Check if the call is successful and if there are more friends to load.
});

PlayGamesPlatform.Instance.LoadMoreFriends(pageSize, (status) => {
    // Check if there are more friends to load.
});

Il parametro pageSize rappresenta il numero di voci da richiedere per questa pagina. Tieni presente che se esistono già dati memorizzati nella cache, il buffer restituito potrebbe contenere più dati di questa dimensione. È garantito che il buffer contenga almeno questo numero di voci se la raccolta contiene un numero sufficiente di record. Se forceReload è impostato su true, questa chiamata cancellerà tutti i dati memorizzati nella cache locale e tenterà di recuperare i dati più recenti dal server. Questo viene comunemente utilizzato per azioni come l'aggiornamento avviato da un utente. Normalmente, questo valore deve essere impostato su false per sfruttare i vantaggi della memorizzazione nella cache dei dati.

Se il callback restituisce LoadFriendsStatus.LoadMore, ci sono altri amici da caricare. LoadFriendsStatus.ResolutionRequired indica che l'utente non ha condiviso l'elenco degli amici e puoi chiamare direttamente PlayGamesPlatform.Instance.AskForLoadFriendsResolution.

Determinare la visibilità dell'elenco di amici

Utilizza PlayGamesPlatform.Instance.GetFriendsListVisibility per verificare se l'utente ha condiviso l'elenco di amici con il gioco. I possibili stati del reso sono:

  • FriendsListVisibilityStatus.RequestRequired indica che devi chiedere il consenso.

  • FriendsListVisibilityStatus.Visible indica che il caricamento dell'elenco di amici dovrebbe riuscire.

  • FriendsListVisibilityStatus.Unknown in genere non dovrebbe accadere. Puoi impostare forceReload su true per aggiornare i dati.

PlayGamesPlatform.Instance.GetFriendsListVisibility(forceReload, (friendsListVisibilityStatus) => {});

Visualizzare il profilo di un giocatore

Per aggiungere o rimuovere un giocatore come amico, utilizza la funzione di visualizzazione e confronto del profilo. Questa funzione attiva una finestra di dialogo del foglio inferiore che mostra il profilo Play Giochi dell'utente. Chiama la funzione con l'ID giocatore del giocatore richiesto. Se il giocatore e l'amico hanno nickname in-game, utilizzali nella chiamata per aggiungere più contesto all'interfaccia utente del profilo:

PlayGamesPlatform.Instance.ShowCompareProfileWithAlternativeNameHintsUI(
    mFirstFriendId, /* otherPlayerInGameName= */ null, /* currentPlayerInGameName= */ null,
    (result) => {
        // Profile comparison view has closed.
});