排行榜

排行榜可以激發玩家彼此競爭的樂趣, 您最硬的粉絲 (他們將爭奪公開排行榜冠軍) 排行榜),也喜歡同樣喜歡 或是相互比較)

如要瞭解如何在平台中加入排行榜, 請參閱「用戶端實作」。

瞭解排行榜

建立排行榜後,Google Play 遊戲服務會負責控管 您需要特別留意這個排行榜以下是典型的運作流程:

  1. 遊戲結束時 (或是在您決定的適當時機) 遊戲會將玩家的分數提交至您建立的一或多個排行榜 遊戲廣告。
  2. Google Play 遊戲服務會檢查這個得分是否高於玩家目前的得分 每日、每週或歷來得分的排行榜項目。如果是的話, Google Play 遊戲服務會使用新的分數更新對應的排行榜。
  3. Google Play 遊戲服務會將分數報告傳回遊戲用戶端。這份報表 告知用戶端此是否為新的每日、每週或歷來最高分。 如果不是,Google Play 遊戲服務就會向客戶告知現在的每日、 或歷來最高分。
  4. 如要擷取玩家的排行榜結果,可以要求時間 影格 (每日、每週或不限時間),並指定使用者需要的 社交或公開排行榜。遊戲服務會負責 然後將結果傳回用戶端。
  5. 如果需要回報的分數很多,遊戲服務會傳送 只能傳回頂端排行榜分數的資料。您也可以擷取原始的 或是與該玩家相關的分數。

多個排行榜

您可以為遊戲設置多個排行榜,上限是 70 個。適用對象 舉例來說,多等級遊戲可以提供不同的排行榜 而賽車遊戲可以為每個關卡分別建立排行榜 軌道。

排行榜時限

Play 遊戲 SDK 會自動建立每日、每週和歷來版本 建立排行榜您不必再另外建立個別的 排行榜。

每日排行榜會在 UTC-7 的時間重設 (也就是「午夜日光節約時間」) 一整年都很長

每週排行榜則會在同一個星期六和星期日的午夜重設, 設為每日排行榜 (UTC-7) 的時區。

公開排行榜和社交排行榜

Play 遊戲 SDK 會向玩家顯示兩個排行榜版本, 播放器:

社交排行榜的上榜對象為使用者社交圈中的成員 社交圈 (更正確地說,是使用者選擇的社交圈成員 分享給你的應用程式) 而且決定分享自己的遊戲活動 以便傳達給使用者

公開排行榜的上榜對象為已選擇遊戲的玩家 即可公開分享自己的遊戲活動。如果您的玩家未選擇 公開分享遊戲活動就不會出現在這個排行榜中。

顯示排行榜

在行動用戶端程式庫中,程式庫會處理所有格式 排行榜和排行榜。您可以指定玩家能否看到 或是查看您所有的排行榜

您也可以實作自己的排行榜 就能直接存取這些資料。

屬性

如要建立及管理排行榜,建議您先熟悉下列方法: 排行榜屬性:

基本概念

以下是與排行榜相關的基本元素:

  • 「ID」是指 Google Play 管理中心將 。您可以用此專屬 ID 在 遊戲用戶端。
  • 名稱:排行榜的簡短名稱 (例如:「高分記錄」或 「第 3 級」)。字元上限為 100 個字元。
  • 圖示是與排行榜相關聯的方形圖示 排行榜。如需建立排行榜圖示的最佳做法,請參閱 下文的圖示規範
  • 顯示順序:排行榜的顯示順序 玩家查看與遊戲相關的排行榜時。
  • 限制是選用值,定義 上下限,這可以幫助您捨棄分數 明顯不實的提交內容您也可以使用 按下 Players.hide 可隱藏玩家 認為提交了

排序

排行榜可採用以下其中一種排列順序:

  • 「高分為贏」為預設排行榜。這是 大部分的遊戲一般都會採用這一種排行榜。
  • 如果出現「低度級別」排行榜, 分數越小越好最常見的例子 排行榜中的排名是競速遊戲,分數代表 賽跑結束的時間。

分數格式

