整合成就

本文說明如何使用 Google Play 管理中心或 API 呼叫，將成就整合至遊戲。內容涵蓋成就的重要元素和狀態，並說明如何建立、匯入及管理成就。

事前準備

建立或匯入新成就

如要從頭開始實作成就，請按照下列步驟操作：

新增成就

新手透過 Google Play 管理中心建立成就的方式有兩種：

  • 建立成就：一次新增一項成就的定義和中繼資料。
  • 匯入成就：一次匯入多項成就的定義和其他中繼資料。

建立成就

如要在尚未發布的新遊戲中建立成就，請完成下列步驟：

  1. 在 Google Play 管理中心選取遊戲。
  2. 在「Play 遊戲服務 - 成就」頁面 (依序點選「拓展」>「Play 遊戲服務」>「設定與管理」>「成就」)，選取「建立成就」。
  3. 填寫「新增成就」頁面的表單。
  4. 按一下「儲存為草稿」。
  5. 建立成就後，請發布成就。
匯入成就

如要一次新增多項遊戲成就，請按照下列步驟操作：

  1. 將成就包入 ZIP 檔案。
  2. 上傳檔案。

如要進一步瞭解 ZIP 檔案，請參閱 ZIP 檔案指南。

如何匯入成就：

  1. 在 Google Play 管理中心選取遊戲。
  2. 在「Play 遊戲服務 - 成就」頁面 (依序點選「拓展」>「Play 遊戲服務」>「設定與管理」>「成就」)，選取「匯入成就」。
  3. 按一下「匯入成就」頁面的「上傳」。
  4. 選取要上傳的 ZIP 檔案。
  5. 按一下「儲存為草稿」。
  6. 匯入成就後，請發布遊戲。

ZIP 檔案指南

您可以透過 ZIP 檔案一次匯入多項成就。請參閱下表，瞭解適合在 ZIP 檔案中使用的確切檔案名稱：

檔案名稱 必要或選用 接受的值
AchievementsMetadata.csv 必要 每項成就的中繼資料。 請參閱「屬性」。
AchievementsLocalizations.csv 選填 用於提供成就名稱和說明的翻譯。
AchievementsIconMappings.csv 選填 用於將成就對應至圖示檔案。
圖示檔案 選填 PNG、JPEG 或 JPG 格式的圖示。

ZIP 檔案相關規定：

  • 不得含有子目錄。
  • 檔案名稱不得重複。
  • 僅限 CSV、PNG、JPEG 或 JPG 檔案。
  • CSV 檔案不得包含標題列。
  • 每個檔案的大小不得超過 1 MB。
  • ZIP 檔案最多只能包含 203 個檔案。
  • ZIP 檔案共計必須小於 200 MB。
AchievementsMetadata.csv 格式

AchievementsMetadata.csv 檔案包含每項成就的中繼資料，這些資料應以逗號分隔值呈現，並按照以下順序排列：

    Name,Description,Incremental value,Steps Needed,Initial State,Points,List Order

下表提供這些欄位的說明：

CSV 欄標題 必要或選用 接受的值
名稱 必要 最多 100 個字元
說明 選填 最多 500 個字元
價值增幅 選填 True 或 False
Steps Needed 如果 Incremental Value 為 True.，則為必要欄位 數字 (不含分數或小數)
初始狀態 必要 Hidden 或 Revealed
點數 必要 5 的倍數，且值介於 5 到 200 之間
清單順序 選填 數字 (不含分數或小數，且大於零)

AchievementsMetadata.csv 檔案相關規定：

  • 每列都必須有七個值。如要省略某個值，請留空。
  • Name 和 Description 欄位會做為預設語言。
  • 所有成就的「名稱」Name欄位皆不得重複。
  • 下列欄位不應包含半形逗號：Name 和 Description。

AchievementsMetadata.csv 範例檔案：

  Achievement1,Achievement One,True,100,Hidden,5,20
  Achievement2,Achievement Two,False,,Revealed,10,30
AchievementsLocalizations.csv 格式

AchievementsLocalizations.csv 是選用檔案，可設定所有必要資料，向不同語言的使用者說明各項成就。成就會根據遊戲指定的語言進行翻譯。

這些資料應以逗號分隔值呈現，並按照以下順序排列：

   Name, Localized name, Localized description, locale

