Lịch ngừng sử dụng

Tài liệu này liệt kê lịch trình ngừng sử dụng SDK Dịch vụ trò chơi của Play phiên bản 1.

Sau khi ngừng sử dụng API Đăng nhập bằng Google (GSI)lên kế hoạch ngừng hoạt động, chúng tôi sẽ ngừng sử dụng SDK và API Dịch vụ trò chơi của Play phiên bản 1. Bạn phải di chuyển trò chơi của mình sang SDK Dịch vụ trò chơi của Play phiên bản 2 để sử dụng các tính năng mới nhất.

Tiến trình ngừng sử dụng như sau:

Ngày Giai đoạn ngừng sử dụng
Tác động Hành động của nhà phát triển
Tháng 5/2026 Xoá API GSI Nếu một trò chơi thêm các tính năng mới (chẳng hạn như liveops, nhiệm vụ hoặc bản đồ) không dựa vào tính năng xác thực của Google (ngoại trừ API Dịch vụ trò chơi của Play phiên bản 1), thì các tính năng này sẽ tiếp tục hoạt động.

Nếu trò chơi của bạn sử dụng SDK bên thứ ba hoặc SDK của Google không phải là Dịch vụ trò chơi của Play phiên bản 1 và yêu cầu nâng cấp tính năng xác thực, thì việc nâng cấp lên phiên bản mới nhất của SDK đó có thể gây ra lỗi biên dịch.
  1. Hãy làm theo lộ trình giải quyết được đề cập tại đây khi gặp lỗi biên dịch.
  2. Đảm bảo bạn di chuyển sang Dịch vụ trò chơi của Play phiên bản 2 theo lộ trình giải quyết được đề cập tại đây ngay sau khi giải pháp được phát hành vào cuối quý 2 năm 2026.
Ngày 15 tháng 6 năm 2026 Xoá API Dịch vụ trò chơi của Play phiên bản 1 SDK Dịch vụ trò chơi của Play phiên bản 1 mới (đã xoá API GSI) sẽ được phát hành mà không có bản sửa lỗi hoặc bản cập nhật nào khác cho các tính năng hiện có của Dịch vụ trò chơi của Play phiên bản 1.
Nếu một trò chơi hiện có ở phiên bản 1 nâng cấp lên phiên bản Dịch vụ trò chơi của Play phiên bản 1 mới nhất, thì các chức năng của Dịch vụ trò chơi của Play trên phiên bản mới này sẽ ngừng hoạt động.
  1. Các trò chơi trên Dịch vụ trò chơi của Play phiên bản 1 không được nâng cấp SDK phiên bản 1 lên com.google.android.gms:play-services-games:25.0.0. Phiên bản này sẽ xoá các API phiên bản 1.
  2. Mọi trò chơi chưa di chuyển sang Dịch vụ trò chơi của Play phiên bản 2 đều có thể gặp lỗi biên dịch vì play-services-auth không còn cung cấp GSI kể từ tháng 5 năm 2026.
  3. Theo tiến trình được đề cập trong phần trước, các trò chơi có thể duy trì sự cảnh giác về việc nâng cấp các SDK khác và đảm bảo rằng các SDK khác không sử dụng SDK Trình quản lý thông tin xác thực mới cho đến khi được di chuyển sang Dịch vụ trò chơi của Play phiên bản 2.
Tháng 5/2027 Ngừng hoạt động Dịch vụ trò chơi của Play phiên bản 1 Tất cả lưu lượng truy cập từ Dịch vụ trò chơi của Play phiên bản 1 đều bị chặn mà không có quá trình biên dịch trò chơi.

Các API hiện có của Dịch vụ trò chơi của Play phiên bản 1 sẽ ngừng hoạt động trong môi trường chính thức.
Bạn chỉ có thể di chuyển sang Dịch vụ trò chơi của Play phiên bản 2 trước thời hạn này để tránh tình trạng gián đoạn quá trình giới thiệu và đăng nhập của người chơi.
  • Sau tháng 9 năm 2025, SDK và API của trò chơi phiên bản 1 sẽ ngừng hoạt động. Các trò chơi hiện có có tích hợp phiên bản 1 trước đó vẫn tiếp tục hoạt động. Google Play ngăn việc phát hành các trò chơi mới sử dụng SDK và API phiên bản 1.

  • Kể từ ngày 15 tháng 6 năm 2026, các API đã ngừng hoạt động sẽ bị xoá khỏi SDK.

  • Kể từ tháng 6 năm 2027, SDK của trò chơi phiên bản 1 sẽ bị xoá. Các lệnh gọi đến những API này sẽ không thành công, ngay cả khi bạn đang sử dụng các phiên bản SDK trước đó.

Bảng sau đây liệt kê các phiên bản trò chơi phiên bản 1 (SDK), ngày ngừng sử dụng và hướng dẫn di chuyển:

Phiên bản SDK Ngày phát hành Hướng dẫn di chuyển
play-services-games:v24.0.0 Ngày 12 tháng 9 năm 2025
Ngừng sử dụng
Di chuyển sang phiên bản 2(Java hoặc Kotlin)
v0.10.15 Unity Ngày 17 tháng 9 năm 2025
Ngừng sử dụng
Di chuyển sang phiên bản 2(Unity)
play-services-games:v25.0.0 Ngày 15 tháng 6 năm 2026
Đã xoá API Dịch vụ trò chơi của Play phiên bản 1 khỏi SDK.
Di chuyển sang phiên bản 2(Java hoặc Kotlin)

