HiddenList

Общие сведения

HiddenList является менеджером поисковых объектов. Для корректного подсчета очков (если он требуется). HiddenList должен располагаться в дереве - ниже всех своих поисковых объектов. На сегодня HiddenList не просто управляет объектами на сцене, он отвечает за все штрафы, поощрения, а в связке с такими объектами как HiddenHint + Effect можно реализовать графические эффекты: "ночь", "трансформация цвета" и т.д. с одним набором графики, а также систему подсказок.

Параметры

У листа есть стандартные параметры такие как положение на экране, размер, модификаторы и т.д. по сути они не важны главное что лист не перекрывал на сцене другие объекты, по-этому лучше ему находиться за пределами сцены. Единственный обязательный объект о котором должен знать лист это Table для отображения списка поиска, даже если таблица не будет использоваться быть все равно должна!

Ниже приведен список параматров и свойств листа которые мы можем найти на картинках справа.

• группа - объект группе которого принадлежит текущий объект
  
• память - Если 1, то при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана)
  
• картинка - Графический ресурс для отображения объекта. Перетаскивается мышкой из редактора ресурсов (поле должно находится в состоянии редактирования). Обычно не используется, а применяется для отображения table
  
• таблица - Объект, типа table который является визуальным отображением списка. Должна быть обязательно
  
• Подсказка — объект типа HiddenHint, который является менеджером хинтов.
  
• Счетчик — объект типа Counter, который отображает количество найденных объектов.
  

В самом счетчике в параметрах нужно указать val = 0, поскольку изначально нет найденных объектов.

• Таймер — объект типа Timer, который отображает время игры.

При инициализации листа он передаст состояние "start" таймеру.

Внешний вид

• вычеркнуть - Если 1, то найденный объект вычеркивается, оставаясь в списке(таблице), иначе он удаляется из списка.
  
• листать - Если 1, то список можно листать (скролировать), иначе ищутся только те, кто сейчас в нём виден.
  
• тип списка - Тип поиска объектов: 1 - слово, 2-предложение, 3-удаляемая пиктограмма, 4-пиктограмма, 5-поиск различий.
  

Звуки при нахождении хидденов

• обычный - Звук при нахождении обычного HiddenObject
• коллекционный - Звук при нахождении коллекционного HiddenObject(объекту должна быть установлена коллекция)

Параметры поиска

Основные

• объектов - Максимальное количество доступных для поиска объектов в одной игровой сессии. (ВАЖНО!!! Таблице нужно установить общее количество ячеек равное(или больше) количеству доступных для поиска объектов.)
  
• одного типа - Максимальное количество объектов одного типа - поле тип в hiddenObject или хидден объекты с одинаковыми текстовыми ID могут считаться объектами одного типа (если -1 то игнорируется)
• прятать - Делать невидимыми объекты, не участвующие в поиске
• оставлять - Оставлять найденный объект на месте (вызывая только флаеры) при удачном клике
• актёр-иконка - если "да", то во время полёта найденного хидден-объекта вместо него летит иконка которая помечена как "main picture" и указана в текстовом id хидден-объекта.
  

Скорость

Отвечают за скорость перемещения найденного объекта.

• полета - Скорость полета в пикселях в секунду.
• вращения - Скорость вращения в градусах в секунду.

Другие