下表提供這些欄位的說明：

CSV 欄標題 必要或選用 Description 接受的值
名稱 必要 必須與 AchievementsMetadata.csv 中的 Name 欄相符。 最多 100 個字元
翻譯名稱 必要 成就的本地化名稱。 最多 100 個字元
本地化說明 選填 指定語言的成就本地化說明。 最多 500 個字元
語言代碼 必要 語言代碼，例如 en-US。 請先 新增遊戲翻譯，再指定語言。請注意，您無法指定預設語言。

如要查看支援的語言代碼，請參閱 支援的語言清單。

AchievementsLocalizations.csv 檔案規定：

  • 遊戲成就名稱不得重複，但僅限於同一個語言。

    舉例來說，如果遊戲提供英文 (美國) 和法文 (法國) 兩種版本，則「Achievement1」成就可以同時用於英文 (美國) 和法文 (法國) 版本。

  • 每列都應包含四個值。如要省略 Localized description 值，請留空。

AchievementsLocalizations.csv 範例檔案：

Achievement1,Achievement One,This is the description of achievement one in English.,en-US
Achievement1,Achievement Un,Voici la description de l'achievement un en français.,fr-FR
Achievement2,Achievement Two,Description of achievement two.,en-US
Achievement2,Logro Dos,Descripción del logro dos.,es-ES
Achievement3,Achievement Three,,en-US
Achievement3,Erfolg Drei,,de-DE
AchievementsIconMappings.csv 格式

AchievementsIconMappings.csv 是選用檔案，可用來將成就與指定圖示對應。這些資料應以逗號分隔值呈現，並按照以下順序排列：

Name, icon filename

下表提供這些欄位的說明：

CSV 欄標題 必要或選用 說明
名稱 必要 必須與 AchievementsMetadata.csv 中的 Name 欄相符。
圖示檔案名稱 必要 圖示檔案的名稱。

AchievementsIconMappings.csv 檔案規定：

  • 每列都應包含兩個值。
  • 圖示檔案只能是 PNG 或 JPEG 格式。

範例 AchievementsIconMappings.csv 檔案：

Valid Achievement,valid-achievement-icon.png
Incremental Achievement,incremental-achievement-icon.jpeg
No Description,no-description-icon.png
Hidden Initial State,hidden-initial-state-icon.png
Large Point Value,large-point-value-icon.jpeg

圖示規範

支援的圖示大小為 512 x 512，檔案格式為 PNG、JPEG 或 JPG。您只需提供代表解鎖成就的圖示，系統會自動產生灰階版本來代表顯示成就。因此，建議您在圖示中加入彩色元素，方便使用者區分顯示成就和解鎖成就。

如果在 Android [浮動式訊息][a]中顯示成就圖示，圖示上會有重疊的圓圈，並隱藏外角。請確保圖示在這類情況下仍可正常顯示。

成就圖示範例。
成就圖示範例。

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

圖示檔案

AchievementsIconMappings.csv 檔案中參照的圖示，必須包含在匯入的現有 ZIP 封存檔中。

更新現有成就的遊戲

您可以在 Google Play 管理中心為遊戲新增更多成就，以及更新現有成就。

新增更多成就

如果您已建立成就，但還想要追加，請按照下列步驟操作：

  1. 在 Google Play 管理中心選取遊戲。
  2. 在「Play 遊戲服務 - 成就」頁面 (依序點選「拓展」>「Play 遊戲服務」>「設定與管理」>「成就」)，選取「新增成就」。
編輯成就

如要編輯現有成就，請按照下列步驟操作：

  1. 在 Google Play 管理中心選取遊戲。
  2. 在「Play 遊戲服務 - 成就」頁面 (依序點選「拓展」>「Play 遊戲服務」>「設定與管理」>「成就」)，選取要編輯的成就。
  3. 你可以編輯任何欄位。
  4. 按一下「儲存為草稿」。
  5. 在「Play 遊戲服務 - 成就」頁面中，編輯後的成就狀態為「可供測試人員使用」。
  6. 測試成就後，按一下「檢查與發布」。

    這樣就能向全體玩家重新發布遊戲，以及所有更新過的成就。
刪除成就

