Pertanyaan umum (FAQ)

Dokumen ini menjawab pertanyaan umum tentang SDK dan publikasi untuk Google Play Game di PC.

Monetisasi

  1. Dapatkah saya menggunakan alur pembelian tanpa server backend?

    Dari perspektif keamanan, pemrosesan tanpa server backend tidak direkomendasikan.

    Untuk mengetahui informasi selengkapnya, lihat Memproses tanpa server backend.

  2. Apakah sistem pembayaran berbasis API yang ada diizinkan setelah mengintegrasikan Google Play Game di PC SDK?

    Semua pembayaran harus ditangani oleh Google Play Game di PC SDK menggunakan Layanan Penagihan Google Play. Anda tidak dapat menggunakan metode pembayaran berbasis API yang ada di game yang sama.

  3. Bagaimana cara menggunakan pembelian dalam mode developer?

    Gunakan pembelian dalam mode developer dalam waktu 3 menit. Jika tidak, pembelian akan dikembalikan dananya.

  4. Apakah pembayaran atau langganan berulang didukung?

    Tidak untuk saat ini, tetapi Anda dapat memberikan kasus penggunaan tertentu agar kami dapat menambahkannya ke rencana mendatang.

  5. Apa yang dimaksud dengan Error Penagihan dalam panggilan pembelian saya?

    BillingError adalah respons dari hasil pembayaran. LaunchPurchaseFlow akan segera ditampilkan tanpa memblokir, tetapi Anda harus memproses callback untuk mengetahui kapan proses selesai dan mengambil hasilnya.

  6. Bagaimana cara menggunakan verifikasi pembelian sisi klien?

    Sebaiknya gunakan pembelian sisi server dan proses verifikasinya. Untuk memproses pembelian dari aplikasi klien, game Anda harus berada dalam daftar yang diizinkan. Hubungi Partner Google Anda jika game Anda memerlukan akses. Untuk mengetahui informasi selengkapnya, lihat Memproses tanpa server backend.

  7. Berapa batas API untuk meminta detail produk?

    Jumlah maksimum produk yang dapat diminta dalam satu panggilan ke QueryProductDetails API adalah 50. Jika Anda melebihi batas ini, Anda harus membagi permintaan menjadi beberapa panggilan.

  8. Parameter apa yang diperlukan saat memanggil Query Purchases atau Launch Purchase Flow di Klien Penagihan?

    Fungsi ini menerima QueryPurchasesContinuation, yang merupakan callback fungsi dengan tanda tangan std::function<void(QueryPurchasesResult)>. Callback akan meneruskan hasil kepada Anda dengan semua ProductPurchaseDetails. Informasi ini tersedia dalam file header SDK di file includes/billing/models.h.

    launch_purchase_flow_result yang dihasilkan memiliki fungsi ok() dan code(). Fungsi ok() menampilkan apakah alur berhasil atau tidak. Fungsi code() menampilkan enum BillingError (includes/billing/enums.h), yang memiliki 10 kemungkinan kasus error, seperti pengguna membatalkan atau error jaringan.

  9. Apakah pengurutan kustom didukung untuk Alur Pembelian Peluncuran di Klien Penagihan?

    Dalam desain SDK saat ini, tidak ada cara untuk meneruskan payload Anda sendiri. Namun, Anda dapat memberikan kombinasi obfuscated_account_id dan obfuscated_profile_id. Anda dapat memberikan tidak ada, hanya satu, atau keduanya.

    Kolom offer_token wajib 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). Di masa mendatang, tim penagihan Play akan memberikan dukungan untuk beberapa penawaran.

    Untuk memastikan metadata tetap diatribusikan apabila alur pembelian terganggu, simpan metadata di server backend sebelum meluncurkan dialog pembelian dan mengatribusikannya dengan ID akun pengguna Anda, SKU yang dibeli, dan stempel waktu saat ini. Untuk mengetahui informasi selengkapnya, lihat Mengaitkan pembelian dengan data internal.

  10. Apakah error waktu tunggu dimaksudkan jika pengguna menutup browser tanpa membayar selama alur pembelian?

    Ya, ini adalah masalah yang diketahui dan perilaku yang dimaksudkan dalam alur berbasis browser. Kami sedang berupaya mengembangkan fitur pembelian yang lancar (berbasis WebView) yang akan mempertahankan alur pembayaran di dalam game dan mengatasi ketidaknyamanan waktu tunggu ini.

  11. Apa saja prasyarat untuk beralih dari penagihan Google dengan OAuth ke penagihan Google native dengan DLL?

    Game dapat terus menggunakan login OAuth dengan Google untuk mengelola akun yang login, tetapi Google merekomendasikan agar Anda berhenti menggunakan REST API penagihan lama. Beralih dari REST API penagihan (dengan login OAuth2) ke alur SDK dapat menjadi operasi yang ditandai fitur, sehingga keduanya dapat berjalan bersamaan untuk jangka waktu tertentu saat game beralih.

  12. Apakah panggilan Launch Purchase Flow API diproses melalui browser web?

    Ya, untuk saat ini, panggilan tersebut diproses melalui browser. Google berencana untuk menyelesaikan seluruh alur tanpa keluar dari game yang dapat dicapai melalui SDK.

  13. Apakah pengguna perlu login secara terpisah untuk setiap game agar dapat melakukan pembelian?

    Akun latar depan di Google Play Game digunakan untuk setiap sesi game, sehingga Anda tidak perlu login lagi. Akun yang Anda gunakan di Google Play Game saat sesi game dimulai adalah akun yang digunakan untuk mengeluarkan panggilan API. Saat meluncurkan alur pembelian di browser, Anda harus login dan menggunakan akun yang sama dengan sesi game. Jika pengguna login dengan akun lain, alur web akan meminta mereka untuk beralih akun.

  14. Dapatkah game mendukung SDK native dan sistem pembayaran lama secara bersamaan?

    Sistem pembayaran beroperasi dalam model alur ganda, bergantung pada versi biner game. Pengguna yang menggunakan build lama akan terus menggunakan alur yang ada, dan pengguna yang menggunakan build baru akan beralih ke pembayaran berbasis SDK. Pengguna di kedua alur pembayaran akan berjalan bersamaan selama periode transisi.

