好友

使用 Friends API 補充及強化現有的遊戲內好友系統 和遊戲可能存取的其他社交系統這樣玩家就可以:

  • 在遊戲中尋找好友。

  • 在排行榜上與好友比較分數。

  • 結合 Play 遊戲好友名單與現有的遊戲內名單

  • 使用遊戲內的個人資料彈出式視窗辨識其他玩家。這個彈出式視窗顯示 目前玩家為好友指定的暱稱,因此他們知道 之間的相關動作

匯入好友

基本資訊

這些 API 可讓您執行下列操作:

  • 載入好友:您可以查看玩家是否允許遊戲存取 好友名單資訊。授予存取權後,就能取得玩家清單 對應到登入玩家好友的對應物件。
  • 啟動其他玩家的 Play 遊戲個人資料檢視畫面:您可以開啟 這個檢視畫面會顯示登入後其他玩家的名字。 廣告。這個檢視畫面也提供好友管理控制選項,且不會
  • 提供使用者控制項:使用者可控管自己的 好友可以看到 Play 遊戲個人資料,以及好友名單的顯示設定 遊戲並不會公開。如需存取好友名單,使用者可以選擇 自動授予所有遊戲的存取權,或者個別玩家可以選擇 才能核准每款遊戲。因此載入好友名單時 結果可能是用來顯示存取要求的回呼。

匯入 Play 遊戲好友名單

您可以使用 Friends API 取得玩家的 Play 遊戲清單 將對方加入遊戲好友名單中。

新使用者將取得開始玩遊戲的好友清單,以及現有使用者 可以將自己的 Play 遊戲好友匯入任何遊戲內的好友名單。 因此,您的使用者將擁有最大的玩家組合。 或互相競爭

在遊戲中加入 Play 遊戲服務好友

將 Play 遊戲好友加入任何現有的遊戲內好友名單,做法如下: 將遊戲 ID 與對應玩家資訊建立關聯 建立內部資料庫確認開發人員有 Play 遊戲按鈕 圖示。點選這些好友時,系統會顯示其他玩家的個人資料, 方便使用者知道好友是誰

從後端伺服器使用好友名單時,請以安全的方式載入 使用 REST API,而不要傳遞 Android API 的結果。請確認 要使用 REST API 中 players.get(me) 傳回的玩家 ID,以便為 目前登入的播放器,因為這個 ID 會與其他其他使用者看到的 ID 一致 廣告。

如果沒有儲存擴增好友名單 (而只是在 所以不需要進行其他作業

授予 Play 遊戲存取權

如果您的遊戲沒有 Play 遊戲存取權,建議您 會在使用者檢視遊戲內的好友名單時,提示他們徵得同意。適用對象 舉例來說,您可以新增「匯入 Play 遊戲好友」按鈕, 會在使用者輕觸時提示使用者表示同意。(請務必使用 Play 遊戲標誌 (用於提及服務的任何按鈕)。

檢視其他玩家的個人資料

你可以允許已登入的玩家觀看其他玩家的 Play 遊戲個人資料。讓已登入的玩家能查看他們的姓名 曾給予其他玩家,以及他們是否已經是好友 並加上背景資訊如果玩家還不是好友 已登入的玩家會在設定檔中看到好友管理控制選項 檢視畫面。在遊戲中建立好友關係後, 這兩名玩家就是他們在遊戲內的名稱 (如果有的話)。清單的名稱 也會顯示建立好友關係的遊戲。

檢視其他玩家的個人資料

社交排行榜

Friends API 也可用於排行榜。使用此功能可以顯示 目前玩家在 Play 遊戲好友中的排名。請注意, 這只適用於選擇與 以及玩家是否為 Play 遊戲的好友為了支持這項功能 功能,遊戲就會向使用者顯示控制選項。這個控制項會使用 collection 引數,用於選取排行榜的社交檢視畫面。學習 詳情請參閱 公開和社交排行榜

排行榜中的好友

如果要實作社交排行榜集合,呼叫載入 排行榜分數可能會傳回需要同意的解決例外狀況,例如: 來自 loadFriends()。 如果您要實作的是預設 Play 遊戲提供的 UI (例如 getLeaderboardIntent()), 系統會自動處理這個問題

後續步驟

開始使用 Friends API 前,請先完成下列步驟: