Hãy sử dụng danh sách kiểm tra này để đảm bảo trò chơi của bạn đáp ứng tất cả yêu cầu và phương pháp hay nhất trước khi gửi đi xem xét trên Google Play Games trên máy tính.
Thiết lập và định cấu hình dự án
- Tải xuống và nhập SDK: Tích hợp SDK Google Play Games trên máy tính chơi trò chơi mới nhất cho môi trường của bạn. Để biết thêm thông tin, hãy xem hướng dẫn về Unity hoặc hướng dẫn về C++.
- Tạo tệp kê khai ứng dụng: Tạo tệp
manifest.xmlliên kết<PackageName>với gói Play Console mà bạn đã xác nhận quyền sở hữu. Để biết thêm thông tin, hãy xem Hướng dẫn về tệp kê khai. - Ký điện tử tệp thực thi: Ký trò chơi của bạn bằng Chữ ký số Authenticode và bảo vệ chứng chỉ cho tất cả các bản cập nhật trong tương lai. Mặc dù bạn có thể bỏ qua bước này trong quá trình phát triển cục bộ bằng cách bật chế độ nhà phát triển, nhưng bạn phải ký tệp nhị phân cuối cùng bằng chứng chỉ chính thức từ một tổ chức phát hành chứng chỉ đã biết. Để biết thêm thông tin, hãy xem bài viết Ký điện tử cho trò chơi.
- Định dạng và gửi chứng chỉ: Gửi thông tin chứng chỉ cho người đại diện của Google. Tệp chứng chỉ chỉ được chứa thông tin liên quan đến chứng chỉ; hãy xác minh rằng tất cả các khối không phải chứng chỉ đều đã bị xoá. Bạn có thể sử dụng OpenSSL để chuyển đổi tệp DER/CER sang định dạng PEM bắt buộc.
Tích hợp API và tính năng
- Khởi chạy SDK: Triển khai logic khởi chạy SDK, ví dụ:
InitializeAsync, trong quá trình khởi động trước khi bạn sử dụng các tính năng khác. Để biết thêm thông tin, hãy xem Hướng dẫn khởi chạy. - Triển khai quy trình đăng nhập liền mạch: Tự động xác thực người chơi bằng tài khoản ứng dụng Play Games thông qua Recall API. Để biết thêm thông tin, hãy xem hướng dẫn Đăng nhập liền mạch.
- Tích hợp Play Integrity: Sử dụng
IntegrityClientđể yêu cầu mã thông báo và xác minh tính hợp lệ của các phiên trò chơi trên phần phụ trợ. Để biết thêm thông tin, hãy xem hướng dẫn về Play Integrity. - Thêm Play Install Referrer: Tích hợp Install Referrer API nếu bạn cần theo dõi nguồn thu nạp người dùng cho máy tính. Để biết thêm thông tin, hãy xem hướng dẫn về URL giới thiệu cài đặt.
- Xử lý lỗi khởi chạy: Để sử dụng SDK, hãy gọi
GooglePlayInitialize(C++) hoặcGooglePlayInitialization.InitializeAsync(C#) để khởi chạy API. Bạn phải gọi hàm này và xác minh rằng lệnh gọi lại tiếp tục hoàn tất vớiInitializeResult::ok()(C++) hoặcResult.IsOk(C#) trả vềtruetrước khi bạn có thể sử dụng bất kỳ API nào khác. - Xử lý việc tắt bắt buộc: Xử lý
kActionRequiredShutdownClientProcessbằng cách tắt quy trình của ứng dụng khách càng sớm càng tốt. - Xử lý các yêu cầu cài đặt Google Play Games: Xử lý
kSdkRuntimeUnavailablebằng cách thông báo cho người dùng rằng họ phải cài đặt Google Play Games và môi trường thời gian chạy SDK để tiếp tục. - Xử lý các bản cập nhật Google Play Games: Xử lý
kSdkRuntimeUpdateRequiredbằng cách thông báo cho người dùng rằng họ cần cập nhật thời gian chạy Google Play Games.
Triển khai Play Billing
- Kiểm tra loại giao dịch mua: Xác nhận rằng trò chơi của bạn chỉ dựa vào giao dịch mua hàng trong ứng dụng, vì các khoản thanh toán định kỳ và gói thuê bao không được hỗ trợ. Để biết thêm thông tin, hãy xem phần Câu hỏi thường gặp về thông tin thanh toán.
- Truy vấn chi tiết sản phẩm: Sử dụng
QueryProductDetailsđể truy xuất dữ liệu cửa hàng đã bản địa hoá. Nếu bạn có hơn 50 sản phẩm, hãy chia yêu cầu thành nhiều lệnh gọi. Để biết thêm thông tin, hãy xem hướng dẫn về sản phẩm truy vấn. - Bắt đầu quy trình mua: Sử dụng
LaunchPurchaseFlowđể xử lý giao dịch theo cách gốc. Lỗi hết thời gian chờ 5 phút sẽ xảy ra nếu bạn đóng trình duyệt thanh toán mà không thanh toán. Để biết thêm thông tin, hãy xem Hướng dẫn về quy trình mua hàng. - Khôi phục các giao dịch mua hiện có: Gọi
QueryPurchaseskhi khởi động và đưa ứng dụng lên nền trước để nắm bắt các giao dịch mua chưa được xác nhận trên nhiều thiết bị. Để biết thêm thông tin, hãy xem Hướng dẫn khôi phục giao dịch mua. - Xử lý phần phụ trợ an toàn: Xác thực
purchaseTokentrên phần phụ trợ của bạn trước khi cấp quyền và hoàn tất bằngAcknowledgePurchasehoặcConsumePurchase. Để biết thêm thông tin, hãy xem Hướng dẫn xử lý an toàn. - Tính đến độ trễ khi truyền khoá cấp phép: Khi định cấu hình khoá thanh toán hoặc khoá cấp phép mới trong Play Console, hãy đợi vài giờ để bộ nhớ đệm phụ trợ đồng bộ hoá trên các môi trường phân phát thương mại trước khi tiến hành kiểm thử giao dịch mua trực tiếp. Nếu bạn cố gắng mua hàng trước khi quá trình đồng bộ hoá hoàn tất, thì hệ thống sẽ trả về Mã lỗi 6.
Kiểm thử ở chế độ nhà phát triển và thực hiện quy trình đảm bảo chất lượng trước khi ra mắt
- Kiểm thử ở chế độ nhà phát triển: Thêm
<IsDeveloperMode>true</IsDeveloperMode>vào tệp kê khai và định cấu hình GUID của đối tác tiếp cận sớm để kiểm thử môi trường phát triển tích hợp (IDE) cục bộ. Nếu bạn chưa có GUID của đối tác tiếp cận sớm, hãy hoàn tất biểu mẫu bày tỏ sự quan tâm. - Quản lý giao dịch mua ở chế độ nhà phát triển: Khi bạn thử nghiệm giao dịch mua ở chế độ nhà phát triển, hãy xử lý giao dịch mua trong vòng 3 phút để tránh tự động hoàn tiền. Để biết thêm thông tin, hãy xem phần Câu hỏi thường gặp về kiểm thử.
- Xoá chế độ nhà phát triển: Bạn phải xoá thẻ
<IsDeveloperMode>càng sớm càng tốt trước khi đóng gói bản phát hành. Để biết thêm thông tin, hãy xem Hướng dẫn về chế độ nhà phát triển. - Chuyển tiếp đối số bằng trình chạy của bên thứ ba: Chuyển tất cả đối số dòng lệnh không xác định mà trình chạy nhận được từ ứng dụng Google Play Games trực tiếp đến quy trình trò chơi được tạo. Để biết thêm thông tin, hãy xem Hướng dẫn về đa quy trình.
- Kiểm thử bằng VPN: Nếu bạn kiểm thử từ một khu vực không được hỗ trợ, hãy sử dụng VPN có bật chế độ TUN để lấy địa chỉ IP được hỗ trợ. Để biết thêm thông tin, hãy xem Câu hỏi thường gặp về việc kiểm thử VPN.
- Hỗ trợ lối tắt trên màn hình: Để được hỗ trợ lối tắt liền mạch, hãy xem phần Câu hỏi thường gặp về lối tắt để biết cách thực thi lối tắt. Việc trực tiếp chạy trò chơi hoặc trình chạy của bên thứ ba bằng lối tắt có thể dẫn đến lỗi khởi chạy.
Đóng gói, kiểm thử và phát hành trò chơi
- Đóng gói WAB: Sử dụng Công cụ xuất bản Play để đóng gói trò chơi của bạn thành một Windows App Bundle (WAB). Tệp WAB phải có kích thước dưới 10 GB đối với tính năng Xuất bản qua trình cài đặt và 200 GB đối với tính năng Xuất bản có quản lý của Play. Để biết thêm thông tin, hãy xem Hướng dẫn đóng gói.
- Sử dụng SDK và công cụ mới nhất: Biên dịch và đóng gói bản phát hành bằng phiên bản mới nhất của SDK Google Play Games trên máy tính, SDK Unity của Google Play Games trên máy tính, công cụ dành cho nhà phát triển Google Play trên máy tính và công cụ xuất bản của Google Play.
- Xác nhận xem có cần nâng cấp hay không: Nếu Trình cài đặt, Trình chạy hoặc Trình gỡ cài đặt của bạn cần được chạy dưới quyền quản trị viên mỗi khi khởi chạy, hãy nhớ kiểm tra xem bạn đã đặt
INSTALLER_REQUIRES_ELEVATION,LAUNCHER_REQUIRES_ELEVATIONhoặcUNINSTALLER_REQUIRES_ELEVATIONthànhtruehay chưa. Nếu không, các dịch vụ này sẽ không chạy với đặc quyền của quản trị viên, dẫn đến lỗi khởi động. Hãy xem Định dạng tệp cấu hình WAB để biết thêm thông tin chi tiết. - Gửi trình cài đặt trình chạy của bên thứ ba: Nếu bạn sử dụng trình chạy của bên thứ ba, hãy gửi trình cài đặt của trình chạy đó trong WAB. Để biết thêm thông tin, hãy xem Hướng dẫn xuất bản trình cài đặt.
- Xử lý mã thông báo phiên Tự động phát: Nếu bạn bật tính năng Tự động phát bằng cách đặt
acceptsCommandLineArguments="true"trongplay_publishing_config.xml, hãy xác minh rằng trình cài đặt của bạn trích xuất đối số dòng lệnh--g_session_token=<token>và sử dụng đối số đó để chạy trò chơi. Đảm bảo trình cài đặt của bạn xử lý trường hợp dự phòng khi không có mã thông báo. Để biết thêm thông tin, hãy xem Câu hỏi thường gặp về Trình chạy. - Cập nhật trò chơi và trình chạy hoặc trình cài đặt: Nội dung gói của bạn, bao gồm cả trình cài đặt trình chạy, phải có khả năng tự cập nhật. Quản lý tất cả tài nguyên mà trò chơi của bạn cần, bao gồm cả việc cập nhật chính trình chạy.
- Chia sẻ thông tin ra mắt với Google: Liên hệ với đối tác Play của bạn và chia sẻ tên gói, quốc gia ra mắt (sử dụng mã ISO gồm 2 ký tự, ví dụ: US, CA, MX) cũng như ngày và giờ ra mắt theo Giờ phối hợp quốc tế (UTC).
- Thiết lập quyền truy cập để thử nghiệm: Cung cấp một nhóm trên Google Groups bên ngoài để thêm vào danh sách cho phép nhằm thử nghiệm, xem tài liệu và truy cập vào Google Drive. Chia sẻ danh sách email của các tài khoản thử nghiệm với đối tác Play của bạn, vì Kênh thử nghiệm của Play Console không hỗ trợ máy tính.
- Thêm hệ số hình dạng máy tính: Thêm rõ ràng hệ số hình dạng "Google Play Games trên máy tính" vào ứng dụng của bạn trong Google Play Console. Nếu bạn không truy cập được vào thẻ này, hãy liên hệ với đối tác Play để thêm tài khoản của bạn vào danh sách cho phép.
- Định cấu hình yêu cầu về máy tính: Nhập các yêu cầu về phần cứng (RAM, GPU, dung lượng lưu trữ) cho máy tính Windows. Để biết thêm thông tin, hãy xem hướng dẫn về yêu cầu đối với máy tính.
- Tải thành phần lên cửa hàng: Tải tệp WAB đã đóng gói lên Kênh phát hành công khai và định cấu hình thành phần hình ảnh. Để biết thêm thông tin, hãy xem Hướng dẫn tải thành phần lên.
- Phát hành để kiểm thử môi trường người dùng: Chọn Phát hành trong Google Play Console. Không giống như phiên bản Android, việc chọn Xuất bản trên WAB không kích hoạt bản phát hành công khai. Thay vào đó, việc này giúp các tài khoản thử nghiệm mà bạn chia sẻ có thể tìm thấy ứng dụng để tiến hành thử nghiệm trong môi trường người dùng sau quy trình xem xét của Google.
- Ra mắt chính thức: Google kiểm soát việc ra mắt dựa trên ngày ra mắt chính thức mà bạn đã chia sẻ với đối tác Play.
- Thử nghiệm trong giai đoạn đăng ký trước: Trong giai đoạn đăng ký trước, bạn phải tiến hành thử nghiệm nội bộ ở một quốc gia không thuộc các khu vực đăng ký trước mà bạn đã chọn.
- Xác minh việc chấm dứt quy trình cài đặt: xác nhận rằng quy trình cài đặt chính vẫn hoạt động cho đến khi tất cả khoá đăng ký bắt buộc được tạo và đăng ký. Nếu quá trình này thoát sớm, thì quá trình xác minh cài đặt sẽ không thành công. Để biết thêm thông tin, hãy xem bài viết Xuất bản trình cài đặt.
- Duy trì các nhánh sổ đăng ký nhất quán và dọn dẹp khi gỡ cài đặt:
Google Play Games trên máy tính kiểm tra
HKEY_LOCAL_MACHINEtrướcHKEY_CURRENT_USERvà sử dụng giá trị khớp đầu tiên. Giữ cho cấu trúc tổ chức của sổ đăng ký nhất quán giữa các bản cập nhật và các tựa game dùng chung trình chạy, đồng thời xoá các khoá đăng ký trong quá trình gỡ cài đặt để các mụcHKEY_LOCAL_MACHINEcũ không che khuất các đường dẫnHKEY_CURRENT_USERhợp lệ. Để biết thêm thông tin, hãy xem bài viết Xuất bản trình cài đặt.
Di chuyển từ API sang SDK
Việc di chuyển từ API sang SDK là một bước không bắt buộc. Nếu bạn chọn di chuyển, hãy làm theo các đề xuất sau:
- Xoá API REST cũ: Liên kết các lệnh gọi API Nhà phát triển Google Play cũ (ví dụ:
purchases.products.get) với các hàm SDK gốc phía máy khách. Để biết thêm thông tin, hãy xem Hướng dẫn di chuyển. - Xác minh đối số dòng lệnh: Đối số dòng lệnh trong môi trường SDK có thể khác với đối số trong môi trường API. Xác minh rằng gói của bạn xử lý và truyền tất cả đối số một cách chính xác. Để biết thêm thông tin, hãy xem phần Xác minh.
- Xác minh đường dẫn sổ đăng ký: Để di chuyển liền mạch sang SDK gốc, cấu hình sổ đăng ký phải nhất quán với các phiên bản trước. Để biết thêm thông tin, hãy xem hướng dẫn về tệp WAB.