Windows App Bundle

  1. Saat mengirimkan WAB menggunakan peluncur pihak ketiga, apakah paket game diperlukan untuk ditinjau?

    Anda hanya dapat mengirimkan penginstal dan tidak perlu mengirimkan seluruh paket game. Peninjau akan dapat mendownload paket game Anda menggunakan penginstal.

  2. Apakah ada batasan ukuran file WAB?

    Anda dapat mengupload ukuran file hingga 10 GB untuk WAB.

  3. Mengapa game saya tidak diinstal atau muncul setelah saya mengupload WAB?

    Jika game Anda diaktifkan tanpa versi PC yang sudah ada ("WAB pertama kali"), sistem mungkin akan otomatis menempatkannya ke status penahanan Publikasi Terkelola. Hal ini terjadi karena tidak ada dasar yang ada untuk diupdate. 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").

  4. Bagaimana cara mengupload WAB untuk pengujian internal?

    Bagikan akun daftar yang diizinkan kepada Google agar Google dapat mengaktifkannya untuk pengujian internal. Setelah menerima daftar tersebut, Google akan memastikan akun tersebut disertakan dalam proses orientasi.

  5. 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 akan mengonfigurasi jadwal rilis dan memastikan jadwal tersebut dipublikasikan tepat waktu.

PC SDK

  1. Apa perbedaan antara API Lama dan Google Play Game di PC SDK?

    • API Lama kami hanya menawarkan fungsi Penagihan.
    • PC SDK mendukung Google Desktop Service (GDS) dan fitur PC lengkap.
    • Tidak diperlukan Login Google berbasis browser dengan PC SDK.

  2. 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.

  3. Apakah PC SDK native mendukung karakter multibyte dalam file sertifikasi PEM?

    Ya, SDK mendukung karakter multibyte untuk sertifikasi.

  4. Bagaimana 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. Akun tersebut dapat berbeda. Jadi, jika Anda meluncurkan game dengan akun A, lalu beralih ke akun B dan meluncurkan kembali, keduanya dapat berjalan secara bersamaan.

  5. Apakah integrasi Play Install Referrer berfungsi dengan PC SDK?

    PC SDK (25.5.409.0 dan yang lebih baru) mendukung Play Install Referrer API. Untuk mengetahui informasi selengkapnya, lihat Play Install Referrer API.

Peluncur

  1. Jika pemain menggunakan peluncur pihak ketiga, bukan Klien Google Play, apakah akun Layanan game Play 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.

  2. Bagaimana cara menangani inisialisasi jika Google Play Game meluncurkan peluncur game pihak ketiga?

    Anda tidak diwajibkan untuk mengintegrasikan SDK langsung ke peluncur. Namun, Anda harus meneruskan semua argumen command line yang diterima oleh peluncur dari klien Google Play Game langsung ke proses turunan yang dibuat (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 di panduan penyiapan.

  3. Bagaimana cara menangani update dan pemeliharaan game dan peluncur saya setelah game dan peluncur tersebut dalam produksi?

    Update dan pemeliharaan berikutnya harus diterapkan melalui peluncur Anda. Klien Google Play Game tidak mendukung fungsi update, sehingga peluncur harus dapat mengupdate game dan peluncur itu sendiri.

Inisialisasi

  1. 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 Anda tidak perlu login lagi melalui proses Login Google.

  2. 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.

  3. Apakah ada cara untuk membuat pintasan untuk membuka game secara langsung?

    Anda dapat menggunakan URI berikut untuk membuka game secara langsung:

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

    URI mendukung pendeteksian apakah klien Google Play Game di PC dibuka atau tidak. 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.

  4. 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 Registri Windows berikut:

    HKEY_LOCAL_MACHINE\SOFTWARE\Google\Play Games Services

    Keberadaan kunci ini menunjukkan bahwa layanan Google Play Game (yang 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

  1. Apakah ada lingkungan pengujian terbuka atau pengujian tertutup yang mirip dengan pengujian seluler?

    Meskipun sandbox menyeluruh khusus tidak tersedia, kami menyadari kebutuhan akan lingkungan pengujian seperti produksi untuk developer. Solusi yang lebih canggih akan segera ditawarkan.

  2. 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

  1. Dapatkah saya menggunakan VPN?

    Untuk developer yang perlu menguji game mereka di wilayah yang tidak mendukung Google Play Game di PC, 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 dalam panduan pengoperasian penyedia VPN.

    Setelah mode TUN diaktifkan, instal Google Play Game di PC dan emulator untuk tujuan pengujian.

  2. Bagaimana cara mulai mengembangkan untuk Google Play Game di PC di Unity atau UE Editor?

  3. Bagaimana cara menggunakan kunci registri dengan benar?

    Anda harus membuat kunci registri berdasarkan hive root. Anda dapat menetapkan hive root sebagai HKEY_LOCAL_MACHINE atau HKEY_CURRENT_USER, bergantung pada tujuan dan karakteristik data. Hive HKEY_LOCAL_MACHINE digunakan sebagai contoh dalam panduan.

  4. Apa saja persyaratan untuk peninjauan paket PC oleh Google?

    Paket PC menjalani pemindaian malware, setelah itu peninjau hanya menguji penginstalan game, startup yang berhasil, dan proses uninstal.

  5. Apakah semua API harus diintegrasikan?

    API lain tidak diperlukan, tetapi API tersebut menawarkan manfaat tambahan. google::play::billing diperlukan untuk pembelian dalam aplikasi dan penjualan konten digital. google::play::install_referrer diperlukan untuk melacak data rujukan guna membantu Anda memahami sumber traffic mana yang mengirimkan paling banyak pengguna untuk mendownload aplikasi Anda. google::play::games::integrity diperlukan untuk melindungi aplikasi Anda dari pelaku kejahatan dengan mendeteksi perangkat yang berpotensi berisiko dan emulator yang tidak dikenal.

  6. 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 yang diemulasi Android atau game PC native. Game yang diemulasi diinstal di dalam lingkungan mereka sendiri, sehingga perilaku mereka sangat bergantung pada inisialisasi dan penghentian emulator.

  7. Haruskah saya menggunakan kemampuan uninstal Google Play Game atau penginstal kustom?

    Google merekomendasikan penggunaan kemampuan uninstal Google Play Game kami.

Bantuan lebih lanjut

Jika Anda memerlukan bantuan lebih lanjut yang tidak dibahas dalam FAQ ini, hubungi google-play-games-pc@google.com