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:
- 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.
- Layanan game Google Play memeriksa apakah skor ini lebih baik daripada skor pemain saat ini entri papan peringkat untuk skor harian, mingguan, atau sepanjang waktu. Jika ya, Layanan game Google Play memperbarui papan peringkat yang sesuai dengan skor baru.
- 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 laporan harian saat ini, skor tertinggi mingguan, atau sepanjang masa adalah untuk pemain ini.
- 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 menjalankan semua penyaringan yang diperlukan, dan kemudian mengirimkan hasilnya kembali ke klien.
- Jika ada banyak skor untuk dilaporkan, layanan Game akan mengirimkan kembali hanya data untuk skor papan peringkat teratas. Anda juga bisa mengambil data data skor untuk skor teratas atau skor yang berdekatan dengan 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
SDK Play Game secara otomatis membuat versi harian, mingguan, dan sepanjang waktu setiap papan peringkat yang Anda buat. Anda tidak perlu membuat papan peringkat 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 oleh Konsol Google Play buat 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 selama layanan Game dapat menyajikannya kepada pengguna dalam sejumlah 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 sebagai3.14159
,3141.59
, atau314159
, 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 sebagai1: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
Ketika pustaka klien seluler meminta data papan peringkat dari layanan {i>Game<i}, 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 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 dan yang tidak dipublikasikan, buka Entri Konsol Google Play untuk game Anda, lalu buka Mendorong pertumbuhan > Play Game Layanan > Penyiapan dan pengelolaan > Papan peringkat, lalu klik Tombol Buat papan peringkat.
![Tombol 'Tambahkan Papan Peringkat' di Panel Papan Peringkat utama](https://developers-dot-devsite-v2-prod.appspot.com/static/games/services/images/leaderboardAddNew.png?authuser=4&hl=id)
Kemudian, cukup isi informasi yang diperlukan untuk papan peringkat ini.
![Formulir yang diisi untuk papan peringkat 'Putaran terbaik'.](https://developers-dot-devsite-v2-prod.appspot.com/static/games/services/images/leaderboardSampleForm.png?authuser=4&hl=id)
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 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 papan peringkat memeriksa skor yang dicurigai dirusak 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:
- Di Konsol Google Play, buka tab Layanan game, lalu pilih game dari daftar.
- Buka tab Papan peringkat, lalu pilih instance papan peringkat tempat Anda ingin mengaktifkan perlindungan terhadap modifikasi tidak sah.
- Alihkan opsi Aktifkan perlindungan terhadap modifikasi tidak sah papan peringkat ke AKTIF.
- Klik Simpan dan lanjutkan.
- Publikasikan game Anda.
Setelah diaktifkan untuk papan peringkat di Konsol Google Play, perlindungan terhadap modifikasi tidak sah akan diaktifkan mungkin memerlukan waktu hingga 24 jam sebelum fitur ini diterapkan. 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: