Papan peringkat

Papan peringkat bisa menjadi cara seru untuk mendorong kompetisi antarpemain, baik untuk penggemar berat (yang akan bertanding untuk posisi teratas di papan peringkat publik) maupun untuk pemain yang lebih santai (yang tertarik untuk membandingkan progresnya dengan teman-teman mereka).

Guna mempelajari cara mengimplementasikan papan peringkat untuk platform Anda, lihat Penerapan klien.

Memahami papan peringkat

Saat Anda membuat papan peringkat, layanan game Google Play akan menangani pengelolaan sebagian besar aspek papan peringkat ini untuk Anda. Umumnya, prosesnya sebagai berikut:

  1. Di akhir game (atau pada waktu yang tepat yang telah Anda tentukan), game akan mengirimkan skor pemain ke satu atau beberapa papan peringkat yang telah Anda buat untuk game tersebut.
  2. Layanan game Google Play memeriksa apakah skor ini lebih baik daripada entri papan peringkat pemain saat ini untuk skor harian, mingguan, atau sepanjang waktu. Jika ya, layanan game Google Play akan memperbarui papan peringkat yang sesuai dengan skor baru.
  3. Layanan game Google Play mengirimkan laporan skor kembali ke klien game. Laporan ini memberi tahu klien apakah ini skor tertinggi harian, mingguan, atau sepanjang waktu yang baru. Jika tidak, Layanan game Google Play akan memberi tahu klien skor tertinggi harian, mingguan, atau sepanjang waktu untuk pemain ini.
  4. Guna mengambil hasil pemain untuk papan peringkat, Anda dapat meminta jangka waktu (harian, mingguan, atau sepanjang waktu), dan menentukan apakah pengguna ingin melihat papan peringkat sosial atau publik. Layanan Game melakukan semua pemfilteran yang diperlukan, lalu mengirimkan hasilnya kembali ke klien.
  5. Jika ada banyak skor yang dilaporkan, layanan Game hanya akan mengirim ulang data untuk skor papan peringkat teratas. Anda juga dapat mengambil data skor mentah untuk skor teratas atau skor yang berdekatan dengan skor pemain.

Beberapa papan peringkat

Game dapat memiliki beberapa papan peringkat, maksimum hingga 70. Misalnya, game multilevel mungkin memberikan papan peringkat yang berbeda untuk setiap level, dan game balapan mungkin memiliki papan peringkat terpisah untuk setiap jalur.

Jangka waktu papan peringkat

Play Game SDK secara otomatis membuat versi harian, mingguan, dan sepanjang waktu dari setiap papan peringkat yang Anda buat. Anda tidak perlu membuat papan peringkat terpisah untuk setiap jangka waktu.

Papan peringkat harian direset ke UTC-7 (yaitu "tengah malam pada Waktu Musim Panas Pasifik") sepanjang tahun.

Papan peringkat mingguan direset pada tengah malam antara hari Sabtu dan Minggu, dalam zona waktu yang sama dengan papan peringkat harian (UTC-7).

Papan peringkat sosial dan publik

Play Game SDK dapat menampilkan dua versi berbeda dari setiap papan peringkat kepada pemain:

Papan peringkat sosial adalah papan peringkat yang terdiri dari orang-orang di lingkaran pengguna (atau lebih tepatnya, anggota lingkaran yang telah dipilih pengguna untuk dibagikan dengan aplikasi Anda) yang memutuskan untuk membagikan aktivitas gameplay-nya kepada pengguna.

Papan peringkat publik adalah papan peringkat yang terdiri dari pemain yang telah memilih untuk membagikan aktivitas gameplay mereka secara publik. Jika pemain belum memilih untuk membagikan aktivitas gameplay mereka secara publik, mereka tidak akan muncul di papan peringkat ini.

Menampilkan papan peringkat

Dalam library klien seluler, library menangani semua format dan tampilan papan peringkat. Anda dapat menentukan apakah pemain dapat melihat papan peringkat tertentu, atau melihat daftar semua papan peringkat yang dapat mereka pilih.

