Достижения в играх для Android

В этом руководстве рассказывается, как использовать API достижений в приложении для Android, чтобы разблокировать и показывать достижения в игре. API можно найти в пакетах com.google.android.gms.games и com.google.android.gms.games.achievements.

Подготовка

Если вы ещё не сделали этого, рекомендуем ознакомиться с основными понятиями, связанными с достижениями.

Прежде чем начать программирование с использованием API достижений, выполните следующие действия:

Как получить клиент достижений

Чтобы начать работу с 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);
        }
      });
}

На изображении ниже показан пример интерфейса достижений по умолчанию.

В строке Рекомендуемые показано самое популярное достижение, которое игрок ещё не разблокировал.

Стандартный интерфейс достижений, в котором показаны рекомендуемые и разблокированные достижения.