Android oyunlarındaki başarılar

Bu kılavuzda, oyununuzdaki başarıların kilidini açmak ve bunları göstermek için Android uygulamasında başarı API'lerinin nasıl kullanılacağı açıklanmaktadır. API'leri com.google.android.gms.games ve com.google.android.gms.games.achievements paketlerinde bulabilirsiniz.

Başlamadan önce

Henüz yapmadıysanız başarılarla ilgili oyun kavramlarını incelemeniz faydalı olabilir.

Başarılar API'sini 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 kılavuzundaki talimatları uygulayarak oyununuzun kilidini açmasını veya göstermesini istediğiniz başarıları tanımlayın.

• Android örnekleri sayfasındaki başarı kodu örneklerini indirip inceleyin.

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

Başarılar istemcisi edinme

Başarılar API'sini kullanmaya başlamak için oyununuzun önce bir AchievementsClient nesnesi alması gerekir. Bunu, Games.getAchievementClient() yöntemini çağırıp etkinliği ileterek yapabilirsiniz.

Başarıların kilidini açma

Bir başarının kilidini açmak için AchievementsClient.unlock() yöntemini çağırın ve başarı kimliğini iletin.

Aşağıdaki kod snippet'inde, uygulamanızın başarıların kilidini nasıl açabileceği gösterilmektedir:

PlayGames.getAchievementsClient(this).unlock(getString(R.string.my_achievement_id));

Başarı artımlı türdeyse (yani kilidini açmak için birkaç adım gerekiyorsa) bunun yerine AchievementsClient.increment() işlevini çağırın.

Aşağıdaki kod snippet'inde, uygulamanızın oyuncunun başarısını nasıl artırabileceği gösterilmektedir:

PlayGames.getAchievementsClient(this).increment(getString(R.string.my_achievement_id), 1);

Başarının kilidini açmak için ek kod yazmanız gerekmez. Google Play Oyun Hizmetleri, gerekli adım sayısına ulaşıldığında başarıyı otomatik olarak açar.

Başarı kimliklerini strings.xml dosyasında tanımlamak iyi bir uygulamadır. Böylece oyununuz, kaynak kimliğine göre başarılara başvurabilir. Başarıları 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.

Başarıları görüntüleme

Bir oyuncunun başarılarını göstermek için AchievementsClient.getAchievementsIntent() çağrısını yaparak Intent alın ve varsayılan başarılar kullanıcı arayüzünü oluşturun. Oyununuz daha sonra startActivityForResult işlevini çağırarak kullanıcı arayüzünü gösterebilir.

Aşağıdaki kod snippet'i, uygulamanızın varsayılan başarı kullanıcı arayüzünü nasıl gösterebileceğini gösterir. Snippet'te RC_ACHIEVEMENT_UI, oyunun istek kodu olarak kullandığı rastgele bir tam sayıdır.

private static final int RC_ACHIEVEMENT_UI = 9003;

private void showAchievements() {
  PlayGames.getAchievementsClient(this)
      .getAchievementsIntent()
      .addOnSuccessListener(new OnSuccessListener<Intent>() {
        @Override
        public void onSuccess(Intent intent) {
          startActivityForResult(intent, RC_ACHIEVEMENT_UI);
        }
      });
}

Varsayılan başarılar kullanıcı arayüzünün bir örneği aşağıda gösterilmektedir.