Tài liệu này trình bày cách sử dụng Google Play Console để thiết lập dịch vụ trò chơi của Google Play cho trò chơi trên Android. Google Play Console là một nơi tập trung để bạn quản lý các dịch vụ trò chơi và định cấu hình siêu dữ liệu nhằm uỷ quyền và xác thực trò chơi.
Để thêm trò chơi vào Google Play Console, hãy làm theo các bước cơ bản sau:
- Tạo dự án trò chơi cho trò chơi của bạn và nêu rõ các thông tin chi tiết, chẳng hạn như tên và nội dung mô tả trò chơi.
- Tạo và liên kết các thông tin xác thực cần thiết để ủy quyền và xác thực trò chơi với Dịch vụ trò chơi của Google Play.
Các bước này được đề cập chi tiết hơn trong các phần dưới đây.
Bước 1. Đăng nhập vào Google Play Console.
Để đăng nhập, hãy truy cập vào Google Play Console. Nếu chưa từng đăng ký Google Play Console, bạn sẽ được nhắc đăng ký.
Bước 2. Thêm trò chơi của bạn vào Google Play Console
Để thêm trò chơi, hãy làm theo các bước sau:
- Tạo trò chơi trong Play Console nếu bạn chưa có. Hãy xem tại đây để biết thêm thông tin chi tiết.
- Chuyển đến phần Phát triển > Dịch vụ trò chơi của Play > Thiết lập và quản lý > Cấu hình.
Xác định dự án Dịch vụ trò chơi của Play mà bạn muốn sử dụng, tạo một dự án từ đầu hoặc chọn sử dụng một dự án hiện có.
Tạo dự án mới sử dụng Dịch vụ trò chơi của Play: Để tạo dự án dịch vụ trò chơi của Play, bạn cần có một dự án trên đám mây.
Nếu bạn đã tạo một dự án trên đám mây cho trò chơi này, hãy chọn dự án đó trên đám mây trong danh sách thả xuống rồi chọn Use (Sử dụng).
Nếu không, hãy chọn Create new Cloud project (Tạo dự án mới trên đám mây), rồi làm theo hướng dẫn để tạo dự án mới trên đám mây cho trò chơi này. Sau đó, hãy chọn Làm mới các dự án trên đám mây, chọn dự án mới tạo trên đám mây trong danh sách thả xuống rồi nhấp vào Sử dụng.
Sử dụng dự án hiện có trên Dịch vụ trò chơi của Play: Nếu đang tạo một trò chơi mới trong Play Console để thay đổi tên gói hiện có, hoặc nếu có phiên bản miễn phí và phiên bản có tính phí của trò chơi với các tên gói khác nhau, bạn có thể sử dụng lựa chọn này. Chọn dự án Dịch vụ trò chơi của Play rồi nhấp vào Use (Sử dụng).
Một dự án trò chơi trong Dịch vụ trò chơi của Play sẽ được tạo và một mục tương ứng sẽ được tạo cho bạn trong Google Cloud Console.
Trong phần Properties (Thuộc tính), bạn có thể chọn Edit Properties (Chỉnh sửa thuộc tính) rồi thêm nội dung mô tả, danh mục và thành phần đồ hoạ cho trò chơi của mình.
- Bạn chỉ cần điền tên hiển thị để thử nghiệm. Bạn phải điền vào đầy đủ các trường trước khi có thể phát hành trò chơi.
- Tên hiển thị và nội dung mô tả trò chơi phải khớp với tên và nội dung mô tả bạn đã thiết lập cho trang thông tin của trò chơi trên Cửa hàng Play.
- Để biết nguyên tắc về cách tạo thành phần đồ hoạ, hãy xem hướng dẫn dành cho Google Play dành cho nhà phát triển và Nguyên tắc về hình ảnh nổi bật trên Google Play.
Bước 3. Tạo mã ứng dụng khách OAuth 2.0
Trò chơi của bạn phải có mã ứng dụng khách OAuth 2.0 để được xác thực và uỷ quyền gọi dịch vụ trò chơi của Google Play. Để thiết lập thông tin xác thực cho Dịch vụ trò chơi của Play, vốn là mối liên kết giữa mã ứng dụng khách và trò chơi của bạn, vui lòng sử dụng Google Cloud Platform để tạo mã ứng dụng khách. Sau đó, sử dụng Google Play Console để thêm thông tin xác thực, liên kết mã ứng dụng khách với trò chơi của bạn.
Để được hướng dẫn chi tiết hơn, vui lòng xem các bước sau:
a. Định cấu hình màn hình xin phép bằng OAuth
Nếu bạn chưa định cấu hình màn hình xin phép bằng OAuth, thì phần Thông tin xác thực sẽ hiển thị một thông báo nhắc bạn định cấu hình.
Nhấp vào Định cấu hình. Thao tác này sẽ mở ra một hộp thoại có thêm hướng dẫn và liên kết sâu tới Google Cloud Platform.
Nếu bạn đã hoàn tất quá trình thiết lập màn hình xin phép bằng OAuth, hãy nhấp vào Xong. Google Play Console sẽ tự động làm mới, và nếu đã định cấu hình thành công, bạn sẽ có thể tạo thông tin xác thực:
b. Tạo thông tin xác thực
Để cho phép trò chơi của bạn giao tiếp với Dịch vụ trò chơi của Google Play, bạn phải tạo thông tin xác thực bằng mã ứng dụng khách OAuth2 được uỷ quyền.
Trong phần Thông tin xác thực, hãy nhấp vào Thêm thông tin xác thực.
Trong trình hướng dẫn, hãy chọn xem bạn muốn tạo thông tin xác thực Android (nếu APK trò chơi của bạn sẽ xác thực người dùng và sử dụng API PGS) hay thông tin xác thực máy chủ trò chơi (nếu máy chủ trò chơi của bạn sử dụng API PGS). Hãy làm theo hướng dẫn dành riêng cho loại thông tin xác thực mà bạn muốn.
Android
Thiết lập thông tin xác thực
Hãy đảm bảo tên trong trường Tên khớp với tên trò chơi của bạn. Bạn có thể tùy chọn bật chế độ Chống vi phạm bản quyền.
Thiết lập lệnh ủy quyền
Tiếp theo, hãy chọn một mã ứng dụng khách OAuth để sử dụng cho dự án trò chơi này. Nếu đã có mã ứng dụng khách OAuth2, bạn có thể chọn một mã khác. Tuy nhiên, bạn thường sẽ tạo một mã mới. Nhấp vào Tạo ứng dụng khách OAuth. Thao tác này sẽ mở ra một hộp thoại có đường liên kết sâu và hướng dẫn tạo mã ứng dụng khách OAuth trong Google Cloud Platform.
- Chọn Android làm loại ứng dụng.
- Nhập tên trò chơi trong trường Tên.
- Nhập tên gói của ứng dụng Android vào trường Tên gói.
Mở một thiết bị đầu cuối và chạy tiện ích Keytool để lấy vân tay SHA1 của bản phát hành và chứng chỉ gỡ lỗi.
Để lấy vân tay cho chứng chỉ phát hành, hãy chạy lệnh sau:
keytool -list -keystore <path-to-production-keystore> -vĐể lấy vân tay cho chứng chỉ gỡ lỗi, hãy chạy lệnh sau:
keytool -list -keystore <path-to-debug-keystore> -vTiện ích keytool nhắc bạn nhập mật khẩu cho kho khóa. Mật khẩu mặc định cho kho khóa gỡ lỗi sẽ là
android. Tiện ích keytool sau đó in vân tay vào thiết bị đầu cuối.Dán vân tay SHA1 vào trường vân tay ký chứng chỉ (SHA1).
Nhấp vào Tạo.
Để biết thêm thông tin về OAuth 2.0 trên Android, vui lòng xem bài viết Xác thực với Dịch vụ OAuth2.
Sau khi bạn nhấp vào Xong trong hộp thoại, các mã ứng dụng khách có sẵn sẽ được làm mới. Chọn thông tin xác thực bạn đã tạo từ trình đơn thả xuống rồi nhấp vào Lưu thay đổi. Thao tác này sẽ tạo thông tin xác thực dưới dạng bản nháp, cho phép bạn xác thực các dịch vụ trò chơi của Play trong trò chơi của mình.
Nếu bạn muốn tạo hai thông tin xác thực: một là vân tay cho chứng chỉ phát hành và một cho vân tay của chứng chỉ gỡ lỗi. Hãy đảm bảo bạn sẽ sử dụng cùng một tên gói cho cả hai. Điều này cho phép Dịch vụ trò chơi của Google Play nhận dạng các lệnh gọi từ tệp APK liên kết được ký với một trong hai chứng chỉ. Để biết thêm thông tin về việc ký chứng chỉ cho Android, vui lòng xem Ký ứng dụng của bạn.
Máy chủ trò chơi
Thiết lập thông tin xác thực
Hãy đảm bảo tên trong trường Tên khớp với tên trò chơi của bạn.
Thiết lập lệnh ủy quyền
Tiếp theo, hãy chọn một mã ứng dụng khách OAuth để sử dụng cho dự án trò chơi này. Nếu đã có mã ứng dụng khách OAuth2, bạn có thể chọn một mã khác. Tuy nhiên, bạn thường sẽ tạo một mã mới. Nhấp vào Tạo ứng dụng khách OAuth. Thao tác này sẽ mở ra một hộp thoại có đường liên kết sâu và hướng dẫn tạo mã ứng dụng khách OAuth trong Google Cloud Platform.
- Chọn Ứng dụng web làm loại ứng dụng.
- Nhập tên trò chơi trong trường Tên.
- Nhấp vào Tạo.
Để biết thêm thông tin về OAuth 2.0 trên Android, vui lòng xem bài viết Xác thực với Dịch vụ OAuth2.
Sau khi bạn nhấp vào Xong trong hộp thoại, các mã ứng dụng khách có sẵn sẽ được làm mới. Chọn thông tin xác thực bạn đã tạo từ trình đơn thả xuống rồi nhấp vào Lưu thay đổi. Thao tác này sẽ tạo thông tin xác thực dưới dạng bản nháp, cho phép bạn xác thực các dịch vụ trò chơi của Play từ máy chủ trò chơi của mình. Để biết thêm thông tin về cách sử dụng Dịch vụ trò chơi của Play với máy chủ trò chơi của bạn, vui lòng xem bài viết Bật Quyền truy cập phía máy chủ vào Dịch vụ trò chơi của Google Play.
Tránh các vấn đề thường gặp khi thiết lập
Để tránh các lỗi thiết lập phổ biến, hãy nhớ làm theo những đề xuất sau đây khi thiết lập trò chơi để sử dụng các dịch vụ trò chơi của Google Play.
- 1. Thiết lập trò chơi của bạn trên Google Play Console.
- Nếu bạn đã tạo mã ứng dụng khách OAuth 2.0 cho ứng dụng của mình trong Google Cloud Console, thì các dịch vụ trò chơi của Google Play sẽ không biết về mối liên kết giữa thành tích và bảng xếp hạng của trò chơi cũng như mã ứng dụng khách. Để tạo mối liên kết này, bạn phải lập một thông tin xác thực bằng cách sử dụng mã ứng dụng khách OAuth 2.0 như mô tả trong phần Tạo thông tin xác thực.
- 2. Sử dụng đúng mã ứng dụng trong Android
- Mã ứng dụng là một tài nguyên chuỗi bắt buộc mà bạn phải tham chiếu trong tệp kê khai Android của mình. Chuỗi mã ứng dụng chỉ bao gồm các chữ số (thường là 12 chữ số trở lên) ở đầu mã ứng dụng khách do Google Play Console cung cấp. Bạn có thể tìm thấy mã ứng dụng ở đầu trang Cấu hình được gắn nhãn Mã dự án bên dưới tên trò chơi.
- 3. Ký APK của bạn bằng chứng chỉ chính xác
- Khi liên kết ứng dụng Android với trò chơi của mình trong Google Play Console, bạn phải sử dụng chính xác tên gói và dấu vân tay chứng chỉ mà bạn đã dùng để phát hành ứng dụng. Nếu không khớp, các lệnh gọi đến dịch vụ trò chơi của Google Play sẽ không thực hiện được. Bạn nên tạo 2 mã ứng dụng khách, một mã có vân tay của chứng chỉ phát hành và một mã khác có vân tay của chứng chỉ gỡ lỗi, đồng thời sử dụng cùng một tên gói cho cả hai. Để tìm hiểu thêm về cách chỉ định chứng chỉ ký trong Google Play Console, hãy xem phần Ký ứng dụng.
- 4. Khi phát triển cho Android, hãy thêm SDK Play Games dưới dạng dự án thư viện, chứ không phải dưới dạng JAR độc lập
- Hãy đảm bảo SDK Dịch vụ Google Play được tham chiếu dưới dạng một dự án thư viện trong dự án Android của bạn. Nếu không, điều này có thể dẫn đến lỗi khi ứng dụng của bạn không thể tìm thấy tài nguyên của Dịch vụ Google Play. Để tìm hiểu cách thiết lập dự án Android nhằm sử dụng Dịch vụ Google Play, vui lòng xem phần Thiết lập Dịch vụ Google Play.
- 5. Đăng nhập bằng tài khoản người chơi thử nghiệm trong quá trình phát triển ứng dụng
- Nếu chưa phát hành các thay đổi về chế độ cài đặt trò chơi trong Google Play Console, thì bạn có thể gặp lỗi trong quá trình kiểm thử nếu chưa đăng nhập bằng tài khoản người kiểm thử có trong danh sách cho phép. Bạn phải luôn bật tài khoản nhà xuất bản Google Play Console để kiểm thử. Để tìm hiểu cách quản lý tài khoản người chơi thử nghiệm, vui lòng xem phần Bật tài khoản để thử nghiệm.
- 6. Phát hành màn hình xin phép trong Google Cloud Platform
- Trước khi phát hành ứng dụng trong Google Play Console, hãy phát hành màn hình xin phép trong Google Cloud Platform. Nếu không có bước này, đối tượng công khai sẽ không thể sử dụng bất kỳ tính năng nào trong Dịch vụ trò chơi của Play.
- 7. Trước khi phát hành, hãy phát hành chế độ cài đặt Dịch vụ trò chơi của Play trước khi phát hành trò chơi
- Nhà phát triển có thể vô tình phát hành ứng dụng mà không phát hành chế độ cài đặt tương ứng cho dịch vụ trò chơi của Google Play. Việc này có thể khiến những người chơi đăng nhập bằng tài khoản không phải người kiểm thử gặp lỗi vì ứng dụng không thể tham chiếu đúng chế độ cài đặt của trò chơi. Khi phát hành trò chơi, hãy nhớ phát hành chế độ cài đặt trò chơi trước tiên bằng cách sử dụng tuỳ chọn Phát hành trò chơi trong Google Play Console. Để tìm hiểu cách phát hành các thay đổi, vui lòng xem phần Phát hành các thay đổi đối với trò chơi.
Để biết thêm các mẹo, hãy tham khảo:
- Hướng dẫn khắc phục sự cố trên Android – Tài liệu dành cho nhà phát triển mô tả cách khắc phục sự cố khi phát triển trò chơi trên Android.
Các bước tiếp theo
Trước khi tiếp tục, bạn nên thêm tài khoản thử nghiệm vào trò chơi như mô tả trong phần Bật tài khoản để thử nghiệm. Người dùng có tài khoản thử nghiệm được uỷ quyền sẽ có quyền truy cập vào dự án trò chơi sử dụng Dịch vụ trò chơi của Play chưa phát hành và có thể kiểm thử để đảm bảo rằng Dịch vụ trò chơi của Google Play đã được định cấu hình đang hoạt động đúng cách.
Sau khi hoàn tất các tác vụ thiết lập ban đầu được mô tả ở trên, bạn có thể tiến hành định cấu hình các tính năng cho trò chơi của mình, chẳng hạn như bảng xếp hạng và thành tích. Để tìm hiểu thêm, hãy xem bài viết Bật các tính năng.