• скалирование объектов - При нахождении во время полета объект будет скалироватся: 0 - отключено, 1 - включено
• пропадание объектов - При нахождении во время полета объект будет менять альфу: 0 - отключено, 1 - включено
• реагировать на отпускание - Объекты связанные с этим хидденлистом будут реагировать на отпускание, а не на нажатие. 0 - отключено, 1 - включено (То есть реагировать на четкий клик, если кликнули и сместили область клика объект не реагирует!)
• задержка срабатывания - только для реакции на нажатие. Время между нажатием и реакцией списка объектов.
• объединять одинаковые тексты - Объекты с одинаковым текстом будут жить в одной ячейке таблицы с добавлением множителя xN. 0 - отключено, 1 - включено
• множитель для иконок - Графический ресурс(анимация) для отображения множителя у иконок для типа списка 4(поиск по иконкам) и включенного объединения одинаковых текстов. Первый фрейм - х2, второй - х3 и т.д.
• исключать одинаковые тексты - исключает или не исключает из поиска объекты с одинаковыми txtID, используется совместно с одного типа.
• вероятность пассивного предпочитаемого объекта - вероятность выпадения пассивного объекта, если у объекта стоит параметр "предпочитаемый" используется при исключении объектов с одинаковыми текстовыми ID
• вероятность активного предпочитаемого объекта - вероятность выпадения активного объекта, если у объекта стоит параметр "предпочитаемый" используется при исключении объектов с одинаковыми текстовыми ID
• реагировать на невидимые - реагировать или нет на объекты, которые в момент игры не видны в таблице. (Кликаются только те hiddenObject которые отображены в таблице, остальные нет!)
• распределять равномерно - Равномерно распределять объекты по площади сцены.
• прятать актеров при старте - Устанавливать актерам видимость false при старте (по умолчаинию - да)(То есть всем актерам которые находятся на сцене при запуске принудительно установиться vis = 0)
• аномалия - нет, текстовая, ночь, трансформация цвета, дым (Можно передавать параметром "anom", val = 0,1,2,3,4 соответственно, для всех аномалий кроме текстовой лист должен быть под объектом Effect)

Сессии

• сессионность - нет = 0 , да = 1
• ограничение сессий - Максимальное количество сессий, в которые можно играть
• набор объектов - Набор объектов при заходе в хидден после последней сессии (случайный=0,последний фон=1,пустой=2)

Цвета

• Цвет обязательных — цвет текста для обязательных объектов, указывается код цвета, если строку не заполнять цвет не используется
• Цвет найденных — цвет текста для найденных объектов, указывается код цвета, если строку не заполнять цвет не используется
• Время перехода - Время изменения цвета
• flyer при ошибке - обычно объект типа flyer (летуны которых надо показать в точке клика, если этот клик ошибочный). Можно в принципе любой объект который обладает состоянием "beg". Ошибочный клик - все клики мимо hiddenObject.

Время

• игры - Общее время игры (если -1, то игнорируется). Если оно истекает, идет переход на экран [время вышло] (см.ниже)
• прерывать - Если 1, то по окончанию времени игра будет прервана, иначе - продолжится, но переход все равно будет на неудачную ветку
• паузы - Время перед закрытием окна после разбора (для осмысления результата)

Переход

• при разборе - Экран на который надо перейти, если все объекты найдены
• время вышло - Экран на который надо перейти если время вышло, а не все объекты найдены
• группа - Группа, в которую входит текущий объект

Система очков

• Счетчик — счетчик, отображающий набранные очки.
• ID пака — строковый идентификатор пака(для записи набранных очков в options должен быть заполнен); используется для вытаскивания суммарных очков в счетчики и дальнейшего их отображения.
• ID игры — строковый идентификатор игры (сцены).

Обязательно должен иметь префикс ID пака. Например, если pack_id = "pack1", то game_id = "pack1.game1"

• Очки — количество очков, которые даются за каждый найденный hiddenObject.
• Бонус за скорость — бонус за быстро найденный hiddenObject.
• Бонусный интервал — время, за которое нужно найти hiddenObject для получения бонуса.
• бонус за время - бонус за оставшееся время игры = коэффициент который введем * оставшееся время таймера.
• Бонусный мультипликатор — Если 1, то умножать очки за второй быстро найденный предмет на 2, за третий на 3, и т. д.
• Количество кликов для штрафа — количество неверных кликов, после которых запустится блокатор (см. ниже).
• Интервал для штрафа — время, за которое нужно совершить неверные клики.
• Штраф (очки) — Сколько отнимаем очков за ошибочный клик.
• Штраф (время) — Сколько отнимаем времени за ошибочный клик.
• блокатор - Объект, блокирующий сцену при серии ошибочных кликов. (Обычно маска растянутая на весь экран. ДОЛЖНА иметь состояние "beg")
• время блокировки - Время блокировки при серии ошибочных кликов по истечении переводит "блокатор" в состояние end
• аниматор очков - машина, которая анимирует полученные очки, должна иметь состояние anim
• touch move как штраф - Считать ли touch move за ложное попадание нет = 0, да = 1
• клик на найденный как штраф - Считать ли клик на найденный объект за ложное попадание(актуально если объекты остаются на сцене)
• коэффициент комбо - коэфициент для расчёта комбо очков по формуле s(n) = k * n * (n + 1).
• счётчик очков за объект - счётчик который показывает очки за последний полученный объект (учитывая бонусы).
• счётчик комбо-очков - счётчик очков полученных за комбо-серию.
• счётчик комбо-серий - счётчик который показывает комбо-серию (комбо из 2-х, 3-х и т.д. найденных объектов)

Звезды

• combo num - Количество быстро найденных объектов, нужное для получения звезды Combo
• combo time - Интервал между кликами, считающимися быстрыми для Combo
• accuracy - Точность кликов для получения звезды Accuracy (1 = 100%, все клики должны быть только удачные)

Формула расчета проста, количество верных кликов делим на общее количество получаем коэффициент если он равен или больше указного нами то в опции пишем параметр, если нет то не пишем.

Добавляемые параметры

разбор: если был экран - При нахождении всех объектов, переходим на определенный экран, если некоторый экран был уже хотя бы раз посещен

был экран - Экран, который мы проверяем на то, был ли он уже открыт хотя бы один раз

перейти на - Переходим на этот экран, если экран из предыдущего поля уже открывался

разбор: изменить состояние объекта - При нахождении всех объектов, перевести объект в новое состояние

объект - Перевести объект в состояние из следующего поля

состояние - Новое состояние для объекта из предыдущего поля

разбор: изменить параметр объекта - При нахождении всех объектов, изменить параметр объекта

объект - этот объект меняет свой параметр

свойство - Параметр, который мы изменяем

значение - Новое значение параметра

не успел: если был экран - Если вышло время, а объекты не найдены, переходим на определенный экран, если некоторый экран был уже хотя бы раз посещен

был экран - Экран, который мы проверяем на то, был ли он уже открыт хотя бы один раз

перейти на - Переходим на этот экран, если экран из предыдущего поля уже открывался

не успел: изменить состояние объекта - Если вышло время, а объекты не найдены, перевести объект в новое состояние

объект - перевести объект в состояние из следующего поля

состояние - Новое состояние для объекта из предыдущего поля

не успел: изменить параметр объекта - Если вышло время, а объекты не найдены, изменить параметр объекта

объект - этот объект меняет свой параметр

свойство - Параметр, который мы изменяем

значение - Новое значение параметра

счетчик очков

счетчик - Каунтер, которому приходят очки

группа extra bonus. Используется для economics, при находжении объекта с некой вероятностью может выпасть бонус. Объект который анимирует появление бонуса должен иметь состояние show, время на наимацию бонуса - 10 секунд.

монетки объект - объект который анимирует получение монет

монетки вероятность - вероятность по нахождению объекта получить дополнительно монетки

опыт объект - объект который анимирует получение опыта

опыт вероятность - вероятность по нахождению объекта получить дополнительно опыт

энергия объект - объект который анимирует получение энергии

энергия вероятность - вероятность по нахождению объекта получить дополнительно энергию

Объект, который срабатывает, если долго не находить хидден

объект - Объект, который переводится в указанное состояние, если долго не находить хидден

состояние - Состояние, в которое переводится объект

время - Время от последнего нахождения хиддена, после которого срабатывает объект

параметры аномалии с исчезновением букв

оставшиеся буквы - Минимальное количество оставшихся букв в предложении

задержка - Момент времени, начиная с которого аномалия будет проявляться

время - Время, за которое должны исчезнуть все буквы (если -1, то до конца времени в хиддене)

промежутки - промежутки времени между каждой итерацией

флайер - Флайер, анимирующий исчезающую букву (должен иметь текстовый тип)

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

effect - эффект, управляющий трансформацией цвета

tag - Тег эффекта, реализующего ночь

параметры аномалии трансформации цвета

effect - Эффект, управляющий трансформацией цвета

tags - Теги эффектов, реализующих трансформацию цвета, из которых будет выбран один

параметры аномалии дым

effect - Машина, управляющая эффектом дыма

tag - Тег эффекта, реализующего дым

Все аномалии кроме текстовой должны быть настроены с помощью объекта Effect

Состояния

Состояния которые есть у листа. Мы можем передавать их с помощью различных объектов.

• invert - горизонтально отображает изображение.
• run - переводит хидден с состояние активности, если до этого был на паузе.
• pause -переводит хидден с состояние паузы, объекты не кликаются!