Bước đầu tiên để tích hợp trò chơi của bạn với Dịch vụ trò chơi của Google Play (PGS) là triển khai tính năng Xác thực nền tảng. Bạn cần phải đăng nhập để sử dụng tất cả các tính năng khác như thành tích, bảng xếp hạng và sự kiện.
Vì SDK Dịch vụ trò chơi của Play tự động thực hiện quy trình xác thực nền tảng khi khởi chạy trò chơi, nên bạn cần tích hợp SDK PGS phiên bản 2 với trò chơi của mình và triển khai quy trình xác thực được đề xuất để trò chơi của bạn sẵn sàng triển khai và đáp ứng nguyên tắc về trải nghiệm người dùng của Google Play Games Level Up.
Các khái niệm về xác thực
Trong Dịch vụ trò chơi của Play phiên bản 2, khái niệm "đăng nhập" được tách thành hai lớp riêng biệt: xác thực nền tảng và xác thực trong trò chơi.
Xác thực bằng công cụ của nền tảng
Dịch vụ trò chơi của Play cung cấp một lớp tương tác trên nền tảng. Dịch vụ này quản lý mối quan hệ của người chơi với hệ sinh thái Google Play Games bằng cách sử dụng Hồ sơ người chơi để truy cập vào các tính năng như thành tích, bảng xếp hạng và nhiệm vụ. Phương thức xác thực bằng công cụ của nền tảng có các đặc điểm chính sau:
- Tự động và không gây gián đoạn: Quá trình xác thực diễn ra tự động ở chế độ nền khi trò chơi khởi chạy. Dịch vụ trò chơi của Play không yêu cầu nút Đăng nhập thủ công.
- Mã nhận dạng người chơi: Sau khi xác thực thành công nền tảng, Dịch vụ trò chơi của Play sẽ cung cấp Mã nhận dạng người chơi ổn định. Mã nhận dạng này không thay đổi trên các thiết bị cho cùng một trò chơi. Sử dụng mã nhận dạng này chủ yếu để theo dõi các tính năng của nền tảng, chẳng hạn như tiến trình đạt được thành tích.
- Tách rời: Bạn không được sử dụng Dịch vụ trò chơi của Play làm hệ thống nhận dạng chính của trò chơi để quản lý tài khoản trong trò chơi (IGA), tiến trình chơi hoặc kho đồ của người chơi. Dịch vụ trò chơi của Play đóng vai trò là giá trị nhận dạng nền tảng cố định.
Tên nhận dạng người chơi
Mã nhận dạng người chơi là giá trị nhận dạng cho tài khoản người chơi sử dụng Dịch vụ trò chơi của Play. Trò chơi của bạn có thể truy xuất mã nhận dạng người chơi của mọi người chơi đăng nhập vào trò chơi đó bằng phương thức xác thực của Dịch vụ trò chơi của Play. Tính năng tích hợp ứng dụng trò chơi, tính năng tích hợp máy chủ trò chơi và dịch vụ lưu vào đám mây có thể sử dụng mã nhận dạng này để truy cập an toàn vào dữ liệu người chơi trong Dịch vụ trò chơi của Play.
Mã nhận dạng người chơi của một người dùng không thay đổi khi họ chơi trò chơi của bạn trên nhiều thiết bị. Tuy nhiên, mã nhận dạng người chơi có thể thay đổi giữa các trò chơi. Để biết thêm thông tin, hãy xem bài viết Mã nhận dạng người chơi thế hệ mới.
Xác thực trong trò chơi
Bạn quản lý tài khoản trong trò chơi (IGA), đây là hệ thống nhận dạng liên kết tiến trình, kho đồ và đơn vị tiền tệ của người chơi trong trò chơi.
- Danh tính chính: Bạn có thể sử dụng phần phụ trợ của riêng mình, tính năng Đăng nhập bằng Google (SiWG) hoặc các nhà cung cấp khác làm phương thức đăng nhập chính.
- Tính độc lập: Người chơi có thể đăng nhập vào Dịch vụ trò chơi của Play (Danh tính nền tảng) để đạt được thành tích trong khi đăng nhập vào bất kỳ IGA cụ thể nào (ví dụ: tài khoản khách hoặc tài khoản SiWG cụ thể).
- Quản lý nhiều IGA: Dịch vụ trò chơi của Play chỉ xử lý việc xác thực nền tảng. Trò chơi của bạn quản lý việc xác thực chính của người chơi vào IGA của họ. Điều này có nghĩa là quy trình hiện tại của trò chơi không thay đổi để người chơi chuyển đổi giữa các IGA của họ. Khi người chơi chuyển đổi tài khoản, họ vẫn được xác thực với nền tảng Play Games thông qua PGS và bạn tiếp tục gửi dữ liệu của họ liên quan đến thành tích và các tính năng khác của PGS theo Mã nhận dạng người chơi cố định.
Tính liên tục trên nhiều nền tảng nhờ SiWG
Để giúp người chơi tiếp tục tiến trình của họ trên Android, iOS và web, hãy sử dụng tính năng Đăng nhập bằng Google làm phương thức xác thực chính trong trò chơi. Hãy cân nhắc những điểm sau:
- Nút Đăng nhập bằng Google: Trong PGS phiên bản 1, nút Google Play thường xử lý cả việc đăng nhập vào nền tảng và trò chơi. Trong phiên bản 2, đây là các quy trình riêng biệt. Triển khai nút Đăng nhập bằng Google tiêu chuẩn để người chơi xác thực và truy cập vào IGA của họ.
- SDK Đăng nhập bằng Google:
- Đối với cả Android và iOS, hãy sử dụng SDK Đăng nhập bằng Google tiêu chuẩn để xác thực người chơi vào IGA của họ.
- Sử dụng Google Open ID làm giá trị nhận dạng chính cho tài khoản trong trò chơi của người chơi.
- Sử dụng Mã nhận dạng người chơi của Dịch vụ trò chơi của Play để báo cáo tiến trình của người chơi trên các tính năng của Play Games, chẳng hạn như thành tích.
Phương thức tích hợp nên dùng
Để tích hợp trò chơi với Dịch vụ trò chơi của Play, hãy làm theo các bước đề xuất sau:
Khởi chạy và xác thực
Bạn cần thực hiện bước này để khởi động và xác thực trò chơi:
Triển khai quy trình xác thực nền tảng bằng cách khởi chạy SDK Dịch vụ trò chơi của Play phiên bản 2 khi khởi động. Để biết thêm thông tin, hãy xem bài viết xác thực nền tảng cho trò chơi Android. Bạn cần thực hiện bước này để sử dụng các tính năng của Dịch vụ trò chơi của Play, chẳng hạn như thành tích và bảng xếp hạng.
Quá trình xác thực chạy dưới dạng một tiến trình nền thầm lặng trong khi khởi chạy trò chơi. Người dùng hiện tại của Dịch vụ trò chơi của Play sẽ thấy thông báo chào mừng sau khi xác thực thành công. Người dùng chưa có hồ sơ Dịch vụ trò chơi của Play sẽ được nhắc tạo hồ sơ trong quá trình khởi chạy SDK.

