Bước đầu tiên trong việc 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 thực hiện bước này để truy cập vào 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 xác thực nền tảng khi trò chơi khởi chạy, nên bạn cần tích hợp SDK Dịch vụ trò chơi của Play 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 các 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 chia 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 nền tảng
Dịch vụ trò chơi của Play cung cấp một lớp tương tác nền tảng. Lớp 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ụ. Tính năng xác thực nền tảng có các đặc điểm chính sau:
- Tự động và không cần thao tác: 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** theo cách thủ công.
- Mã nhận dạng người chơi: Sau khi xác thực nền tảng thành công, Dịch vụ trò chơi của Play sẽ cung cấp một 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ị đối với cùng một trò chơi. Hãy 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 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 liên tục.
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 tính năng xác thực của Dịch vụ trò chơi của Play. Tính năng tích hợp máy khách trò chơi, 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 chơi, kho và đơn vị tiền tệ trong trò chơi của bạn.
- Giá trị nhận dạng 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 (Giá trị nhận dạng nền tảng) để kiếm 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ý quá trình xác thực nền tảng. Trò chơi của bạn quản lý quá trình 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à không có thay đổi nào đối với các quy trình hiện có của trò chơ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 Dịch vụ trò chơi của Play và bạn tiếp tục gửi dữ liệu liên quan đến thành tích và các tính năng khác của Dịch vụ trò chơi của Play dựa trên Mã nhận dạng người chơi liên tục.
Tính liên tục trên nhiều nền tảng bằng tính năng Đăng nhập bằng Google
Để giúp người chơi chuyển tiến trình chơi 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ều sau:
- Nút Đăng nhập bằng Google: Trong Dịch vụ trò chơi của Play phiên bản 1, nút Google Play thường xử lý cả quá trình đă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.
Đề xuất tích hợp
Để tích hợp trò chơi của bạn với Dịch vụ trò chơi của Play, hãy làm theo các bước đượ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 chạy và xác thực trò chơi:
Triển khai tính năng 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 để truy cập vào 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 quy trình nền không cần thao tác trong khi trò chơi khởi chạy. Người dùng hiện tại của Dịch vụ trò chơi của Play sẽ thấy một thông báo chào mừng sau khi xác thực thành công. Những người dùng không 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. Một số người chơi có thể không có hồ sơ Dịch vụ trò chơi của Play khi họ bắt đầu chơi 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ơ.
Lời nhắc tạo hồ sơ được kích hoạt tự động sẽ tự động xuất hiện theo mặc định khi bạn khởi chạy một trò chơi mà không có hồ sơ Dịch vụ trò chơi của Play.
Xác thực trong trò chơi
Sau khi thực hiện thành công quá 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 hiện tại của trò chơi:
- Nếu có một phiên trò 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.
- Nếu không có phiên trò chơi nào đang hoạt động:
- Trong trường hợp khôi phục liền mạch trong đó IGA được chơi gần đây nhất được liên kết với Mã nhận dạng người chơi của Dịch vụ trò chơi của Play, 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 thức 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 Dịch vụ trò chơi của Play phiên bản 2. Các nguyên tắc này bao gồm các trường hợp dành cho người dùng mới, người dùng hiện tại và người dùng cũ, cũng như chế độ khách.
Người chơi mới
Quy trình này áp dụng cho người dùng khởi chạy trò chơi lần đầu tiên trên một thiết bị không có lịch sử chơi trò chơi trước đó.
- Khi khởi chạy, SDK Dịch vụ trò chơi của Play sẽ khởi chạy để xác thực giá trị nhận dạng nền tảng của người dùng (Mã nhận dạng người chơi của Dịch vụ trò chơi của Play).
- Sau quá trình bắt tay ở chế độ 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, ví dụ: 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 tài khoản 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 của Dịch vụ trò chơi của Play, đánh dấu IGA nà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 đang hoạt động
Trường hợp này mô tả những người chơi khởi chạy trò chơi trên một thiết bị mà họ đã có một phiên đang hoạt động. Mục tiêu là mang đến trải nghiệm truy cập liền mạch.
- Khi người chơi khởi chạy ứng dụng, Dịch vụ trò chơi của Play sẽ xác thực ở chế độ nền mà không cần thao tác, cung cấp cho bạn Mã nhận dạng người chơi để theo dõi tiến trình đạt thành tích và các tính năng khác của Play Games.
- Đồng thời, nếu có thể, trò chơi sẽ bỏ qua màn hình đăng nhập và đăng nhập ngay người chơi vào phiên IGA đang hoạt động hoặc IGA được chơi gần đây nhất được 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 một người chơi có phiên đang 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 Dịch vụ trò chơi của Play 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 hiện tại của Dịch vụ trò chơi của Play 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 khởi chạy trò chơi sau một thời gian không hoạt động, 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, Dịch vụ trò chơi của Play sẽ xác thực người dùng và cung cấp Mã nhận dạng người chơi của Dịch vụ trò chơi của Play cho trò chơi.
- Trò chơi sẽ kiểm tra phần phụ trợ của trò chơi (hoặc mã gọi lại đã truy xuất nếu sử dụng Recall API) để xem IGA được chơi gần đây nhất đã được liên kết với Mã nhận dạng người chơi của Dịch vụ trò chơi của Play này hay chưa.
- Nếu tìm thấy một đường 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ị cho người chơi màn hình đăng nhập
- Sau đó, người chơi chọn một phương thức đăng nhập và đăng nhập vào một IGA
- Sau đó, trò chơi sẽ liên kết IGA này với mã nhận dạng người chơi của Dịch vụ trò chơi của Play dưới dạng 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ể khởi chạy trò chơi và chơi bằng tài khoản khách cục bộ. Dịch vụ trò chơi của Play vẫn xác thực ở chế độ nền. Nếu người chơi chọn Lưu tiến trình, trò chơi sẽ chuyển đổi phiên khách thành một IGA vĩnh viễn và liên kết IGA đó với Mã nhận dạng người chơi của Dịch vụ trò chơi của Play.
