Разработка системы достижений Google Play Games
Google Play Games Services предоставляет готовую инфраструктуру для достижений (achievements), таблиц лидеров (leaderboards) и сохранений в облаке. Достижения — пожалуй, самая простая интеграция в этом стеке: Google берёт на себя хранение, UI и синхронизацию между устройствами.
Настройка в Play Console
Прежде чем писать код — настройка в Google Play Console → Play Games Services → Setup and Management. Там создаются достижения с ID, иконками, описаниями и типами (стандартное или инкрементальное с количеством шагов). ID достижений выглядят как CgkI... — строки из Base64, их нужно скопировать в res/values/games_ids.xml через кнопку «Get resources» в Console.
Приложение связывается с Play Games через OAuth. В AndroidManifest.xml нужен <meta-data> с com.google.android.gms.games.APP_ID.
Код разблокировки достижений
Зависимость: com.google.android.gms:play-services-games-v2:19.0.0 (Play Games SDK v2, актуальная версия без legacy PendingResult API).
val gamesSignInClient = PlayGames.getGamesSignInClient(activity)
gamesSignInClient.signIn().addOnCompleteListener { task ->
if (task.isSuccessful) {
val achievementsClient = PlayGames.getAchievementsClient(activity)
// Разблокировать достижение
achievementsClient.unlock(getString(R.string.achievement_first_win))
// Инкрементальное достижение (шаги)
achievementsClient.increment(getString(R.string.achievement_veteran), 1)
}
}
Вызывать unlock() можно многократно — повторная разблокировка уже выполненного достижения игнорируется. increment() для инкрементальных достижений добавляет шаги; когда накопится нужное количество — достижение разблокируется автоматически.
Показ стандартного UI достижений:
achievementsClient.achievementsIntent.addOnSuccessListener { intent ->
startActivityForResult(intent, RC_ACHIEVEMENT_UI)
}
Google отображает красивый список с прогрессом и иконками — свой UI писать не нужно.
Что нужно учесть
SDK v2 требует, чтобы пользователь был авторизован через Play Games перед любыми вызовами. Если пользователь не авторизован — достижения не засчитываются. Нужна логика: попытка автоматического входа при старте, graceful degradation если Play Games недоступен (отсутствует на некоторых устройствах без Google Services).
Тестирование: в Play Console можно сбросить достижения для тест-аккаунта через «Reset achievements». Без этого повторное тестирование разблокировки невозможно.
Настройка системы достижений с 5-15 достижениями: 2-3 дня включая настройку в Play Console, интеграцию SDK и тестирование. Стоимость рассчитывается индивидуально.