Anda juga dapat mengimplementasikan papan peringkat versi Anda sendiri dengan mengakses data langsung dari library klien.

Atribut

Untuk membuat dan mengelola papan peringkat, Anda harus memahami atribut papan peringkat berikut:

Dasar-dasar

Elemen dasar ini terkait dengan setiap papan peringkat:

  • ID adalah string unik yang akan dibuat oleh Konsol Google Play untuk Anda. Anda akan menggunakan ID unik ini untuk merujuk ke papan peringkat di klien game Anda.
  • Nama adalah nama pendek papan peringkat (misalnya, "Skor Tinggi" atau "Level 3"). Nama dapat berisi maksimal 100 karakter.
  • Ikon adalah ikon persegi yang akan dikaitkan dengan papan peringkat Anda. Untuk praktik terbaik saat membuat ikon papan peringkat, lihat bagian Panduan Ikon di bawah.
  • Urutan daftar adalah urutan papan peringkat yang akan muncul saat pemain melihat papan peringkat yang terkait dengan game Anda.
  • Batas adalah nilai opsional yang menentukan batas skor bawah dan atas yang diizinkan di papan peringkat. Batas dapat membantu Anda menghapus pengiriman skor yang jelas-jelas merupakan penipuan. Anda juga dapat menggunakan Players.hide untuk menyembunyikan pemain yang Anda yakini telah mengirimkan skor yang menipu dari semua papan peringkat di aplikasi Anda.

Pengurutan

Papan peringkat dapat memiliki satu dari dua jenis pengurutan berikut:

  • Papan peringkat Lebih besar lebih baik adalah opsi default. Biasanya, ini adalah hal yang Anda lihat di sebagian besar game yang memungkinkan pemain memperoleh poin.
  • Papan peringkat Lebih kecil lebih baik terkadang digunakan jika skor yang lebih kecil dianggap lebih baik. Contoh paling umum dari jenis papan peringkat ini adalah pada game balapan, dengan skor yang menunjukkan waktu pemain untuk menyelesaikan lomba.

Pemformatan skor

Meskipun semua skor dikirim ke papan peringkat dan disimpan secara internal sebagai bilangan bulat panjang, layanan Game dapat menyajikannya kepada pengguna dalam berbagai format:

  • Papan peringkat numerik menyajikan skor sebagai angka. Skor dapat ditampilkan sebagai bilangan bulat atau sebagai bilangan riil dengan jumlah tempat desimal yang tetap. Anda mengirimkan skor sebagai bilangan bulat dan titik desimal dimasukkan dalam lokasi yang ditentukan. Skor 314159, misalnya, akan ditampilkan sebagai 3.14159, 3141.59, atau 314159, bergantung pada tempat desimal yang Anda tentukan.

  • Papan peringkat waktu menyajikan skor dalam format jam / menit / detik / seperseratus detik. Anda harus mengirimkan skor sebagai milidetik, sehingga 66032 akan diinterpretasikan sebagai 1:06.03.

  • Papan peringkat mata uang menyajikan skor dalam format mata uang. Anda mengirimkan skor sebagai 1/1.000.000 dari unit mata uang utama. Misalnya, skor 19.950.000 akan diinterpretasikan sebagai $19.95, dengan asumsi Anda menentukan mata uang sebagai USD.

Papan peringkat numerik juga mendukung unit khusus. Misalnya, jika game Anda mengukur skor tertinggi dalam meter, Anda dapat menentukan "meter" sebagai unit default untuk papan peringkat Anda.

Terjemahan dan pemformatan skor

Saat library klien seluler meminta data papan peringkat dari layanan Game, library tersebut akan menentukan bahasa dan lokalitas untuk menampilkan skor tersebut. Dengan REST API, Anda juga dapat menentukan bahasa berbasis lokalitas. Layanan game menampilkan skor papan peringkat berformat yang sesuai untuk bahasa dan lokalitas tersebut. Skor yang diformat ini akan muncul terlepas dari apakah Anda telah menambahkan terjemahan atau tidak untuk papan peringkat.

