Lịch ngừng sử dụng

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

Sau khi ngừng cung cấp API Đăng nhập bằng Google (GSI) và ngừng hoạt động theo kế hoạch, chúng tôi sẽ ngừng cung cấp 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 Cột mốc
ngừng sử dụng		 Tác động Hành động của nhà phát triển
Tháng 9 năm 2026 Xoá GSI API 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 hoạt độ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ì những tính năng này sẽ tiếp tục hoạt động.

Nếu trò chơi của bạn dùng một SDK bên thứ ba hoặc một SDK của Google (ngoài Dịch vụ trò chơi của Play phiên bản 1) yêu cầu nâng cấp quy trình 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 quy trình giải quyết được đề cập ở đâ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 pháp được đề cập ở đây ngay sau khi giải pháp được phát hành vào cuối quý 2 năm 2026.
Tháng 6/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 đã được xuất bản mà không có thêm bản sửa lỗi hoặc bản cập nhật nào 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. SDK này đã xoá các API GSI.
Nếu một ứng dụng/trò chơi phiên bản 1 hiện có 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. Thao tác 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 Trình quản lý thông tin xác thực SDK 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 năm 2027 Dịch vụ trò chơi của Play phiên bản 1 ngừng hoạt động 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ần 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 thực tế. 		Cách duy nhất là 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 làm gián đoạn quá trình tham gia và đăng nhập của người chơi.

  • Sau tháng 9 năm 2025, SDK và API của games phiên bản 1 sẽ ngừng hoạt động. Các ứng dụng/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 không cho phép xuất bản những tiêu đề 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 không dùng nữa đã bị xoá khỏi SDK.

  • Kể từ tháng 9 năm 2026, API Đăng nhập bằng Google cho Android sẽ không còn được hỗ trợ nữa.

  • Từ tháng 6 năm 2027, SDK của games 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 dùng các phiên bản SDK cũ.

Bảng sau đây liệt kê các phiên bản Dịch vụ trò chơi của Play 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
Không dùng nữa		 Di chuyển sang phiên bản 2(Java hoặc Kotlin)
Unity phiên bản 0.10.15 Ngày 17 tháng 9 năm 2025
Không dùng nữa		 Chuyển sang phiên bản 2(Unity)
play-services-games:v25.0.0 Ngày 15 tháng 6 năm 2026
API Dịch vụ trò chơi của Play phiên bản 1 bị xoá khỏi SDK.		 Di chuyển sang phiên bản 2(Java hoặc Kotlin)

Ví dụ về tác động của việc xoá API GSI

Hãy xem xét một trường hợp trong đó 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 Google Authentication SDK trong những 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 Trình quản lý thông tin xác thực SDK cung cấp.

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

  • Tình huống 1: SDK1 nâng cấp lên SDK Xác thực của Google mới nhất.
  • Tình huống 2: SDK1 tích hợp với Trình quản lý thông tin xác thực, không thay đổi SDK Xác thực của Google.
  • Tình huống 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 Tình huống 1 Tình huống 2 Tình huống 3
Các trường hợp nâng cấp quy trình xác thực
  1. Không biết về việc xoá các 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ị gián đoạn 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 bằng SDK Xác thực và SDK Trình quản lý thông tin xác thực mới nhất.
 Nhận thức được việc xoá GSI API, SDK1 không nâng cấp SDK xác thực mà hỗ trợ chức năng xác thực bằng Google bằng Trình quản lý thông tin xác thực SDK ở phiên bản mới nhất. Trong phiên bản mới nhất, SDK1 hỗ trợ chức năng xác thực của Google bằng Trình quản lý thông tin xác thực SDK 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 biệt -> 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ẽ ngừng hoạt độ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 thực hiện theo đường dẫn độ phân giải.
 Trò chơi gặp lỗi thời gian biên dịch Sau đó, trò chơi sẽ cố gắng thực hiện theo đường dẫn độ phân giải.
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 xuất bản được.
  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.
Cách giải quyết dành cho nhà phát triển trò chơi
  1. Tìm hiểu xem SDK nào gây ra quá trình nâng cấp SDK xác thực.
  2. Khôi phục 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 trao đổi với SDK1 để áp dụng trường hợp 2 hoặc 3 cho phiên bản của họ.
  1. Nothing
  2. Tuy nhiên, nếu cũng đang sử dụng nút Đăng nhập bằng Google, thì có thể bạn phải sử dụng 2 loại quy trình Đăng nhập bằng Google cho người chơi.
  1. Nothing
  2. Tuy nhiên, nếu cũng đang sử dụng nút Đăng nhập bằng Google, thì có thể bạn 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.