Лидерборды

Видеоурок. Как добавить в свою игру лидерборд?
Посмотреть видео
Видеоурок. Как добавить в свою игру лидерборд?
Посмотреть видео

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

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

  1. Добавьте код SDK в исходные файлы вашей игры.
  2. Зайдите в консоль разработчика.
  3. Выберите нужную игру.
  4. Перейдите на вкладку Лидерборды.

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

    Поле Описание
    Техническое название лидерборда Название, которое используется для взаимодействия в SDK.
    Локализированное отображаемое название лидерборда

    Название, которое будет отображаться для пользователей:

    • Для русского языка укажите название в поле [ru] Отображаемое название лидерборда.

    • Для других языков нажмите Добавить локализацию для [код языка] и укажите название в поле с соответствующим кодом языка.

      Коды языков:
      • be — белорусский;
      • en — английский;
      • kk — казахский;
      • ru — русский;
      • tr — турецкий;
      • uk — украинский;
      • uz — узбекский.
    Основной лидерборд

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

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

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

    • numeric — число.
    • time — время в миллисекундах.
    Направление сортировки

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

    • Сортировка по убыванию — на первых местах будут пользователи с наибольшим значением числа счета.
    • Сортировка по возрастанию — на первых местах будут пользователи с наименьшим значением числа счета.

    Например, для соревнования по скорости прохождения нужно выбрать направление Сортировка по возрастанию и тип лидерборда time.
    Размер десятичной части счета Параметр, который определяет, сколько знаков из целого числа счета будут отображаться после запятой. Например, если задать размер 2, значение счета 5712 будет отображаться как 57.12.
    Поле Описание
    Техническое название лидерборда Название, которое используется для взаимодействия в SDK.
    Локализированное отображаемое название лидерборда

    Название, которое будет отображаться для пользователей:

    • Для русского языка укажите название в поле [ru] Отображаемое название лидерборда.

    • Для других языков нажмите Добавить локализацию для [код языка] и укажите название в поле с соответствующим кодом языка.

      Коды языков:
      • be — белорусский;
      • en — английский;
      • kk — казахский;
      • ru — русский;
      • tr — турецкий;
      • uk — украинский;
      • uz — узбекский.
    Основной лидерборд

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

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

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

    • numeric — число.
    • time — время в миллисекундах.
    Направление сортировки

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

    • Сортировка по убыванию — на первых местах будут пользователи с наибольшим значением числа счета.
    • Сортировка по возрастанию — на первых местах будут пользователи с наименьшим значением числа счета.

    Например, для соревнования по скорости прохождения нужно выбрать направление Сортировка по возрастанию и тип лидерборда time.
    Размер десятичной части счета Параметр, который определяет, сколько знаков из целого числа счета будут отображаться после запятой. Например, если задать размер 2, значение счета 5712 будет отображаться как 57.12.
  6. Нажмите Сохранить.

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