Untuk papan peringkat Numerik, format angka ditampilkan berbeda untuk setiap bahasa. (Misalnya, 12,345.78 di AS, dan 12 345,78 di Prancis.) Jika Anda menggunakan unit kustom dan telah menambahkan terjemahan ke game, Anda harus menyediakan unit terjemahan untuk setiap bahasa yang telah ditambahkan. Kemudian, layanan akan menampilkan unit terjemahan tersebut jika sesuai.

Bergantung pada bahasa yang dipilih, Anda mungkin perlu memberikan versi nama unit yang berbeda. Dalam bahasa Inggris, Anda memerlukan versi untuk satu item, dan versi lain untuk item lainnya (misalnya, "meter" dan "meters"). Di sisi lain, untuk bahasa Polandia, Anda harus menyediakan versi untuk satu unit, beberapa unit, banyak unit, dan lainnya. Untuk mempelajari aturan bentuk jamak lebih lanjut, lihat String Kuantitas (Jamak).

Untuk papan peringkat Waktu, format waktu ditampilkan sesuai dengan bahasa dan lokalitas pemain. Hal ini terutama akan terlihat jika Anda menggunakan fraksi detik atau memiliki nilai jam dengan lebih dari 3 digit (misalnya, 4,815:16:23.42 di AS dan 4.815:16:23,42 di Jerman).

Untuk papan peringkat Mata Uang, format mata uang akan ditampilkan sesuai dengan bahasa dan lokalitas pemain. Namun, Anda tidak dapat mengubah unit mata uang. Misalnya, jika Anda menentukan mata uang dalam USD, game akan menampilkan $19.95 di AS dan 19,95 $ di Prancis. Tetapi Anda tidak dapat menentukan bahwa game Anda menampilkan dolar di AS dan Euro di Prancis.

Pedoman ikon

Ikon harus dibuat sebagai file PNG atau JPEG berukuran 512 x 512. Ukuran ikon Anda akan diperkecil di sebagian besar klien game, jadi sebaiknya Anda tidak membuat ikon dengan detail yang terlalu kecil. Anda dapat mengirimkan ikon dengan saluran alfa, dan transparansi akan dipertahankan. Ikon papan peringkat akan ditampilkan dengan latar belakang abu-abu yang lebih gelap di perangkat Android, jadi pilih ikon yang dapat berfungsi dengan baik dalam situasi ini.

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

Membuat papan peringkat

Bagian ini menunjukkan cara membuat papan peringkat untuk game baru atau yang sudah ada.

Membuat papan peringkat untuk game baru

Untuk membuat papan peringkat game baru yang tidak dipublikasikan, buka entri Konsol Google Play untuk game Anda, lalu buka Grow > Layanan game Play > Penyiapan dan pengelolaan > Papan Peringkat, lalu klik tombol Buat papan peringkat.

Tombol 'Tambahkan Papan Peringkat' di Panel Papan Peringkat utama

Kemudian, cukup isi informasi yang diperlukan untuk papan peringkat ini.

Formulir yang diisi untuk papan peringkat 'Putaran terbaik'.

Klik Simpan sebagai draf, dan papan peringkat Anda akan tersedia dalam status "Draf". 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 keinginan.

Setelah selesai mengedit papan peringkat, klik tombol Simpan sebagai draf. Papan peringkat yang baru diedit akan berada dalam status "Draf", yang memungkinkan Anda untuk 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 Scores Management API.

Menambahkan terjemahan untuk papan peringkat

Anda dapat menentukan terjemahan sendiri untuk papan peringkat yang terkait dengan game Anda. Sebelum melakukannya, pastikan Anda 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).

Implementasi klien

Guna mempelajari cara mengimplementasikan papan peringkat untuk platform Anda, lihat referensi berikut: