В этом руководстве показано, как использовать API-интерфейсы списков лидеров в приложении для Android для создания визуальных списков лидеров, записи результатов игроков и сравнения результатов с результатами предыдущих игровых сессий. API можно найти в пакетах com.google.android.gms.games
и com.google.android.gms.games.leaderboards
.
Прежде чем вы начнете
Если вы еще этого не сделали, возможно, вам будет полезно ознакомиться с концепциями игр с таблицами лидеров .
Прежде чем вы начнете кодировать с помощью API списков лидеров:
- Следуйте инструкциям по установке и настройке приложения для использования игровых сервисов Google Play в руководстве по настройке SDK сервисов Google Play .
- Определите списки лидеров, которые вы хотите отображать или обновлять в своей игре, следуя инструкциям в руководстве по консоли Google Play .
- Загрузите и просмотрите примеры кода списков лидеров на странице примеров Android .
- Ознакомьтесь с рекомендациями, описанными в контрольном списке качества .
Получение клиента таблицы лидеров
Чтобы начать использовать 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 мог получить идентификатор вызывающего пакета. Пример пользовательского интерфейса таблицы лидеров по умолчанию показан ниже.