Рейтинг игроков

Рейтинги могут стать отличным способом стимулировать конкуренцию между игроками. Это касается как самых преданных поклонников, которые будут бороться за первое место в общем рейтинге, так и обычных игроков, которым будет интересно сравнить свои результаты с достижениями друзей.

Чтобы узнать, как реализовать таблицы лидеров на вашей платформе, ознакомьтесь с разделом Реализация на стороне клиента.

Таблицы лидеров

Когда вы создаете рейтинг игроков, сервисы Play Games берут на себя управление большинством его аспектов. Обычно это происходит так:

1. В конце игры (или в другой подходящий момент) игра отправляет результат игрока в один или несколько рейтингов, созданных вами для этой игры.
2. Сервисы Play Games проверяют, лучше ли этот счет, чем текущий результат игрока в рейтинге игроков за день, неделю или все время. Если да, сервисы Play Games обновят соответствующие рейтинги игроков, добавив новый счет.
3. Сервисы Play Games отправляют отчет о результатах обратно клиенту игры. В этом отчете клиент может узнать, является ли полученная оценка новым дневным, недельным или абсолютным рекордом. Если нет, сервисы Play Games сообщат клиенту, какой текущий рекорд этого игрока за день, неделю или все время.
4. Чтобы получить результаты игрока для таблицы лидеров, можно запросить временной интервал (день, неделю или все время) и указать, хочет ли пользователь видеть социальную или общедоступную таблицу лидеров. Сервисы Play Games выполняют всю необходимую фильтрацию и отправляют результаты клиенту.
5. Если нужно передать много результатов, сервисы Play Games отправляют только данные о лучших результатах рейтинга игроков. Вы также можете получить необработанные данные о лучших результатах или результатах, близких к результату игрока.

Несколько рейтингов

В игре может быть несколько рейтингов, но не более 70. Например, в многоуровневой игре может быть отдельная таблица лидеров для каждого уровня, а в гоночной игре – для каждой трассы.

Периоды для рейтинга

SDK Игр Play автоматически создает ежедневные, еженедельные и общие версии всех таблиц лидеров. Вам не нужно создавать отдельные таблицы лидеров для каждого периода времени.

Ежедневные таблицы лидеров сбрасываются в UTC-7 (то есть в полночь по тихоокеанскому летнему времени) круглый год.

Еженедельные таблицы лидеров сбрасываются в полночь с субботы на воскресенье в том же часовом поясе, что и ежедневные таблицы (UTC-7).

Общедоступные рейтинги и рейтинги в социальных сетях

SDK Игр Play может показывать игроку две версии каждой таблицы лидеров:

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

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

Показывать рейтинги

В мобильных клиентских библиотеках все форматирование и отображение таблиц лидеров выполняется автоматически. Вы можете указать, будет ли игрок видеть определенный рейтинг или список всех рейтингов, из которых он сможет выбрать нужный.

Вы также можете реализовать собственные таблицы лидеров, получая данные напрямую из клиентских библиотек.

Атрибуты

Чтобы создавать таблицы лидеров и управлять ими, вам нужно знать следующие атрибуты:

Основные сведения

С каждой таблицей лидеров связаны следующие основные элементы:

• Идентификатор – это уникальная строка, которую Google Play Console сгенерирует для вас. Этот уникальный идентификатор используется для обращения к таблице лидеров в клиентах игры.
• Название – это сокращенное название таблицы лидеров (например, "Лучшие результаты" или "Уровень 3"). Длина названия не должна превышать 100 символов.
• Значок – квадратный значок, который будет связан с таблицей лидеров. Рекомендации по созданию значков для таблицы лидеров приведены в Руководстве по значкам.
• Порядок в списке – это порядок, в котором рейтинг будет показываться игроку, когда он просматривает рейтинги, связанные с вашей игрой.
• Ограничения – это необязательные значения, которые определяют нижний и верхний пределы допустимых результатов в таблице лидеров. Это поможет вам отбрасывать явно мошеннические результаты. Вы также можете использовать метод Players.hide, чтобы скрыть игроков, которые, по вашему мнению, отправили поддельные результаты, из всех таблиц лидеров в приложении.

Рейтинги

Таблицы лидеров могут быть двух типов:

• По умолчанию используются таблицы лидеров с более высокими значениями. Обычно так и происходит в играх, где пользователи зарабатывают очки.
• Меньшее – лучше – иногда используется в случаях, когда меньший результат лучше. Чаще всего такие таблицы используются в гонках, где счет – это время, за которое игрок прошел трассу.

Формат отображения результатов

Все результаты отправляются в рейтинги игроков и хранятся в виде целых чисел типа long, но сервисы Play Games могут показывать их пользователю в разных форматах:

• В числовых рейтингах игроков счет представлен в виде чисел. Они могут быть представлены в виде целых чисел или действительных чисел с фиксированным количеством знаков после запятой. Вы отправляете оценку в виде целого числа, а десятичный разделитель вставляется в указанном месте. Например, оценка 314159 будет отображаться как 3.14159, 3141.59 или 314159 в зависимости от того, сколько знаков после запятой вы указали.

• В таблицах рекордов по времени результаты представлены в формате "часы / минуты / секунды/сотые доли секунды". Оценки нужно указывать в миллисекундах, поэтому значение 66032 будет интерпретировано как 1:06.03.

• Таблицы лидеров с валютой показывают результаты в денежном формате. Вы отправляете баллы в виде 1/1 000 000 основной денежной единицы. Например, если вы указали в качестве валюты доллары США, то значение 19 950 000 будет интерпретировано как $19.95.

В числовых таблицах лидеров также поддерживаются специальные единицы измерения. Например, если в вашей игре рекорды измеряются в метрах, вы можете указать "метры" в качестве единицы измерения по умолчанию для таблицы рекордов.

Переводы и форматирование оценок

Когда клиентские библиотеки для мобильных устройств запрашивают данные о рейтингах в игровых сервисах Play, они указывают язык и региональные настройки, в которых нужно показывать результаты. REST API позволяет также указать язык на основе региональных стандартов. Сервисы Play Games возвращают отформатированные результаты рейтинга игроков, соответствующие языку и региональным настройкам. Форматированные результаты будут показываться независимо от того, переведены ли названия таблиц лидеров.

В числовых таблицах лидеров формат чисел зависит от языка. (например, 12,345.78 в США и 12 345,78 во Франции). Если вы используете собственные рекламные блоки и добавили в игру переводы, то вам необходимо предоставить переведенные рекламные блоки для каждого добавленного языка. После этого сервис будет показывать переведенные единицы там, где это необходимо.

В зависимости от выбранного языка вам может понадобиться указать названия единиц в разных вариантах. В английском языке вам понадобится версия для одного объекта и версия для всех остальных (например, "meter" и "meters"). В польском языке нужно указать формы для одного, нескольких и многих объектов, а также для всех остальных случаев. Подробнее о правилах для множественного числа…

Для рейтингов Время формат времени зависит от языка и региона игрока. Это будет заметно, если вы используете доли секунды или значение часов с более чем тремя цифрами (например, 4,815:16:23.42 в США и 4.815:16:23,42 в Германии).

В таблицах лидеров валюты формат валюты будет зависеть от языка и региона игрока. Однако изменить валюту нельзя. Например, если вы укажете доллары США, то в США будет показываться $19.95, а во Франции – 19,95 $. Однако вы не можете указать, чтобы в США цены показывались в долларах, а во Франции – в евро.

Требования к значкам

Значки должны быть размером 512 x 512 пикселей в формате PNG или JPEG. В большинстве игровых клиентов значки будут уменьшены, поэтому не стоит добавлять на них слишком много мелких деталей. Вы можете загружать значки с альфа-каналом, и прозрачность будет сохранена. На устройствах Android значок таблицы лидеров будет показываться на темно-сером фоне, поэтому выберите значок, который будет хорошо выглядеть в такой ситуации.

Вид значка не меняется в зависимости от региона, поэтому не используйте текст и другой локализованный контент при оформлении.

Как создать рейтинг игроков

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

Как создать рейтинг игроков

для новой игры;

Чтобы создать рейтинг игроков для новой неопубликованной игры, откройте страницу игры в Google Play Console и выберите Привлечение пользователей > Игровые сервисы Play > Настройка и управление > Рейтинги игроков, а затем нажмите кнопку Создать рейтинг игроков.

Затем просто заполните информацию, необходимую для этой таблицы лидеров.

Нажмите Сохранить как черновик, и ваша таблица лидеров будет доступна в состоянии "Черновик". Когда вы опубликуете игру, рейтинги будут опубликованы вместе с ней.

Как создать рейтинг игроков

для опубликованной игры;

Чтобы добавить рейтинг в опубликованную игру, следуйте инструкциям ниже. Дополнительную информацию о тестировании можно найти на этой странице.

Когда вы убедитесь, что рейтинг работает без ошибок, опубликуйте игру снова.

Как изменить рейтинг игроков

Чтобы изменить опубликованный рейтинг, выберите его на вкладке Рейтинги игроков в Google Play Console. На этом этапе вы увидите ту же форму, которую использовали при первом создании таблицы лидеров, и сможете отредактировать любые поля по мере необходимости.

Когда закончите, нажмите Сохранить как проект. После этого вы сможете протестировать рейтинг.

Если он работает правильно, выберите Опубликовать изменения в верхней части формы со сведениями о нем. Теперь обновленный рейтинг будет опубликован вместе с игрой.

Как отменить изменения

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

Как удалить рейтинг игроков

Рейтинг можно удалить, даже если он опубликован. Для этого откройте форму со сведениями о рейтинге в Google Play Console и нажмите Удалить рейтинг игроков в ее верхней части.

Чтобы скрыть рейтинги игроков в приложении, вы также можете использовать метод Players.hide.

Как сбросить рейтинг игроков

Вы можете сбросить данные о прогрессе игроков только на этапе тестирования рейтинга.

• Для этого нажмите Сбросить прогресс в верхней части страницы с рейтингом в Google Play Console.
• Чтобы сбросить данные таблицы лидеров программно, вызовите методы ScoresManagement API.

Как локализовать рейтинги

Вы можете добавить переводы рейтингов в вашу игру. Перед этим убедитесь, что сама игра уже переведена. и в ней опубликован хотя бы один рейтинг.

Чтобы добавить перевод рейтинга, выберите его на вкладке Рейтинги игроков в Google Play Console. На странице рейтинга откройте вкладку языка, который ранее указали в сведениях об игре. Добавьте перевод в форму. Нажмите Сохранить, чтобы сохранить переведенные данные таблицы лидеров.

Как скрыть результаты в рейтинге игроков

В игровых сервисах Google Play есть защита от вмешательства, автоматически скрывающая в рейтинге результаты, которые могли быть получены нечестным путем. Эта функция поддерживает только игры для Android.

Защита от вмешательства включена по умолчанию для новых рейтингов. Чтобы включить ее для уже опубликованных рейтингов, сделайте следующее:

1. Выберите игру из списка на вкладке игровых сервисов в Google Play Console.
2. Откройте вкладку Рейтинги игроков, затем выберите экземпляр рейтинга, для которого вы хотите включить защиту от вмешательства.
3. Включите защиту от вмешательства.
4. Нажмите Сохранить и продолжить.
5. Опубликуйте игру.

После включения защиты от вмешательства для рейтинга игроков в Google Play Console эта функция может начать действовать в течение 24 часов. Результаты, добавленные в рейтинг до того, как вы включили защиту от вмешательства, скрыты не будут.

В некоторых случаях защиту от вмешательства лучше отключать. Например, если у вашей игры есть не только мобильная, но и веб-версия, а результаты игроков попадают в один рейтинг игроков.

Реализации на стороне клиента

Чтобы узнать, как реализовать таблицы лидеров на вашей платформе, ознакомьтесь со следующими ресурсами:

• Android
• Сайты
• C++ API
• Рекомендации по добавлению таблиц лидеров