После прекращения поддержки API входа в Google мы удалим SDK games v1 в 2026 году. После февраля 2025 года вы не сможете публиковать в Google Play игры, которые недавно были интегрированы с SDK games v1. Вместо этого мы рекомендуем использовать SDK games v2.
Хотя существующие игры с интеграцией предыдущих игр v1 продолжат работать еще пару лет, вам рекомендуется перейти на v2, начиная с июня 2025 года.
Это руководство по использованию Play Games Services v1 SDK. Информацию о последней версии SDK см. в документации v2 .
В этом руководстве показано, как использовать API достижений в приложении Android для разблокировки и отображения достижений в вашей игре. API можно найти в пакетах com.google.android.gms.games и com.google.android.gms.games.achievements .
Прежде чем начать
Если вы еще этого не сделали, возможно, вам будет полезно ознакомиться с концепциями игровых достижений .
Прежде чем начать писать код с использованием API достижений:
- Следуйте инструкциям по установке и настройке приложения для использования игровых сервисов Google Play, приведенным в руководстве «Настройка SDK сервисов Google Play» .
- Определите достижения, которые вы хотите разблокировать или отобразить в своей игре, следуя инструкциям в руководстве по Google Play Console .
- Загрузите и ознакомьтесь с примерами кода достижений на странице примеров Android .
- Ознакомьтесь с рекомендациями, описанными в Контрольном списке качества .
Получить клиент достижений
Чтобы начать использовать API достижений, ваша игра должна сначала получить объект AchievementsClient . Это можно сделать, вызвав метод Games.getAchievementClient() и передав ему активность и GoogleSignInAccount для текущего игрока. Чтобы узнать, как получить информацию об учетной записи игрока, см. раздел Вход в игры Android .
Разблокируйте достижения
Чтобы разблокировать достижение, вызовите метод AchievementsClient.unlock() и передайте идентификатор достижения.
Следующий фрагмент кода показывает, как ваше приложение может разблокировать достижения:
Games.getAchievementsClient(this, GoogleSignIn.getLastSignedInAccount(this))
.unlock(getString(R.string.my_achievement_id)); Если достижение имеет инкрементный тип (то есть для его разблокировки требуется несколько шагов), вместо этого вызовите AchievementsClient.increment() .
Следующий фрагмент кода показывает, как ваше приложение может увеличить достижение игрока:
Games.getAchievementsClient(this, GoogleSignIn.getLastSignedInAccount(this))
.increment(getString(R.string.my_achievement_id), 1);Вам не нужно писать дополнительный код, чтобы разблокировать достижение; игровые сервисы Google Play автоматически разблокируют достижение, как только будет достигнуто необходимое количество шагов.
Хорошей практикой является определение идентификаторов достижений в файле strings.xml , чтобы ваша игра могла ссылаться на достижения по идентификатору ресурса. При выполнении вызовов для обновления и загрузки достижений обязательно следуйте этим рекомендациям , чтобы избежать превышения квоты API.
Показать достижения
Чтобы показать достижения игрока, вызовите AchievementsClient.getAchievementsIntent() , чтобы получить Intent для создания пользовательского интерфейса достижений по умолчанию. Затем ваша игра может вызвать пользовательский интерфейс, вызвав startActivityForResult .
Следующий фрагмент кода показывает, как ваше приложение может отображать пользовательский интерфейс достижений по умолчанию. В фрагменте RC_ACHIEVEMENT_UI — это произвольное целое число, которое игра использует в качестве кода запроса.
private static final int RC_ACHIEVEMENT_UI = 9003; private void showAchievements() { Games.getAchievementsClient(this, GoogleSignIn.getLastSignedInAccount(this)) .getAchievementsIntent() .addOnSuccessListener(new OnSuccessListener<Intent>() { @Override public void onSuccess(Intent intent) { startActivityForResult(intent, RC_ACHIEVEMENT_UI); } }); }
Пример пользовательского интерфейса достижений по умолчанию показан ниже.
