淘汰時間表

本文列出 Play Games 服務第 1 版 SDK 的淘汰時間表。

Google 登入 (GSI) API 淘汰後，我們將關閉 Play Games 服務第 1 版 SDK 和 API。您必須將遊戲遷移至 Play 遊戲服務第 2 版 SDK，才能使用最新功能。

淘汰時程如下：

日期 淘汰
里程碑		 影響 開發人員
動作
2026 年 5 月 移除 GSI API 如果遊戲新增的功能 (例如 LiveOps、任務或地圖) 並非依賴 Google 驗證 (Play 遊戲服務 v1 API 除外)，這些功能仍可正常運作。

如果遊戲使用第三方 SDK 或 Play Games 服務第 1 版以外的 Google SDK，且需要升級驗證，升級至該 SDK 的最新版本可能會導致編譯錯誤。
  1. 如果遇到編譯錯誤，請按照這裡說明的解決路徑操作。
  2. 請務必在 2026 年第 2 季末發布解決方案後，立即按照這裡提及的解決方案路徑遷移至 Play Games 服務第 2 版。
2026 年 6 月 15 日 Play Games 服務第 1 版 API 移除作業 我們將發布新的 Play Games 服務第 1 版 SDK，其中已移除 GSI API，且現有 Play Games 服務第 1 版功能不會再修正錯誤或更新。
如果現有的第 1 版遊戲升級至最新版 Play 遊戲服務第 1 版，新版遊戲的 Play 遊戲服務功能將停止運作。
  1. 使用 Play Games 服務第 1 版的遊戲不得將第 1 版 SDK 升級至 com.google.android.gms:play-services-games:25.0.0，因為這樣會移除第 1 版 API。
  2. 如果遊戲尚未遷移至 Play Games 服務第 2 版，可能會發生編譯錯誤，因為 play-services-auth 將於 2026 年 5 月停止提供 GSI。
  3. 按照上一節所述的時間表，遊戲可以持續注意其他 SDK 的升級情況，並確保其他 SDK 在遷移至 Play Games 服務第 2 版之前，不會使用新的 Credential Manager SDK。
2027 年 5 月 Play Games 服務第 1 版即將停止運作 系統會封鎖 Play Games 服務第 1 版的所有流量，且不會編譯遊戲。

現有的 Play Games 服務第 1 版 API 將無法在正式環境中運作。 		您只能在這個期限前遷移至 Play 遊戲服務第 2 版，以免玩家加入和登入程序中斷。

  • 2025 年 9 月後，遊戲服務第 1 版 SDK 和 API 將淘汰。先前整合第 1 版的現有遊戲可持續運作。Google Play 會禁止發布使用第 1 版 SDK 和 API 的新遊戲。

  • 自 2026 年 6 月 15 日起，SDK 將移除已淘汰的 API。

  • 遊戲服務第 1 版 SDK 將於 2027 年 6 月移除。即使您使用舊版 SDK，對這些 API 的呼叫也會失敗。

下表列出遊戲第 1 版 (SDK) 版本、淘汰日期和遷移指南：

SDK 版本 發布日期 遷移指南
play-services-games:v24.0.0 2025 年 9 月 12 日
已淘汰		 遷移至第 2 版(Java 或 Kotlin)
v0.10.15 Unity 2025 年 9 月 17 日
已淘汰		 遷移至第 2 版(Unity)
play-services-games:v25.0.0 2026 年 6 月 15 日
：從 SDK 移除 Play Games 服務第 1 版 API。		 遷移至第 2 版(Java 或 Kotlin)

移除 Google Sign-In API 的影響範例

假設 SDK1 從玩家的 Google 帳戶擷取好友名單。如要使用這項功能，玩家必須使用 Google 驗證 SDK 驗證自己的 Google 帳戶。

在下列情況中，您可能需要更新 Google 驗證 SDK：

  • 解決驗證流程中的重大錯誤。
  • 導入 Credential Manager SDK 提供的新密碼金鑰體驗。

下表說明更新遊戲驗證整合的三種情況：

  • 情境 1：SDK1 升級至最新版 Google 驗證 SDK。
  • 情境 2：SDK1 與 Credential Manager 整合，Google 驗證 SDK 則維持不變。
  • 情境 3：SDK1 與 Credential Manager 整合，並移除 Google 驗證 SDK。
功能 Scenario 1 Scenario 2 情境 3：
驗證升級情境
  1. 不知道 GSI API 已移除，遊戲升級至最新版驗證 SDK。
  2. 現有的驗證功能會中斷，且 SDK1 會強制整合 Credential Manager SDK。
  3. 遊戲發布最新版本，其中包含最新驗證 SDK 和 Credential Manager SDK。
 由於 GSI API 即將移除，SDK1 並未升級驗證 SDK，而是使用最新版的 Credential Manager SDK，為 Google 驗證功能提供支援。 在最新版本中，SDK1 會使用 Credential Manager SDK 支援 Google 驗證功能，並完全移除 Auth SDK。
Play Games 服務第 1 版 SDK 未變更 未變更 未變更
遊戲編譯時會發生什麼情況
  1. Play Games 服務第 1 版需要個別整合驗證 SDK -> 由於驗證 SDK 升級時沒有 GSI API，Play Games 服務第 1 版將無法運作。
  2. 遊戲發生編譯時間錯誤。
  3. 遊戲會嘗試按照解決路徑操作。
 遊戲發生編譯時間錯誤 遊戲會嘗試按照解決路徑操作。
可能的玩家體驗 以上選項皆不適用，由於遊戲無法編譯，因此無法發布。
  1. 使用 Play Games 服務第 1 版進行驗證時，玩家會看到 Play Games 服務帳戶選取器。
  2. 玩家向 SDK1 功能驗證時，會看到 Credential Manager 底部功能表。
  1. 使用 Play Games 服務第 1 版進行驗證時，玩家會看到 Play Games 服務帳戶選取器。
  2. 玩家向 SDK1 功能驗證時，會看到 Credential Manager 底部功能表。
遊戲開發人員的解決路徑
  1. 找出導致 Auth SDK 升級的 SDK。
  2. 還原 SDK1 的 SDK 版本。
  3. 使用該功能重新編譯遊戲。
  4. 如果新遊戲功能需要升級至 SDK1，請與 SDK1 討論，為其版本採用情境 2 或 3。
  1. Nothing
  2. 不過，如果您也使用「使用 Google 帳戶登入」按鈕，可能就必須為玩家提供兩種「Google 登入」流程。
  1. Nothing
  2. 不過，如果您也使用「使用 Google 帳戶登入」按鈕，可能就必須為玩家使用兩種「Google 登入」流程。
Play Games 服務第 1 版的最終結果 遊戲不需要升級至 Play Games 服務第 2 版，但 SDK1 仍會過時。 遊戲不需要從 Play Games 服務第 1 版升級至第 2 版。 遊戲不需要從 Play Games 服務第 1 版升級至第 2 版。