Tác động mẫu của việc xoá API GSI

Hãy xem xét trường hợp một SDK (SDK1) truy xuất danh sách bạn bè từ Tài khoản Google của người chơi. Để sử dụng tính năng này, người chơi phải xác thực Tài khoản Google của mình bằng SDK xác thực của Google.

Bạn có thể cần cập nhật SDK xác thực của Google trong các trường hợp sau:

  • Giải quyết một lỗi nghiêm trọng trong quy trình xác thực.
  • Triển khai trải nghiệm khoá truy cập mới do SDK Trình quản lý thông tin xác thực cung cấp.

Bảng sau đây mô tả 3 trường hợp cập nhật quy trình tích hợp xác thực của trò chơi:

  • Trường hợp 1: SDK1 nâng cấp lên SDK xác thực của Google mới nhất.
  • Trường hợp 2: SDK1 tích hợp với Trình quản lý thông tin xác thực, giữ nguyên SDK xác thực của Google.
  • Trường hợp 3: SDK1 tích hợp với Trình quản lý thông tin xác thực và xoá SDK xác thực của Google.
Tính năng Trường hợp 1 Trường hợp 2 Trường hợp 3
Các trường hợp nâng cấp tính năng xác thực
  1. Không biết về việc xoá API GSI, trò chơi nâng cấp lên SDK xác thực mới nhất.
  2. Chức năng xác thực hiện có bị hỏng và SDK1 buộc phải tích hợp SDK Trình quản lý thông tin xác thực.
  3. Trò chơi phát hành phiên bản mới nhất có SDK xác thực mới nhất và SDK Trình quản lý thông tin xác thực.
Biết về việc xoá API GSI, SDK1 không nâng cấp SDK xác thực nhưng hỗ trợ chức năng xác thực của Google bằng SDK Trình quản lý thông tin xác thực ở phiên bản mới nhất. Ở phiên bản mới nhất, SDK1 hỗ trợ chức năng xác thực của Google bằng SDK Trình quản lý thông tin xác thực và xoá hoàn toàn SDK xác thực.
SDK Dịch vụ trò chơi của Play phiên bản 1 Không thay đổi Không thay đổi Không thay đổi
Điều gì xảy ra khi trò chơi biên dịch
  1. Dịch vụ trò chơi của Play phiên bản 1 yêu cầu tích hợp SDK xác thực riêng -> Vì SDK xác thực được nâng cấp mà không có API GSI, nên Dịch vụ trò chơi của Play phiên bản 1 sẽ bị hỏng.
  2. Trò chơi gặp lỗi thời gian biên dịch.
  3. Sau đó, trò chơi sẽ cố gắng làm theo lộ trình giải quyết.
Trò chơi gặp lỗi thời gian biên dịch Sau đó, trò chơi sẽ cố gắng làm theo lộ trình giải quyết.
Trải nghiệm có thể có của người chơi Không có. Vì trò chơi không thể biên dịch nên không có quá trình phát hành.
  1. Người chơi thấy bộ chọn tài khoản Dịch vụ trò chơi của Play khi xác thực bằng Dịch vụ trò chơi của Play phiên bản 1.
  2. Người chơi thấy bảng dưới cùng của Trình quản lý thông tin xác thực khi xác thực tính năng SDK1.
  1. Người chơi thấy bộ chọn tài khoản Dịch vụ trò chơi của Play khi xác thực bằng Dịch vụ trò chơi của Play phiên bản 1.
  2. Người chơi thấy bảng dưới cùng của Trình quản lý thông tin xác thực khi xác thực tính năng SDK1.
Lộ trình giải quyết cho nhà phát triển trò chơi
  1. Tìm hiểu xem SDK nào đang gây ra quá trình nâng cấp SDK xác thực.
  2. Hoàn nguyên phiên bản SDK của SDK1.
  3. Biên dịch lại trò chơi của họ bằng tính năng của họ.
  4. Nếu tính năng mới của trò chơi yêu cầu nâng cấp lên SDK1, hãy nói chuyện với SDK1 để áp dụng trường hợp 2 hoặc 3 cho phiên bản của họ.
  1. Không có
  2. Tuy nhiên, nếu bạn cũng đang sử dụng nút Đăng nhập bằng Google, thì bạn có thể phải sử dụng 2 loại quy trình Đăng nhập bằng Google cho người chơi.
  1. Không có
  2. Tuy nhiên, nếu bạn cũng đang sử dụng nút Đăng nhập bằng Google, thì bạn có thể phải sử dụng 2 loại quy trình Đăng nhập bằng Google cho người chơi.
Kết quả cuối cùng cho Dịch vụ trò chơi của Play phiên bản 1 Trò chơi không cần nâng cấp lên Dịch vụ trò chơi của Play phiên bản 2, nhưng SDK1 vẫn lỗi thời. Trò chơi không cần nâng cấp từ Dịch vụ trò chơi của Play phiên bản 1 lên phiên bản 2. Trò chơi không cần nâng cấp từ Dịch vụ trò chơi của Play phiên bản 1 lên phiên bản 2.