Таблицы лидеров
Вы можете показывать на странице игры персонализированные таблицы лидеров с результатами лучших игроков и местом в рейтинге авторизованного пользователя.
Чтобы у вас заработали описанные ниже запросы, проверьте, что в консоли разработчика создана таблица лидеров.
Отправка счёта
Запрос доступен только для авторизованных пользователей. Рекомендуется заранее воспользоваться авторизацией и использовать таблицы лидеров только если пользователь предоставил персональные данные.
Используйте действие 
, чтобы отправить новый счёт в таблицу
лидеров c параметрами:
| Название | string | Техническое название таблицы лидеров. |
| Счёт | number | Счёт игрока в таблице лидеров. |
| Дополнительные данные | string | Необязательные метаданные, отправляемые вместе со счётом. |
Например, отправка счёта в таблицу лидеров может выглядеть так:
Запрос можно отправлять не чаще, чем раз в секунду. В противном случае он будет отклонен с ошибкой.
Рекомендуется использовать отправку счёта с особым условием 
.
Записи таблицы лидеров
Чтобы вывести рейтинг пользователей, используйте цикл 
c
параметрами:
| Название | string | Техническое название таблицы лидеров. |
| Позиции из топа | number | Количество запрашиваемых записей из топа таблицы лидеров. |
| Запросить позицию игрока | boolean | Определяет, будет ли позиция пользователя запрошена. |
| Позиции позиций вокруг игрока | number | Количество запрашиваемых записей ниже и выше пользователя по таблице. |
Плагин запросит через SDK Яндекс.Игр данные об таблице лидеров, после чего начнётся цикл. Этот процесс занимает какое-то время.
Рекомендуется оставлять на экране какое-нибудь обозначение загрузки, пока этот процесс происходит.
Убедитесь, что данный цикл не вызывается постоянно. Рекомендуется использовать его внутри функций или триггеров.
Внутри цикла у вас будет доступ к выражениям из списков: Игрок и Таблицы Лидеров.
Пример таблицы лидеров
Ниже вы можете увидеть и скачать пример реализации отображения таблицы лидеров.
Вы примере реализвованы:
- Колёсо загрузки перед отображением таблицы лидеров.
- Отображение счёта и имени.
- Отображение аватарок игроков.
- Отображение места игрока в таблице л идеров
Вы примере используется Локализация текста, Локализация спрайтов, а также плагин Адаптинвый текст.
