Лидерборды

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

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

Внимание

Если в Консоли нет лидерборда с соответствующим именем в поле Техническое название лидерборда, запросы будут выдавать ошибку 404.

Отправка счета

Внимание

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

Используйте действие Отправить счет в лидерборд, чтобы отправить новый счет в лидерборд c параметрами:

Параметр	Тип	Описание
Название	`string`	Техническое название лидерборда.
Счет	`number`	Счет игрока в лидерборде.
Дополнительные данные	`string`	Необязательные метаданные, отправляемые вместе со счетом.

Например, отправка счета в лидерборд может выглядеть так:

Скриншот Construct 3: экран настройки лидербордов при помощи плагина YandexGamesSDK. Таблица из трех столбцов (в каждой ячейке третьего столбца есть кнопки «+ Добавить действие» и «+ Добавить...») и двух строк. 1 строка — «Кнопка», «При нажатии», пустая ячейка. 2 строка — иконка настроек «Система», «authorized правда», «Yan... | Отправить счет 10 в таблицу лидеров "score" с данными ""».

Примечание

Запрос можно отправлять не чаще, чем 1 раз за 1 секунду, иначе он будет отклонен с ошибкой.

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

Записи лидербордов

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

Параметр	Тип	Описание
Название	`string`	Техническое название лидерборда.
Позиции из топа	`number`	Количество запрашиваемых записей из топа лидерборда.
Запросить позицию игрока	`boolean`	Определяет, будет ли позиция пользователя запрошена.
Позиции позиций вокруг игрока	`number`	Количество запрашиваемых записей ниже и выше пользователя по таблице.