Migrasi API ke SDK

Jika game Native Google Play Game di PC Anda memanggil Play Billing API secara langsung, Anda harus memigrasikan game untuk menggunakan PC SDK.

Bergantung pada game engine yang Anda gunakan, Anda dapat mengintegrasikan C++ SDK atau C# SDK. Lihat project contoh yang menunjukkan contoh yang dapat digunakan untuk memigrasikan game Native Anda ke SDK.

Penyiapan dan persiapan

Bagian ini menjelaskan langkah-langkah migrasi dari solusi berbasis API ke SDK Native Google Play Game di PC.

Argumen command line

Google Play Game di PC Native SDK mengandalkan beberapa argumen command-line yang diteruskan selama startup proses game Anda untuk mengautentikasi pengguna. Argumen ini perlu diteruskan ke proses yang memanggil Initialize SDK. Jika startup game Anda melibatkan beberapa proses, Anda harus memverifikasi bahwa semua argumen diteruskan ke proses yang pada akhirnya menggunakan SDK. Lihat langkah Mendukung multi-proses game dalam penyiapan.

Pemetaan API

Untuk menyelesaikan migrasi, Anda harus menghapus semua panggilan API langsung ke server Play. Ada panggilan fungsi yang sesuai di SDK untuk mencapai fungsionalitas yang sama. Bagian ini mencantumkan pemetaan untuk setiap fungsi.

Login dengan Google

Login dengan Google, juga dikenal sebagai Login dengan Google, adalah metode autentikasi OAuth yang menyediakan opsi autentikasi sekali klik bagi pengguna dengan Akun Google mereka. Dalam project berbasis API, Anda mengaitkan akun pemain dengan pembeliannya. Solusi berbasis SDK tidak memerlukan pengaitan ini.

Solusi berbasis SDK menggunakan Akun Google klien Google Play Game yang sudah dikaitkan dengan Profil Gamer dan hak pemain. Hal ini memberikan pengalaman yang lebih lancar bagi pemain dan lingkungan yang lebih aman bagi developer karena SDK dapat berkomunikasi secara aman dengan klien Google Play Game melalui IPC.

Daripada Login dengan Google, panggil Initialize SDK sesegera mungkin. Tindaki kode error yang sesuai untuk menyediakan lingkungan yang aman bagi runtime game Anda.

Mendapatkan daftar produk

Dalam solusi API, server backend Anda mengambil daftar produk menggunakan endpoint Play Developer API inappproduct.gets.

Di SDK, ambil daftar produk dalam aplikasi langsung di klien menggunakan fungsi QueryProductDetails.

Mendapatkan pembelian

Dalam solusi API, server backend Anda mengambil pembelian pengguna menggunakan endpoint Play Developer API purchases.products.get.

Di SDK, gunakan fungsi QueryPurchases langsung dari klien game Anda.

Meluncurkan alur pembelian

Dalam solusi API, peluncuran alur pembelian memerlukan panggilan beberapa endpoint untuk penyiapan dan mendapatkan token yang diperlukan.

Di SDK, luncurkan proses dengan memanggil fungsi LaunchPurchaseFlow BillingClient. SDK menangani semua tugas yang diperlukan.

Memproses pembelian

Memproses pembelian pengguna melibatkan pengonfirmasi dan penggunaan pembelian setelah berhasil memvalidasi bahwa pembelian tersebut sah. Solusi API dan solusi SDK merekomendasikan langkah-langkah yang harus diselesaikan dari backend Anda untuk tujuan keamanan.

Prosesnya serupa untuk solusi API dan solusi SDK:

Setelah mengambil purchaseToken dari pembelian, seperti ProductPurchase.purchaseToken di solusi API atau ProductPurchaseDetails's purchase_token di solusi SDK, kirimkan ke backend Anda untuk verifikasi.

Setelah diverifikasi, backend Anda dapat mengonfirmasi atau menggunakan pembelian dengan aman setelah memberikan hak.

Mengirimkan untuk pengujian

Untuk mengirimkan game Anda untuk pengujian, ikuti langkah-langkah berikut.

Paket untuk pengiriman

Game yang menggunakan SDK harus dikemas dalam format Windows App Bundle dan diupload melalui Konsol Play. Lihat dokumentasi untuk mengemas game Anda di Windows App Bundle untuk: