Bu kılavuzda, görsel skor tabloları oluşturmak, bir oyuncunun skorunu kaydetmek ve bu skoru oyuncunun önceki oyun oturumlarındaki skoruyla karşılaştırmak için Android uygulamalarında skor tablosu API'lerinin nasıl kullanılacağı gösterilmektedir. API'leri com.google.android.gms.games
ve com.google.android.gms.games.leaderboards
paketlerinde bulabilirsiniz.
Başlamadan önce
Henüz yapmadıysanız puan tablosu oyun konseptlerini incelemeniz faydalı olabilir.
Lider tabloları API'lerini kullanarak kodlamaya başlamadan önce:
- Google Play Hizmetleri SDK'sını kurma kılavuzundaki Google Play Oyun Hizmetleri'ni kullanmak için uygulamanızı yükleme ve ayarlama talimatlarını uygulayın.
- Google Play Console kılavuzundaki talimatları uygulayarak oyununuzun göstermesini veya güncellemesini istediğiniz lider tablolarını tanımlayın.
- Android örnekleri sayfasında yer alan lider tablosu kod örneklerini indirip inceleyin.
- Kalite Kontrol Listesi'nde açıklanan önerileri inceleyin.
Liderlik tabloları istemcisini alma
Skor tabloları API'sini kullanmaya başlamak için oyununuzun önce bir LeaderboardsClient
nesnesi alması gerekir.
Bunu, Games.getLeadeboardsClient()
yöntemini çağırıp etkinliği ve mevcut oynatıcı için GoogleSignInAccount
öğesini ileterek yapabilirsiniz. Oyuncu hesabı bilgilerini nasıl alacağınızı öğrenmek için Android oyunlarında oturum açma başlıklı makaleyi inceleyin.
Oyuncunun skorunu güncelleyin
Oyuncunun puanı değiştiğinde (örneğin, oyuncu oyunu bitirdiğinde) oyununuz, LeaderboardsClient.submitScore()
numarasını çağırıp skor tablosu kimliğini ve ham puan değerini ileterek skor tablosunda skorunu güncelleyebilir.
Aşağıdaki kod snippet'inde, uygulamanızın oyuncunun puanını nasıl güncelleyebileceği gösterilmektedir:
Games.getLeaderboardsClient(this, GoogleSignIn.getLastSignedInAccount(this)) .submitScore(getString(R.string.leaderboard_id), 1337);
İyi bir uygulama, strings.xml
dosyanızda skor tablosu kimliğini tanımlamaktır. Böylece oyununuz, kaynak kimliğine göre skor tablolarına referans verebilir. Oyuncu puanlarını güncellemek ve yüklemek için çağrı yaparken API kotanızı aşmamak için bu en iyi uygulamaları da izlediğinizden emin olun.
Skor tablosu görüntüleme
Skor tablosunu görüntülemek için LeaderboardsClient.getLeaderboardIntent()
çağrısı yaparak varsayılan skor tablosu kullanıcı arayüzünü oluşturmak üzere bir Intent
kodu alın. Ardından oyununuz startActivityForResult
çağrısını yaparak kullanıcı arayüzünü açabilir.
Aşağıdaki kod snippet'inde, uygulamanızın oyuncunun puanını nasıl güncelleyebileceği gösterilmektedir. Kod snippet'inde RC_LEADERBOARD_UI
, istek kodu için rastgele bir tam sayıdır.
private static final int RC_LEADERBOARD_UI = 9004; private void showLeaderboard() { Games.getLeaderboardsClient(this, GoogleSignIn.getLastSignedInAccount(this)) .getLeaderboardIntent(getString(R.string.leaderboard_id)) .addOnSuccessListener(new OnSuccessListener<Intent>() { @Override public void onSuccess(Intent intent) { startActivityForResult(intent, RC_LEADERBOARD_UI); } }); }
Sonuç döndürülmese bile API'nin arayan paketin kimliğini alabilmesi için startActivityForResult
kullanmamız gerektiğini unutmayın. Varsayılan liderlik tablosu kullanıcı arayüzü örneği aşağıda gösterilmiştir.