Таблицы лидеров в играх для Android

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

Прежде чем вы начнете

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

Прежде чем вы начнете кодировать с помощью API списков лидеров:

Получение клиента таблицы лидеров

Чтобы начать использовать API списков лидеров, ваша игра должна сначала получить объект LeaderboardsClient . Вы можете сделать это, вызвав метод Games.getLeadeboardsClient() и передав действие.

Обновление счета игрока

Когда счет игрока изменяется (например, когда игрок заканчивает игру), ваша игра может обновить его счет в таблице лидеров, вызвав LeaderboardsClient.submitScore() и передав идентификатор таблицы лидеров и исходное значение счета.

В следующем фрагменте кода показано, как ваше приложение может обновлять счет игрока:

PlayGames.getLeaderboardsClient(this)
    .submitScore(getString(R.string.leaderboard_id), 1337);

Хорошей практикой является определение идентификатора таблицы лидеров в файле strings.xml , чтобы ваша игра могла ссылаться на таблицы лидеров по идентификатору ресурса. Выполняя вызовы для обновления и загрузки очков игроков, обязательно следуйте этим рекомендациям , чтобы не превысить квоту API.

Отображение таблицы лидеров

Чтобы отобразить таблицу лидеров, вызовите LeaderboardsClient.getLeaderboardIntent() , чтобы получить Intent для создания пользовательского интерфейса таблицы лидеров по умолчанию. Затем ваша игра может вызвать пользовательский интерфейс, вызвав startActivityForResult .

В следующем фрагменте кода показано, как ваше приложение может обновлять счет игрока. Во фрагменте кода RC_LEADERBOARD_UI — это произвольное целое число для кода запроса.

private static final int RC_LEADERBOARD_UI = 9004;

private void showLeaderboard() {
  PlayGames.getLeaderboardsClient(this)
      .getLeaderboardIntent(getString(R.string.leaderboard_id))
      .addOnSuccessListener(new OnSuccessListener<Intent>() {
        @Override
        public void onSuccess(Intent intent) {
          startActivityForResult(intent, RC_LEADERBOARD_UI);
        }
      });
}

Обратите внимание, что даже если результат не возвращается, мы должны использовать startActivityForResult , чтобы API мог получить идентификатор вызывающего пакета. Пример пользовательского интерфейса таблицы лидеров по умолчанию показан ниже.