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, Google merekomendasikan penggunaan server backend.

    Untuk mengetahui informasi selengkapnya, lihat Memproses tanpa server backend.

  2. 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 di game yang sama.

  3. Bagaimana cara menggunakan pembelian dalam mode developer?

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

  4. Apakah pembayaran berulang atau langganan didukung?

    Tidak untuk waktu dekat, meskipun Anda dapat memberikan kasus penggunaan spesifik agar kami dapat menambahkannya ke rencana mendatang.

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

    BillingError adalah respons hasil pembayaran. LaunchPurchaseFlow akan langsung ditampilkan tanpa memblokir, tetapi Anda harus memproses callback untuk mengetahui kapan callback tersebut selesai dan untuk mendapatkan hasilnya.

  6. Bagaimana cara menggunakan verifikasi pembelian sisi klien?

    Sebaiknya gunakan pembelian sisi server dan proses verifikasinya. Memproses pembelian dari aplikasi klien memerlukan game Anda untuk 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 membuat kueri detail produk?

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

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

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

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

  9. 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_id dan obfuscated_profile_id. Anda dapat memberikan tidak ada, hanya satu, atau keduanya.

    Kolom offer_token wajib diisi dan menentukan penawaran pembelian yang dicoba dibeli pengguna dalam alur checkout. Untuk saat ini, setiap SKU di Google Play memiliki tepat satu penawaran (misalnya, beli satu item seharga Rp100.000). Pada 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. Apa 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 REST Billing API (dengan login OAuth2) ke alur SDK dapat menjadi operasi yang ditandai fitur, sehingga keduanya dapat berjalan bersama selama jangka waktu tertentu saat game beralih.

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

  12. 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, sehingga Anda tidak perlu login lagi. Akun yang Anda gunakan di Google Play Game saat sesi game dimulai adalah akun yang digunakan untuk membuat panggilan API. Alur pembelian akan menggunakan akun ini secara otomatis.

  13. Dapatkah game mendukung SDK PC dan sistem pembayaran lama secara bersamaan?

    Sistem pembayaran beroperasi berdasarkan model aliran ganda, bergantung pada versi biner game. Pengguna di build lama akan tetap menggunakan alur yang ada, dan pengguna di build baru akan beralih ke pembayaran berbasis SDK. Pengguna di kedua alur pembayaran dapat menggunakan aplikasi selama periode transisi.

Windows App Bundle

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

    Anda cukup 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 sebelumnya ("WAB pertama kali"), sistem dapat otomatis menempatkannya ke status penahanan Publikasi Terkelola. Hal ini terjadi karena tidak ada tolok ukur 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").

  4. Bagaimana cara mengupload WAB untuk pengujian internal?

    Bagikan akun yang masuk daftar yang diizinkan kepada Google agar Google dapat mengaktifkannya untuk pengujian internal. Setelah Google memiliki daftar tersebut, Google akan memastikan bahwa mereka disertakan dalam proses aktivasi.

  5. Ke 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 memberi staf backend Google waktu UTC yang tepat (hingga jam). Kemudian, Google akan mengonfigurasi jadwal rilis dan memastikan rilis dipublikasikan tepat waktu.

SDK PC

  1. Apa perbedaan antara Legacy API dan Google Play Games di PC SDK?

    • API lama hanya menawarkan fungsi penagihan.
    • PC SDK mendukung Google Desktop Service (GDS) dan fitur PC lengkap.
    • Tidak diperlukan Login dengan 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 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. Keduanya bisa berbeda. Jadi, jika Anda meluncurkan game dengan akun A, lalu beralih ke akun B dan meluncurkan ulang, keduanya dapat berjalan secara bersamaan.

  5. 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 informasi selengkapnya, lihat Play Install Referrer API.

Peluncur

  1. 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 penginstal atau aplikasi peluncur, memulai game, maka 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 secara 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 di-spawn (dapat dieksekusi game). 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.

  3. Bagaimana cara menangani update dan pemeliharaan game dan peluncur saya setelah 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.

  4. 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 menetapkan acceptsCommandLineArguments="true" di play_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 (fallback).

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 disinkronkan secara otomatis dan tidak perlu login melalui proses Login Google lagi.

  2. Apakah parameter inisialisasi dapat digunakan kembali beberapa kali?

    Hal ini dapat dilakukan selama klien Google Play Games 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 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. 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 Registry Windows berikut:

    HKEY_LOCAL_MACHINE\SOFTWARE\Google\Play Games Services

    Kehadiran 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 serupa dengan lingkungan seluler?

    Meskipun sandbox end-to-end khusus tidak tersedia, kami menyadari kebutuhan akan lingkungan pengujian yang mirip dengan lingkungan produksi bagi developer. Solusi yang lebih andal akan segera ditawarkan.

  2. Bagaimana cara menambahkan penguji baru?

    Kontak Google Anda 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 manual pengoperasian penyedia VPN.

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

  2. Bagaimana cara memulai pengembangan 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 root hive sebagai HKEY_LOCAL_MACHINE atau HKEY_CURRENT_USER, bergantung pada tujuan dan sifat data Anda. Hive HKEY_LOCAL_MACHINE digunakan sebagai contoh dalam pedoman.

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

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

  5. Apakah semua API perlu diintegrasikan?

    API lainnya tidak diperlukan, tetapi 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 Android yang di-emulator atau game PC. Game yang diemulasikan diinstal di dalam lingkungannya sendiri, sehingga perilakunya sangat bergantung pada inisialisasi dan penonaktifan emulator.

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

    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