В этом руководстве рассказывается, как использовать API достижений в приложении для Android, чтобы разблокировать и показывать достижения в игре. API можно найти в пакетах com.google.android.gms.games и com.google.android.gms.games.achievements.
Подготовка
Если вы ещё не сделали этого, рекомендуем ознакомиться с основными понятиями, связанными с достижениями.
Прежде чем начать программирование с использованием API достижений, выполните следующие действия:
Следуйте инструкциям по установке и настройке приложения для использования сервисов Google Play Games в руководстве Настройка SDK сервисов Google Play.
Определите достижения, которые будут доступны в игре, следуя инструкциям в руководстве по Google Play Console.
Скачайте и изучите примеры кода для достижений на странице примеров для Android.
Ознакомьтесь с рекомендациями в контрольном списке по качеству.
Как получить клиент достижений
Чтобы начать работу с API достижений, игра должна получить объект AchievementsClient. Для этого вызовите метод Games.getAchievementClient() и передайте в него действие.
Разблокируйте достижения
Чтобы разблокировать достижение, вызовите метод AchievementsClient.unlock() и передайте в него идентификатор достижения.
В следующем фрагменте кода показано, как приложение может разблокировать достижения:
PlayGames.getAchievementsClient(this).unlock(getString(R.string.my_achievement_id));
Если достижение относится к типу Дополнительное (то есть для его разблокировки требуется выполнить несколько шагов), вызовите метод AchievementsClient.increment().
В следующем фрагменте кода показано, как приложение может увеличивать значение достижения игрока:
PlayGames.getAchievementsClient(this).increment(getString(R.string.my_achievement_id), 1);
Вам не нужно писать дополнительный код, чтобы разблокировать достижение. Сервисы Google Play Games автоматически разблокируют достижение, как только будет достигнуто необходимое количество шагов.
Рекомендуем определить идентификаторы достижений в файле strings.xml, чтобы в игре можно было ссылаться на достижения по идентификатору ресурса. При вызове методов для обновления и загрузки достижений следуйте рекомендациям, чтобы не превысить квоту API.
Показывать достижения
Чтобы показать достижения игрока, вызовите метод AchievementsClient.getAchievementsIntent(), который возвращает объект Intent, и создайте стандартный пользовательский интерфейс для достижений. После этого игра может вызвать интерфейс с помощью метода startActivityForResult.
В приведенном ниже фрагменте кода показано, как в приложении можно отобразить стандартный пользовательский интерфейс достижений. В этом фрагменте RC_ACHIEVEMENT_UI – произвольное целое число, которое игра использует в качестве кода запроса.
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); } }); }
На изображении ниже показан пример интерфейса достижений по умолчанию.
В строке Рекомендуемые показано самое популярное достижение, которое игрок ещё не разблокировал.