Fitur layanan game Google Play

Dengan layanan game Google Play, Anda dapat menambahkan fitur sosial dan multiplayer yang menarik ke dalam game.

Pilih fitur di bawah untuk mempelajari dasar-dasarnya lalu cari dokumentasi terkait penerapan layanan game Google Play.

Memulai

Mengintegrasikan SDK layanan game Google Play

Untuk mempelajari cara mengintegrasikan SDK layanan game Google Play, kunjungi situs Google Developers untuk mendapatkan petunjuk dan sampel terkait cara memulai.

Membuat daftar game

Untuk menggunakan layanan game Google Play, Anda harus membuat listingan game di Konsol Google Play. Direktori game terpisah dari halaman Listingan Google Play Store aplikasi Anda.

Berikut ini cara menambahkan listingan game baru:

1. Buka Konsol Google Play.
2. Buka Penyiapan > Project game.
3. Di dekat kanan atas, klik Tambahkan game baru.

Fitur

Pencapaian

Pencapaian dapat membantu Anda mempertahankan pemain dengan menambahkan bonus setelah menyelesaikan target yang ditentukan dalam game. Pemain dapat memperoleh poin pengalaman (XP) setelah berhasil meraih pencapaian dalam game.

Kunjungi situs Google Developers untuk mempelajari Pencapaian lebih lanjut.

Catatan: Pencapaian tidak dapat dihapus setelah Anda memublikasikannya.

Menambahkan pencapaian

Anda dapat membuat pencapaian untuk pertama kalinya menggunakan Konsol Google Play dengan dua cara:

• Membuat pencapaian: Tambahkan definisi dan metadata untuk setiap pencapaian satu per satu.
• Mengimpor pencapaian: Impor definisi dan metadata lainnya untuk beberapa pencapaian secara bersamaan dalam satu langkah.

Catatan: Gunakan API untuk membuka kunci pencapaian bagi pemain yang login. Tindakan ini akan menampilkan pencapaian tersembunyi kepada pemain.

Membuat pencapaian

Untuk membuat pencapaian game baru yang tidak dipublikasikan, selesaikan langkah-langkah berikut menggunakan Konsol Google Play:

1. Di Konsol Google Play, pilih game.
2. Di halaman Layanan game Google Play - Pencapaian (Mendorong pertumbuhan > Layanan game Google Play > Penyiapan dan pengelolaan > Pencapaian), pilih Buat pencapaian.
3. Di halaman Tambahkan pencapaian, lengkapi formulir.
4. Klik Simpan sebagai draf.

Setelah membuat pencapaian, Anda harus memublikasikan game.

Menambahkan pencapaian lainnya

Jika Anda sudah memiliki pencapaian dan ingin menambahkan pencapaian lainnya:

1. Di Konsol Google Play, pilih game.

2. Di halaman Layanan game Google Play - Pencapaian (Mendorong pertumbuhan > Layanan game Google Play > Penyiapan dan pengelolaan > Pencapaian), pilih Tambahkan pencapaian.

Mengimpor pencapaian

Untuk menambahkan beberapa pencapaian ke game Anda sekaligus, gunakan langkah-langkah berikut:

1. Buat file ZIP yang berisi pencapaian Anda.

1. Upload file.

Untuk informasi selengkapnya tentang file ZIP, lihat Panduan file ZIP.

Untuk mengimpor pencapaian:

1. Di Konsol Google Play, pilih game.
2. Di halaman Layanan game Google Play - Pencapaian (Mendorong pertumbuhan > Layanan game Google Play > Penyiapan dan pengelolaan > Pencapaian), pilih Impor pencapaian.
3. Di halaman Impor pencapaian, klik Upload.
4. Pilih file zip yang akan diupload.
5. Klik Simpan sebagai draf.
6. Setelah mengimpor pencapaian, Anda harus memublikasikan game.

Memublikasikan game Anda

Setelah Anda menguji dan memublikasikan game, semua pencapaian game akan dipublikasikan bersama game tersebut.

Mengedit pencapaian

Untuk mengedit pencapaian yang telah Anda buat, pilih pencapaian di tab Pencapaian di Konsol Google Play. Pada tahap ini, Anda akan melihat formulir yang sama dengan yang digunakan saat pertama kali membuat pencapaian, dan Anda dapat mengedit kolom apa pun sesuai kebutuhan.

Setelah selesai mengedit pencapaian, klik tombol Simpan sebagai draf. Pencapaian yang baru diedit akan berada pada tahap "siap untuk diuji", dan Anda dapat mengujinya. Jika berfungsi dengan benar, pilih Publikasikan ulang dari menu drop-down. Tindakan ini akan memublikasikan ulang game Anda, beserta semua pencapaian terbaru Anda, ke publik.

Catatan: Setelah pencapaian dipublikasikan, status awal (tersembunyi atau terungkap) dan jenisnya (inkremental atau standar) bersifat tetap dan tidak dapat diubah.

Mengurungkan pengeditan

Jika Anda merasa tidak menyukai pencapaian saat ini dan ingin kembali ke pencapaian sebelumnya, pilih Kembalikan dari menu drop-down di Konsol Google Play, dan semua pencapaian Anda akan kembali ke versi yang telah dipublikasikan sebelumnya.

Menghapus pencapaian

Setelah dipublikasikan, pencapaian Anda tidak dapat dihapus.

Anda hanya dapat menghapus pencapaian dalam status pra-publikasi dengan mengklik tombol berlabel Hapus di bagian bawah formulir untuk pencapaian tersebut.

Mereset pencapaian

Anda hanya dapat mereset data progres pemain untuk pencapaian draf.

• Untuk mereset pencapaian di Konsol Google Play, klik tombol berlabel Reset progres pencapaian di bagian bawah formulir untuk peristiwa tersebut.
• Untuk mereset data pencapaian secara terprogram, panggil metode Pencapaian dari Management API.

Pedoman ikon

Ikon harus dibuat sebagai file PNG, JPEG, atau JPG berukuran 512 x 512. Anda hanya perlu memberikan ikon untuk pencapaian terbuka. Kami akan secara otomatis membuat versi hitam putih untuk ikon yang ditampilkan. Oleh karena itu, sebaiknya ikon pencapaian Anda menyertakan elemen yang berwarna-warni, sehingga pengguna dapat dengan mudah membedakan antara pencapaian terungkap dan pencapaian terbuka.

Saat ditampilkan dalam toast Android, ikon pencapaian akan ditempatkan dalam lingkaran dan sudut-sudut luarnya tersembunyi. Pastikan ikon Anda masih terlihat bagus dalam kondisi ini.

Contoh ikon pencapaian.

Ikon yang sama digunakan di semua lokalitas. Jadi, sebaiknya jangan sertakan teks atau konten yang dilokalkan dalam ikon.

Panduan file ZIP

Anda dapat mengimpor beberapa pencapaian sekaligus menggunakan file zip. Lihat tabel untuk mengetahui nama file yang tepat untuk digunakan dalam file zip Anda:

Nama file	Wajib Diisi atau Opsional	Nilai yang diterima
AchievementsMetadata.csv	Wajib	Metadata untuk setiap pencapaian. Lihat Atribut.
AchievementsLocalizations.csv	Opsional	Memberikan terjemahan untuk nama dan deskripsi pencapaian.
AchievementsIconMappings.csv	Opsional	Memetakan pencapaian ke file ikonnya.
File ikon	Opsional	Ikon dalam format PNG, JPEG, atau JPG.

Persyaratan file ZIP:

• Tidak ada subdirektori.
• Nama file yang unik.
• Hanya file CSV, PNG, JPEG, atau JPG.
• File CSV tidak boleh memiliki baris header.
• Ukuran setiap file tidak boleh lebih dari 1 MB.
• Total file tidak boleh lebih dari 203.
• Total ukuran file zip tidak boleh lebih dari 200 MB.

Format AchievementsMetadata.csv

File AchievementsMetadata.csv berisi metadata untuk setiap pencapaian. File ini harus menyertakan informasi sebagai nilai yang dipisahkan koma dalam urutan berikut:

Name,Description,Incremental value,Steps Needed,Initial State,Points,List Order

Kolom-kolom ini dijelaskan dalam tabel berikut:

Header kolom CSV	Wajib Diisi atau Opsional	Nilai yang diterima
Nama	Wajib	Maksimum 100 karakter
Deskripsi	Opsional	Maksimum 500 karakter
Nilai Inkremental	Opsional	Benar atau Salah
Langkah yang Diperlukan	Wajib diisi jika Nilai Inkremental adalah Benar.	Angka (tanpa pecahan atau desimal)
Keadaan Awal	Wajib	Tersembunyi atau Terungkap
Poin	Wajib	Angka yang merupakan kelipatan 5, dan nilainya harus antara 5 dan 200
Urutan Daftar	Opsional	Angka (tanpa pecahan atau desimal, dan lebih besar dari nol)

Persyaratan file AchievementsMetadata.csv:

• Setiap baris harus memiliki tujuh nilai. Jika Anda ingin menghapus nilai, kosongkan nilai tersebut.
• Kolom Nama dan Deskripsi digunakan sebagai lokalitas default.
• Kolom Nama harus unik di semua pencapaian.
• Kolom berikut tidak boleh berisi koma: Nama dan Deskripsi.

Contoh file AchievementsMetadata.csv:

Achievement1,,True,100,Hidden,5,20

Achievement2,,False,,Revealed,10,30

Format AchievementsLocalizations.csv

File AchievementsLocalizations.csv adalah file opsional yang menyiapkan semua data yang diperlukan untuk mendeskripsikan setiap pencapaian kepada pengguna di lokalitas yang berbeda. Pencapaian diterjemahkan sesuai dengan lokalitas yang ditentukan untuk game.

File ini harus menyertakan informasi sebagai nilai yang dipisahkan koma dalam urutan berikut:

Name, Localized name, Localized description, locale

Kolom-kolom ini dijelaskan dalam tabel berikut:

Header kolom CSV	Wajib Diisi atau Opsional	Deskripsi	Nilai yang diterima
Nama	Wajib	Harus cocok dengan kolom Nama dari AchievementsMetadata.csv.	Maksimum 100 karakter
Nama yang dilokalkan	Wajib	Nama yang dilokalkan untuk pencapaian.	Maksimum 100 karakter
Deskripsi yang dilokalkan	Opsional	Deskripsi yang dilokalkan untuk pencapaian dalam lokalitas yang ditentukan.	Maksimum 500 karakter
Lokal	Wajib	Kode lokalitas seperti en-US.	Tambahkan terjemahan untuk game Anda sebelum menentukan lokalitas. Perhatikan bahwa Anda tidak dapat menentukan lokalitas default. Kode lokalitas yang didukung dapat ditemukan dalam daftar bahasa yang didukung.

Persyaratan file AchievementsLocalizations.csv:

• Nama pencapaian dalam game harus unik per lokalitas. Misalnya, jika game mendukung lokalitas en-US dan fr-FR, pencapaian yang bernama "Achievement1" untuk en-US juga dapat diberi nama "Achievement1" untuk fr-FR.
• Setiap baris harus memiliki empat nilai. Jika Anda ingin menghapus nilai Deskripsi yang dilokalkan, kosongkan nilai tersebut.

Contoh file AchievementsLocalizations.csv:

Achievement1,Achievement One,This is the description of achievement one in English.,en-US

Achievement1,Achievement Un,Voici la description de l'achievement un en français.,fr-FR

Achievement2,Achievement Two,Description of achievement two.,en-US

Achievement2,Logro Dos,Descripción del logro dos.,es-ES

Achievement3,Achievement Three,,en-US

Achievement3,Erfolg Drei,,de-DE

Format AchievementsIconMappings.csv

File AchievementsIconMappings.csv adalah file opsional yang digunakan untuk memetakan pencapaian Anda dengan ikon yang diberikan. File ini harus menyertakan informasi sebagai nilai yang dipisahkan koma dalam urutan berikut:

Nama, nama file ikon

Kolom-kolom ini dijelaskan dalam tabel berikut:

Header kolom CSV	Wajib Diisi atau Opsional	Deskripsi
Nama	Wajib	Harus cocok dengan kolom Nama dari AchievementsMetadata.csv.
Nama file ikon	Wajib	Nama file ikon Anda.

Persyaratan file AchievementsIconMappings.csv:

• Setiap baris harus memiliki dua nilai.
• File ikon hanya boleh dalam format PNG atau JPEG.

Contoh file AchievementsIconMappings.csv:

Valid Achievement,valid-achievement-icon.png

Incremental Achievement,incremental-achievement-icon.jpeg

No Description,no-description-icon.png

Hidden Initial State,hidden-initial-state-icon.png

Large Point Value,large-point-value-icon.jpeg

File Ikon

Ikon yang Anda referensikan dalam file AchievementsIconMappings.csv harus ada dalam arsip zip saat ini yang Anda impor. Untuk informasi selengkapnya, lihat Panduan ikon.

Menambahkan terjemahan untuk pencapaian

Anda dapat menentukan terjemahan Anda sendiri untuk pencapaian yang terkait dengan game Anda. Sebelum melakukannya, pastikan Anda sudah menyelesaikan langkah-langkah yang dijelaskan dalam Menambahkan terjemahan untuk game.

Ada dua cara untuk menambahkan terjemahan game:

• Anda dapat menggunakan opsi Impor pencapaian untuk mengupload terjemahan untuk banyak pencapaian baru sekaligus. Anda tidak dapat menggunakan opsi ini untuk mengupload terjemahan pencapaian yang sudah ada.
• Anda dapat menambahkan terjemahan untuk setiap pencapaian dalam game. Untuk menambahkan terjemahan Anda sendiri untuk setiap pencapaian:
  1. Di Konsol Google Play, buka tab Pencapaian untuk game Anda, lalu pilih pencapaian yang sudah ada.
  2. Di halaman detail pencapaian, pilih tab untuk bahasa yang sebelumnya Anda tambahkan di tab Detail game.
  3. Di halaman detail pencapaian untuk bahasa tersebut, edit formulir yang berisi terjemahan untuk pencapaian tersebut.
  4. Klik Simpan untuk menyimpan detail pencapaian yang telah diterjemahkan.

Papan Peringkat

Melalui papan peringkat, Anda memberikan tempat bagi para pemain game untuk membandingkan skor dengan teman-temannya dan berkompetisi dengan pemain teratas.

Catatan: Skor papan peringkat tidak dapat direset, tetapi Anda dapat menghapus atau menyembunyikan papan peringkat kapan saja.

Untuk menyembunyikan skor yang mencurigakan di papan peringkat yang sudah ada, Anda dapat mengaktifkan perlindungan terhadap modifikasi tidak sah papan peringkat pada halaman Papan Peringkat game Anda di Konsol Google Play.

Membuat papan peringkat

Untuk membuat papan peringkat untuk game baru dan yang tidak dipublikasikan, selesaikan langkah-langkah berikut:

1. Di Konsol Google Play, pilih game.
2. Buka Grow > Layanan game Google Play > Penyiapan dan pengelolaan > Papan peringkat, lalu klik tombol Buat papan peringkat.
3. Isi informasi yang diperlukan untuk papan peringkat ini.
4. Klik Simpan sebagai draf, dan papan peringkat Anda akan tersedia dalam status "Draf".
5. Setelah Anda memublikasikan game, semua papan peringkat game akan dipublikasikan bersama game.

Membuat papan peringkat untuk game yang dipublikasikan

Untuk membuat papan peringkat tambahan bagi game yang telah dipublikasikan, ikuti langkah-langkah yang sama seperti di atas. Untuk mengetahui informasi selengkapnya tentang pengujian versi game yang telah diupdate, lihat Memublikasikan Perubahan Game.

Setelah menguji papan peringkat dan merasa puas, Anda dapat memublikasikan ulang game dengan papan peringkat baru, dan game tersebut akan diluncurkan ke seluruh dunia.

Mengedit papan peringkat

Untuk mengedit papan peringkat yang sudah Anda buat, klik papan peringkat di tab Papan Peringkat di Konsol Google Play. Pada tahap ini, Anda akan melihat formulir yang sama dengan yang digunakan saat pertama kali membuat papan peringkat, dan Anda dapat mengedit kolom apa pun sesuai kebutuhan.

Setelah selesai mengedit papan peringkat, klik tombol Simpan sebagai draf. Papan peringkat yang baru diedit akan berada dalam status "Draf", yang memungkinkan Anda mengujinya.

Jika berfungsi dengan benar, pilih Publikasikan perubahan dari kotak di bagian atas formulir papan peringkat, dan Anda akan dapat memublikasikan ulang game, beserta semua papan peringkat yang telah diperbarui, untuk publik.

Mengurungkan pengeditan

Jika Anda tidak menyukai papan peringkat yang baru diedit dan ingin kembali ke iterasi sebelumnya, cukup pilih Kembalikan dari kotak di bagian atas formulir Papan Peringkat. Papan peringkat Anda akan kembali ke versi yang sudah dipublikasikan.

Menghapus papan peringkat

Anda dapat menghapus papan peringkat yang ada dalam status "Draf" atau yang telah dipublikasikan. Untuk menghapus papan peringkat di Konsol Google Play, buka formulir untuk papan peringkat, lalu klik Hapus papan peringkat di bagian atas formulir.

Atau, Anda dapat memanggil Players.hide untuk menyembunyikan papan peringkat pemain di aplikasi.

Mereset papan peringkat

Anda hanya dapat mereset data progres pemain untuk papan peringkat draf.

• Untuk mereset papan peringkat di Konsol Google Play, klik Reset progres di bagian atas formulir untuk peristiwa tersebut.
• Untuk mereset data papan peringkat secara terprogram, panggil metode Management API.

Menambahkan terjemahan untuk papan peringkat

Anda dapat menentukan terjemahan sendiri untuk papan peringkat yang terkait dengan game Anda. Sebelum melakukannya, pastikan Anda sudah menyelesaikan langkah-langkah yang dijelaskan dalam Menambahkan terjemahan untuk game. Anda juga harus membuat satu atau beberapa papan peringkat untuk game Anda.

Guna menambahkan terjemahan Anda sendiri untuk papan peringkat, buka tab Papan Peringkat untuk game Anda di Konsol Google Play, lalu pilih papan peringkat yang sudah ada. Di halaman detail papan peringkat, klik tab untuk bahasa yang sebelumnya Anda tambahkan di tab Detail game. Di halaman detail papan peringkat untuk bahasa tersebut, edit formulir dengan terjemahan Anda untuk papan peringkat tersebut. Klik Simpan untuk menyimpan detail papan peringkat yang telah diterjemahkan.

Menyembunyikan skor papan peringkat

Layanan game Google Play menyediakan fitur perlindungan terhadap modifikasi tidak sah pada papan peringkat yang memeriksa skor yang dicurigai telah dimodifikasi, dan menyembunyikannya secara otomatis. Fitur ini hanya tersedia untuk game Android.

Perlindungan terhadap modifikasi tidak sah diaktifkan secara default untuk papan peringkat baru yang Anda buat untuk game Android, tetapi dinonaktifkan untuk papan peringkat yang sudah ada. Guna mengaktifkan perlindungan terhadap modifikasi tidak sah untuk papan peringkat yang sudah ada dan telah dipublikasikan, ikuti langkah-langkah berikut:

1. Di Konsol Google Play, buka tab Layanan game, lalu pilih game Anda dari daftar.
2. Buka tab Papan peringkat, lalu pilih instance papan peringkat tempat Anda ingin mengaktifkan perlindungan terhadap modifikasi tidak sah.
3. Alihkan opsi Aktifkan perlindungan terhadap modifikasi tidak sah papan peringkat ke AKTIF.
4. Klik Simpan dan lanjutkan.
5. Publikasikan game Anda.

Setelah perlindungan terhadap modifikasi tidak sah diaktifkan untuk papan peringkat di Konsol Google Play, mungkin diperlukan waktu hingga 24 jam sebelum fitur ini aktif. Skor yang dikirimkan sebelum Anda mengaktifkan perlindungan terhadap modifikasi tidak sah tidak akan disembunyikan secara retroaktif.

Dalam beberapa situasi, Anda dapat menonaktifkan perlindungan terhadap modifikasi tidak sah (misalnya, jika game juga berjalan di web selain Android, dan membagikan papan peringkat di seluruh platform ini).

Game tersimpan

Game yang disimpan dapat memudahkan para pemain game untuk menyimpan dan melanjutkan game. Kemajuan pemain dan metadata akan disinkronkan ke berbagai perangkat yang menggunakan layanan game Google Play.

