Dokumen ini menjawab pertanyaan umum tentang SDK dan publikasi untuk Google Play Game di PC.
Monetisasi
Mengapa alur pembelian saya gagal dengan Kode Error 6 setelah menambahkan kunci penagihan atau kunci lisensi baru?
Kunci lisensi yang baru dibuat di Konsol Google Play mengalami penundaan caching dan propagasi selama beberapa jam di backend perdagangan sebelum cache internal Google Play disinkronkan di semua lingkungan penayangan. Meskipun klien game Anda dapat berhasil mengkueri detail produk, permintaan pembelian akan gagal dengan Kode Error 6 hingga sinkronisasi selesai. Tunggu beberapa jam setelah mengupload atau memperbarui kunci pemberian lisensi sebelum menguji pembelian.
Dapatkah saya menggunakan alur pembelian tanpa server backend?
Dari perspektif keamanan, Google merekomendasikan penggunaan server backend.
Untuk mengetahui informasi selengkapnya, lihat Proses tanpa server backend.
Apakah sistem pembayaran berbasis API yang ada diizinkan setelah mengintegrasikan SDK Google Play Game di PC?
Semua pembayaran harus ditangani oleh SDK Google Play Game di PC menggunakan Layanan Penagihan Google Play. Anda tidak dapat menggunakan metode pembayaran berbasis API yang ada dalam game yang sama.
Bagaimana cara menggunakan pembelian dalam mode developer?
Gunakan pembelian dalam mode developer dalam waktu 3 menit. Jika tidak, pembelian akan dikembalikan dananya.
Apakah pembayaran berulang atau langganan didukung?
Tidak untuk waktu dekat, meskipun Anda dapat memberikan kasus penggunaan tertentu untuk kami tambahkan ke roadmap mendatang.
Apa yang dimaksud dengan Error Penagihan dalam panggilan pembelian saya?
BillingError adalah respons dari hasil pembayaran. LaunchPurchaseFlow akan langsung ditampilkan tanpa memblokir, tetapi Anda harus memproses callback untuk mengetahui kapan callback selesai dan untuk mengambil hasilnya.
Bagaimana cara menggunakan verifikasi pembelian sisi klien?
Sebaiknya gunakan pembelian sisi server dan proses verifikasinya. Pemrosesan pembelian dari aplikasi klien mengharuskan game Anda berada dalam daftar yang diizinkan. Hubungi Partner Google Anda jika game Anda memerlukan akses. Untuk mengetahui informasi selengkapnya, lihat Proses tanpa server backend.
Apa saja batas API untuk membuat kueri detail produk?
Jumlah maksimum produk yang dapat dikueri dalam satu panggilan ke
QueryProductDetailsAPI adalah 50. Jika melebihi batas ini, Anda harus membagi permintaan menjadi beberapa panggilan.Mengapa kueri produk atau alur pembelian gagal dengan error internal saat memuat banyak SKU produk?
Membuat kueri terlalu banyak SKU produk sekaligus atau memanggil
QueryProductDetailsdi C++ atauQueryProductDetailsAsyncdi Unity secara berturut-turut terlalu sering dalam jangka waktu singkat—misalnya, mengirimkan puluhan panggilan batch dalam loop yang ketat atau membuat instanceBillingClientbaru per batch—dapat membebani koneksi IPC dan backend lokal. Saat koneksi tersebut direset, kueri detail produk akan gagal dan game Anda tidak dapat memperoleh token penawaran yang diperlukan untuk meluncurkan alur pembelian.Untuk mencegah error ini saat memuat katalog, ikuti praktik berikut:
- Ikuti jumlah produk yang didukung per panggilan: Buat kueri tidak lebih dari
50 produk dalam satu panggilan
QueryProductDetailsatauQueryProductDetailsAsync, dan simpanProductDetailsyang ditampilkan dalam cache di memori, bukan membuat kueri ulang katalog lengkap berulang kali. Untuk mengetahui informasi selengkapnya tentang batas batch yang didukung dan cara mengkueri detail produk, lihat pertanyaan batas API sebelumnya, Menampilkan produk yang tersedia untuk dibeli untuk C++, dan Mengkueri detail produk untuk Unity. - Hindari memanggil API secara berturut-turut terlalu sering dalam waktu singkat: Jangan mengirimkan beberapa batch kueri produk secara bersamaan atau berturut-turut tanpa jeda. Gunakan kembali satu instance
BillingClient, serialisasikan permintaan atau batasi konkurensi menjadi dua atau tiga panggilan dalam proses sekaligus, dan tambahkan jeda singkat di antara batch yang berurutan. - Update ke SDK terbaru: Update integrasi Anda ke rilis SDK Google Play Game di PC terbaru, versi 26.9.261.0 untuk C++ atau 26.9.261.0 untuk Unity, dari halaman download SDK PC Play Game untuk memastikan klien Anda menyertakan peningkatan stabilitas penagihan dan IPC terbaru.
- Ikuti jumlah produk yang didukung per panggilan: Buat kueri tidak lebih dari
50 produk dalam satu panggilan
Parameter apa yang diperlukan saat memanggil Kueri Pembelian atau Alur Peluncuran Pembelian di Billing Client?
Fungsi ini menerima
QueryPurchasesContinuation, yang merupakan callback fungsi dengan tanda tanganstd::function<void(QueryPurchasesResult)>. Callback meneruskan hasilnya kepada Anda dengan semuaProductPurchaseDetails. Informasi ini tersedia di file header SDK dalam fileincludes/billing/models.h.launch_purchase_flow_resultyang dihasilkan memiliki fungsiok()dancode(). Fungsiok()menampilkan apakah alur berhasil. Fungsicode()menampilkan enumBillingError(includes/billing/enums.h), yang memiliki 10 kemungkinan kasus error, seperti pengguna membatalkan atau error jaringan.Apakah pengurutan kustom didukung untuk Alur Pembelian Peluncuran di Billing Client?
Dalam desain SDK saat ini, tidak ada cara untuk meneruskan payload Anda sendiri. Namun, Anda dapat memberikan kombinasi
obfuscated_account_iddanobfuscated_profile_idapa pun. Anda dapat tidak memberikan, hanya memberikan salah satu, atau memberikan keduanya.Kolom
offer_tokenwajib diisi dan menentukan penawaran pembelian yang ingin dibeli pengguna dalam alur checkout. Untuk saat ini, setiap SKU di Google Play memiliki tepat satu penawaran (misalnya, beli satu item seharga $10). Pada masa mendatang, tim Layanan Penagihan Play akan memberikan dukungan untuk beberapa penawaran.Untuk memastikan metadata dikaitkan jika terjadi gangguan alur pembelian, simpan metadata di server backend Anda sebelum meluncurkan dialog pembelian dan kaitkan dengan ID akun pengguna, SKU yang dibeli, dan stempel waktu saat ini. Untuk mengetahui informasi selengkapnya, lihat Mengaitkan pembelian dengan data internal.
Apa saja prasyarat untuk beralih dari penagihan Google dengan OAuth ke penagihan Google berbasis DLL?
Game dapat terus menggunakan login OAuth dengan Google untuk mengelola akun yang login, tetapi Google merekomendasikan agar Anda berhenti menggunakan API penagihan REST lama. Beralih dari API penagihan REST (dengan login OAuth2) ke alur SDK dapat menjadi operasi yang menggunakan tombol fitur, sehingga keduanya dapat berdampingan selama beberapa waktu saat game beralih.
Apakah panggilan API Launch Purchase Flow diproses melalui browser web?
Tidak, alur pembelian kini diselesaikan sepenuhnya dalam game menggunakan overlay WebView yang lancar, tanpa keluar dari klien game.
Apakah pengguna harus login secara terpisah untuk setiap game agar dapat melakukan pembelian?
Akun latar depan di Google Play Game digunakan untuk setiap sesi game, jadi Anda tidak perlu login lagi. Akun yang Anda gunakan di Google Play Game saat sesi game dimulai adalah akun yang digunakan untuk melakukan panggilan API. Alur pembelian akan menggunakan akun ini secara otomatis.
Dapatkah game mendukung SDK PC dan sistem pembayaran lama secara bersamaan?
Sistem pembayaran beroperasi dengan model alur ganda, bergantung pada versi biner game. Pengguna di build lama melanjutkan alur yang ada, dan pengguna di build baru beralih ke pembayaran berbasis SDK. Pengguna di kedua alur pembayaran akan berdampingan selama periode transisi.
Windows App Bundle
Saat mengirimkan WAB menggunakan peluncur pihak ketiga, apakah paket game diperlukan untuk peninjauan?
Anda cukup mengirimkan penginstal dan tidak perlu mengirimkan seluruh paket game. Peninjau akan dapat mendownload paket game Anda menggunakan penginstal.
Apakah ada batasan ukuran file WAB?
Untuk Publikasi Penginstal, Anda dapat mengupload ukuran file hingga 10 GB untuk WAB. Untuk Publikasi Terkelola Google Play, batas ukuran file WAB maksimum adalah 200 GB.
Mengapa game saya tidak diinstal atau muncul setelah saya mengupload WAB?
Jika game Anda diaktivasi tanpa versi PC yang sudah ada sebelumnya ("WAB pertama kali"), sistem dapat otomatis menempatkannya dalam status penangguhan Publikasi Terkelola. Hal ini terjadi karena tidak ada dasar pengukuran yang ada untuk diperbarui. Untuk merilis WAB sepenuhnya dan membuat game tersedia untuk diinstal, Anda harus membuka Konsol Google Play dan menjalankan tindakan publikasi yang diperlukan secara manual (misalnya, klik "Publikasikan perubahan").
Bagaimana cara mengupload WAB untuk pengujian internal?
Bagikan akun yang diizinkan kepada Google agar Google dapat mengaktifkannya untuk pengujian internal. Setelah Google memiliki daftar tersebut, Google akan memastikan bahwa mereka disertakan dalam proses orientasi.
Di mana paket WAB harus diupload?
Anda dapat mengupload paket WAB di lokasi yang disebutkan dalam pertanyaan pertama. Namun, Anda tidak dapat memublikasikannya secara manual. Anda harus memberikan waktu UTC yang tepat (hingga jam) kepada staf backend Google. Google kemudian mengonfigurasi jadwal rilis dan memastikan rilis dipublikasikan tepat waktu.
PC SDK
Apa perbedaan antara API Lama dan SDK Google Play Game di PC?
- API lama hanya menawarkan fungsi penagihan.
- SDK PC mendukung Google Desktop Service (GDS) dan fitur PC lengkap.
- Login dengan Google berbasis browser tidak diperlukan dengan SDK PC.
Apakah ada cara alternatif untuk melakukan inisialisasi SDK dengan meluncurkan game secara langsung menggunakan peluncur game, tanpa melalui Google Play Game di PC?
Game Anda harus diluncurkan melalui klien Google Play Game di PC. Untuk mengetahui detail selengkapnya, lihat dokumen developer ini.
Apakah PC SDK mendukung karakter multibyte dalam file sertifikasi PEM?
Ya, SDK mendukung karakter multibyte untuk sertifikasi.
Bagaimana cara SDK menangani login Akun Google untuk beberapa instance atau akun?
Setiap peluncuran game di Google Play Game diperlakukan sebagai "sesi game" dan setiap "sesi game" dapat memiliki akun yang terkait dengannya. Keduanya bisa berbeda. Jadi, jika Anda meluncurkan game dengan akun A, lalu beralih ke akun B dan meluncurkan kembali, keduanya dapat berjalan secara bersamaan.
Apakah integrasi Play Install Referrer berfungsi dengan PC SDK?
PC SDK (25.5.409.0 dan yang lebih tinggi) mendukung Play Install Referrer API. Untuk mengetahui informasi selengkapnya, lihat Play Install Referrer API.
Peluncur
Jika pemain menggunakan peluncur pihak ketiga, bukan Klien Google Play, apakah akun Layanan Play Games mereka akan otomatis disinkronkan?
Agar fungsi SDK dapat beroperasi, game harus diluncurkan langsung melalui klien Google Play Game. Jika proses lain, seperti aplikasi penginstal atau peluncur, memulai game, proses tersebut harus diluncurkan dari klien Google Play Game. Game harus meneruskan semua parameter yang diterima dari klien ke proses klien.
Bagaimana cara menangani inisialisasi jika Google Play Game meluncurkan peluncur game pihak ketiga?
Anda tidak diwajibkan untuk mengintegrasikan SDK langsung ke peluncur Anda. Namun, Anda harus meneruskan semua argumen command line yang diterima oleh peluncur dari klien Google Play Game langsung ke proses turunan yang dihasilkan (file game yang dapat dieksekusi). Jika inisialisasi gagal (misalnya, dengan menampilkan
kActionRequiredShutdownClientProcess), semua proses termasuk peluncur harus dihentikan agar Google Play Game dapat mencoba memulihkan dan meluncurkan kembali game secara otomatis. Untuk mengetahui detail selengkapnya, lihat Langkah 5 dalam panduan penyiapan.Bagaimana cara menangani update dan pemeliharaan game dan peluncur setelah berada dalam produksi?
Update dan pemeliharaan berikutnya harus diterapkan melalui peluncur Anda. Klien Google Play Game tidak mendukung fungsi update, sehingga peluncur harus mampu mengupdate game dan peluncur itu sendiri.
Bagaimana cara penginstal menerima token sesi GPG untuk Putar Otomatis?
GPG meneruskan token sesi menggunakan argumen command line
--g_session_token=<token>ke penginstal. Untuk mengaktifkannya, Anda harus menetapkanacceptsCommandLineArguments="true"diplay_publishing_config.xml.Penginstal bertanggung jawab untuk mengekstrak token ini dan menggunakannya untuk meluncurkan game. Jika pembuatan token gagal, GPG akan meluncurkan penginstal tanpa token (penggantian).
Inisialisasi
Saat saya memulai game menggunakan aplikasi Google Play Game, apakah aplikasi tersebut menyinkronkan detail Akun Google saya?
Setelah meluncurkan game melalui klien Google Play Game, akun akan otomatis disinkronkan dan tidak perlu login melalui proses Login dengan Google lagi.
Apakah parameter inisialisasi dapat digunakan kembali beberapa kali?
Hal ini dapat dilakukan selama klien Google Play Game berjalan dan informasi login valid. Namun, dalam skenario seperti yang dijelaskan dalam panduan, semua proses yang diluncurkan oleh game harus dihentikan saat pengguna menutup game atau game keluar karena kegagalan inisialisasi SDK, seperti
kActionRequiredShutdownClientProcess.Apakah ada cara membuat pintasan untuk membuka game secara langsung?
Anda dapat menggunakan URI berikut untuk membuka game secara langsung:
googleplaygames://launch/?pid=2&id=com.company.gamenameURI mendukung pendeteksian apakah klien Google Play Game di PC dibuka. Jika klien tidak terbuka, klien Google Play Game akan terbuka sebelum game atau peluncur berjalan. Anda perlu mengelola game atau peluncur untuk mencegah beberapa instance berjalan.
Apakah ada cara untuk memverifikasi penginstalan Google Play Game di PC tanpa menggunakan SDK?
Anda dapat memverifikasi status penginstalan Google Play Game di PC tanpa mengintegrasikan SDK dengan memeriksa keberadaan kunci Registry Windows berikut:
HKEY_LOCAL_MACHINE\SOFTWARE\Google\Play Games ServicesKeberadaan kunci ini menunjukkan bahwa Layanan game Google Play (diperlukan untuk menjalankan game di PC) diinstal di komputer. Jika kunci tidak ada, Anda harus mengarahkan pengguna ke halaman penginstalan Google Play Game di PC untuk mendownload dan menginstal klien.
Pengujian
Apakah ada lingkungan pengujian terbuka atau pengujian tertutup yang mirip dengan perangkat seluler?
Meskipun sandbox menyeluruh khusus tidak tersedia, kami menyadari perlunya lingkungan pengujian yang mirip dengan produksi bagi developer. Solusi yang lebih andal akan segera ditawarkan.
Bagaimana cara menambahkan penguji baru?
Kontak Google Anda akan membuat grup email untuk setiap project PC, tempat Akun Google penguji harus ditambahkan. Hanya anggota grup email ini yang diizinkan untuk mendownload paket pengujian dalam Google Play Game.
Lain-lain
Dapatkah saya menggunakan VPN?
Bagi developer yang perlu menguji game mereka di wilayah tempat Google Play Game di PC tidak didukung, sebaiknya gunakan VPN untuk mendapatkan alamat IP dari wilayah yang didukung.
Pastikan Anda mengaktifkan mode TUN di VPN. Panduan tentang cara mengaktifkan mode TUN dan mengonfigurasi firewall dapat ditemukan di panduan pengoperasian penyedia VPN.
Setelah mode TUN diaktifkan, instal Google Play Game di PC dan emulator untuk tujuan pengujian.
Bagaimana cara memulai pengembangan untuk Google Play Game di PC di Unity atau UE Editor?
- Aktifkan Mode developer dan lanjutkan pengujian.
- Tambahkan file
manifest.xmldan.dll. Untuk informasi selengkapnya, lihat dokumen developer. - Daftarkan GUID partner akses awal untuk tujuan pengujian.
Bagaimana cara menggunakan kunci registry dengan benar?
Anda harus membuat kunci registry berdasarkan root hive. Anda dapat menetapkan hive root sebagai
HKEY_LOCAL_MACHINEatauHKEY_CURRENT_USER, bergantung pada tujuan dan sifat data Anda. HiveHKEY_LOCAL_MACHINEdigunakan sebagai contoh dalam panduan.Apa saja persyaratan untuk peninjauan paket PC oleh Google?
Paket PC menjalani pemindaian malware, setelah itu peninjau hanya menguji proses penginstalan game, startup yang berhasil, dan uninstal.
Apakah semua API harus diintegrasikan?
API lain tidak diperlukan, tetapi menawarkan manfaat tambahan.
google::play::billingdiperlukan untuk pembelian dalam aplikasi dan penjualan konten digital.google::play::install_referrerdiperlukan untuk melacak data rujukan guna membantu Anda memahami sumber traffic mana yang mengirimkan pengguna terbanyak untuk mendownload aplikasi Anda.google::play::games::integritydiperlukan untuk melindungi aplikasi Anda dari pihak tidak bertanggung jawab dengan mendeteksi perangkat yang berpotensi berisiko dan emulator yang tidak dikenal.Mengapa beberapa proses game dihentikan saat klien Google Play Game ditutup, sementara yang lain tidak?
Google tidak mengontrol subproses atau proses game yang sedang berjalan. Perilaku ini bergantung pada apakah game tersebut adalah game Android yang diemulasi atau game PC. Game yang diemulasi diinstal di dalam lingkungannya sendiri, sehingga perilakunya sangat bergantung pada inisialisasi dan penonaktifan emulator.
Haruskah saya menggunakan kemampuan uninstal Google Play Game atau uninstaller kustom?
Google merekomendasikan penggunaan kemampuan uninstal Google Play Game kami.
Bantuan lebih lanjut
Jika Anda memerlukan bantuan lebih lanjut yang tidak tercakup dalam FAQ ini, hubungi google-play-games-pc@google.com