Tổng quan về quá trình di chuyển

Dịch vụ Google Play Games, SDK games phiên bản 1 dựa vào tính năng Đăng nhập bằng Google cho Android. Tính năng này đã ngừng hoạt động và sẽ bị xoá khỏi SDK xác thực của Dịch vụ Google Play (com.google.android.gms:play-services-auth) vào năm 2025. Các ứng dụng trò chơi mới có thể sử dụng phiên bản 1 của Dịch vụ trò chơi cho đến năm 2025. Việc xoá tính năng Đăng nhập bằng Google sẽ gây ra các vấn đề về phần phụ thuộc cho các ứng dụng trò chơi hiện có. Việc di chuyển các ứng dụng trò chơi hiện có từ SDK games phiên bản 1 sang SDK games phiên bản 2 sẽ giải quyết các vấn đề về phần phụ thuộc do việc xoá tính năng Đăng nhập bằng Google gây ra.

Tài liệu này giúp bạn hiểu rõ các hoạt động tương tác giữa ứng dụng trò chơi và nhiều SDK. Tài liệu này cũng so sánh các tính năng của ứng dụng với các tính năng của SDK Dịch vụ trò chơi của Play phiên bản 1 và phiên bản 2.

Tương tác SDK

Các sơ đồ minh hoạ mối tương tác giữa một ứng dụng trò chơi trên Android, GMS Core, Dịch vụ Play Games và một máy chủ trò chơi bên thứ ba (3P). Ví dụ này nêu bật cách ứng dụng sử dụng các dịch vụ của Google để xác thực và cung cấp các tính năng trò chơi, đồng thời tương tác với một hệ thống riêng biệt của bên thứ ba.

games v2 (Hiện tại)

Tương tác giữa Ứng dụng trò chơi trên Android, GMS Core, Dịch vụ trò chơi của Play và máy chủ trò chơi của bên thứ ba (3P).
Tương tác giữa một Ứng dụng trò chơi trên Android, GMS Core, Dịch vụ Play Games và một máy chủ trò chơi của bên thứ ba (3P). (nhấp để phóng to).

games v1 (Cũ)

Tương tác giữa Ứng dụng trò chơi trên Android, GMS Core, Dịch vụ trò chơi của Play và máy chủ trò chơi của bên thứ ba (3P).
Tương tác giữa một Ứng dụng trò chơi trên Android, GMS Core, Dịch vụ Play Games và một máy chủ trò chơi của bên thứ ba (3P). (nhấp để phóng to).

Sau đây là thông tin tổng quan ngắn gọn về các thành phần và SDK:

  • Ứng dụng trò chơi.
    • Đây là ứng dụng trò chơi của người dùng đang chạy trên một thiết bị Android.
    • Thư viện này chứa 2 thành phần chính:
      • SDK games v1 hoặc games v2. SDK phía máy khách chịu trách nhiệm tương tác với Dịch vụ trò chơi của Play.
      • SDK xác thực. SDK Xác thực Dịch vụ Google Play chịu trách nhiệm xử lý quy trình xác thực và uỷ quyền người dùng trong trò chơi phiên bản 1.
    • Cả hai SDK đều giao tiếp bằng AIDL (Ngôn ngữ định nghĩa giao diện Android), cho biết một mẫu giao tiếp giữa các quy trình hoặc dịch vụ khác nhau.
  • GMS Core còn được gọi là Dịch vụ Google Play.
    • Đây là lớp thuộc quyền sở hữu của Google trên Android.
    • Ứng dụng trò chơi sử dụng 2 mô-đun GMS Core:
      • Mô-đun Trò chơi cung cấp các tính năng dành riêng cho trò chơi, chẳng hạn như bảng xếp hạng, thành tích và quản lý trạng thái trò chơi.
      • Mô-đun uỷ quyền. Xử lý các thao tác xác thực và uỷ quyền người dùng.
    • Các SDK Games và Auth trong ứng dụng trò chơi giao tiếp với các mô-đun tương ứng bằng cách sử dụng các giao diện AIDL, cho biết hoạt động giao tiếp giữa các quy trình (IPC).

  • Cổng Dịch vụ trò chơi của Play.
    • Một cổng logic đóng vai trò trung gian trong quá trình giao tiếp giữa GMS Core và máy chủ Dịch vụ trò chơi của Play.
    • Xử lý các yêu cầu API, quá trình chuyển đổi dữ liệu và xác thực cho hoạt động giao tiếp của máy chủ.
  • Máy chủ Dịch vụ trò chơi của Play.
    • Đại diện cho các dịch vụ phụ trợ của Dịch vụ trò chơi của Play chịu trách nhiệm lưu trữ dữ liệu trò chơi, quản lý tài khoản người dùng và hỗ trợ các tính năng nhiều người chơi.
  • Cổng trò chơi của bên thứ ba.
    • Nếu ứng dụng trò chơi của bạn đủ điều kiện là ứng dụng bên thứ ba (3P), thì thư viện ứng dụng sẽ giao tiếp với các máy chủ Dịch vụ trò chơi của Play thông qua các máy chủ trò chơi bên thứ ba.
    • Ngụ ý rằng ứng dụng cũng có thể xác thực bằng một nhà cung cấp dịch vụ khác.
  • Máy chủ trò chơi của bên thứ ba.
    • Biểu thị một máy chủ bên ngoài không bắt buộc mà ứng dụng trò chơi có thể tương tác, có thể là để quản lý dữ liệu hoặc các tính năng tuỳ chỉnh.
    • Ứng dụng giao tiếp thông qua cổng trò chơi của bên thứ ba.

