Localtoplist

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

Общие параметры

• имя - Имя объекта Localtoplist в дереве проекта. Может быт произвольным.
• id-объекта - Уникальный номер объекта Localtoplist, который можно увидеть при наведении курсора на строку "имя".
• синхронизация - Применяется для синхронизации между лейаутами. Если указан параметр "нет", то объект будет активен только на текущем лейауте. По умолчанию указан параметр "да".
• сохранение параметров - Настройка этого параметра актуальна, если приложение в дальнейшем будет сворачиваться в системную панель («трей»). Выбирается значение этого параметра из выпадающего списка. Возможны следующие варианты: "нет", "только объект", "объект с подобъектами", "только подобъекты". При выходе из трэя будут восстановлены ранее измененные/установленные (при переходе с одного экрана на другой) параметры объектов или подобъектов в зависимости от выбранного варианта для этого параметра. По умолчанию указан параметр "нет". Следует помнить, что если выбирается для объекта некоторой сцены значения этого параметра отличное от "нет", то должно и предусматриваться соответствующее значение этого параметра и для этой сцены, и для экрана, содержащего эту сцену.

Основные параметры

Группа - положение

• X - Горизонтальная координата точки пивота объекта в пикселях. Отсчитывается от точки пивота сцены.
• Y - Вертикальная координата точки пивота объекта в пикселях. Отсчитывается от точки пивота сцены.

Группа - размер

• W - Ширина графического объекта в пикселях.
• H - Высота графического объекта в пикселях.

Группа - внешний вид

• Картинка - Графический ресурс для отображения объекта. Может отсутствовать.

• Таблица - Объект типа table, который является визуальным отображением результатов. ОБЯЗАТЕЛЬНО!!! У таблицы должно быть 3 колонки для отображения: позиции, имени, очков.

Дополнительные параметры

• Ключ - Ключ в опциях, который мы будем складировать в таблице.

• Сортировка - Принимает два значения: 0 - отобразит игроков в таблице в порядке их создания (записи в опции), 1 - отобразит игроков в таблице в порядке убывания количества их очков.

• Место игрока - Объект для отображения места игрока.

• Имя игрока - Объект для отображении имени игрока.

• Очки игрока - Объект для отображения очков игрока.

Примечания

• Все результаты игры заранее должны быть записаны в Options, из них наш объект и вычитывает значения.

• Для каждого пака должен быть свой Localtoplist, своя таблица, свой ключ!

Пример использования

Обычно объект применяется для сортировки игроков по количеству очков, набранных в паке игры.
Если в игре у нас несколько паков, то для статистики каждого нам нужен отдельный Localtoplist, с индивидуальным ключом хранения данных в Options.

Например, для первого пака мы будем записывать очки под ключом Pack1.Local_score, а для второго Pack2.Local_score и т.д.(название ключей могут быть и другими)

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

Для примера рассмотрим фрагмент игры, где применяется объект Localtoplist.

На экране размещаются следующие объекты:

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

Ключевым является параметр таблица -> колонок. Ширина колонок настраиваемая.

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

Экран с турнирной таблицей в результате будет выглядеть следующим образом:

Пример

Download