提交到排行榜的分數時, 遊戲服務可以透過多種不同的 格式:

  • 數字排行榜會以數字表示分數。數字可以顯示為 或具有固定小數位數的實數。您提交的資訊 並將分數插入指定的 或 HTTP/HTTPS 位置例如 314159 的分數會顯示為 3.14159 3141.59314159 (視您指定的小數位置而定)。

  • 時間排行榜是以時 / 分 / 秒 / 毫秒為單位顯示分數 則是使用第二種格式您提交的分數必須以毫秒為單位,因此 66032 會是 解讀為 1:06.03

  • 貨幣排行榜會以貨幣格式顯示分數。您提交的資訊 分數為主要貨幣單位的 1/1,000,000。例如,如果分數為 19,950,000 會被解讀為 $19.95 (假設您指定 貨幣單位。

數字排行榜也支援自訂單位。舉例來說,如果遊戲 是公尺,因此您可以指定「公尺」做為 排行榜。

翻譯與分數格式

如果行動用戶端程式庫向「遊戲」服務要求排行榜資料, 便會指定要以何種語言和語言代碼顯示分數。REST API 可讓您指定語言代碼 語言遊戲服務會傳回格式化排行榜分數 以及適用的語言格式化分數會顯示在 您是否新增了 翻譯

數字排行榜顯示的數字格式會改變。 語言。(例如:在美國顯示為 12,345.78,而在法國則顯示為 12 345,78。)如果 您使用的是自訂廣告單元,且已將 翻譯 ,您必須為遊戲提供每種語言版本的翻譯單位 已新增。遊戲服務會依照情況顯示這些單位的翻譯。

視您選擇的語言而定,您可能需要提供不同語言 也可以輸入相應的單位名稱以英文來說,您需要提供 項目,另一個則用於所有其他值 (例如「meter」和「meters」)。於 另一方面,提交波蘭文時,則需要提供單件式、 少數單位、許多單位和所有其他單位如要進一步瞭解複數規則 請參閱「數量 字串(複數)

時間排行榜會根據 設定播放器的語言。如果您使用 的值或大於 3 位數的小時值 (例如 例如:在美國顯示為 4,815:16:23.42,在德國則顯示為 4.815:16:23,42)。

如果是「貨幣」排行榜,系統會根據 調整玩家使用的語言和語言代碼不過,您無法變更 貨幣。舉例來說,如果指定貨幣為美元,遊戲就會採用 在美國顯示 $19.95,在法國顯示 19,95 $。但無法指定 您的遊戲在美國顯示美元,在法國顯示歐元。

圖示規範

請使用 512 x 512 PNG 或 JPEG 格式的圖示檔案。您的圖示將採用下列格式: 大多數遊戲用戶端都會縮減資源大小,因此請避免同時建立圖示 都細部工作提交圖示時,您可以使用 Alpha 通道和 透明度將維持不變。排行榜圖示會顯示在 在 Android 裝置中,顏色較深的灰色背景,因此請挑選成效良好的圖示 在此情況下。

所有語言代碼都會使用相同的圖示,因此建議不要加入任何語言代碼 在圖示中包含任何文字或本地化內容。

建立排行榜

本節將說明如何為新遊戲或現有遊戲建立排行榜。

建立新遊戲的排行榜

如要在尚未發布的新遊戲中建立排行榜,請前往 您遊戲的 Google Play 管理中心項目,然後依序前往「拓展」>「拓展」Play 遊戲 服務 >設定與管理 >排行榜,然後按一下 「建立排行榜」按鈕。

在《Add Leaderboard》(新增排行榜)主要排行榜面板上的按鈕

然後只要填寫這個排行榜所需的資訊即可。

已填妥的「最佳回合」表單排行榜。

按一下「Save as draft」(儲存為草稿),排行榜就會顯示在「草稿」中 state.遊戲發布後,系統就會發布遊戲的所有排行榜 。

建立已發布遊戲的排行榜

如要為已發布的遊戲建立其他排行榜, 請按照上述相同步驟操作進一步瞭解如何測試 測試遊戲更新版,請參閱:發布遊戲變更

排行榜測試完成感到滿意之後,即可重新發布排行榜 重新發布加入新排行榜的遊戲,讓遊戲正式問世。

編輯排行榜

如要編輯已建立的排行榜,請按一下 Google Play 管理中心的「排行榜」分頁。此時,您會看到 與首次建立排行榜時使用的格式相同,然後您可以 視需要編輯任何欄位

編輯完成後,請按一下「Save as draft」(儲存為草稿) 按鈕。 新編輯的排行榜 會處於「草稿」狀態方便您進行測試 。

如果排行榜正常運作,請在排行榜表單頂端的方塊中選取「發布變更」,這樣您就能重新發布遊戲,並公開排行榜的所有更新內容。

復原編輯內容

如果您不滿意新編輯的排行榜,想要恢復 只要在頁面頂端的方塊中選取「還原」即可 顯示排行榜表單您的排行榜就會還原至已發布的版本 版本。

刪除排行榜

您可以刪除「草稿」中的排行榜或已轉換成 已發布如要在 Google Play 管理中心刪除排行榜,請前往 ,然後按一下表單頂端的「Delete leaderboard」(刪除排行榜)

或者,您也可以呼叫 按下 Players.hide 可隱藏玩家的 排行榜。

重設排行榜

只有草稿排行榜才能重設玩家進度資料。

  • 如要在 Google Play 管理中心重設排行榜,請點選右上角的「重設進度」 優先顯示該活動。
  • 如要透過程式輔助方式重設排行榜資料,請呼叫 Management API Scores 方法

新增排行榜翻譯

您可以指定與排行榜相關聯的排行榜翻譯 您的遊戲。在開始之前,請務必先完成 新增翻譯 遊戲。 另外也必須為遊戲建立一或多個排行榜。

如要加入排行榜翻譯,請在「排行榜」分頁開啟 然後選取現有的排行榜。每月中的特定幾天 排行榜詳細資料頁面,按一下先前使用的語言分頁 在該語言的排行榜詳細資料頁面 編輯該排行榜表單並加入翻譯。按一下 「儲存」儲存已翻譯的排行榜詳細資料。

隱藏排行榜分數

Google Play 遊戲服務提供排行榜防竄改功能, 檢查是否有疑似竄改的分數,並自動加以隱藏。這項功能 僅適用於 Android 遊戲。

新排行榜預設會啟用防竄改功能, 您為 Android 遊戲建立,但現有的排行榜設為停用。 為現有的排行榜啟用防竄改功能 ,請按照下列步驟操作:

  1. 在 Google Play 管理中心開啟「遊戲服務」分頁,然後選取 選擇清單中的遊戲
  2. 開啟「排行榜」分頁,然後選取要啟用防竄改功能的排行榜例項。
  3. 將「Enable leaderboard tamper protection」(啟用排行榜防竄改功能) 選項設為「ON」(開)。
  4. 按一下「儲存」並繼續。
  5. 發布遊戲。

在 Google Play 管理中心啟用排行榜的防竄改功能後, 最多可能需要 24 小時才會生效。已提交的分數 防竄改功能不會溯及既往。

在某些情況下,建議您停用防竄改功能 (例如 您的遊戲也會在 Android 網站上執行,並且與其他人分享 排行榜)。

用戶端實作

如要瞭解如何實作平台中的排行榜,請參閱以下資源 資源: