Di chuyển API sang SDK

Nếu trò chơi gốc của bạn trên Google Play Games trên máy tính gọi trực tiếp API Play Billing, thì bạn phải di chuyển trò chơi của mình để sử dụng PC SDK.

Tuỳ thuộc vào công cụ phát triển trò chơi mà bạn đang sử dụng, bạn có thể tích hợp C++ SDK hoặc C# SDK. Tham khảo các dự án mẫu minh hoạ các ví dụ có thể dùng để di chuyển trò chơi gốc của bạn sang SDK.

Thiết lập và chuẩn bị

Phần này mô tả các bước di chuyển từ một giải pháp dựa trên API sang Google Play Games trên máy tính Native SDK.

Đối số dòng lệnh

Google Play Games trên máy tính Native SDK dựa vào một số đối số dòng lệnh được truyền vào trong quá trình khởi động trò chơi để xác thực người dùng. Bạn cần truyền các đối số này vào quy trình gọi Initialize SDK. Nếu quá trình khởi động trò chơi của bạn liên quan đến nhiều quy trình, thì bạn phải xác minh rằng tất cả các đối số đều được truyền đến quy trình cuối cùng sử dụng SDK. Hãy xem bước Hỗ trợ nhiều quy trình trò chơi trong quá trình thiết lập.

Liên kết API

Để hoàn tất quá trình di chuyển, bạn cần xoá tất cả các lệnh gọi API trực tiếp đến máy chủ Play. Có các lệnh gọi hàm tương ứng trong SDK để đạt được chức năng tương tự. Phần này liệt kê mối liên kết cho từng chức năng.

Đăng nhập bằng Google

Tính năng Đăng nhập bằng Google (còn gọi là Đăng nhập bằng Google) là một phương thức xác thực OAuth, cung cấp lựa chọn xác thực bằng một lần nhấp cho người dùng có Tài khoản Google. Trong các dự án dựa trên API, bạn sẽ liên kết tài khoản của người chơi với giao dịch mua của họ. Các giải pháp dựa trên SDK không yêu cầu mối liên kết này.

Các giải pháp dựa trên SDK sử dụng Tài khoản Google của ứng dụng Google Play Games đã được liên kết với Hồ sơ người chơi và các quyền của người chơi. Điều này mang lại trải nghiệm liền mạch hơn cho người chơi và môi trường an toàn hơn cho nhà phát triển vì SDK có thể giao tiếp an toàn với ứng dụng Google Play Games thông qua IPC.

Thay vì sử dụng tính năng Đăng nhập bằng Google, hãy gọi Khởi chạy SDK càng sớm càng tốt. Xử lý mã lỗi cho phù hợp để cung cấp một môi trường an toàn cho thời gian chạy của trò chơi.

Lấy danh sách sản phẩm

Trong giải pháp API, máy chủ phụ trợ của bạn sẽ truy xuất danh sách sản phẩm bằng cách sử dụng điểm cuối inappproduct.gets của API Nhà phát triển Play.

Trong SDK, hãy truy xuất danh sách sản phẩm trong ứng dụng ngay trên ứng dụng bằng hàm QueryProductDetails.

Mua hàng

Trong giải pháp API, máy chủ phụ trợ của bạn truy xuất giao dịch mua của người dùng bằng cách sử dụng điểm cuối purchases.products.get của Play Developer API.

Trong SDK, hãy sử dụng trực tiếp hàm QueryPurchases từ ứng dụng trò chơi của bạn.

Bắt đầu quy trình mua

Trong giải pháp API, việc khởi chạy quy trình mua hàng yêu cầu bạn phải gọi nhiều điểm cuối để thiết lập và lấy các mã thông báo cần thiết.

Trong SDK, hãy khởi chạy quy trình bằng cách gọi hàm LaunchPurchaseFlow của BillingClient. SDK sẽ xử lý mọi công việc cần thiết.

Xử lý giao dịch mua

Xử lý giao dịch mua của người dùng bao gồm việc xác nhận và sử dụng giao dịch mua sau khi xác thực thành công rằng giao dịch đó là hợp lệ. Cả giải pháp API và giải pháp SDK đều đề xuất các bước cần hoàn tất từ phần phụ trợ của bạn vì mục đích bảo mật.

Quy trình này tương tự cho cả giải pháp API và giải pháp SDK:

Sau khi truy xuất purchaseToken từ giao dịch mua, chẳng hạn như ProductPurchase.purchaseToken trong giải pháp API hoặc ProductPurchaseDetails's purchase_token trong giải pháp SDK, hãy gửi mã này đến phần phụ trợ của bạn để xác minh.

Sau khi xác minh, phần phụ trợ của bạn có thể xác nhận hoặc sử dụng giao dịch mua một cách an toàn sau khi cấp quyền.

Gửi để kiểm thử

Để gửi trò chơi của bạn đi kiểm thử, hãy làm theo các bước sau.

Gói để gửi

Trò chơi sử dụng SDK này phải được đóng gói ở định dạng Windows App Bundle và tải lên thông qua Play Console. Tham khảo tài liệu để đóng gói trò chơi của bạn trong Gói ứng dụng Windows cho: