Gunakan checklist ini untuk memastikan game Anda memenuhi semua persyaratan dan praktik terbaik sebelum Anda mengirimkannya untuk ditinjau di Google Play Game di PC.
Menyiapkan dan mengonfigurasi project Anda
- Download dan impor SDK: Integrasikan SDK Play Game PC terbaru untuk lingkungan Anda. Untuk informasi selengkapnya, lihat panduan Unity atau panduan C++.
- Buat manifes aplikasi: Buat file
manifest.xmlyang memetakan<PackageName>ke paket Konsol Play yang Anda klaim. Untuk mengetahui informasi selengkapnya, lihat Panduan manifes. - Tanda tangani file yang dapat dieksekusi secara digital: Tanda tangani game Anda menggunakan Tanda Tangan Digital Authenticode dan amankan sertifikat untuk semua update mendatang. Meskipun Anda dapat melewati langkah ini selama pengembangan lokal dengan mengaktifkan mode developer, Anda harus menandatangani biner akhir dengan sertifikat produksi yang sebenarnya dari certificate authority yang dikenal. Untuk mengetahui informasi selengkapnya, lihat Menandatangani game Anda secara digital.
- Format dan kirim sertifikat: Kirim informasi sertifikat ke perwakilan Google Anda. File sertifikat hanya boleh berisi informasi terkait sertifikat; pastikan semua blok non-sertifikat dihapus. Anda dapat menggunakan OpenSSL untuk mengonversi file DER/CER ke format PEM yang diperlukan.
Mengintegrasikan API dan fitur
- Lakukan inisialisasi SDK: Terapkan logika inisialisasi SDK, misalnya,
InitializeAsync, selama startup sebelum Anda menggunakan fitur lain. Untuk mengetahui informasi selengkapnya, lihat Panduan inisialisasi. - Terapkan login yang lancar: Autentikasi pemain secara otomatis menggunakan akun klien Play Game melalui Recall API. Untuk mengetahui informasi selengkapnya, lihat panduan Login yang Lancar.
- Integrasikan Play Integrity: Gunakan
IntegrityClientuntuk meminta token dan memverifikasi legitimasi sesi game di backend Anda. Untuk mengetahui informasi selengkapnya, lihat panduan Play Integrity. - Tambahkan Play Install Referrer: Integrasikan Install Referrer API jika Anda perlu melacak sumber akuisisi pengguna untuk PC. Untuk mengetahui informasi selengkapnya, lihat panduan Install Referrer.
- Menangani error inisialisasi: Untuk menggunakan SDK, panggil
GooglePlayInitialize(C++) atauGooglePlayInitialization.InitializeAsync(C#) untuk melakukan inisialisasi API. Anda harus memanggilnya dan memverifikasi bahwa callback lanjutan selesai denganInitializeResult::ok()(C++) atauResult.IsOk(C#) menampilkantruesebelum Anda dapat menggunakan API lainnya. - Menangani penonaktifan wajib: Tangani
kActionRequiredShutdownClientProcessdengan menonaktifkan proses klien sesegera mungkin. - Menangani persyaratan penginstalan Google Play Game: Tangani
kSdkRuntimeUnavailabledengan memberi tahu pengguna bahwa Google Play Game dan runtime SDK harus diinstal untuk melanjutkan. - Menangani update Google Play Game: Tangani
kSdkRuntimeUpdateRequireddengan memberi tahu pengguna bahwa update runtime Google Play Game diperlukan.
Mengimplementasikan Layanan Penagihan Play
- Periksa jenis pembelian: Pastikan game Anda hanya mengandalkan pembelian dalam aplikasi, karena pembayaran berulang dan langganan tidak didukung. Untuk informasi selengkapnya, lihat FAQ Penagihan.
- Membuat kueri detail produk: Gunakan
QueryProductDetailsuntuk mengambil data Play Store yang dilokalkan. Jika Anda memiliki lebih dari 50 produk, bagi permintaan menjadi beberapa panggilan. Untuk mengetahui informasi selengkapnya, lihat Panduan membuat kueri produk. - Meluncurkan alur pembelian: Gunakan
LaunchPurchaseFlowuntuk memproses transaksi secara native. Error waktu tunggu lima menit akan terjadi jika Anda menutup browser pembayaran tanpa membayar. Untuk mengetahui informasi selengkapnya, lihat Panduan alur pembelian. - Pulihkan pembelian yang ada: Panggil
QueryPurchasessaat memulai dan menampilkan aplikasi di latar depan untuk menangkap pembelian lintas perangkat yang tidak dikonfirmasi. Untuk mengetahui informasi selengkapnya, lihat Panduan memulihkan pembelian. - Pemrosesan backend yang aman: Validasi
purchaseTokendi backend Anda sebelum memberikan hak dan menyelesaikan denganAcknowledgePurchaseatauConsumePurchase. Untuk mengetahui informasi selengkapnya, lihat Panduan pemrosesan yang aman. - Perhitungkan penundaan penyebaran kunci lisensi: Saat mengonfigurasi kunci penagihan atau kunci lisensi baru di Konsol Play, tunggu beberapa jam hingga cache backend disinkronkan di seluruh lingkungan penayangan perdagangan sebelum melakukan pengujian pembelian langsung. Pembelian yang dicoba sebelum sinkronisasi selesai akan menampilkan Kode Error 6.
Menguji dalam mode developer dan melakukan QA prapeluncuran
- Menguji dalam mode developer: Tambahkan
<IsDeveloperMode>true</IsDeveloperMode>ke manifes Anda dan konfigurasikan GUID partner akses awal untuk pengujian lingkungan pengembangan terintegrasi (IDE) lokal. Jika Anda tidak memiliki GUID partner akses awal, lengkapi formulir minat. - Mengelola pembelian mode developer: Saat Anda menguji pembelian dalam mode developer, gunakan pembelian dalam waktu tiga menit untuk mencegah pengembalian dana otomatis. Untuk mengetahui informasi selengkapnya, lihat FAQ Pengujian.
- Hapus mode developer: Anda harus menghapus tag
<IsDeveloperMode>sebelum memaketkan build rilis sesegera mungkin. Untuk mengetahui informasi selengkapnya, lihat Panduan mode developer. - Meneruskan argumen menggunakan peluncur pihak ketiga: Teruskan semua argumen command line yang tidak diketahui yang diterima oleh peluncur dari klien Google Play Game langsung ke proses game yang dihasilkan. Untuk mengetahui informasi selengkapnya, lihat Panduan multiproses.
- Uji dengan VPN: Jika Anda menguji dari wilayah yang tidak didukung, gunakan VPN dengan mode TUN diaktifkan untuk mendapatkan alamat IP yang didukung. Untuk mengetahui informasi selengkapnya, lihat FAQ pengujian VPN.
- Mendukung pintasan desktop: Untuk dukungan pintasan yang lancar, lihat FAQ Pintasan untuk eksekusi pintasan. Meluncurkan game atau peluncur pihak ketiga secara langsung menggunakan pintasan dapat menyebabkan error inisialisasi.
Membuat paket, menguji, dan memublikasikan game Anda
- Mengemas WAB: Gunakan Play Publishing Tool untuk mengemas game Anda ke dalam Windows App Bundle (WAB). File WAB harus berukuran di bawah batas ukuran file 10 GB untuk Publikasi Penginstal dan 200 GB untuk Publikasi Terkelola Google Play. Untuk mengetahui informasi selengkapnya, lihat Panduan pengemasan.
- Gunakan SDK dan alat terbaru: Kompilasi dan paketkan rilis Anda dengan versi terbaru Play Game PC SDK, Play Game PC Unity SDK, alat developer Play PC, dan alat publikasi Play.
- Konfirmasi apakah peningkatan diperlukan: Jika Penginstal, Peluncur, atau
Uninstaller Anda perlu dijalankan sebagai admin setiap kali diluncurkan,
ingatlah untuk memeriksa apakah Anda telah menetapkan
INSTALLER_REQUIRES_ELEVATION,LAUNCHER_REQUIRES_ELEVATION, atauUNINSTALLER_REQUIRES_ELEVATIONketrue. Jika tidak, skrip tidak akan berjalan dengan hak istimewa admin, yang akan menyebabkan kegagalan startup. Lihat Format File Konfigurasi WAB untuk mengetahui detail selengkapnya. - Mengirimkan penginstal peluncur pihak ketiga: Jika Anda menggunakan peluncur pihak ketiga, kirimkan penginstalnya di dalam WAB. Untuk mengetahui informasi selengkapnya, lihat Panduan publikasi penginstal.
- Menangani token sesi Putar Otomatis: Jika Anda mengaktifkan Putar Otomatis dengan menyetel
acceptsCommandLineArguments="true"diplay_publishing_config.xml, pastikan penginstal Anda mengekstrak argumen command line--g_session_token=<token>dan menggunakannya untuk meluncurkan game. Pastikan penginstal Anda menangani kasus penggantian saat token tidak ada. Untuk mengetahui informasi selengkapnya, lihat FAQ Peluncur. - Update game dan peluncur atau penginstal: Konten paket Anda, termasuk penginstal peluncur, harus dapat diupdate sendiri. Kelola semua resource yang diperlukan game Anda, termasuk mengupdate peluncur itu sendiri.
- Bagikan informasi peluncuran kepada Google: Hubungi partner Play Anda dan bagikan nama paket, negara peluncuran (menggunakan kode 2 karakter ISO, misalnya US, CA, MX), serta tanggal dan waktu peluncuran dalam Waktu Universal Terkoordinasi (UTC).
- Siapkan akses pengujian: Berikan Grup Google Eksternal untuk ditambahkan ke daftar yang diizinkan untuk pengujian, dokumentasi, dan akses Google Drive. Bagikan daftar email akun pengujian kepada partner Play Anda, karena Jalur Pengujian Konsol Play tidak didukung untuk PC.
- Tambahkan faktor bentuk PC: Tambahkan faktor bentuk 'Google Play Game di PC' secara eksplisit ke aplikasi Anda di Konsol Google Play. Jika Anda tidak dapat mengakses tab ini, hubungi partner Play Anda untuk menambahkan akun Anda ke daftar yang diizinkan.
- Konfigurasi persyaratan PC: Masukkan persyaratan hardware (RAM, GPU, penyimpanan) untuk PC Windows. Untuk informasi selengkapnya, lihat panduan persyaratan PC.
- Upload aset Play Store: Upload file WAB yang dipaketkan ke Jalur produksi dan konfigurasikan aset visual. Untuk mengetahui informasi selengkapnya, lihat Panduan upload aset.
- Publikasikan untuk pengujian lingkungan pengguna: Pilih Publikasikan di Konsol Google Play. Tidak seperti versi Android, memilih Publikasikan di WAB tidak akan memicu rilis publik. Sebagai gantinya, aplikasi akan dapat ditelusuri oleh akun pengujian bersama Anda untuk melakukan pengujian di lingkungan pengguna setelah proses peninjauan Google.
- Peluncuran resmi: Google mengontrol peluncuran berdasarkan tanggal peluncuran resmi yang Anda bagikan kepada partner Play.
- Pengujian selama prapendaftaran: Selama fase prapendaftaran, Anda harus melakukan pengujian internal di negara yang tidak termasuk dalam wilayah prapendaftaran yang Anda pilih.
- Verifikasi penghentian proses penginstal: pastikan proses penginstal utama tetap aktif hingga semua kunci registry yang diperlukan dibuat dan didaftarkan. Jika proses keluar sebelum waktunya, verifikasi penginstalan akan gagal. Untuk mengetahui informasi selengkapnya, lihat Publikasi penginstal.
- Pertahankan hive registry yang konsisten dan bersihkan saat meng-uninstal:
Google Play Game di PC memeriksa
HKEY_LOCAL_MACHINEsebelumHKEY_CURRENT_USERdan menggunakan nilai pertama yang cocok. Jaga agar hive registry tetap konsisten di seluruh update dan judul peluncur bersama, serta hapus kunci registry selama uninstal agar entriHKEY_LOCAL_MACHINEyang tidak berlaku tidak menutupi jalurHKEY_CURRENT_USERyang valid. Untuk mengetahui informasi selengkapnya, lihat Publikasi penginstal.
Bermigrasi dari API ke SDK
Migrasi dari API ke SDK adalah langkah opsional. Jika Anda memilih untuk bermigrasi, ikuti rekomendasi berikut:
- Hapus REST API lama: Petakan panggilan API Play Developer lama (misalnya,
purchases.products.get) ke fungsi Native SDK sisi klien. Untuk mengetahui informasi selengkapnya, lihat Panduan migrasi. - Verifikasi argumen command line: Argumen command line di lingkungan SDK mungkin berbeda dengan argumen di lingkungan API. Pastikan paket Anda menangani dan meneruskan semua argumen dengan benar. Untuk mengetahui informasi selengkapnya, lihat Memverifikasi.
- Verifikasi jalur registry: Untuk migrasi yang lancar ke Native SDK, konfigurasi registry harus tetap konsisten dengan versi sebelumnya. Untuk mengetahui informasi selengkapnya, lihat panduan file WAB.