成就發布後即無法刪除。 您只能刪除尚未發布的成就

  1. 在「Play 遊戲服務 - 成就」頁面中，選取成就。
  2. 如要刪除成就，請按一下「刪除成就」。
重設成就

只有處於草稿狀態的成就，才能重設玩家進度資料。

  1. 在「Play 遊戲服務 - 成就」頁面中，選取成就。
  2. 如要重設成就，請按一下「重設進度」。
  3. 如要透過程式輔助方式重設成就資料，請呼叫 Management API Achievements 方法。

新增成就翻譯

您可以指定與遊戲相關聯的成就翻譯。在開始之前，請務必先完成「新增遊戲翻譯」所述的步驟。

新增遊戲翻譯的方式有兩種：

  • 使用「匯入成就」選項，一次上傳多項新成就的翻譯。這個選項無法上傳現有成就的翻譯。

  • 新增每項遊戲成就的翻譯。 如要為每項成就新增翻譯，請按照下列步驟操作：

    1. 在 Google Play 管理中心開啟遊戲的「成就」分頁，然後選取現有成就。
    2. 在成就詳細資料頁面中，選取先前在「遊戲詳細資料」分頁中所新增語言的分頁標籤。
    3. 在該語言的成就詳細資料頁面中，將相關成就的翻譯填入表單。
    4. 按一下「儲存」，即可儲存成就翻譯資料。

用戶端實作

如要瞭解如何實作平台中的成就，請參閱以下資源：

測試成就

如要確認成就功能是否正常運作，請按照下列步驟進行測試：

  • 設定內部測試群組。
  • 為測試人員新增測試帳戶至遊戲專案。
  • 使用 Play 遊戲應用程式，為其中一個測試帳戶建立 Play 遊戲服務設定檔。
  • 使用建立 Play 遊戲服務設定檔的測試帳戶開啟遊戲。
  • 確認畫面上顯示 Play 遊戲服務「歡迎訊息」，確認遊戲啟動時已成功自動驗證。
  • 玩遊戲並完成必要步驟，即可解鎖成就。

  • 如要驗證成就，請按照下列指示操作：

    • 確認完成成就時，畫面上會顯示「成就已解鎖」彈出式視窗。

    • 開啟「Play 商店」應用程式，然後確認「你的專區」分頁中的成就部分會顯示已完成和進行中的成就 (以及進度詳細資料)。

在 Play 管理中心追蹤成就成效

如何尋找個別關卡的快速統計資料：

  • 在 Google Play 管理中心。
  • 依序前往「設定」>「遊戲專案」。
  • 選擇遊戲。
  • 按一下左側選單中的「成就」。
  • 「成就」頁面會顯示統計資料，方便您瞭解玩家是否正在解鎖成就。如果成就未隱藏，您就能查看解鎖成就的百分比。如果是早期成就，解鎖百分比通常會接近 100%。

您也可以在「拓展」>「Play 遊戲服務」>「遊戲統計資料」頁面中，追蹤成就的時間序列成效。

發布成就

測試完成後，請務必發布遊戲。 遊戲的所有成就都會一併發布。發布成就 是成就正常運作的必要步驟。

如要發布，請按照下列步驟操作：

  1. 在 Google Play 管理中心選取遊戲。
  2. 在「Play 遊戲服務 - 成就」頁面 (依序點選「拓展」>「Play 遊戲服務」>「設定與管理」>「成就」)，按一下「檢查並發布」。
  3. 在「Play 遊戲服務 - 發布」頁面 (依序點選「拓展」>「Play 遊戲服務」>「設定與管理」>「發布」)，查看動作並修正問題。
  4. 按一下「發布」。

    遊戲的所有成就都會發布。

應避免的常見錯誤

這些要點說明在遊戲中導入成就時，應避免的常見錯誤。他們強調以下事項的重要性：

  • 在 Play 管理中心，依序前往「拓展」>「Play 遊戲服務」>「設定與管理」>「成就」。

    • 發布前，請確認 Play 管理中心設定的成就不處於「草稿」狀態。
    • 請勿將 Play 管理中心的成就 ID 值新增至遊戲程式碼。請改用用戶端實作。

  • 請務必在用戶端實作解鎖邏輯。

    • 玩家無法略過呼叫解鎖 API 的觸發步驟。 舉例來說，完成教學課程是一項成就，但玩家可以略過教學課程。