Kunjungi situs Google Developers untuk mempelajari cara menerapkan game tersimpan.

Mengaktifkan Game Tersimpan

Untuk mengaktifkan layanan Game Tersimpan, selesaikan langkah-langkah ini di Konsol Google Play:

1. Di Konsol Google Play, pilih game.
2. Di halaman Layanan game Google Play - Konfigurasi (Grow > Layanan game Google Play > Penyiapan dan pengelolaan > Konfigurasi), pilih Edit properti.
3. Alihkan opsi Game Tersimpan ke AKTIF.
4. Klik Simpan.

Setelah melakukan langkah-langkah di atas, mungkin perlu waktu hingga 24 jam agar Layanan game Google Play mengaktifkan Layanan Game Tersimpan untuk game Anda. Jika Anda ingin segera menguji Layanan Game Tersimpan, hapus data secara manual di aplikasi Layanan Google Play di perangkat pengujian.

Untuk menghapus data cache di Android, buka Setelan > Aplikasi > Layanan Google Play, klik Kelola Ruang, lalu klik Hapus Semua Data.

Untuk informasi selengkapnya tentang layanan Game Tersimpan, lihat Panduan game Game Tersimpan.

Tambahkan terjemahan

Anda dapat menetapkan terjemahan sendiri untuk detail game, termasuk nama tampilan, deskripsi game, dan aset visual. Anda juga dapat menentukan terjemahan sendiri untuk pencapaian dan papan peringkat yang terkait dengan game Anda.

Guna menambahkan terjemahan Anda sendiri untuk detail game:

1. Di Konsol Google Play, pilih game.
2. Buka halaman Layanan game Google Play - Konfigurasi (Grow > Layanan game Google Play > Penyiapan dan pengelolaan > Konfigurasi).
3. Pilih Edit properti.
4. Pilih Kelola terjemahan > Kelola terjemahan Anda sendiri.
5. Pilih bahasa untuk terjemahan, lalu klik Terapkan untuk mengonfirmasi pilihan Anda. Di halaman Properti, bahasa yang Anda pilih akan tersedia di pemilih bahasa.
6. Pilih bahasa yang ingin diedit dari pemilih bahasa, lalu edit formulir dengan terjemahan Anda untuk nama tampilan, deskripsi, dan aset visual.
7. Klik Simpan perubahan untuk menyimpan detail game yang diterjemahkan.

Untuk informasi selengkapnya tentang menambahkan terjemahan untuk pencapaian dan papan peringkat, lihat panduan pencapaian dan papan peringkat.

Saat menampilkan string pencapaian, papan peringkat, dan detail game, Layanan game Google Play menggunakan bahasa yang didukung game dan paling dekat dengan bahasa yang diminta pengguna. Misalnya, jika preferensi bahasa perangkat pengguna disetel ke bahasa Prancis (Kanada) (fr-CA), tetapi game hanya mendukung bahasa Inggris (Amerika Serikat) (en-US) dan Prancis (Prancis) (fr-FR), Layanan game Google Play akan memilih string fr-FR untuk ditampilkan karena ini adalah bahasa yang paling mendekati.

Memberikan izin edit kepada pengguna

Untuk mengedit setelan Layanan game Google Play dalam Konsol Play, Anda harus memastikan bahwa tim Anda memiliki izin yang tepat untuk mengelola Layanan game Google Play. Lihat Menambahkan pengguna akun developer dan mengelola izin untuk mengetahui informasi selengkapnya tentang izin di Konsol Google Play.

Google Play Game Services Publishing API

Untuk mengotomatiskan konfigurasi aplikasi dan mengintegrasikan rilis ke dalam alat dan proses otomatis yang sudah ada, Anda dapat menggunakan Google Play Game Services Publishing API. Berikut cara mengaktifkan akses ke Google Play Games Services Publishing API menggunakan Konsol Google Play.

1. Buka Konsol Google Play.
2. Buka PenyiapanAkses API.
3. Jika belum melakukannya, buatlah project tertaut.
4. Di samping "API konfigurasi game", klik tombol Aktifkan.

Mengelola beberapa pengguna

Jika ada beberapa pengguna yang mengelola game di akun developer Anda, Anda harus mengelola izin dari Halaman pengguna dan izin di Konsol Google Play.