Лидерборды

Лидерборд — инструмент, с помощью которого на странице игры вы можете показывать игрокам персонализированные соревновательные таблицы с результатами лучших игроков и местом в рейтинге авторизованного пользователя. Подробнее см. блог Лидерборды на Яндекс Играх.

Лидерборды можно добавить двумя способами:

• Подключить с помощью SDK Яндекс Игр. Лидерборды SDK учитывают только результаты авторизованных пользователей.
• Прописать самостоятельно в коде игры, чтобы соревновательные таблицы учитывали результаты всех пользователей, независимо от авторизации. Такие лидерборды важно реализовать для игр, в которых пользователь ожидает сразу увидеть свой рекорд или количество набранных очков.

Создание лидербордов

Для подключения лидербордов необходимо добавить код SDK в исходные файлы вашей игры и подключить лидерборды через консоль.

1. Добавьте код SDK в исходные файлы вашей игры.

2. Зайдите в консоль разработчика.

3. Выберите нужную игру.

4. Перейдите на вкладку Лидерборды.

5. Заполните поля:

   Поле	Описание
   Техническое название лидерборда	Название, которое используется для взаимодействия в SDK.
   Локализированное отображаемое название лидерборда	Название, которое будет отображаться для пользователей: Для русского языка укажите название в поле [ru] Отображаемое название лидерборда. Для других языков нажмите Добавить локализацию для <код языка> и в появившемся поле укажите название на выбранном языке. Коды языков: be — белорусский; en — английский; kk — казахский; ru — русский; tr — турецкий; uk — украинский; uz — узбекский.
   Основной лидерборд	Опция Является ли основным лидербордом определяет, какой лидерборд будет отображаться на карточке игры. Важно Основной лидерборд может быть только один. Если вы создаете и делаете основным новый лидерборд, в предыдущем лидерборде опция автоматически отключится.
   Тип лидерборда	Тип лидерборда, от которого зависит единица измерения результатов. Возможные значения: numeric — число. time — время в миллисекундах. Диапазон допустимых значений Значение score принимает только тип integer, которое не может быть отрицательным, а его максимум — это наибольшее целое число, доступное в JavaScript. Если вы хотите отображать в лидерборде дробные числа, то задайте Размер десятичной части счета. Для лидерборда типа time значения тоже считаются целыми числами и передаются в миллисекундах (1 сек = 1000 мс). Подробнее см. в Документации Mozilla.
   Направление сортировки	Порядок расположения результатов в лидерборде. Возможные значения: Сортировка по убыванию — на первых местах будут пользователи с наибольшим значением числа счета. Сортировка по возрастанию — на первых местах будут пользователи с наименьшим значением числа счета. Например, для соревнования по скорости прохождения нужно выбрать направление Сортировка по возрастанию и тип лидерборда time.
   Размер десятичной части счета	Параметр, который определяет, сколько знаков из целого числа счета будет отображаться после запятой. Например, если задать размер 2, значение счета 5712 будет отображаться как 57.12.

6. Нажмите Сохранить.

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

Можно создать новый лидерборд с именем старого?

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

Редактирование лидербордов

Чтобы посмотреть или отредактировать уже добавленный лидерборд, на вкладке Лидерборды прокрутите страницу вниз и нажмите Изменение лидерборда '<Техническое название лидерборда>'. Там вы можете изменить:

• Техническое название.
• Локализированное отображаемое название.
• Является лидерборд основным или нет.

Подробнее о заполнении полей см. в разделе Создание лидерборда.