Android oyunlarında skor tabloları

Bu kılavuzda, Android uygulamasında skor tablosu API'lerini kullanarak görsel skor tabloları oluşturma, oyuncuların skorlarını kaydetme ve skorları önceki oyun oturumlarındaki oyuncu skorlarıyla karşılaştırma işlemleri açıklanmaktadır. API'leri com.google.android.gms.games ve com.google.android.gms.games.leaderboards paketlerinde bulabilirsiniz.

Başlamadan önce

Henüz yapmadıysanız lider tablolarıyla ilgili oyun kavramlarını incelemeniz faydalı olabilir.

Liderlik tabloları API'lerini kullanarak kod yazmaya başlamadan önce:

• Google Play Hizmetleri SDK'sını Kurma rehberindeki Google Play Games Hizmetleri'ni kullanmak için uygulamanızı yükleme ve ayarlama talimatlarını uygulayın.

• Google Play Console rehberindeki talimatları uygulayarak oyununuzun göstermesini veya güncellemesini istediğiniz skor tablolarını tanımlayın.

• GitHub'daki Android örnekleri sayfasında skor tabloları kod örneklerini indirip inceleyin.

• Kalite Kontrol Listesi'nde açıklanan öneriler hakkında bilgi edinin.

Liderlik tabloları istemcisini edinme

Skor tabloları API'sini kullanmaya başlamak için oyununuzun önce bir LeaderboardsClient nesnesi alması gerekir. Bunu, PlayGames.getLeadeboardsClient() yöntemini çağırıp etkinliği ileterek yapabilirsiniz.

Oyuncunun puanını güncelleme

Oyuncunun puanı değiştiğinde (ör. oyuncu oyunu bitirdiğinde) oyununuz, LeaderboardsClient.submitScore() işlevini çağırıp skor tablosu kimliğini ve ham puan değerini ileterek oyuncunun skorunu skor tablosunda güncelleyebilir.

Aşağıdaki kod snippet'inde, uygulamanızın oyuncunun puanını nasıl güncelleyebileceği gösterilmektedir:

PlayGames.getLeaderboardsClient(this)
    .submitScore(getString(R.string.leaderboard_id), 1337);

İyi bir uygulama olarak, skor tablosu kimliğini strings.xml dosyanızda tanımlayabilirsiniz. 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 aşağıdaki en iyi uygulamaları da uyguladığınızdan 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 Intent alın. Oyununuz daha sonra startActivityForResult işlevini çağırarak kullanıcı arayüzünü gösterebilir.

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() {
  PlayGames.getLeaderboardsClient(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 de API'nin çağıran paketin kimliğini alabilmesi için startActivityForResult kullanmanız gerekir. Varsayılan skor tablosu kullanıcı arayüzünün bir örneği aşağıda gösterilmiştir.