Câu hỏi thường gặp

Tài liệu này giải đáp các câu hỏi thường gặp về SDK và việc phát hành cho Google Play Games trên máy tính.

Kiếm tiền

  1. Tại sao quy trình mua của tôi không thành công và có Mã lỗi 6 sau khi thêm khoá cấp phép hoặc khoá thanh toán mới?

    Các khoá cấp phép mới được tạo trong Google Play Console sẽ bị trễ nhiều giờ do quá trình lưu vào bộ nhớ đệm và truyền tải trong phần phụ trợ thương mại trước khi bộ nhớ đệm nội bộ của Google Play đồng bộ hoá trên tất cả môi trường phân phát. Mặc dù ứng dụng trò chơi của bạn có thể truy vấn chi tiết sản phẩm thành công, nhưng các yêu cầu mua hàng sẽ không thành công và trả về Mã lỗi 6 cho đến khi quá trình đồng bộ hoá hoàn tất. Hãy chờ vài giờ sau khi tải lên hoặc cập nhật khoá cấp phép trước khi thử nghiệm giao dịch mua.

  2. Tôi có thể sử dụng quy trình mua mà không cần máy chủ phụ trợ không?

    Xét ở góc độ bảo mật, Google khuyên bạn nên sử dụng máy chủ phụ trợ.

    Để biết thêm thông tin, hãy xem phần Xử lý mà không cần máy chủ phụ trợ.

  3. Sau khi tích hợp SDK Google Play Games trên máy tính, tôi có được phép sử dụng các hệ thống thanh toán hiện có dựa trên API không?

    Tất cả các khoản thanh toán phải được xử lý bằng SDK Google Play Games trên máy tính thông qua Google Play Billing. Bạn không thể sử dụng phương thức thanh toán dựa trên API hiện có trong cùng một trò chơi.

  4. Làm cách nào để sử dụng giao dịch mua ở chế độ nhà phát triển?

    Xử lý giao dịch mua ở chế độ nhà phát triển trong vòng 3 phút, nếu không, giao dịch mua sẽ được hoàn tiền.

  5. Có hỗ trợ thanh toán định kỳ hoặc gói thuê bao không?

    Chúng tôi chưa có kế hoạch cho việc này trong tương lai gần, nhưng bạn có thể cung cấp các trường hợp sử dụng cụ thể để chúng tôi thêm vào lộ trình trong tương lai.

  6. Lỗi thanh toán trong cuộc gọi mua hàng của tôi là gì?

    BillingError là phản hồi của kết quả thanh toán. LaunchPurchaseFlow sẽ trả về ngay lập tức mà không chặn, nhưng bạn phải nghe lệnh gọi lại để biết thời điểm hoàn tất và ghi lại kết quả.

  7. Làm cách nào để sử dụng tính năng xác minh giao dịch mua phía máy khách?

    Bạn nên sử dụng quy trình mua hàng và xác minh phía máy chủ. Để xử lý giao dịch mua từ ứng dụng khách, trò chơi của bạn phải nằm trong danh sách cho phép. Vui lòng liên hệ với Đối tác của Google nếu trò chơi của bạn cần quyền truy cập. Để biết thêm thông tin, hãy xem phần Xử lý mà không cần máy chủ phụ trợ.

  8. Hạn mức API để truy vấn thông tin chi tiết về sản phẩm là gì?

    Số lượng sản phẩm tối đa có thể truy vấn trong một lệnh gọi đến API QueryProductDetails là 50. Nếu vượt quá giới hạn này, bạn phải chia yêu cầu thành nhiều lệnh gọi.

  9. Tại sao truy vấn sản phẩm hoặc quy trình mua hàng không thành công do lỗi nội bộ khi tải nhiều SKU sản phẩm?

    Việc truy vấn quá nhiều SKU sản phẩm cùng một lúc hoặc gọi QueryProductDetails trong C++ hoặc QueryProductDetailsAsync trong Unity liên tiếp quá nhiều lần trong một khoảng thời gian ngắn (ví dụ: gửi hàng chục lệnh gọi theo lô trong một vòng lặp hẹp hoặc tạo một thực thể BillingClient mới cho mỗi lô) có thể làm quá tải các kết nối IPC và phần phụ trợ cục bộ. Khi các kết nối đó đặt lại, truy vấn chi tiết sản phẩm sẽ không thành công và trò chơi của bạn không thể lấy mã thông báo ưu đãi cần thiết để bắt đầu quy trình mua.

    Để tránh những lỗi này khi tải danh mục lên, hãy làm theo các phương pháp sau:

    • Tuân thủ số lượng sản phẩm được hỗ trợ cho mỗi lệnh gọi: Truy vấn không quá 50 sản phẩm trong một lệnh gọi QueryProductDetails hoặc QueryProductDetailsAsync, đồng thời lưu ProductDetails được trả về vào bộ nhớ đệm thay vì truy vấn lại toàn bộ danh mục nhiều lần. Để biết thêm thông tin về giới hạn lô được hỗ trợ và truy vấn thông tin chi tiết về sản phẩm, hãy xem câu hỏi về giới hạn API trước đó, Hiển thị sản phẩm có thể mua cho C++ và Truy vấn thông tin chi tiết về sản phẩm cho Unity.
    • Tránh gọi API liên tiếp quá nhiều lần trong một khoảng thời gian ngắn: Đừng gửi nhiều lô truy vấn sản phẩm cùng lúc hoặc liên tiếp mà không có khoảng nghỉ. Sử dụng lại một thực thể BillingClient duy nhất, chuyển đổi tuần tự các yêu cầu hoặc giới hạn đồng thời ở hai hoặc ba lệnh gọi đang diễn ra cùng một lúc và thêm một khoảng thời gian trễ ngắn giữa các lô liên tiếp.
    • Cập nhật lên SDK mới nhất: Cập nhật bản tích hợp của bạn lên bản phát hành SDK Google Play Games trên máy tính mới nhất, phiên bản 26.9.261.0 cho C++ hoặc 26.9.261.0 cho Unity, từ trang Tải SDK Google Play Games trên máy tính xuống để đảm bảo ứng dụng của bạn có các điểm cải tiến mới nhất về tính ổn định của IPC và tính năng thanh toán.
  10. Cần có những tham số nào khi gọi Query Purchases (Truy vấn giao dịch mua) hoặc Launch Purchase Flow (Chạy quy trình mua) trong Billing Client?

    Hàm này chấp nhận QueryPurchasesContinuation, là một lệnh gọi lại hàm có chữ ký std::function<void(QueryPurchasesResult)>. Lệnh gọi lại sẽ chuyển kết quả cho bạn cùng với tất cả ProductPurchaseDetails. Thông tin này có trong các tệp tiêu đề SDK trong tệp includes/billing/models.h.

    launch_purchase_flow_result thu được có các hàm ok() và code(). Hàm ok() trả về kết quả cho biết quy trình có thành công hay không. Hàm code() trả về enum BillingError (includes/billing/enums.h), có 10 trường hợp lỗi có thể xảy ra, chẳng hạn như người dùng đã huỷ hoặc lỗi mạng.

  11. Thư viện Billing Client có hỗ trợ thứ tự tuỳ chỉnh cho quy trình mua hàng không?

    Trong thiết kế SDK hiện tại, không có cách nào để truyền tải trọng của riêng bạn. Tuy nhiên, bạn có thể cung cấp bất kỳ tổ hợp obfuscated_account_id và obfuscated_profile_id nào. Bạn có thể không cung cấp, chỉ cung cấp một hoặc cung cấp cả hai.

    Trường offer_token là bắt buộc và chỉ định ưu đãi mua hàng mà người dùng đang cố gắng mua trong quy trình thanh toán. Hiện tại, mỗi SKU trong Google Play chỉ có đúng một ưu đãi (ví dụ: mua một mặt hàng với giá 10 USD). Trong tương lai, nhóm Google Play Billing sẽ hỗ trợ nhiều ưu đãi.

    Để đảm bảo liên kết siêu dữ liệu trong trường hợp gián đoạn quy trình mua, hãy lưu trữ siêu dữ liệu trên máy chủ phụ trợ trước khi khởi chạy hộp thoại giao dịch mua và liên kết siêu dữ liệu đó với mã tài khoản của người dùng, SKU đang được mua và dấu thời gian hiện tại. Để biết thêm thông tin, hãy xem phần Liên kết giao dịch mua với dữ liệu nội bộ.

  12. Điều kiện tiên quyết để chuyển từ hệ thống thanh toán của Google có OAuth sang hệ thống thanh toán của Google dựa trên DLL là gì?

    Trò chơi có thể tiếp tục sử dụng tính năng đăng nhập OAuth bằng Google để quản lý tài khoản đã đăng nhập, nhưng Google khuyên bạn nên ngừng sử dụng các API thanh toán REST cũ. Việc chuyển từ API thanh toán REST (có đăng nhập OAuth2) sang quy trình SDK có thể là một thao tác được gắn cờ tính năng, vì vậy, cả hai có thể cùng tồn tại trong một khoảng thời gian trong khi trò chơi chuyển đổi.

  13. Lệnh gọi API Launch Purchase Flow (Bắt đầu quy trình mua) có được xử lý thông qua trình duyệt web không?

    Không, quy trình mua hiện được hoàn tất hoàn toàn trong trò chơi bằng cách sử dụng lớp phủ WebView liền mạch mà không cần rời khỏi ứng dụng trò chơi.

  14. Người dùng có cần đăng nhập riêng cho từng trò chơi để mua hàng không?

    Tài khoản trên nền trước trong Google Play Games được dùng cho mỗi phiên trò chơi, vì vậy, bạn không cần phải đăng nhập lại. Tài khoản mà bạn sử dụng trong Google Play Games khi phiên trò chơi bắt đầu là tài khoản mà các lệnh gọi API được thực hiện. Quy trình mua sẽ tự động sử dụng tài khoản này.

  15. Một trò chơi có thể hỗ trợ cả SDK dành cho máy tính và hệ thống thanh toán cũ cùng một lúc không?

    Hệ thống thanh toán hoạt động theo mô hình luồng kép, tuỳ thuộc vào phiên bản nhị phân của trò chơi. Người dùng các bản dựng cũ tiếp tục sử dụng quy trình hiện có, còn người dùng các bản dựng mới chuyển sang thanh toán dựa trên SDK. Người dùng trên cả hai quy trình thanh toán cùng tồn tại trong giai đoạn chuyển đổi.

Windows App Bundle

  1. Khi gửi WAB bằng trình chạy của bên thứ ba, tôi có cần gửi gói trò chơi để xem xét không?

    Bạn chỉ cần gửi trình cài đặt mà không cần gửi toàn bộ gói trò chơi. Người đánh giá sẽ có thể tải gói trò chơi của bạn xuống bằng trình cài đặt.

  2. Có giới hạn nào về kích thước tệp WAB không?

    Đối với tính năng Xuất bản trình cài đặt, bạn có thể tải tệp WAB có kích thước lên đến 10 GB lên. Đối với tính năng Xuất bản có quản lý của Play, giới hạn kích thước tệp WAB tối đa là 200 GB.

  3. Tại sao trò chơi của tôi không cài đặt hoặc không xuất hiện sau khi tôi tải WAB lên?

    Nếu trò chơi của bạn đang được tham gia mà không có phiên bản PC hiện có ("WAB lần đầu"), thì hệ thống có thể tự động đưa trò chơi đó vào trạng thái giữ lại Xuất bản có quản lý. Điều này xảy ra vì không có đường cơ sở hiện tại để cập nhật. Để phát hành đầy đủ WAB và cung cấp trò chơi để cài đặt, bạn phải chuyển đến Google Play Console và thực hiện thao tác phát hành bắt buộc theo cách thủ công (ví dụ: nhấp vào "Phát hành thay đổi").

  4. Làm cách nào để tải WAB lên cho mục đích thử nghiệm nội bộ?

    Chia sẻ các tài khoản trong danh sách cho phép với Google để Google có thể bật các tài khoản đó cho hoạt động thử nghiệm nội bộ. Sau khi có danh sách, Google sẽ đảm bảo rằng họ được đưa vào quy trình làm quen.

  5. Tôi nên tải gói WAB lên đâu?

    Bạn có thể tải gói WAB lên tại vị trí được đề cập trong câu hỏi đầu tiên. Tuy nhiên, bạn không thể xuất bản theo cách thủ công. Bạn phải cung cấp cho nhân viên phụ trách phần phụ trợ của Google thời gian chính xác theo giờ UTC (đến từng giờ). Sau đó, Google sẽ định cấu hình lịch phát hành và đảm bảo lịch phát hành được xuất bản đúng hạn.

SDK cho máy tính

  1. API cũ và SDK Google Play Games trên máy tính có gì khác biệt?

    • API cũ chỉ cung cấp chức năng thanh toán.
    • SDK cho máy tính hỗ trợ Google Desktop Service (GDS) và các tính năng đầy đủ cho máy tính.
    • Bạn không cần phải đăng nhập bằng Google trên trình duyệt khi dùng SDK cho máy tính.
  2. Có cách nào khác để khởi chạy SDK bằng cách trực tiếp khởi chạy trò chơi thông qua trình chạy trò chơi mà không cần thông qua Google Play Games trên máy tính không?

    Trò chơi của bạn phải được chạy thông qua ứng dụng Google Play Games trên máy tính. Để biết thêm thông tin, hãy tham khảo tài liệu dành cho nhà phát triển này.

  3. SDK PC có hỗ trợ các ký tự nhiều byte trong tệp chứng chỉ PEM không?

    Có, SDK hỗ trợ các ký tự nhiều byte để chứng nhận.

  4. SDK xử lý việc đăng nhập vào Tài khoản Google cho nhiều phiên bản hoặc tài khoản như thế nào?

    Mỗi lần chạy trò chơi trong Google Play Games được coi là một "phiên trò chơi" và mỗi "phiên trò chơi" có thể có một tài khoản được liên kết với phiên đó. Chúng có thể khác nhau. Vì vậy, nếu bạn chạy trò chơi bằng tài khoản A, sau đó chuyển sang tài khoản B và chạy lại, thì cả hai đều có thể chạy cùng một lúc.

  5. Tính năng tích hợp Play Install Referrer có hoạt động với SDK dành cho máy tính không?

    SDK PC (phiên bản 25.5.409.0 trở lên) hỗ trợ API Play Install Referrer. Để biết thêm thông tin, hãy xem bài viết Play Install Referrer API.

Súng phóng lựu

  1. Nếu người chơi sử dụng trình chạy của bên thứ ba thay vì ứng dụng Google Play, thì tài khoản Dịch vụ trò chơi của Play của họ có tự động đồng bộ hoá không?

    Để các hàm SDK hoạt động, trò chơi phải được chạy trực tiếp thông qua ứng dụng Google Play Games. Nếu một quy trình khác (chẳng hạn như trình cài đặt hoặc ứng dụng trình chạy) khởi động trò chơi, thì chính quy trình đó phải được khởi chạy từ ứng dụng Google Play Games. Trò chơi phải truyền tất cả tham số nhận được từ ứng dụng đến quy trình ứng dụng.

  2. Làm cách nào để xử lý quá trình khởi chạy nếu Google Play Games khởi chạy một trình chạy trò chơi của bên thứ ba?

    Bạn không bắt buộc phải tích hợp SDK trực tiếp vào trình chạy của mình. Tuy nhiên, bạn phải truyền tất cả đối số dòng lệnh mà trình chạy nhận được từ ứng dụng Google Play Games trực tiếp đến quy trình con được tạo (tệp thực thi trò chơi). Nếu quá trình khởi chạy không thành công (ví dụ: bằng cách trả về kActionRequiredShutdownClientProcess), thì tất cả các quy trình (bao gồm cả trình chạy) phải được chấm dứt để Google Play Games có thể tự động khôi phục và chạy lại trò chơi. Để biết thêm thông tin, hãy xem Bước 5 trong hướng dẫn thiết lập.

  3. Làm cách nào để xử lý các bản cập nhật và bảo trì cho trò chơi và trình chạy sau khi phát hành công khai?

    Các bản cập nhật và bảo trì tiếp theo phải được triển khai thông qua trình chạy của bạn. Ứng dụng Google Play Games không hỗ trợ các chức năng cập nhật, vì vậy, trình chạy phải có khả năng cập nhật cả trò chơi và chính trình chạy đó.

  4. Làm cách nào để trình cài đặt nhận được mã phiên GPG cho tính năng Tự động phát?

    GPG truyền mã phiên bằng đối số dòng lệnh --g_session_token=<token> đến trình cài đặt. Để bật tính năng này, bạn phải đặt acceptsCommandLineArguments="true" trong play_publishing_config.xml.

    Trình cài đặt chịu trách nhiệm trích xuất mã thông báo này và sử dụng mã thông báo đó để chạy trò chơi. Nếu không tạo được mã thông báo, GPG sẽ chạy trình cài đặt mà không có mã thông báo (dự phòng).

Khởi chạy

  1. Khi tôi bắt đầu chơi một trò chơi bằng ứng dụng Google Play Games, ứng dụng này có đồng bộ hoá thông tin chi tiết về Tài khoản Google của tôi không?

    Sau khi khởi chạy trò chơi thông qua ứng dụng Google Play Games, tài khoản sẽ tự động được đồng bộ hoá và bạn không cần phải đăng nhập lại thông qua quy trình Đăng nhập bằng Google.

  2. Có thể sử dụng lại các tham số khởi chạy nhiều lần không?

    Bạn có thể thực hiện việc này miễn là ứng dụng Google Play Games đang chạy và thông tin đăng nhập là hợp lệ. Tuy nhiên, trong các trường hợp như trường hợp được mô tả trong hướng dẫn, tất cả các quy trình do trò chơi khởi chạy phải được chấm dứt khi người dùng đóng trò chơi hoặc trò chơi thoát do lỗi khởi chạy SDK, chẳng hạn như kActionRequiredShutdownClientProcess.

  3. Có cách nào để tạo lối tắt mở trực tiếp trò chơi không?

    Bạn có thể sử dụng URI sau để mở trực tiếp trò chơi:

    googleplaygames://launch/?pid=2&id=com.company.gamename

    URI hỗ trợ phát hiện xem ứng dụng Google Play Games trên máy tính có được mở hay không. Nếu ứng dụng chưa mở, ứng dụng Google Play Games sẽ mở trước khi trò chơi hoặc trình chạy chạy. Bạn cần quản lý trò chơi hoặc trình chạy để ngăn nhiều thực thể chạy.

  4. Có cách nào để xác minh việc cài đặt Google Play Games trên máy tính mà không cần sử dụng SDK không?

    Bạn có thể xác minh trạng thái cài đặt của Google Play Games trên máy tính mà không cần tích hợp SDK bằng cách kiểm tra xem có khoá Windows Registry sau đây hay không:

    HKEY_LOCAL_MACHINE\SOFTWARE\Google\Play Games Services

    Sự hiện diện của khoá này cho biết rằng các dịch vụ trò chơi của Google Play (bắt buộc để chạy trò chơi trên máy tính) đã được cài đặt trên máy. Nếu thiếu khoá này, bạn nên chuyển người dùng đến trang cài đặt Google Play Games trên máy tính để tải xuống và cài đặt ứng dụng.

Thử nghiệm

  1. Có môi trường thử nghiệm công khai hoặc thử nghiệm khép kín nào tương tự như thiết bị di động không?

    Mặc dù không có hộp cát toàn diện chuyên dụng, nhưng chúng tôi nhận thấy nhu cầu về một môi trường thử nghiệm giống như môi trường thực tế cho nhà phát triển. Chúng tôi sẽ sớm cung cấp một giải pháp hiệu quả hơn.

  2. Làm cách nào để thêm người thử nghiệm mới?

    Người liên hệ của bạn tại Google sẽ tạo một nhóm email cho mỗi dự án PC, trong đó bạn phải thêm Tài khoản Google của người kiểm thử. Chỉ những thành viên của nhóm email này mới được phép tải các gói thử nghiệm xuống trong Google Play Games.

Khác

  1. Tôi có thể sử dụng VPN không?

    Đối với những nhà phát triển cần thử nghiệm trò chơi ở khu vực không hỗ trợ Google Play Games trên máy tính, bạn nên sử dụng VPN để lấy địa chỉ IP từ một khu vực được hỗ trợ.

    Đảm bảo rằng bạn bật chế độ TUN trên VPN. Bạn có thể xem hướng dẫn về cách bật chế độ TUN và định cấu hình tường lửa trong hướng dẫn sử dụng của nhà cung cấp VPN.

    Sau khi bật chế độ TUN, hãy cài đặt Google Play Games trên máy tính và trình mô phỏng để thử nghiệm.

  2. Làm cách nào để bắt đầu phát triển cho Google Play Games trên máy tính trong Unity hoặc Trình chỉnh sửa UE?

  3. Làm cách nào để sử dụng khoá đăng ký đúng cách?

    Bạn nên tạo khoá sổ đăng ký dựa trên hive gốc. Bạn có thể đặt hive gốc là HKEY_LOCAL_MACHINE hoặc HKEY_CURRENT_USER tuỳ thuộc vào mục đích và bản chất của dữ liệu. Tổ ong HKEY_LOCAL_MACHINE được dùng làm ví dụ trong nguyên tắc.

  4. Google có những yêu cầu gì khi xem xét gói dành cho máy tính?

    Các gói dành cho máy tính sẽ được quét phần mềm độc hại, sau đó, nhân viên đánh giá chỉ kiểm tra quá trình cài đặt, khởi động thành công và gỡ cài đặt trò chơi.

  5. Có cần tích hợp tất cả API không?

    Các API khác không bắt buộc nhưng mang lại nhiều lợi ích khác. google::play::billing là bắt buộc đối với giao dịch mua hàng trong ứng dụng và bán nội dung kỹ thuật số. google::play::install_referrer là cần thiết để theo dõi dữ liệu giới thiệu, giúp bạn hiểu được nguồn lưu lượng truy cập nào gửi nhiều người dùng nhất đến tải ứng dụng của bạn xuống. google::play::games::integrity là cần thiết để bảo vệ ứng dụng của bạn khỏi các đối tượng xấu bằng cách phát hiện các thiết bị có thể gặp rủi ro và trình mô phỏng không xác định.

  6. Tại sao một số quy trình trò chơi bị chấm dứt khi ứng dụng Google Play Games đóng, trong khi một số quy trình khác thì không?

    Google không kiểm soát các quy trình phụ hoặc quy trình của trò chơi đang chạy. Hành vi này phụ thuộc vào việc trò chơi đó là trò chơi Android được mô phỏng hay trò chơi trên máy tính. Trò chơi mô phỏng được cài đặt trong môi trường riêng, vì vậy, hành vi của trò chơi phụ thuộc phần lớn vào quá trình khởi chạy và tắt trình mô phỏng.

  7. Tôi nên sử dụng chức năng gỡ cài đặt của Google Play Games hay trình gỡ cài đặt tuỳ chỉnh?

    Google khuyên bạn nên sử dụng chức năng gỡ cài đặt Google Play Games.

Thông tin hỗ trợ khác

Nếu bạn cần được trợ giúp thêm về vấn đề không có trong phần Câu hỏi thường gặp này, vui lòng liên hệ theo địa chỉ google-play-games-pc@google.com