Tạo tiểu sử
Người chơi cần có hồ sơ Dịch vụ trò chơi của Play để tương tác với nền tảng này. Một số người chơi có thể không có hồ sơ Dịch vụ trò chơi của Play khi bắt đầu trò chơi của bạn. Những người chơi này sẽ được yêu cầu tạo một hồ sơ. Bạn có thể quyết định trải nghiệm phù hợp cho người dùng bằng cách chọn một trong các lựa chọn sau:
Lời nhắc tạo hồ sơ được kích hoạt tự động
Theo mặc định, lời nhắc tạo hồ sơ tự động kích hoạt sẽ tự động xuất hiện khi bạn chạy một trò chơi mà không có hồ sơ Dịch vụ trò chơi của Play.
Ngừng lời nhắc tạo hồ sơ được kích hoạt tự động
Tắt lời nhắc hồ sơ khi khởi chạy bằng cách định cấu hình tệp kê khai để ngăn lời nhắc tự động kích hoạt. Điều này cho phép người dùng không có hồ sơ Dịch vụ trò chơi của Play tiếp tục tải trò chơi mà không được nhắc tạo hồ sơ Dịch vụ trò chơi của Play.
Mặc dù người dùng có thể đăng nhập bằng bất kỳ nhà cung cấp dịch vụ danh tính nào, nhưng bạn nên hiển thị lời nhắc tạo hồ sơ để khuyến khích họ xác thực bằng phương thức xác thực của nền tảng Play Games. Hiển thị lời nhắc này khi cần, nhưng hãy đảm bảo lời nhắc xuất hiện trước khi người dùng đạt được tiến trình đáng kể trong các tính năng như thành tích và bảng xếp hạng.
Hãy cân nhắc việc kích hoạt lời nhắc hồ sơ trong những thời điểm được đề xuất sau:
- Sau khi hoàn thành một hướng dẫn.
- Trong khoảnh khắc nhận phần thưởng (ví dụ: thắng một trận đấu, thu thập một vật phẩm hiếm hoặc đạt được một mốc quan trọng).
- Tại thời điểm bắt đầu phiên thứ hai.
Để biết thêm thông tin, hãy xem bài viết Ngăn chặn việc tự động tạo hồ sơ (Java) và Ngăn chặn việc tự động tạo hồ sơ (Unity).
Xác thực trong trò chơi
Sau khi thực hiện thành công quy trình xác thực nền tảng, nhà phát triển nên triển khai các bước sau để người chơi truy cập vào IGA của họ, tuỳ thuộc vào trạng thái trò chơi hiện tại:
- Nếu có một phiên chơi đang hoạt động trên thiết bị, hãy cho phép người chơi tiếp tục phiên hiện tại của họ.
- Nếu không có phiên chơi nào đang hoạt động:
- Trong trường hợp khôi phục liền mạch, khi tài khoản trong trò chơi (IGA) được chơi gần đây nhất liên kết với Mã nhận dạng người chơi PGS, hãy tiến hành tự động khôi phục IGA được liên kết.
- Nếu không, hãy hiển thị cho người chơi màn hình đăng nhập hoặc tạo tài khoản được chỉ định của ứng dụng. Sau đó, người chơi có thể chọn phương pháp xác thực mà họ muốn để thiết lập hoặc đăng nhập vào một IGA hiện có.
Phạm vi OAuth
Dịch vụ trò chơi của Play dựa vào hệ thống OAuth để cho phép người dùng cấp cho trò chơi của bạn quyền truy cập vào tài khoản của họ. Dịch vụ trò chơi của Play có một phạm vi riêng cho trò chơi (games-lite), đồng thời dựa vào một phạm vi khác (drive.appdata) nếu trò chơi của bạn sử dụng tính năng trò chơi đã lưu. Tính năng trò chơi đã lưu cho phép truy cập vào tài khoản Google Drive của người dùng, đây là nơi lưu trữ dữ liệu trò chơi.
Khi sử dụng SDK Dịch vụ trò chơi của Play phiên bản 2, bạn có thể yêu cầu thêm phạm vi OAuth.
Nếu cần thêm phạm vi OAuth, bạn nên gọi requestServerSideAccess.
Để biết thêm thông tin, hãy xem bài viết
lấy mã xác thực máy chủ hoặc truy xuất mã xác thực máy chủ.
Nguyên tắc về trải nghiệm người dùng cho quy trình xác thực lý tưởng
Các nguyên tắc sau đây giải thích quy trình xác thực được đề xuất khi tích hợp PGS phiên bản 2. Các trường hợp này bao gồm các tình huống cho người dùng mới, người dùng hiện tại, người dùng cũ và chế độ khách.
Người chơi mới
Quy trình này áp dụng cho người dùng chạy trò chơi lần đầu tiên trên một thiết bị chưa từng có nhật ký chơi trò chơi này.
- Khi khởi chạy, SDK PGS sẽ khởi động để xác thực danh tính của người dùng trên nền tảng (Mã nhận dạng người chơi PGS).
- Sau khi hoàn tất quá trình bắt tay trong nền này, trò chơi sẽ hiển thị các lựa chọn tạo IGA cho người chơi, chẳng hạn như Tạo tài khoản mới, Đăng nhập bằng Google hoặc các phương thức đăng nhập bằng mạng xã hội khác.
- Sau khi người chơi tạo hoặc chọn một IGA, trò chơi sẽ liên kết tài khoản này với giá trị nhận dạng chính đã chọn trong phần phụ trợ của họ.
- Trò chơi cũng liên kết IGA đã chọn này với Mã nhận dạng người chơi PGS, đánh dấu đây là IGA được chơi gần đây nhất để khôi phục liền mạch.
Người chơi có phiên hoạt động
Trường hợp này mô tả người chơi khởi chạy trò chơi trên một thiết bị mà họ đã có phiên hoạt động. Mục tiêu là mang đến trải nghiệm nhập dữ liệu liền mạch.
- Khi người chơi chạy ứng dụng, PGS sẽ tự động xác thực trong nền, cung cấp cho bạn Mã nhận dạng người chơi để theo dõi tiến trình đạt được thành tích và các tính năng khác của trò chơi.
- Đồng thời, nếu có thể, trò chơi sẽ bỏ qua màn hình đăng nhập và ngay lập tức đăng nhập người chơi vào phiên IGA đang hoạt động hoặc IGA được chơi gần đây nhất liên kết với Mã nhận dạng người chơi của họ, để họ có thể tiếp tục chơi ngay lập tức.
Người chơi chuyển đổi tài khoản
Quy trình này xảy ra khi người chơi có phiên hoạt động chuyển đến phần cài đặt trò chơi để chuyển đổi tài khoản. Ví dụ: đăng xuất khỏi tài khoản chính để sử dụng tài khoản thay thế.
- Người chơi đăng xuất khỏi IGA hiện tại, nhưng kết nối nền tảng PGS vẫn hoạt động.
- Khi người chơi đăng nhập bằng một IGA khác, trò chơi sẽ liên kết tài khoản mới này với Mã nhận dạng người chơi PGS hiện tại dưới dạng IGA được chơi gần đây nhất chỉ để khôi phục liền mạch.
Khôi phục liền mạch cho người chơi cũ
Trường hợp này áp dụng khi người chơi chạy trò chơi sau một khoảng thời gian không hoạt động, sau khi cài đặt lại hoặc trên một thiết bị hoàn toàn mới. Bạn nên triển khai tính năng khôi phục liền mạch cho trò chơi.
- Khi khởi chạy, PGS sẽ xác thực người dùng và cung cấp Mã nhận dạng người chơi PGS cho trò chơi.
- Trò chơi sẽ kiểm tra phần phụ trợ (hoặc mã gọi lại đã truy xuất nếu sử dụng API Recall) để xem liệu IGA đã chơi gần đây nhất có được liên kết với mã nhận dạng PGS này hay không.
- Nếu tìm thấy mối liên kết, trò chơi sẽ tự động khôi phục tiến trình của người chơi và đăng nhập cho họ, bỏ qua hoàn toàn màn hình đăng nhập thủ công.
- Nếu không, trò chơi sẽ hiển thị màn hình đăng nhập cho người chơi
- Sau đó, người chơi chọn một phương pháp Đăng nhập và đăng nhập vào IGA
- Sau đó, trò chơi sẽ liên kết IGA này với mã nhận dạng người chơi PGS làm IGA được chơi gần đây nhất để khôi phục liền mạch.
Chế độ khách
Người chơi có thể chạy trò chơi của bạn và chơi bằng tài khoản khách trên thiết bị. Dịch vụ trò chơi của Play vẫn xác thực người chơi ở chế độ nền. Nếu người chơi chọn Lưu tiến trình, thì trò chơi của bạn sẽ chuyển đổi phiên khách thành IGA vĩnh viễn và liên kết phiên đó với mã nhận dạng người chơi. Để biết thêm thông tin về cách giải quyết xung đột, hãy xem bài viết Tài khoản khách.
Kiểm thử trò chơi
Hãy đảm bảo trò chơi của bạn hoạt động đúng như thiết kế bằng cách thử nghiệm trò chơi. Các bài kiểm thử bạn thực hiện phụ thuộc vào tính năng của trò chơi.
Sau đây là danh sách các thử nghiệm phổ biến cần chạy.
Đăng nhập thành công.
Tính năng tự động đăng nhập hoạt động. Người dùng phải đăng nhập vào Dịch vụ trò chơi của Play khi khởi chạy trò chơi.
Cửa sổ bật lên chào mừng sẽ xuất hiện.
Cửa sổ bật lên chào mừng mẫu (nhấp để phóng to). Thông điệp nhật ký thành công sẽ hiển thị. Chạy lệnh sau trong dòng lệnh:
adb logcat | grep com.google.android.
Thông điệp nhật ký thành công được hiển thị trong ví dụ sau:
[
$PlaylogGamesSignInAction$SignInPerformerSource@e1cdecc number=1 name=GAMES_SERVICE_BROKER>], returning true for shouldShowWelcomePopup. [CONTEXT service_id=1 ]
Đảm bảo tính nhất quán của thành phần giao diện người dùng.
Cửa sổ bật lên, bảng xếp hạng và thành tích hiển thị chính xác và nhất quán trên nhiều kích thước và hướng màn hình trong giao diện người dùng (UI) của Dịch vụ trò chơi của Play.
Lựa chọn đăng xuất không xuất hiện trong giao diện người dùng của Dịch vụ trò chơi của Play.
Đảm bảo bạn có thể truy xuất thành công Mã nhận dạng người chơi và nếu có, các chức năng phía máy chủ sẽ hoạt động như mong đợi.
Nếu trò chơi sử dụng phương thức xác thực phía máy chủ, hãy kiểm tra kỹ quy trình
requestServerSideAccess. Đảm bảo máy chủ nhận được mã xác thực và có thể trao đổi mã đó để lấy mã truy cập. Kiểm thử cả trường hợp thành công và không thành công đối với lỗi mạng, trường hợpclient IDkhông hợp lệ.
Nếu trò chơi của bạn đang sử dụng bất kỳ tính năng nào sau đây, hãy kiểm thử để đảm bảo rằng các tính năng đó hoạt động giống như trước khi di chuyển:
- Bảng xếp hạng: Gửi điểm số và xem bảng xếp hạng. Kiểm tra để đảm bảo thứ hạng, tên và điểm số của người chơi được hiển thị chính xác.
- Thành tích: Mở khoá thành tích và xác minh rằng thành tích được ghi lại và hiển thị chính xác trong giao diện người dùng của Play Games.
- Trò chơi đã lưu: Nếu trò chơi sử dụng tính năng trò chơi đã lưu, hãy đảm bảo rằng việc lưu và tải tiến trình trò chơi hoạt động hoàn hảo. Điều này đặc biệt quan trọng khi thử nghiệm trên nhiều thiết bị và sau khi cập nhật ứng dụng.