So sánh tính năng

Bảng này giúp bạn so sánh các tính năng giữa SDK trò chơi phiên bản 1 và SDK trò chơi phiên bản 2:


Tính năng

SDK games v1

SDK games v2

Xác thực

Bạn phải tích hợp với play-services-auth.

Đơn giản hoá và tinh giản; không cần play-services-auth.

Uỷ quyền

Mã bổ sung cho trạng thái thành công, không thành công và thử lại.

Do SDK quản lý

Mã truy cập máy chủ

Có thể yêu cầu thêm phạm vi OAuth 2.0 bằng GoogleSigninClient.

Mã bổ sung để xử lý lỗi trong quá trình đăng nhập.

Có thể yêu cầu 3 phạm vi danh tính cơ bản của OAuth 2.0 bằng GamesSignInClient khi yêu cầu quyền truy cập phía máy chủ vào API web của Dịch vụ trò chơi của Play.

Để biết thêm thông tin, hãy xem bài viết Quyền truy cập phía máy chủ vào Dịch vụ trò chơi của Play Truy xuất mã xác thực máy chủ.


Quy trình đăng nhập

Cách dùng GoogleSigninClient.

Mã bổ sung để xử lý mã chuẩn cho tính năng tự động đăng nhập và xử lý lỗi.

Cách dùng GamesSignInClient.

SDK xử lý mã nguyên mẫu, tính năng tự động đăng nhập và xử lý lỗi.

Cửa sổ bật lên chào mừng

Cần có mã bổ sung.
Nhà phát triển có thể kiểm soát vị trí và thời gian của thông báo.

Không cần thêm mã. Giao diện người dùng nhất quán trên tất cả các trò chơi được định cấu hình bằng SDK phiên bản 2.

Phần phụ thuộc

Yêu cầu play-services-auth.

Mô-đun Trò chơi đảm nhiệm việc uỷ quyền và xác thực. Bạn không cần thêm bất kỳ phần phụ thuộc nào khác.
Đăng xuất

Cách dùng GoogleSignInClient.signOut.

Không hỗ trợ API đăng xuất.

Nhiều tài khoản Dịch vụ trò chơi của Play và chế độ cài đặt cho từng trò chơi

Bạn có thể quản lý tài khoản trong trò chơi.

Người dùng có thể thay đổi hồ sơ Dịch vụ Play Games trong phần cài đặt của thiết bị di động. Để biết thêm thông tin, hãy xem bài viết cách chuyển đổi hồ sơ Play Games trên thiết bị di động.