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 trực tiếp gọi các API Thanh toán của Play, thì bạn phải di chuyển trò chơi đó để sử dụng SDK dành cho máy tính.

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. Hãy tham khảo các dự án mẫu minh hoạ những ví dụ có thể dùng để di chuyển trò chơi gốc 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 SDK gốc của Google Play Games trên máy tính.

Đối số dòng lệnh

SDK gốc của Google Play Games trên máy tính 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 SDK Khởi chạy. 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 vào 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

Đă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 cú nhấp chuột 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 các 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ì Đăng nhập bằng Google, hãy gọi Khởi chạy SDK càng sớm càng tốt. Hãy hành động theo mã lỗi để cung cấp một môi trường an toàn cho thời gian chạy của trò chơi.

Tải 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 điểm cuối API Nhà phát triển Play inappproduct.gets.

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

Tải giao dịch mua

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

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

Bắt đầu quy trình mua

Trong giải pháp API, việc bắt đầu quy trình mua đòi hỏi 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 bắt đầu quy trình bằng cách gọi hàm BillingClient's LaunchPurchaseFlow. SDK sẽ xử lý tất cả công việc cần thiết.

Xử lý giao dịch mua

Việc xử lý giao dịch mua của người dùng bao gồm việc xác nhận và tiêu thụ 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ợ để xác minh.

Sau khi được xác minh, phần phụ trợ có thể xác nhận hoặc tiêu thụ 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 để kiểm thử, hãy làm theo các bước sau.

Đóng gói để gửi

Các trò chơi sử dụng SDK 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 Windows App Bundle cho: