Bu rehber, bir Android uygulamasında başarı API'lerinin nasıl kullanılacağını gösterir.
kullanabilirsiniz. API'ler,
com.google.android.gms.games
ve com.google.android.gms.games.achievements
paketleri dahildir.
Başlamadan önce
Henüz yapmadıysanız başarılar oyunu kavramlarını inceleyin.
Başarılar API'sini kullanarak kodlamaya başlamadan önce:
Uygulamanızı kullanmak için yükleme ve ayarlama talimatlarını Google Play Games Hizmetleri Google Play Hizmetleri SDK'sını kurma kılavuzu.
Oyununuzun kilidini açmasını veya görüntülemesini istediğiniz başarıları şu şekilde tanımlayın: Google Play Console rehberindeki talimatları uygulayın.
Başarı kodu örneklerini Android örnekleri sayfası.
Şu bölümde açıklanan öneriler hakkında bilgi edinin: Kalite Kontrol Listesi.
Bir başarı müşterisi edinin
Başarılar API'sini kullanmaya başlamak için oyununuzun önce bir
AchievementsClient
nesnesini tanımlayın. Bunu,
Games.getAchievementClient()
ve etkinliği iletmenizi sağlar.
Başarıların kilidini açın
Bir başarının kilidini açmak için
AchievementsClient.unlock()
yöntemini kullanın ve başarı kimliğini iletin.
Aşağıdaki kod snippet'i, uygulamanızın başarıların kilidini nasıl açabileceğini gösterir:
PlayGames.getAchievementsClient(this).unlock(getString(R.string.my_achievement_id));
Başarı artımlı türdeyse (yani
(kilitlemek için gereklidir), bunun yerine AchievementsClient.increment()
numaralı telefonu arayın.
Aşağıdaki kod snippet'i, uygulamanızın oynatıcının başarı:
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 Games Hizmetleri istenen sayıya ulaştığında başarının kilidini otomatik olarak açar adımları.
Başarı kimliklerini strings.xml
dosyasında tanımlamak iyi bir uygulamadır.
Oyununuz kaynak kimliğine göre başarılara başvurabilir. Çağrı yaparken
başarıları güncelleyebilir ve yükleyebilirsiniz. Ayrıca,
API'nizi aşmamaya yönelik en iyi uygulamalar
kota.
Başarıları görüntüle
Bir oyuncunun başarılarını görmek için AchievementsClient.getAchievementsIntent()
numaralı telefonu arayın
almak için
Intent
kullanıcı arayüzünü oluşturun. Oyununuz daha sonra
şunu çağırarak kullanıcı arayüzünü
startActivityForResult
.
Aşağıdaki kod snippet'i, uygulamanızın varsayılan
kullanıcı arayüzü. Snippet'te RC_ACHIEVEMENT_UI
rastgele bir değerdir
Oyunun istek kodu olarak kullandığı tam sayı.
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ı kullanıcı arayüzünün bir örneği aşağıda gösterilmektedir.