wiki.appsalutecreator.com - Вклад участника [ru]

Taskorganizer

2016-04-19T12:23:12Z

Vefimov: /* Механизм многоуровневых достижений */

{{TOC right}}
[[Object|Объект]] Taskorganizer - Менеджер задач и квестов

=Свойства=
[[Файл:Task.jpg|250px|thumb|right]]
[[Файл:Task_1.jpg|250px|thumb|right]]
'''Общие параметры'''
*'''economics''' - Объект типа экономикс.
*'''предметы''' - Объект типа eitems.
*'''таблица''' - Таблица куда будут помещены иконки заданий. При тапе на таблицу объекту Taskorganizer вызывается состояние show. Иконки подтягиваются из текстовой базы (icon1).
*'''добавлять иконки''' - 1 - добавлять в таблицу иконки, 0 - тексты из текстового id (поле word).
*'''шаблон предмета''' - Объект типа etaskitem будет использоваться при показе превью задания.
*'''фильтрация''' - Категория, которые должны будут отобразиться в таблице логов при вызове состояния logbook. Пустая строка - все.
*'''таблица логов''' - Таблица куда будут помещены записи логбука.
*'''новая запись''' - Объект, которому будет вызвано состояние show при добавлении новой записи в логбук.
*'''новое задание''' - Графический ресурс, который будет отмечать новые задания. Смещение должно достигаться пивотом.
*'''прочитанное задание''' - Графический ресурс, который будет отмечать прочитанные задания. Смещение должно достигаться пивотом (возможно указать анимацию, скорость смены кадров указываем в ресурсной базе).
*'''выполненное задание''' - Графический ресурс, который будет отмечать выполненные задания. Смещение должно достигаться пивотом (возможно указать анимацию, скорость смены кадров указываем в ресурсной базе)
*'''уведомление''' - Текстовый айди заголовка связанных с задачами уведомлений (Должно быть заполнено поле sense 4 - т.к. рандомно его будет постить).
*'''вероятность уведомления''' - Подменная вероятность нахождения предмета нужного для задания по уведомлению с которого мы пришли. 0 - использовать значение по умолчанию.
*'''выполнять непрочитанные''' - 1 - выполнять непрочитанные таски, 0 - нет.
*'''хронологический порядок''' - 1 - записывать задачи в хронологическом порядке, 0 - нет.
*'''картинки в логбук''' - Расположение картинки до или после текста.
*'''сдвиг уровней''' - число на которое сдвинутся требования к уровню игрока в taskorganizer_setup для каждой задачи;
*'''refresh при показе окна''' - 0 - нет, 1 - да. Ставим = 0 ( "нет" ), если хотим чтобы при тапе по таблице отложить сортировку и обновление статуса таска ( в определённый момент ( к примеру, когда открылось окно таска), передаём состояние '''refresh''' и таблица обновится).
*'''использовать накопление ошибки''' - 0 - нет, 1 - да. Ставим = 1 ( "да" ), если хотим чтобы нахождение предметов в хиддене, по таску не превышало n-раз ( к примеру p= 0.5 (1/0.5=2 , т.е. предмет должны найти не более чем за две игры в хидн), если количество сыгранных игр >= максимальному по вероятности, то предмет попадает в таблицу ( мы его нашли)). Если стоит - 0 ( "нет" ), то вне зависимости от количества заходов, будет браться вероятность.

<pre>
Для огранизации логбука необходимо текст поместить в sentenсe 1. Картинка, что будет отображаться с этим текстом, должна быть icon 2. Также есть возможность использовать эту картинку в качестве фона. Тогда текст, который будет отображаться поверх этой картинки, нужно разместить в sentenсe 2.
</pre>

'''Группа угадайка'''

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

*'''показывать через''' - Через какое количество обычных задач показывать угадайку.
*'''с уровня''' - Угадайка будет генерироваться только начиная с данного уровня.
*'''машина''' - Объект, которому при активации будет вызвано состояние show. Она же после угадайки будет переведена в состояние win или fail.
*'''иконка''' - Объект, в который сложим иконку предмета.
*'''иконка для таблицы''' - Иконка соответствующая угадайке в таблице задач.
*'''ресурс 1''' - Деньги даваемые за выполнение задания.
*'''ресурс 2''' - Кристаллы даваемые за выполнение задания.
*'''опыт''' - Опыт даваемый за выполнение задания.
*'''награда ресурс 1''' - Счетчик, которому будет присвоено количество призового ресурса 1.
*'''награда ресурс 2''' - Счетчик, которому будет присвоено количество призового ресурса 2.
*'''награда опыт''' - Счетчик, которому будет присвоено количество призового опыта.
'''Группа рулетка'''

На самом деле название "рулетка" весьма условное. В этом разделе можно поместить любое периодически повторяющееся задание.

*'''показывать через''' - Через какое количество обычных задач показывать рулетку.
*'''с уровня''' - Рулетка будет генерироваться только начиная с данного уровня.
*'''машина''' - Объект, которому при активации будет вызвано состояние show.
*'''иконка для таблицы''' - Иконка соответствующая рулетке в таблице задач.
'''Группа генерируемые'''

В этой группе находятся периодически генерируемые задания на прохождение локаций.

*'''активных задач''' - Эти задачи будут генерироваться, когда активных задач столько или меньше.
*'''с уровня''' - Эти задачи будут генерироваться только начиная с данного уровня.
*'''максимально''' - Будет сгенерированно случайное количество задач от 1 до n.
*'''машина''' - Объект, которому при активации будет вызвано состояние show. Она же после угадайки будет переведена в состояние win или fail.
*'''название''' - Текстовый объект, в который будет сложено название локации.
*'''превью''' - Объект, в который сложим превью локации для генерируемой задачи.
*'''иконка для таблицы''' - Иконка соответствующая генерируемому таску в таблице задач.
*'''ресурс 1''' - Деньги даваемые за выполнение задания.
*'''ресурс 2''' - Кристаллы даваемые за выполнение задания.
*'''опыт''' - Опыт даваемый за выполнение задания.
*'''награда ресурс 1''' - Счетчик, которому будет присвоено количество призового ресурса 1.
*'''награда ресурс 2''' - Счетчик, которому будет присвоено количество призового ресурса 2.
*'''награда опыт''' - Счетчик, которому будет присвоено количество призового опыта.

<pre>
Если перед генерацией случайного таска на исследование локации указать параметру gen_loc значение от 0 до n, то ближайшая генерируемая задача будет для конкретной локации под указанным номером. После генерации параметр gen_loc становится -1.
</pre>

<pre>
Если перед генерацией случайного таска от персоанжа указать параметру gen_face значение от 0 до n, то ближайшая генерируемая задача будет от персонажа под указанным номером. После генерации параметр gen_face становится -1.
</pre>

'''Группа угадаечные задачи'''

В этой группе указываем диапазоны для генерации тасков-викторин и способ генерации.

*'''стандартная генерация''':
::'''нет''' - особая генерация задач, при которой с начало генерируем задачи из _очереди 1_, потом задачи из _очереди 2_ ( Если в первой очереди мы не можем сгенерировать задачу, пытаемся сгенерировать из второй очереди). Если мы не сгенерировали задачу из обоих очередей, то мы обнуляем все таски из обоих очередей ( и сразу генерим из _очереди 1_ задачу);
::'''да''' - стандартная генерация одной угадайки ( начинаем сверху вниз генерить;
*'''очередь 1''' - Основная очередь, пытаемся из неё сгенерировать задачу, при получении Taskorganizer сост. _generate_guess_, если в предыдущем поле стоит '''нет'''. Каждая задача из этой очереди имеет условия для появления ( прохождение сюжетного таска к примеру);
*'''очередь 2''' - Очередь затычка, задачи из этой очереди без условий. Предназначена когда в первой очереди нету доступных тасков для генерации;

<pre>
У таскорганайзера есть поле disabled, если при каждом запуске приложения после конца туториала писать туда 1 - это приведет к удалению старого сейва и несозданию нового. Несколько килобайт выгоды в опциях + использовать только для туториального таскорганайзера, когда он отработает.
</pre>

=Taskorganizer setup=
[[Файл:Task_2.jpg|600px|thumb|right]]

*'''id''' - Идентификатор задания. Используется в других заданиях. По общей концепции - строковый айди. Перетаскивается из текстовой базы.
'''Для каждого задания(записи в logbook) должен быть свой уникальный id.'''
*'''хинт''' - Список строк-подсказок для задачи. Перетаскиваются из текстовой базы. Таким образом, добавив несколько записей из базы, увидим выпадающий список.
*'''название (объект)''' - Текстовый объект, в который мы сложим название задания. Описание подтягивается из текстовой базы из первого столбика (word) текстового id задания.
*'''машина''' - Объект, которому при активации задания будет вызвано состояние show, а при повторном открытии задания show_old.
*'''портрет''' - Объект, которому при активации задания будет устанорвлен графический ресурс рожи.
*'''таблица''' - Таблица куда будут помещены темплейты предметов данного задания.
*'''описание (объект)''' - Текстовый объект, в который мы сложим описание задания. Описание подтягивается из текстовой базы из второго столбика (sentence1) текстового id задания.
*'''награда (ресурс 1)''' - Счетчик отображающий награду в ресурсе 1 за выполнение задания.
*'''награда (ресурс 2)''' - Счетчик отображающий награду в ресурсе 2 за выполнение задания.
*'''награда (опыт)''' - Счетчик отображающий награду в опыте за выполнение задания.
*'''таблица хинта''' - Таблица, в которую будем складывать хинты.

'''Необходимое для логбука'''

*'''для журнала''' - 0 - задача предназначена для списка задач, 1 - задача предназначена для журнала.
*'''категория''' - Категория к которой относится задача/запись. Пока используется только задачами для логбука.

'''Критерии появления'''

*'''уровень''' - Минимальный уровень, при котором может появиться задание.
*'''аномалия''' - В какой-либо локации присутствует аномалия данного типа. -1 - не учитывать условие.
*'''локация''' - Локация для которой будем проверять мастерство. -1 - не учитывать условие.
*'''мастерство''' - Уровень мастерства, который должен быть достигнут в локиции. -1 - не учитывать условие.
*'''завершены до''' - Задания, которые должны быть завершены до появления этого.
*'''получены до''' - Задания, которые должны быть получены до появления этого.
*'''не завершены до''' - Задания, которые должны быть НЕ завершены до появления этого.
*'''объект до''' - Объект, который должен находиться в состоянии_до для появления задания.
*'''состояние до''' - Состояние объекта_до, в котором вызывается генерация задания.
*'''коллекционные''' - Коллекционные предметы, которые должны быть найдены для появления задания.
*'''вероятность нужного''' - Когда мы будем проходить локации, в которых есть предметы необходимые для задания - мы будем подменять вероятность из локации вот этой вероятностью. 0 - использовать дефолтную.

'''Критерии завершения'''

*'''с аномалией''' - Задача выполняется при нахождение локации с аномалией данного типа. Не путать с аномалией необходимой для возникновения задания. -1 - не учитывать аномалию.
*'''задачи''' - Задания, выполнение которых требуется для выполнения данной.
*'''предметы''' - Задание завершается, когда получены следующие предметы (коллекционные и инвентарные единым списком).
*'''объект''' - Объект, который должен находиться в определенном состоянии,для завершения задания.
*'''состояние''' - Состояние объекта, в котором вызывается проверка задания.

'''Награда'''

*'''ресурс 1''' - Деньги даваемые за выполнение задания.
*'''ресурс 2''' - Кристаллы даваемые за выполнение задания.
*'''опыт''' - Опыт даваемый за выполнение задания.
*'''перевести объект''' - При выполнении задания этот объект будет переведен в новое состояние.
*'''в состояние''' - Состояние для объекта из предыдущего поля.

==Изменить состояние объекта - новое задание==

Позволяет изменять состояние объекту каждый раз при появлении нового задания, находится в taskorganizer setup.

=Состояния=

*'''show''' - При вызове этого состояния из таблицы с иконками заданий открывается соответствующая машина задания, прописанная в группе '''задание'''.
*'''check''' - При вызове проверяется выполнение текущих заданий(заданий добавленных в таблицу). Для того чтобы таскорганайзер добавил таски в таблицу после загрузки приложения ему нужно передать refresh.
*'''generate''' - При вызове подбирается подходящее задание в зависимости от прогресса игрока.
*'''generate_plot''' - При вызове генерится задача с персонажем ( поле генерируемые с персонажами), если перед этим передать в поле gen_face номер персонажа, то сгенерируем с указанным персонажем, после параметр обнулится ( значение -1 ). Перед вызовом данного состояния, '''обязательнo''' в поле _param_ вбить "1".
*'''log_check''' - При вызове состояния проверяется доступны ли новые записи в логбук.
*'''log_show''' - Заполняет таблицу логбука записями с текущим фильтром.
*'''refresh''' - Удаляет иконку выполненного задания из таблицы. Лучше всего вызывать после Check.
*'''cancel''' - Удаляет задание без награды, которое указано как ID в параметре param таскорганайзера, т.е. объекту Taskorganizer в param указываем ID таска (например 1933 - берется из options.xml или текстовой базы), а потом вызываем состояние cancel.
*'''add_hint''' - Добавляет в таблицу хинтов следующий текстовый ID из поля хинты текущего таска. Если все хинты показаны, то в опции записывается параметр haveHints=0.
*'''task_prev''' - Используется, если открыта машина-шаблон текущего задания. В этом состоянии показывается предыдущее по списку таблицы задание.
*'''task_next''' - Показывает следующее по списку таблицы задание.
<pre>
Состояния task_prev и task_next работают циклически, после первой задачи показывают последнюю и наоборот.
</pre>
*'''show_id''' - Показать окно задачи, взяв ее id из параметра.
*'''show_last_plot''' - Открыть последнюю сгенерированную сюжетную задачу.
*'''guess''' - Ответить на текущую угадайку, взяв ответ из параметра (param). Taskorganizer также хранит правильный ответ на текущую угадайку в параметре ''guess_answer'', его можно использовать, если нужно оставить игроку меньше вариантов для угадывания.
*'''add_hint_last''' - Добавить подсказку последней добавленной задаче.
*'''add_hint_top''' - Добавить подсказку верхней задаче в таблице.
*'''guess_who_reward''' - начислить награду за последнюю угадайку.
*'''roulette_complete''' -состояние, вызываемое при выполнении текущей задачи "рулетка".
*'''cheat_complete''' - если его вызвать, то при следующем check выполнится задача, для которой последней показывали превью.
*'''skip''' - При вызове этого состояния выполнится последний открытый таск. Цена скипа указывается внутри самого таска.
*'''check_multiple''' - Проверить выполнение задач не выходя из проверки после первой найденной.

Состояния для работы с тасками-угадайками по типу викторины ( в taskorganizer_setup - тип = "угадайка"):
*'''answer''' - ответить на открытую угадайку ( в поле '''param''' должно находиться число, номер нажатой кнопки от 0 до 3 ). Вешаем на кнопки варианты-ответа ( пишем param = 0 - 3 , после передаёт _answer_);
*'''generate_guess''' - сгенерировать угадайку-викторину ( выберет доступные задачи из диапазона указанном в очередях ( 1 и 2) поле _угадаечные задачи_ taskorganizer). При открытии угадайки, в поле _cur_guess_answer_ объекта Taskorganizer записывается номер кнопки где лежит правильный ответ ( от 0 до 3 );

ПРИМЕЧАНИЕ: при проверке задач для логбука для последней выполненной будет перезаписано поле filter автоматически.

При кажом refresh таскорганайзер заполняет у себя поля:
*'''tasks_in_table''' - задач в таблице
*'''tasks_total''' - задач в таблице + скрытых задач

=Запись в опции=

В процессе работы таскорганайзер записывает параметры в опции. Для конкретной задачи этот параметр представляет следующую строку:

"tasks(id таскорганайзера в проекте).t(id текстового объекта - идентификатора задания).s".

Возможные значения:
* '''0''' - таск не активен (не добавлен путем вызова generate таскорганайзеру);
* '''1''' - таск сгенерирован ;
* '''2''' - таск прочитан (вызвано состояние show);
* '''3''' - таск выполнен;
* '''4''' - отложенное состояние таска (условия появления выполнены, но время его появления еще не прийшло);
* '''5''' - таск выполнен, но награда ещё не забиралась ( таск будет оставаться в таблице, если таски не выполняются автоматически);

=Сопутствующие объекты=

Объекты, которые используются вместе с объектом economics и имеют с ним непосредственную связь:

* [[Файл:E_items.png]] - [[Eitems]] - объект, служащий для связи инвентаря(магазина) и экономики.
* [[Файл:E_store_item.png]] - [[Estoreitem]] - шаблон для ячейки магазина.
* [[Файл:E_inventory_item.png]] - [[Einventoryitem]] - шаблон для ячейки инвентаря.
* [[Файл:Kub.png]] - [[Ecraftitem]] - шаблон для ячейки создания предмета.
* [[Файл:Taskorganizer.png]] - [[Taskorganizer]] - органайзер заданий.
* [[Файл:E_task_item.png]] - [[Etaskitem]] - шаблон для ячейки задания.
* [[Файл:E_collection.png]] - [[Ecollection]] - шаблон для строки в таблице коллекции.
* [[Файл:Economics.png]] - [[Economics]] - глобальная настройка игр типа ферма\билдер

=Вычитаемые параметры:=
Каждая таскорганайзер пишет в пользователя следующие параметры:
*'''public.TaskOrganizerCompletedTasks''' - количество выполненных одноразовых задач;
*'''public.TaskOrganizerCompletedTasksAll''' - количество выполненных задач с учётом повторяемых;

=Механизм многоуровневых достижений=
С помощью таскорганайзера можно организовать систему многоуровневых достижений. Для этого используется [[Etasktemplate|темплейт задачи]]. Данные темплейты складываются в таблицу темплейтов таскорганайзера. При этом в самом таскорганайзере должна быть указанна таблица для иконок задач, хоть она и не используется (желательно вынести за границы экрана).

Каждый уровень достижения представляет собой отдельный таск с подзадачей на опции. В поле опций этой подзадачи указываем параметр, который отображает прогресс по достижению. Чтобы создать несколько уровней достижения, нужно несколько задач одного типа (с возрастающими требованиями).

Часть контента для достижения задается чрез текстовый объект - id таска. В текстовом объекте указываем название (word), описание невыполненной (sentence1) и выполненной (sentence2) ачивки. А также ресурс иконки ачивки (ico1), ресурс звезд для невыполненной (ico2) и выполененной (ico3) задачи.
Награду за достижения ачивки указываем как награду за выполнение таска. Также с помощью обработчика завершения задачи можем запустить анимацию получения ачивки.

Для заполнения таблицы темплейтов нужно вызвать состояние '''refresh_templates''', при вызове '''check''' задача, условия которой были выполнены изменит свое состояние, при этом будут переключены ресурсы звезд, описание ачивки и спрятана кнопка темплейта '''btn'''.

Для контроля того, какая задача будет вызвана при вызове '''check''' можно использовать следующий способ. К задаче добавляем еще одну подзадачу на опции. Когда прогресс по первой подзадаче на опции будет >= требуемого значения для задачи будет отображаться кнопка темплейта '''btn'''. При нажатии на эту кнопку, которая должна вызывать '''take''' темплейту задачи, в него пишется параметр clicked_task_id, по этому параметру определяем у какой задачи нужно выполнить вторую подзадачу на опции и вызываем '''check''' таскорганайзеру.

Пример
S:\!MOBILE\!!!EditorGames\Wiki_sample

Complex_achievements.zip

=Пример проекта=
S:\!MOBILE\!!!EditorGames\Wiki_sample\Taskorganizer

[[Category:Economics]]

Taskorganizer

2016-04-19T11:44:28Z

Vefimov:

{{TOC right}}
[[Object|Объект]] Taskorganizer - Менеджер задач и квестов

=Свойства=
[[Файл:Task.jpg|250px|thumb|right]]
[[Файл:Task_1.jpg|250px|thumb|right]]
'''Общие параметры'''
*'''economics''' - Объект типа экономикс.
*'''предметы''' - Объект типа eitems.
*'''таблица''' - Таблица куда будут помещены иконки заданий. При тапе на таблицу объекту Taskorganizer вызывается состояние show. Иконки подтягиваются из текстовой базы (icon1).
*'''добавлять иконки''' - 1 - добавлять в таблицу иконки, 0 - тексты из текстового id (поле word).
*'''шаблон предмета''' - Объект типа etaskitem будет использоваться при показе превью задания.
*'''фильтрация''' - Категория, которые должны будут отобразиться в таблице логов при вызове состояния logbook. Пустая строка - все.
*'''таблица логов''' - Таблица куда будут помещены записи логбука.
*'''новая запись''' - Объект, которому будет вызвано состояние show при добавлении новой записи в логбук.
*'''новое задание''' - Графический ресурс, который будет отмечать новые задания. Смещение должно достигаться пивотом.
*'''прочитанное задание''' - Графический ресурс, который будет отмечать прочитанные задания. Смещение должно достигаться пивотом (возможно указать анимацию, скорость смены кадров указываем в ресурсной базе).
*'''выполненное задание''' - Графический ресурс, который будет отмечать выполненные задания. Смещение должно достигаться пивотом (возможно указать анимацию, скорость смены кадров указываем в ресурсной базе)
*'''уведомление''' - Текстовый айди заголовка связанных с задачами уведомлений (Должно быть заполнено поле sense 4 - т.к. рандомно его будет постить).
*'''вероятность уведомления''' - Подменная вероятность нахождения предмета нужного для задания по уведомлению с которого мы пришли. 0 - использовать значение по умолчанию.
*'''выполнять непрочитанные''' - 1 - выполнять непрочитанные таски, 0 - нет.
*'''хронологический порядок''' - 1 - записывать задачи в хронологическом порядке, 0 - нет.
*'''картинки в логбук''' - Расположение картинки до или после текста.
*'''сдвиг уровней''' - число на которое сдвинутся требования к уровню игрока в taskorganizer_setup для каждой задачи;
*'''refresh при показе окна''' - 0 - нет, 1 - да. Ставим = 0 ( "нет" ), если хотим чтобы при тапе по таблице отложить сортировку и обновление статуса таска ( в определённый момент ( к примеру, когда открылось окно таска), передаём состояние '''refresh''' и таблица обновится).
*'''использовать накопление ошибки''' - 0 - нет, 1 - да. Ставим = 1 ( "да" ), если хотим чтобы нахождение предметов в хиддене, по таску не превышало n-раз ( к примеру p= 0.5 (1/0.5=2 , т.е. предмет должны найти не более чем за две игры в хидн), если количество сыгранных игр >= максимальному по вероятности, то предмет попадает в таблицу ( мы его нашли)). Если стоит - 0 ( "нет" ), то вне зависимости от количества заходов, будет браться вероятность.

<pre>
Для огранизации логбука необходимо текст поместить в sentenсe 1. Картинка, что будет отображаться с этим текстом, должна быть icon 2. Также есть возможность использовать эту картинку в качестве фона. Тогда текст, который будет отображаться поверх этой картинки, нужно разместить в sentenсe 2.
</pre>

'''Группа угадайка'''

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

*'''показывать через''' - Через какое количество обычных задач показывать угадайку.
*'''с уровня''' - Угадайка будет генерироваться только начиная с данного уровня.
*'''машина''' - Объект, которому при активации будет вызвано состояние show. Она же после угадайки будет переведена в состояние win или fail.
*'''иконка''' - Объект, в который сложим иконку предмета.
*'''иконка для таблицы''' - Иконка соответствующая угадайке в таблице задач.
*'''ресурс 1''' - Деньги даваемые за выполнение задания.
*'''ресурс 2''' - Кристаллы даваемые за выполнение задания.
*'''опыт''' - Опыт даваемый за выполнение задания.
*'''награда ресурс 1''' - Счетчик, которому будет присвоено количество призового ресурса 1.
*'''награда ресурс 2''' - Счетчик, которому будет присвоено количество призового ресурса 2.
*'''награда опыт''' - Счетчик, которому будет присвоено количество призового опыта.
'''Группа рулетка'''

На самом деле название "рулетка" весьма условное. В этом разделе можно поместить любое периодически повторяющееся задание.

*'''показывать через''' - Через какое количество обычных задач показывать рулетку.
*'''с уровня''' - Рулетка будет генерироваться только начиная с данного уровня.
*'''машина''' - Объект, которому при активации будет вызвано состояние show.
*'''иконка для таблицы''' - Иконка соответствующая рулетке в таблице задач.
'''Группа генерируемые'''

В этой группе находятся периодически генерируемые задания на прохождение локаций.

*'''активных задач''' - Эти задачи будут генерироваться, когда активных задач столько или меньше.
*'''с уровня''' - Эти задачи будут генерироваться только начиная с данного уровня.
*'''максимально''' - Будет сгенерированно случайное количество задач от 1 до n.
*'''машина''' - Объект, которому при активации будет вызвано состояние show. Она же после угадайки будет переведена в состояние win или fail.
*'''название''' - Текстовый объект, в который будет сложено название локации.
*'''превью''' - Объект, в который сложим превью локации для генерируемой задачи.
*'''иконка для таблицы''' - Иконка соответствующая генерируемому таску в таблице задач.
*'''ресурс 1''' - Деньги даваемые за выполнение задания.
*'''ресурс 2''' - Кристаллы даваемые за выполнение задания.
*'''опыт''' - Опыт даваемый за выполнение задания.
*'''награда ресурс 1''' - Счетчик, которому будет присвоено количество призового ресурса 1.
*'''награда ресурс 2''' - Счетчик, которому будет присвоено количество призового ресурса 2.
*'''награда опыт''' - Счетчик, которому будет присвоено количество призового опыта.

<pre>
Если перед генерацией случайного таска на исследование локации указать параметру gen_loc значение от 0 до n, то ближайшая генерируемая задача будет для конкретной локации под указанным номером. После генерации параметр gen_loc становится -1.
</pre>

<pre>
Если перед генерацией случайного таска от персоанжа указать параметру gen_face значение от 0 до n, то ближайшая генерируемая задача будет от персонажа под указанным номером. После генерации параметр gen_face становится -1.
</pre>

'''Группа угадаечные задачи'''

В этой группе указываем диапазоны для генерации тасков-викторин и способ генерации.

*'''стандартная генерация''':
::'''нет''' - особая генерация задач, при которой с начало генерируем задачи из _очереди 1_, потом задачи из _очереди 2_ ( Если в первой очереди мы не можем сгенерировать задачу, пытаемся сгенерировать из второй очереди). Если мы не сгенерировали задачу из обоих очередей, то мы обнуляем все таски из обоих очередей ( и сразу генерим из _очереди 1_ задачу);
::'''да''' - стандартная генерация одной угадайки ( начинаем сверху вниз генерить;
*'''очередь 1''' - Основная очередь, пытаемся из неё сгенерировать задачу, при получении Taskorganizer сост. _generate_guess_, если в предыдущем поле стоит '''нет'''. Каждая задача из этой очереди имеет условия для появления ( прохождение сюжетного таска к примеру);
*'''очередь 2''' - Очередь затычка, задачи из этой очереди без условий. Предназначена когда в первой очереди нету доступных тасков для генерации;

<pre>
У таскорганайзера есть поле disabled, если при каждом запуске приложения после конца туториала писать туда 1 - это приведет к удалению старого сейва и несозданию нового. Несколько килобайт выгоды в опциях + использовать только для туториального таскорганайзера, когда он отработает.
</pre>

=Taskorganizer setup=
[[Файл:Task_2.jpg|600px|thumb|right]]

*'''id''' - Идентификатор задания. Используется в других заданиях. По общей концепции - строковый айди. Перетаскивается из текстовой базы.
'''Для каждого задания(записи в logbook) должен быть свой уникальный id.'''
*'''хинт''' - Список строк-подсказок для задачи. Перетаскиваются из текстовой базы. Таким образом, добавив несколько записей из базы, увидим выпадающий список.
*'''название (объект)''' - Текстовый объект, в который мы сложим название задания. Описание подтягивается из текстовой базы из первого столбика (word) текстового id задания.
*'''машина''' - Объект, которому при активации задания будет вызвано состояние show, а при повторном открытии задания show_old.
*'''портрет''' - Объект, которому при активации задания будет устанорвлен графический ресурс рожи.
*'''таблица''' - Таблица куда будут помещены темплейты предметов данного задания.
*'''описание (объект)''' - Текстовый объект, в который мы сложим описание задания. Описание подтягивается из текстовой базы из второго столбика (sentence1) текстового id задания.
*'''награда (ресурс 1)''' - Счетчик отображающий награду в ресурсе 1 за выполнение задания.
*'''награда (ресурс 2)''' - Счетчик отображающий награду в ресурсе 2 за выполнение задания.
*'''награда (опыт)''' - Счетчик отображающий награду в опыте за выполнение задания.
*'''таблица хинта''' - Таблица, в которую будем складывать хинты.

'''Необходимое для логбука'''

*'''для журнала''' - 0 - задача предназначена для списка задач, 1 - задача предназначена для журнала.
*'''категория''' - Категория к которой относится задача/запись. Пока используется только задачами для логбука.

'''Критерии появления'''

*'''уровень''' - Минимальный уровень, при котором может появиться задание.
*'''аномалия''' - В какой-либо локации присутствует аномалия данного типа. -1 - не учитывать условие.
*'''локация''' - Локация для которой будем проверять мастерство. -1 - не учитывать условие.
*'''мастерство''' - Уровень мастерства, который должен быть достигнут в локиции. -1 - не учитывать условие.
*'''завершены до''' - Задания, которые должны быть завершены до появления этого.
*'''получены до''' - Задания, которые должны быть получены до появления этого.
*'''не завершены до''' - Задания, которые должны быть НЕ завершены до появления этого.
*'''объект до''' - Объект, который должен находиться в состоянии_до для появления задания.
*'''состояние до''' - Состояние объекта_до, в котором вызывается генерация задания.
*'''коллекционные''' - Коллекционные предметы, которые должны быть найдены для появления задания.
*'''вероятность нужного''' - Когда мы будем проходить локации, в которых есть предметы необходимые для задания - мы будем подменять вероятность из локации вот этой вероятностью. 0 - использовать дефолтную.

'''Критерии завершения'''

*'''с аномалией''' - Задача выполняется при нахождение локации с аномалией данного типа. Не путать с аномалией необходимой для возникновения задания. -1 - не учитывать аномалию.
*'''задачи''' - Задания, выполнение которых требуется для выполнения данной.
*'''предметы''' - Задание завершается, когда получены следующие предметы (коллекционные и инвентарные единым списком).
*'''объект''' - Объект, который должен находиться в определенном состоянии,для завершения задания.
*'''состояние''' - Состояние объекта, в котором вызывается проверка задания.

'''Награда'''

*'''ресурс 1''' - Деньги даваемые за выполнение задания.
*'''ресурс 2''' - Кристаллы даваемые за выполнение задания.
*'''опыт''' - Опыт даваемый за выполнение задания.
*'''перевести объект''' - При выполнении задания этот объект будет переведен в новое состояние.
*'''в состояние''' - Состояние для объекта из предыдущего поля.

==Изменить состояние объекта - новое задание==

Позволяет изменять состояние объекту каждый раз при появлении нового задания, находится в taskorganizer setup.

=Состояния=

*'''show''' - При вызове этого состояния из таблицы с иконками заданий открывается соответствующая машина задания, прописанная в группе '''задание'''.
*'''check''' - При вызове проверяется выполнение текущих заданий(заданий добавленных в таблицу). Для того чтобы таскорганайзер добавил таски в таблицу после загрузки приложения ему нужно передать refresh.
*'''generate''' - При вызове подбирается подходящее задание в зависимости от прогресса игрока.
*'''generate_plot''' - При вызове генерится задача с персонажем ( поле генерируемые с персонажами), если перед этим передать в поле gen_face номер персонажа, то сгенерируем с указанным персонажем, после параметр обнулится ( значение -1 ). Перед вызовом данного состояния, '''обязательнo''' в поле _param_ вбить "1".
*'''log_check''' - При вызове состояния проверяется доступны ли новые записи в логбук.
*'''log_show''' - Заполняет таблицу логбука записями с текущим фильтром.
*'''refresh''' - Удаляет иконку выполненного задания из таблицы. Лучше всего вызывать после Check.
*'''cancel''' - Удаляет задание без награды, которое указано как ID в параметре param таскорганайзера, т.е. объекту Taskorganizer в param указываем ID таска (например 1933 - берется из options.xml или текстовой базы), а потом вызываем состояние cancel.
*'''add_hint''' - Добавляет в таблицу хинтов следующий текстовый ID из поля хинты текущего таска. Если все хинты показаны, то в опции записывается параметр haveHints=0.
*'''task_prev''' - Используется, если открыта машина-шаблон текущего задания. В этом состоянии показывается предыдущее по списку таблицы задание.
*'''task_next''' - Показывает следующее по списку таблицы задание.
<pre>
Состояния task_prev и task_next работают циклически, после первой задачи показывают последнюю и наоборот.
</pre>
*'''show_id''' - Показать окно задачи, взяв ее id из параметра.
*'''show_last_plot''' - Открыть последнюю сгенерированную сюжетную задачу.
*'''guess''' - Ответить на текущую угадайку, взяв ответ из параметра (param). Taskorganizer также хранит правильный ответ на текущую угадайку в параметре ''guess_answer'', его можно использовать, если нужно оставить игроку меньше вариантов для угадывания.
*'''add_hint_last''' - Добавить подсказку последней добавленной задаче.
*'''add_hint_top''' - Добавить подсказку верхней задаче в таблице.
*'''guess_who_reward''' - начислить награду за последнюю угадайку.
*'''roulette_complete''' -состояние, вызываемое при выполнении текущей задачи "рулетка".
*'''cheat_complete''' - если его вызвать, то при следующем check выполнится задача, для которой последней показывали превью.
*'''skip''' - При вызове этого состояния выполнится последний открытый таск. Цена скипа указывается внутри самого таска.
*'''check_multiple''' - Проверить выполнение задач не выходя из проверки после первой найденной.

Состояния для работы с тасками-угадайками по типу викторины ( в taskorganizer_setup - тип = "угадайка"):
*'''answer''' - ответить на открытую угадайку ( в поле '''param''' должно находиться число, номер нажатой кнопки от 0 до 3 ). Вешаем на кнопки варианты-ответа ( пишем param = 0 - 3 , после передаёт _answer_);
*'''generate_guess''' - сгенерировать угадайку-викторину ( выберет доступные задачи из диапазона указанном в очередях ( 1 и 2) поле _угадаечные задачи_ taskorganizer). При открытии угадайки, в поле _cur_guess_answer_ объекта Taskorganizer записывается номер кнопки где лежит правильный ответ ( от 0 до 3 );

ПРИМЕЧАНИЕ: при проверке задач для логбука для последней выполненной будет перезаписано поле filter автоматически.

При кажом refresh таскорганайзер заполняет у себя поля:
*'''tasks_in_table''' - задач в таблице
*'''tasks_total''' - задач в таблице + скрытых задач

=Запись в опции=

В процессе работы таскорганайзер записывает параметры в опции. Для конкретной задачи этот параметр представляет следующую строку:

"tasks(id таскорганайзера в проекте).t(id текстового объекта - идентификатора задания).s".

Возможные значения:
* '''0''' - таск не активен (не добавлен путем вызова generate таскорганайзеру);
* '''1''' - таск сгенерирован ;
* '''2''' - таск прочитан (вызвано состояние show);
* '''3''' - таск выполнен;
* '''4''' - отложенное состояние таска (условия появления выполнены, но время его появления еще не прийшло);
* '''5''' - таск выполнен, но награда ещё не забиралась ( таск будет оставаться в таблице, если таски не выполняются автоматически);

=Сопутствующие объекты=

Объекты, которые используются вместе с объектом economics и имеют с ним непосредственную связь:

* [[Файл:E_items.png]] - [[Eitems]] - объект, служащий для связи инвентаря(магазина) и экономики.
* [[Файл:E_store_item.png]] - [[Estoreitem]] - шаблон для ячейки магазина.
* [[Файл:E_inventory_item.png]] - [[Einventoryitem]] - шаблон для ячейки инвентаря.
* [[Файл:Kub.png]] - [[Ecraftitem]] - шаблон для ячейки создания предмета.
* [[Файл:Taskorganizer.png]] - [[Taskorganizer]] - органайзер заданий.
* [[Файл:E_task_item.png]] - [[Etaskitem]] - шаблон для ячейки задания.
* [[Файл:E_collection.png]] - [[Ecollection]] - шаблон для строки в таблице коллекции.
* [[Файл:Economics.png]] - [[Economics]] - глобальная настройка игр типа ферма\билдер

=Вычитаемые параметры:=
Каждая таскорганайзер пишет в пользователя следующие параметры:
*'''public.TaskOrganizerCompletedTasks''' - количество выполненных одноразовых задач;
*'''public.TaskOrganizerCompletedTasksAll''' - количество выполненных задач с учётом повторяемых;

=Механизм многоуровневых достижений=

=Пример проекта=
S:\!MOBILE\!!!EditorGames\Wiki_sample\Taskorganizer

[[Category:Economics]]

Absolutist Framework

2016-04-19T11:17:32Z

Vefimov: /* Game mechanic */

{{TOC right}}
'''[[:category:main|Категории]]'''
== Новости ==
Вышла новая игра HOG созданная с помощью AppSalute Game Сreator. Созданы новые уникальные эффекты и механики для обеспечения незабываемых впечатлений.
Описание и видео:
http://time-gap.com/

== AppSalute Game Сreator ==
* [[Примеры приложений]]
* [[Введение в AppSalute Game Сreator]]
* [[Установка и настройка]]
* [[Интерфейс ScenceEditor ]]
* [[Интерфейс ResourceEditor ]]
* [[Интерфейс TextEditor ]]
*[[Интерфейс Viewer ]]
* [[Книга жалоб и пожеланий]]
* [[Roadmap]]

== Обучение ==

* [[Learning|Уроки по освоению фреймворка]]
* [[Примеры реализации в играх]]
* [[Основные понятия объектов физического мира]]
* [[Использование AppSalute Debugger при отладке]]
* [[FAQ]]

== Подготовка проекта ==
* [[Проектирование экранов игры]]
* [[Подготовка и форматы графики]]
* [[Подготовка и форматы шрифтов]]
* [[Подготовка и форматы звуков]]
* [[Подготовка и форматы видео]]
* [[Создание проекта]]
* [[Загрузка проекта по частям]]
* [[Конфигурация проекта для сборки]]
* [[Подготовка для загрузки на маркеты]]
* [[Сборка проекта]]
* [[Частые ошибки]]
* [[Отличия подготовки проекта для разных платформ]]
* [[Lua|Использование lua-скриптов]]

== Встроенные объекты редактора==

=== Common objects ===

''[[Файл:Screen.png]] - [[Screen]]'' - экран

''[[Файл:Scene.png]] - [[Scene]]'' - сцена

=== Main objects ===

''[[Файл:Objects.png]] - [[Object]]'' - общие параметры для всех игровых объектов

* [[Файл:Kub.png]] - [[Azmanager]] - менеджер активных зон
* [[Файл:Kub.png]] - [[Active zone]] - активная зона
* [[Файл:Picture.png]] - [[Image]] - картинка
* [[Файл:Kub.png]] - [[Statistic]] - объект для отправки событий статистики.
* [[Файл:Button.png]] - [[Button]] - кнопка
* [[Файл:Text.png]] - [[Text]] - текст
* [[Файл:Machine.png]] - [[Machine]] - машина состояний
* [[Файл:Tableicon.png]] - [[Table]] - таблица
* [[Файл:Checkbox.png]] - [[Checkbox]] - чекбокс (кнопка в 2-х состояниях)
* [[Файл:Checkgroup.png]] - [[Groupbox]] - группа, содержащая несколько чекбоксов
* [[Файл:Timer.png]] - [[Timer]] - цифровой таймер
** [[Файл:Kub.png]] - [[Globaltimer]] - таймер "реального времени"
* [[Файл:Counter2.png]] - [[Counter]] - счетчик сделанных кликов в игре и т.п.
* [[Файл:Progressbar.png]] - [[Progress]] - прогресс прохождения игры (эчивмент)
* [[Файл:Particle.png]] - [[Flyer]] - флаер (патиклы)
* [[Файл:Rectangle.png]] - [[Rectangle]] - прямоугольник
* [[Файл:Kub.png]] - [[Isomover]] - объект движения в изометрической карте
* [[Файл:Group.png]] - [[Group]] - группа
* [[Файл:Groupset.png‎]] - [[Groupset]] - группа
* [[Файл:Effect.jpg|20px]] - [[Effect]] - Создание различных эффектов
* [[Файл:Graphprogress.png]] - [[Graphprogress]] - создание мини-карты для отображения прогресса прохождения игры.
* [[Файл:Kub.png]] - [[Statesmanager]] - очередь работы с объектами
* [[Файл:Slider icons.png]] - [[Slider]] - объект реализующий листание списка.
* [[Файл:Ribbon.png]] - [[Ribbon]] - объект отображения графики по сплайну
* [[Файл:Kub.png]] - [[Animation]] - объект различных анимаций
* [[Файл:Kub.png]] - [[Magicparticles]] - объект файлов Magic Particles

=== Game mechanic ===

* [[Файл:Puzzle.png]] - [[Puzzle]] - игра пазл
* [[Файл:Memory.png]] - [[Memory]] - класс игр с memory-механикой
* [[Файл:Patchwork.png]] - [[Patchwork]] - класс игр с Patchwork-механикой
* [[Файл:Match3.png]] - [[Match]] - класс match-подобных игр
* [[Файл:Collaps.png]] - [[Collapse]] - класс match-подобных игр
* [[Файл:Bejewelled.png]] - [[Bejewelled]] - класс match-подобных игр
* [[Файл:BubbleShooter.png]] - [[Bubble Shooter]] - класс Bubble игр включая механику Снукер
* [[Файл:Tapthebubble.png]] - [[TapTheBubble]] - механика игры Tap The Bubble
* [[Файл:GemSlider.jpg]] - [[Gem Slider]] - механика игры Gem Slider
* [[Файл:W-57.png]] - [[Words]] - механика игры Words
* [[Файл:Kub.png]] - [[2048]] - механика игры 2048
* [[Файл:Kub.png]] - [[Planet]] - игра "Планетки"
* [[Файл:Kub.png]] - [[Unblock]] - механика игры unblock
* [[Файл:Matchbattle.png]] - [[Match Battle]] - настройка глобальных параметров для мини-игр
* [[Файл:Move box.png]] - [[DragBox]] - класс игр с dragbox-механикой
* [[Файл:Labyrinth.png]] - [[Labyrinth]] - класс игр лабиринт
* [[Файл:Pipes.png]] - [[Pipes]] - класс игр трубы
* [[Файл:Search object.png]] - [[HiddenObject]] - поисковый объект в хидден играх
* [[Файл:Object list.png]] - [[HiddenList]] - список поисковых объектов в хидден играх
* [[Файл:Hint.png]] - [[HiddenHint]] - подсказка (указатель на спрятанный объект)
* [[Файл:Kub.png]] - [[HiddenHighLighter]] - позволяет показать не найденные объекты в хиддене.
* [[Файл:Collection.png]] - [[Collection]] - "коллекция" поисковых объектов для хидден игр
* [[Файл:Inventory.png]] - [[Inventory]] - "инвентарь" список применяемых объектов для игр
* [[Файл:Tool.png]] - [[Tool]] - "применение" - объект, который можно применить для игр
* [[Файл:Kub.png]] - [[Isomap]] - изометрическая карта
* [[Файл:Slotmachine.png]] - [[Slotmachine]] - объект типа "slot"
* [[Файл:Economics.png]] - [[Economics]] - глобальная настройка игр типа ферма\билдер
** [[Файл:E_items.png]] - [[Eitems]] - объект, служащий для связи инвентаря/магазина и экономики
** [[Файл:E_store_item.png]] - [[Estoreitem]] - шаблон для ячейки магазина
** [[Файл:E_inventory_item.png]] - [[Einventoryitem]] - шаблон для ячейки инвентаря
** [[Файл:Kub.png]] - [[Ecraftitem]] - шаблон для ячейки создания предмета.
** [[Файл:Taskorganizer.png]] - [[Taskorganizer]] - органайзер заданий
*** [[Файл:Kub.png]] - [[Etasktemplate]] - шаблон задачи для таблицы темплейтов.
** [[Файл:E_task_item.png]] - [[Etaskitem]] - шаблон для ячейки задания
** [[Файл:E_collection.png]] - [[Ecollection]] - шаблон для строки в таблице коллекции
* [[Файл:Paint.png‎]] - [[Paint]] - объект для рисования
* [[Файл:Physicsworld.png]] - [[Physicsworld]] - физический мир Box2D
** [[Файл:Physicsobject.png]] - [[Physicsobject]] - физические объекты
** [[Файл:Physics links.png]] - [[Physicsjoint]] - физические соединения
* [[Файл:Eraser.png]] - [[Eraser]] - стирачка
* [[Файл:Kub.png]] - [[trivia]] - игровая механика - миллионер (trivia)
* [[Файл:Kub.png]] - [[Dailybonus]] - объект для управления механизмом ежедневного бонуса за вход в игру.
* [[Файл:Kub.png]] - [[Pet]] - объект питомца.
* [[Файл:Kub.png]] - [[PetCollectionTemplate]] - объект шаблона ячейки с коллекцией.
* [[Файл:Kub.png]] - [[PetTemplate]] - объект шаблона ячейки с животным.

=== Global score ===
* [[Файл:Gamecenter.png]] - [[Gamecenter]] - объект для отправки данных на GameCenter iTunse
**[[Файл:Kub.png]] - [[Achievementitem]] - шаблон локального достижения (оффлайн ачивка)
* [[Файл:Gamecircle.jpg]] - [[Amazon GameCircle]] - объект для отправки данных Amazon GameCircle
* [[Файл:Google-play-games-android.jpg‎]] - [[Google Play services]] - объект для отправки данных на Google Play services
* [[Файл:Localtoplist.png]] - [[Localtoplist]] - настройки для отображения результатов прохождения игры
* [[Файл:Globaltoplist.png]] - [[Globaltoplist]] - настройки для отображения результатов прохождения игры
* [[Файл:Globaltopsender.png]] - [[Globaltopsender]] - настройки для отображения результатов прохождения игры

=== Options ===
* [[Файл:Options.png]] - [[Options]] - общие настройки игры
* [[Файл:Gamedata.png]] - [[Gamedata]] -
* [[Файл:Controls.png]] - [[Controls]] - обьект для работы с клавишами клавиатуры или девайса
* [[Файл:Editicon.png]] - [[Edit]] - ввод текста
* [[Файл:Store.png]] - [[Store]] - настройки InApp покупок в игре
** [[Файл:Kub.png]] - [[Wallet]] - объект для начисления игровой валюты при InApp покупках через объект economics
* [[Файл:Notification.png]] - [[Notification]] - push-уведомления
* [[Файл:Imagepicker.png]] - [[Imagepiker]] - объект для загрузки фото из галереи
* [[Файл:Video.png]] - [[Video]] - объект для просмотра видео
* [[Файл:Webview.png]] - [[Webview]] - объект для просмотра интернет страниц в приложении
* [[Файл:Flurryobject.png]] - [[Flurry]] - настройки системы статистики для приложений https://dev.flurry.com
* [[Файл:Moregames.png]] - [[MoreGamesList]] - запрос банеров рекламируемых игр
* [[Файл:Advertisement.png]] - [[Advertisement]] - банерная система flurry, amazon
* [[Файл:Splitmanager.png]] - [[Splitmanager or A\B Testing]] - менеджер сплитов
* [[Файл:Tapjoy.png]] - [[Tapjoy]] - система рекламы игр
* [[Файл:Playhaven.png|24px]] - [[Playhaven]] - система рекламы игр с внутренними up-sale
* [[Файл:Mobileapptracker.png|24px]] - [[Mobileapptracking]] -
* [[Файл:Chartboost-logo-new.jpeg]] - [[Chartboost]] - Chartboost-logo-new.jpeg
* [[Файл:Kub.png]] - [[SuperSonic]] - провайдер рекламы SuperSonic
* [[Файл:Kub.png]] - [[System]] - объект для доступа к системным настройкам
* [[Файл:Kub.png]] - [[Salesmanager]] - менеджер акций
* [[Файл:Kub.png]] - [[Cloud]] - объект для синхронизации в облаке
* [[Файл:Kub.png]] - [[Game]] - объект для отправки событий

=== Social ===
* [[Файл:Facebook.png]] - [[Facebook]] - настройки расшаривания Facebook
** [[Файл:Esocialfrienditem.png]] - [[Esocialitem]] - Шаблон для ячейки списка друзей
** [[Файл:Kub.png]] - [[Esocialgiftitem]] - Шаблон для ячейки с предметом, который можно подарить другу
** [[Файл:Esocial.png]] - [[Esocial]] - объект для взаимодействия с Facebook'ом
* [[Файл:Twitter.png]] - [[Twitter]] - настройки расшаривания Twitter
* [[Файл:Odnoklassniki.png]] - [[Odnoklassniki]] - настройки для социальной сети Одноклассники
* [[Файл:Googleplus.png]] - [[GooglePlus]] - настройки для социальной сети GooglePlus

=== Functions ===
* [[Файл:Forward.png]] - [[SendMail]] - отправка письма через почтовый клиент
* [[Файл:footer-icon-rate.png]] - [[Rate]] - вызов окна оценки приложения
----
<gallery widths="50px" heights="50px" >
Изображение:Who.png
Изображение:AnimalHideSeek.png
Изображение:travel.png
Изображение:Game_Adventure_Train.png
Изображение:Gmae_Match_MoveTheDolly.png
Изображение:Game_Patchwork_BigEyes.png
Изображение:Game_Patchwork_Chameleon.png
Изображение:Game_Patchwork_Logicly.png‎
Изображение:Game_Patchwork_Stickers.png‎
Изображение:Elephant.png
Изображение:Elephant2.png
Изображение:Cinderella.png
Изображение:Pigs.png
Изображение:Bremenskye.png
Изображение:Book_SnowWhite.png
Изображение:Book_PussInBoots.png
Изображение:Call.png
Изображение:GreatestArtists.png
Изображение:Game_Puzzle_Kids.png
Изображение:Game_Puzzle_Architect.png‎
Изображение:Game_Puzzle_Science.png
Изображение:Ico_1_114_Full.png
Изображение:Game_Adventure_Dreams.png
Изображение:Abc.png
Изображение:Ico_114_Full.png
Изображение:Ico_114_Paints.png
Изображение:Ico_114_Puzzle.png
</gallery>

[[category:main]]

Etasktemplate

2016-04-19T11:15:22Z

Vefimov: Новая страница: «{{TOC right}} Данный объект представляет собой темплейт задач, которые будут помещены в…»

{{TOC right}}
Данный [[Object|объект]] представляет собой темплейт задач, которые будут помещены в таблицу для шаблонов (tabletemplate) [[Taskorganizer|таскорганайзера]].
[[Файл:Etasktemplate.png|right|thumb]]

=Параметры=

*'''taskorganizer''' - Объект типа taskorganizer, который использует темплейт;
*'''название''' - Текстовый объект куда будет занесено название задачи, берется из поля word текстового id задачи;
*'''описание''' - Текстовый объект куда будет занесено описание задачи, берется из поля sentence1 текстового id задача для активной задачи и sentence2 - для выполненной;
*'''иконка''' - Иконка задания (ico1);
*'''иконка 2''' - Вторая иконка задания, для активной задачи ресурс ico2, для выполненной ico3;
*'''выполнено''' - Счетчик, куда буде занесен текущий прогресс;
*'''всего''' - Счетчик, куда буде занесен необходимый прогресс;
*'''прогресс''' - Прогресс (отношение текущего к необходимому);
*'''награда ресурс 1''' - Счетчик награды ресурс 1;
*'''награда ресурс 2''' - Счетчик награды ресурс 2;
*'''награда опыт''' - Счетчик награды опыта;
*'''кнопка''' - Отображается для активных задач, для которой текущий прогресс меньше необходимого;
*'''кнопка2''' - Отображается для активных задач, для которой текущий прогресс равен необходимому;
*'''кнопка искать''' - Кнопка;
*'''награда предмет иконка''' - Иконка награды-предмета;
*'''награда количество''' - Количество предметов в награде;
*'''отметка выполненной задачи''' - Галочка видимая для выполненных задач и невидимая для невыполненных;
*'''эффект новой задачи''' - Эффект, который будет склонирован для новой задачи;

=Состояния=

*'''take''' - должно вызываться кнопкой или кнопкой2, при вызове состояния в объект записываются параметры:
**'''clicked_task_id''' - id таска, на темплейте которого была нажата кнопка или кнопка2;
**'''clicked_task_x''' - координата x центра ячейки, относительно пивота таблицы, в которой была нажата кнопка или кнопка2;
**'''clicked_task_y''' - координата y центра ячейки, относительно пивота таблицы, в которой была нажата кнопка или кнопка2;

[[Category:Game mechanic]]

Файл:Etasktemplate.png

2016-04-19T10:32:47Z

Vefimov:

Absolutist Framework

2016-04-05T11:02:27Z

Vefimov: /* Main objects */

{{TOC right}}
'''[[:category:main|Категории]]'''
== Новости ==
Вышла новая игра HOG созданная с помощью AppSalute Game Сreator. Созданы новые уникальные эффекты и механики для обеспечения незабываемых впечатлений.
Описание и видео:
http://time-gap.com/

== AppSalute Game Сreator ==
* [[Примеры приложений]]
* [[Введение в AppSalute Game Сreator]]
* [[Установка и настройка]]
* [[Интерфейс ScenceEditor ]]
* [[Интерфейс ResourceEditor ]]
* [[Интерфейс TextEditor ]]
*[[Интерфейс Viewer ]]
* [[Книга жалоб и пожеланий]]
* [[Roadmap]]

== Обучение ==

* [[Learning|Уроки по освоению фреймворка]]
* [[Примеры реализации в играх]]
* [[Основные понятия объектов физического мира]]
* [[Использование AppSalute Debugger при отладке]]
* [[FAQ]]

== Подготовка проекта ==
* [[Проектирование экранов игры]]
* [[Подготовка и форматы графики]]
* [[Подготовка и форматы шрифтов]]
* [[Подготовка и форматы звуков]]
* [[Подготовка и форматы видео]]
* [[Создание проекта]]
* [[Загрузка проекта по частям]]
* [[Конфигурация проекта для сборки]]
* [[Подготовка для загрузки на маркеты]]
* [[Сборка проекта]]
* [[Частые ошибки]]
* [[Отличия подготовки проекта для разных платформ]]
* [[Lua|Использование lua-скриптов]]

== Встроенные объекты редактора==

=== Common objects ===

''[[Файл:Screen.png]] - [[Screen]]'' - экран

''[[Файл:Scene.png]] - [[Scene]]'' - сцена

=== Main objects ===

''[[Файл:Objects.png]] - [[Object]]'' - общие параметры для всех игровых объектов

* [[Файл:Kub.png]] - [[Azmanager]] - менеджер активных зон
* [[Файл:Kub.png]] - [[Active zone]] - активная зона
* [[Файл:Picture.png]] - [[Image]] - картинка
* [[Файл:Kub.png]] - [[Statistic]] - объект для отправки событий статистики.
* [[Файл:Button.png]] - [[Button]] - кнопка
* [[Файл:Text.png]] - [[Text]] - текст
* [[Файл:Machine.png]] - [[Machine]] - машина состояний
* [[Файл:Tableicon.png]] - [[Table]] - таблица
* [[Файл:Checkbox.png]] - [[Checkbox]] - чекбокс (кнопка в 2-х состояниях)
* [[Файл:Checkgroup.png]] - [[Groupbox]] - группа, содержащая несколько чекбоксов
* [[Файл:Timer.png]] - [[Timer]] - цифровой таймер
** [[Файл:Kub.png]] - [[Globaltimer]] - таймер "реального времени"
* [[Файл:Counter2.png]] - [[Counter]] - счетчик сделанных кликов в игре и т.п.
* [[Файл:Progressbar.png]] - [[Progress]] - прогресс прохождения игры (эчивмент)
* [[Файл:Particle.png]] - [[Flyer]] - флаер (патиклы)
* [[Файл:Rectangle.png]] - [[Rectangle]] - прямоугольник
* [[Файл:Kub.png]] - [[Isomover]] - объект движения в изометрической карте
* [[Файл:Group.png]] - [[Group]] - группа
* [[Файл:Groupset.png‎]] - [[Groupset]] - группа
* [[Файл:Effect.jpg|20px]] - [[Effect]] - Создание различных эффектов
* [[Файл:Graphprogress.png]] - [[Graphprogress]] - создание мини-карты для отображения прогресса прохождения игры.
* [[Файл:Kub.png]] - [[Statesmanager]] - очередь работы с объектами
* [[Файл:Slider icons.png]] - [[Slider]] - объект реализующий листание списка.
* [[Файл:Ribbon.png]] - [[Ribbon]] - объект отображения графики по сплайну
* [[Файл:Kub.png]] - [[Animation]] - объект различных анимаций
* [[Файл:Kub.png]] - [[Magicparticles]] - объект файлов Magic Particles

=== Game mechanic ===

* [[Файл:Puzzle.png]] - [[Puzzle]] - игра пазл
* [[Файл:Memory.png]] - [[Memory]] - класс игр с memory-механикой
* [[Файл:Patchwork.png]] - [[Patchwork]] - класс игр с Patchwork-механикой
* [[Файл:Match3.png]] - [[Match]] - класс match-подобных игр
* [[Файл:Collaps.png]] - [[Collapse]] - класс match-подобных игр
* [[Файл:Bejewelled.png]] - [[Bejewelled]] - класс match-подобных игр
* [[Файл:BubbleShooter.png]] - [[Bubble Shooter]] - класс Bubble игр включая механику Снукер
* [[Файл:Tapthebubble.png]] - [[TapTheBubble]] - механика игры Tap The Bubble
* [[Файл:GemSlider.jpg]] - [[Gem Slider]] - механика игры Gem Slider
* [[Файл:W-57.png]] - [[Words]] - механика игры Words
* [[Файл:Kub.png]] - [[2048]] - механика игры 2048
* [[Файл:Kub.png]] - [[Unblock]] - механика игры unblock
* [[Файл:Matchbattle.png]] - [[Match Battle]] - настройка глобальных параметров для мини-игр
* [[Файл:Move box.png]] - [[DragBox]] - класс игр с dragbox-механикой
* [[Файл:Labyrinth.png]] - [[Labyrinth]] - класс игр лабиринт
* [[Файл:Pipes.png]] - [[Pipes]] - класс игр трубы
* [[Файл:Search object.png]] - [[HiddenObject]] - поисковый объект в хидден играх
* [[Файл:Object list.png]] - [[HiddenList]] - список поисковых объектов в хидден играх
* [[Файл:Hint.png]] - [[HiddenHint]] - подсказка (указатель на спрятанный объект)
* [[Файл:Kub.png]] - [[HiddenHighLighter]] - позволяет показать не найденные объекты в хиддене.
* [[Файл:Collection.png]] - [[Collection]] - "коллекция" поисковых объектов для хидден игр
* [[Файл:Inventory.png]] - [[Inventory]] - "инвентарь" список применяемых объектов для игр
* [[Файл:Tool.png]] - [[Tool]] - "применение" - объект, который можно применить для игр
* [[Файл:Kub.png]] - [[Isomap]] - изометрическая карта
* [[Файл:Slotmachine.png]] - [[Slotmachine]] - объект типа "slot"
* [[Файл:Economics.png]] - [[Economics]] - глобальная настройка игр типа ферма\билдер
** [[Файл:E_items.png]] - [[Eitems]] - объект, служащий для связи инвентаря/магазина и экономики
** [[Файл:E_store_item.png]] - [[Estoreitem]] - шаблон для ячейки магазина
** [[Файл:E_inventory_item.png]] - [[Einventoryitem]] - шаблон для ячейки инвентаря
** [[Файл:Kub.png]] - [[Ecraftitem]] - шаблон для ячейки создания предмета.
** [[Файл:Taskorganizer.png]] - [[Taskorganizer]] - органайзер заданий
** [[Файл:E_task_item.png]] - [[Etaskitem]] - шаблон для ячейки задания
** [[Файл:E_collection.png]] - [[Ecollection]] - шаблон для строки в таблице коллекции
* [[Файл:Paint.png‎]] - [[Paint]] - объект для рисования
* [[Файл:Physicsworld.png]] - [[Physicsworld]] - физический мир Box2D
** [[Файл:Physicsobject.png]] - [[Physicsobject]] - физические объекты
** [[Файл:Physics links.png]] - [[Physicsjoint]] - физические соединения
* [[Файл:Eraser.png]] - [[Eraser]] - стирачка
* [[Файл:Kub.png]] - [[trivia]] - игровая механика - миллионер (trivia)
* [[Файл:Kub.png]] - [[Dailybonus]] - объект для управления механизмом ежедневного бонуса за вход в игру.
* [[Файл:Kub.png]] - [[Pet]] - объект питомца.
* [[Файл:Kub.png]] - [[PetCollectionTemplate]] - объект шаблона ячейки с коллекцией.
* [[Файл:Kub.png]] - [[PetTemplate]] - объект шаблона ячейки с животным.

=== Global score ===
* [[Файл:Gamecenter.png]] - [[Gamecenter]] - объект для отправки данных на GameCenter iTunse
**[[Файл:Kub.png]] - [[Achievementitem]] - шаблон локального достижения (оффлайн ачивка)
* [[Файл:Gamecircle.jpg]] - [[Amazon GameCircle]] - объект для отправки данных Amazon GameCircle
* [[Файл:Google-play-games-android.jpg‎]] - [[Google Play services]] - объект для отправки данных на Google Play services
* [[Файл:Localtoplist.png]] - [[Localtoplist]] - настройки для отображения результатов прохождения игры
* [[Файл:Globaltoplist.png]] - [[Globaltoplist]] - настройки для отображения результатов прохождения игры
* [[Файл:Globaltopsender.png]] - [[Globaltopsender]] - настройки для отображения результатов прохождения игры

=== Options ===
* [[Файл:Options.png]] - [[Options]] - общие настройки игры
* [[Файл:Gamedata.png]] - [[Gamedata]] -
* [[Файл:Controls.png]] - [[Controls]] - обьект для работы с клавишами клавиатуры или девайса
* [[Файл:Editicon.png]] - [[Edit]] - ввод текста
* [[Файл:Store.png]] - [[Store]] - настройки InApp покупок в игре
** [[Файл:Kub.png]] - [[Wallet]] - объект для начисления игровой валюты при InApp покупках через объект economics
* [[Файл:Notification.png]] - [[Notification]] - push-уведомления
* [[Файл:Imagepicker.png]] - [[Imagepiker]] - объект для загрузки фото из галереи
* [[Файл:Video.png]] - [[Video]] - объект для просмотра видео
* [[Файл:Webview.png]] - [[Webview]] - объект для просмотра интернет страниц в приложении
* [[Файл:Flurryobject.png]] - [[Flurry]] - настройки системы статистики для приложений https://dev.flurry.com
* [[Файл:Moregames.png]] - [[MoreGamesList]] - запрос банеров рекламируемых игр
* [[Файл:Advertisement.png]] - [[Advertisement]] - банерная система flurry, amazon
* [[Файл:Splitmanager.png]] - [[Splitmanager or A\B Testing]] - менеджер сплитов
* [[Файл:Tapjoy.png]] - [[Tapjoy]] - система рекламы игр
* [[Файл:Playhaven.png|24px]] - [[Playhaven]] - система рекламы игр с внутренними up-sale
* [[Файл:Mobileapptracker.png|24px]] - [[Mobileapptracking]] -
* [[Файл:Chartboost-logo-new.jpeg]] - [[Chartboost]] - Chartboost-logo-new.jpeg
* [[Файл:Kub.png]] - [[SuperSonic]] - провайдер рекламы SuperSonic
* [[Файл:Kub.png]] - [[System]] - объект для доступа к системным настройкам
* [[Файл:Kub.png]] - [[Salesmanager]] - менеджер акций
* [[Файл:Kub.png]] - [[Cloud]] - объект для синхронизации в облаке
* [[Файл:Kub.png]] - [[Game]] - объект для отправки событий

=== Social ===
* [[Файл:Facebook.png]] - [[Facebook]] - настройки расшаривания Facebook
** [[Файл:Esocialfrienditem.png]] - [[Esocialitem]] - Шаблон для ячейки списка друзей
** [[Файл:Kub.png]] - [[Esocialgiftitem]] - Шаблон для ячейки с предметом, который можно подарить другу
** [[Файл:Esocial.png]] - [[Esocial]] - объект для взаимодействия с Facebook'ом
* [[Файл:Twitter.png]] - [[Twitter]] - настройки расшаривания Twitter
* [[Файл:Odnoklassniki.png]] - [[Odnoklassniki]] - настройки для социальной сети Одноклассники
* [[Файл:Googleplus.png]] - [[GooglePlus]] - настройки для социальной сети GooglePlus

=== Functions ===
* [[Файл:Forward.png]] - [[SendMail]] - отправка письма через почтовый клиент
* [[Файл:footer-icon-rate.png]] - [[Rate]] - вызов окна оценки приложения
----
<gallery widths="50px" heights="50px" >
Изображение:Who.png
Изображение:AnimalHideSeek.png
Изображение:travel.png
Изображение:Game_Adventure_Train.png
Изображение:Gmae_Match_MoveTheDolly.png
Изображение:Game_Patchwork_BigEyes.png
Изображение:Game_Patchwork_Chameleon.png
Изображение:Game_Patchwork_Logicly.png‎
Изображение:Game_Patchwork_Stickers.png‎
Изображение:Elephant.png
Изображение:Elephant2.png
Изображение:Cinderella.png
Изображение:Pigs.png
Изображение:Bremenskye.png
Изображение:Book_SnowWhite.png
Изображение:Book_PussInBoots.png
Изображение:Call.png
Изображение:GreatestArtists.png
Изображение:Game_Puzzle_Kids.png
Изображение:Game_Puzzle_Architect.png‎
Изображение:Game_Puzzle_Science.png
Изображение:Ico_1_114_Full.png
Изображение:Game_Adventure_Dreams.png
Изображение:Abc.png
Изображение:Ico_114_Full.png
Изображение:Ico_114_Paints.png
Изображение:Ico_114_Puzzle.png
</gallery>

[[category:main]]

Statistic

2016-04-05T10:57:43Z

Vefimov: /* Окно настройки событий событий */

{{TOC right}}

[[Файл:Statistic 4.png|thumb|right]]
[[Object|Объект]] '''Statistic''' предназначен для отправки игровых событий на сервер статистики. Для работы объекту нужны ссылки на объекты [[Economics|экономики]] и [[Options|опций]].

Также в проекте должен быть [[Flurry|объект для отправки статистики]].

'''Важно!''' Все параметры нужно указывать через объект Statistic. Механизм отправки статистики с непосредственным указанием параметров объекту statesender является устаревшим и приводит к появлению ворнингов.

Для настройки событий нужно открыть окно объекта (двойной клик по объекту в дереве проекта или на области свойств)

==Окно настройки событий событий==
[[Файл:Statistic 1.png|border|400 px|right]]
В данном окне мы можем добавлять и редактировать группы для событий и сами события.
[[Файл:Statistic 5.png|border|left]]
[[Файл:Statistic 6.png|border|left]]
[[Файл:Statistic 7.png|border|left]]
[[Файл:Statistic 8.png|border|left]]

Каждое событие может иметь произвольное количество параметров, которое ограничено [[Flurry#Ограничения для разных сервисов статистики|сервисом статистики]], куда отправляются данные. Каждое событие может включать статические и пользовательские параметры. Пользовательские параметры добавляются как подобъекты события. Статические события выбираются из списка слева
[[Файл:Statistic 3.png|border|right]]

==Свойства события==

*'''имя события'''
*'''приоритет''' - глобальный фильтр для событий, при указании конкретного значения события с меньшим приоритетом отправляться не будут.
*'''одноразовое''' - Отправлять событие только один раз.
*'''префикс при первом''' - префикс при первом отправлении данного события.

'''''receiver''''' - Система статистики, которой нужно отправлять события.
*'''Flurry'''
*'''AppStat'''
*'''Google'''
*'''Amazon'''

'''''static_events''''' - Статические параметры событий
*'''exp''' - опыт внутри уровня.
*'''level''' - уровень игрока.
*'''xplevel''' - уровень игрока.
*'''res1''' - количество ресурса 1.
*'''coins_left''' - количество ресурса 1.
*'''res2''' - количество ресурса 2.
*'''diams_left''' - количество ресурса 2.
*'''en''' - текущая энергия
[[Файл:Statistic 2.png|border|right]]
*'''res1log''' - логарифмический остаток монет.
*'''res1logfl''' - логарифмический остаток монет.
*'''coins_left_log''' - логарифмический остаток монет.
*'''res1sp''' - количество потраченного ресурса 1.
*'''res2sp''' - количество потраченного ресурса 2.
*'''res1ea''' - количество заработанного ресурса 1.
*'''res2ea''' - количество заработанного ресурса 2.
*'''t_log_ses''' - 24 * log(время сессии).

Также для всех событий автоматически добавляются параметры t_log_cal и t_log_play, которые представляют логарифмическое календарное и игровое время.
Также для всех событий можно добавить пользовательский параметр, который будет добавляться автоматически.

==Использование объекта==
Для того, что бы отправить событие объекту Statistic нужно вызвать состояние, соответствующие имени события. (На пример для события указанного на рисунке нужно вызвать состояние my_event). Следовательно имя каждого события должно быть уникально.

Иногда возникает необходимость отправлять несколько событий, которые отличаются частью имени. Что бы не добавлять несколько событий можно использовать заменяемую часть имени. Вместо части, которую мы будем заменять, нужно указать %r%. Перед отправкой данного события объекту нужно установить в параметр replace_string строку, на которую мы заменим %r%.

Если в событии нужно отправлять параметр, который вычисляется с помощью математики, то все вычисления делаем в [[Machine|машине состояний]], пишем их куда-то (можно в эту же машину), а в событии вычитываем эти параметры.

==Пример==
S:\!MOBILE\!!!EditorGames\Wiki_sample

Statistic_test.zip

[[Category:Main objects]]

Statistic

2016-04-05T10:57:25Z

Vefimov: /* Окно настройки событий событий */

Statistic

2016-04-05T10:57:18Z

Vefimov: /* Окно настройки событий событий */

Statistic

2016-04-05T10:55:19Z

Vefimov: Новая страница: «{{TOC right}} right Объект '''Statistic''' предназначен для отправки игровых с…»

Файл:Statistic 3.png

2016-04-05T09:24:17Z

Vefimov: Vefimov загрузил новую версию Файл:Statistic 3.png

Файл:Statistic 1.png

2016-04-05T09:04:35Z

Vefimov: Vefimov загрузил новую версию Файл:Statistic 1.png

Файл:Statistic 2.png

2016-04-05T09:03:36Z

Vefimov: Vefimov загрузил новую версию Файл:Statistic 2.png

Файл:Statistic 8.png

2016-04-05T08:38:44Z

Vefimov:

Файл:Statistic 7.png

2016-04-05T08:38:38Z

Vefimov:

Файл:Statistic 6.png

2016-04-05T08:38:33Z

Vefimov:

Файл:Statistic 5.png

2016-04-05T08:38:27Z

Vefimov:

Файл:Statistic 4.png

2016-04-05T07:01:24Z

Vefimov:

Файл:Statistic 3.png

2016-04-05T07:01:18Z

Vefimov:

Файл:Statistic 2.png

2016-04-05T07:00:05Z

Vefimov:

Файл:Statistic 1.png

2016-04-05T06:59:53Z

Vefimov:

Salesmanager

2016-04-05T06:02:53Z

Vefimov:

{{TOC right}}

[[Object|Объект]] '''Salesmaneger''' предназначается для управления всплывающими окошками с различными акциями: скидками, выгодными предложениями и т. д. Для того, чтобы наиболее выгодным образом показывать человеку акции, этот объект будет сам определяет категорию пользователя, и в зависимости от нее показывает игроку различные события. За основу взято окно настройки локации из объекта [[Economics|Economics]].

==Окно акций==

[[Файл:SM Actions.png|600 px|right]]
В данном окне добавляются и редактируются акции, которые потом включаются в сценарии. Каждая запись слева представляет одну акцию. Справа расположены настройки акции. Некоторые из них оставлены для совместимости с [[Salesmanager (Предыдущая версия)|предыдущей версией]] менеджера акций.

Используемые параметры:
*'''id события''' - id акции, берется из текстовой базы ресурсов.
*'''объект''' - Машина-обработчик акции должна иметь состояния '''show_first''' (первый показ акции), '''show'''(показать акцию), '''delete''' - удалить акцию; также в эту машину пишется id сценария, в который входит акция, как параметр '''sales_scenario'''.
*'''Длительность акции''' - время в секундах, в течении которого, акция активна.
*'''Количество показов ''' - сколько раз акция будет показана игроку (для акции будет вызвано show и show_first)
Также можно добавить произвольное количество условий окончания акции. Все условия объединяются логическим "И".

==Окно групп пользователей==

[[Файл:SM Groups.png|600 px|right]]
Есть 6 групп пользователей, в зависимости от их действий в игре:
*1. Не платившие, покинувшие игру;
*2. Платившие, но переставшие платить, продолжающие играть;
*3. Платившие, покинувшие игру;
*4. Не платившие, продолжающие играть;
*5. Платящие, играющие;
*6. Сломали игру.
Изменить количество групп в редакторе нельзя. Но это можно сделать через редактирование лейаута (Но я вам об этом не говорил.)
Эти группы определяются рядом параметров, по которым происходит определение игрока в одну из них. Эти параметры на протяжении игры меняются, поэтому одни и те же игроки со временем могут менять группу.

'''Важно!''' Данные параметры нужно подобрать таким образом, что бы группы не имели пересечений, т.е. в один момент времени игрок может попасть только в одну группу. Иначе сценарии будут отрабатывать некорректно.
[[Файл:SM Switch.png|400 px|right]]
Параметры группы:
*'''от последней сессии мин''' ''(t_last_ses_min)'' - Время от последней сессии в полных сутках.
*'''от последней сессии макс''' ''(t_last_ses_max)'' - Время от последней сессии в полных сутках.
*'''от последней покупки мин''' ''(t_last_buy_min)'' - Время от последней покупки в полных сутках.
*'''от последней покупки макc''' ''(t_last_buy_max)'' - Время от последней покупки в полных сутках.
*'''суток в игре мин''' ''(t_days_min)'' - Количество проведенных в игре полных суток.
*'''суток в игре макс''' ''(t_days_max)'' - Количество проведенных в игре полных суток.

Для каждой группы мы можем добавлять произвольное количество сценариев. Сценарий может включать произвольное количество акций. Для добавления акций в сценарий нужно переключить вид окна групп (кнопка "Switch") и выбрать нужные акции для сценария.

Для активации сценария должны быть выполнены все его условия. Каждый сценарий имеет следующие параметры (описаны только актуальные параметры):

*'''id сценария''' - id сценария, берется из текстовой базы ресурсов.
*'''события сценария''' - список акций, которые входят в этот сценарий.
*'''поле в опциях''' - Поле в опциях, откуда будет взят прогресс игрока.
*'''min уровень''' - Минимальный уровень при котором срабатывает событие.
*'''уровни''' - Через запятую значения для предыдущего поля, при которых сработает событие.
*'''события до''' - События, которые должны были сработать до этого.
*'''время от инсталла min''' - Время от инстала в секундах.
*'''время от покупки min''' - Время от последней покупки в секундах.
*'''время от события min''' - Время от последнего события в секундах.
*'''время от инсталла max''' - Время от инстала в секундах.
*'''время от покупки max''' - Время от последней покупки в секундах.
*'''время от события max''' - Время от последнего события в секундах.
*'''использовать дату''' - 0 - не использовать, 1 - проверять месяц и день, 2 - проверять и год тоже.
*'''год''' - Год, когда сработает оповещение.
*'''месяц''' - Месяц, когда сработает оповещение.
*'''день''' - День, когда сработает оповещение.
*'''повторяемое''' - Повторяемое ли событие нет=0, да=1.
Также для сценария можно добавить произвольное количество условий начала сценария.

==Состояния==

*'''check_multiple''' - определяется группа игрока, проверяет есть ли сценарии, которые можно запустить;
*'''ok''' - сценарий завершился успехом(покупкой), перед вызовом состояния Salesmamnager'у нужно установить в param id сценария (пишется в машину-обработчик акции, как sales_scenario);
*'''cancel''' - завершить текущую акцию в сценарии, перед вызовом указать id сценария;
*'''cancel_scenario''' - завершить сценарий, указанный в param Salesmamnager'у (ожидается);

==Принцип работы==
При вызове объекту состояния "check_multiple" сначала определяется группа игрока, после чего проверяются все сценарии этой группы.
Если есть сценарий, для которого выполнились условия, то он активируется. При этом машина-обработчик первой акции в сценарии переходит в "show_first". В этом состоянии обработчика настраиваем первый показ акции.
Если на момент вызова состояния "check_multiple" были активные акции, то информация о них будет обновлена а машина-обработчик акции перейдет в "show". В этом состоянии настраиваем обновление акции (оставшееся время и т.д.).
Если акция закончилась (по времени или количеству показов), то при следующей проверке будет показана следующая акция из данного сценария.
Сценарий может закончиться 3 способами:
# Закончились все акции сценария
# Отменой сценария
# Покупкой акции
При отмене/покупки акции ее обработчик перейдет в состояние "delete", если будет корректно вызвано соответствующее состояние.

==Запись в опции==
объект пишет опции в текущего пользователя, в следующем виде:
<salesmanager%d ev3="1" act_group="4" last_ev="1459770112">
<ev3 tl="915" skip="0" aen="-1" aes="1459770112" ae="0"/>
</salesmanager%d>
В теге ''salesmanager%d'':
*'''ev%d''' - число активаций сценария (отдельно от прочей информации по сценарию из-за обратной совместимости);
*'''act_group''' - номер группы пользователя (начиная с 0) по последней проверке;
*'''last_ev''' - время активации последнего сценария;

В теге ''ev%d'':
*'''tl''' - оставшееся время;
*'''skip''' - 1 - событие отменено, при следующей проверке попытаемся перейти на следующее;
*'''aen''' - оставшееся число его показов;
*'''aes''' - дата старта текущего события;
*'''ae''' - текущее событие для активного сценария, -1 для неактивного;

==Пример==
S:\!MOBILE\!!!EditorGames\Wiki_sample

salesmanager_test.zip

[[Category:Options|*]]

Salesmanager

2016-04-05T05:36:09Z

Vefimov: /* Состояния */

{{TOC right}}

[[Object|Объект]] '''Salesmaneger''' предназначается для управления всплывающими окошками с различными акциями: скидками, выгодными предложениями и т. д. Для того, чтобы наиболее выгодным образом показывать человеку акции, этот объект будет сам определяет категорию пользователя, и в зависимости от нее показывает игроку различные события. За основу взято окно настройки локации из объекта [[Economics|Economics]].

==Окно акций==

[[Файл:SM Actions.png|600 px|right]]
В данном окне добавляются и редактируются акции, которые потом включаются в сценарии. Каждая запись слева представляет одну акцию. Справа расположены настройки акции. Некоторые из них оставлены для совместимости с [[Salesmanager (Предыдущая версия)|предыдущей версией]] менеджера акций.

Используемые параметры:
*'''id события''' - id акции, берется из текстовой базы ресурсов.
*'''объект''' - Машина-обработчик акции должна иметь состояния '''show_first''' (первый показ акции), '''show'''(показать акцию), '''delete''' - удалить акцию; также в эту машину пишется id сценария, в который входит акция, как параметр '''sales_scenario'''.
*'''Длительность акции''' - время в секундах, в течении которого, акция активна.
*'''Количество показов ''' - сколько раз акция будет показана игроку (для акции будет вызвано show и show_first)
Также можно добавить произвольное количество условий окончания акции. Все условия объединяются логическим "И".

==Окно групп пользователей==

[[Файл:SM Groups.png|600 px|right]]
Есть 6 групп пользователей, в зависимости от их действий в игре:
*1. Не платившие, покинувшие игру;
*2. Платившие, но переставшие платить, продолжающие играть;
*3. Платившие, покинувшие игру;
*4. Не платившие, продолжающие играть;
*5. Платящие, играющие;
*6. Сломали игру.
Изменить количество групп в редакторе нельзя. Но это можно сделать через редактирование лейаута (Но я вам об этом не говорил.)
Эти группы определяются рядом параметров, по которым происходит определение игрока в одну из них. Эти параметры на протяжении игры меняются, поэтому одни и те же игроки со временем могут менять группу.

'''Важно!''' Данные параметры нужно подобрать таким образом, что бы группы не имели пересечений, т.е. в один момент времени игрок может попасть только в одну группу. Иначе сценарии будут отрабатывать некорректно.
[[Файл:SM Switch.png|400 px|right]]
Параметры группы:
*'''от последней сессии мин''' ''(t_last_ses_min)'' - Время от последней сессии в полных сутках.
*'''от последней сессии макс''' ''(t_last_ses_max)'' - Время от последней сессии в полных сутках.
*'''от последней покупки мин''' ''(t_last_buy_min)'' - Время от последней покупки в полных сутках.
*'''от последней покупки макc''' ''(t_last_buy_max)'' - Время от последней покупки в полных сутках.
*'''суток в игре мин''' ''(t_days_min)'' - Количество проведенных в игре полных суток.
*'''суток в игре макс''' ''(t_days_max)'' - Количество проведенных в игре полных суток.

Для каждой группы мы можем добавлять произвольное количество сценариев. Сценарий может включать произвольное количество акций. Для добавления акций в сценарий нужно переключить вид окна групп (кнопка "Switch") и выбрать нужные акции для сценария.

Для активации сценария должны быть выполнены все его условия. Каждый сценарий имеет следующие параметры (описаны только актуальные параметры):

*'''id сценария''' - id сценария, берется из текстовой базы ресурсов.
*'''события сценария''' - список акций, которые входят в этот сценарий.
*'''поле в опциях''' - Поле в опциях, откуда будет взят прогресс игрока.
*'''min уровень''' - Минимальный уровень при котором срабатывает событие.
*'''уровни''' - Через запятую значения для предыдущего поля, при которых сработает событие.
*'''события до''' - События, которые должны были сработать до этого.
*'''время от инсталла min''' - Время от инстала в секундах.
*'''время от покупки min''' - Время от последней покупки в секундах.
*'''время от события min''' - Время от последнего события в секундах.
*'''время от инсталла max''' - Время от инстала в секундах.
*'''время от покупки max''' - Время от последней покупки в секундах.
*'''время от события max''' - Время от последнего события в секундах.
*'''использовать дату''' - 0 - не использовать, 1 - проверять месяц и день, 2 - проверять и год тоже.
*'''год''' - Год, когда сработает оповещение.
*'''месяц''' - Месяц, когда сработает оповещение.
*'''день''' - День, когда сработает оповещение.
*'''повторяемое''' - Повторяемое ли событие нет=0, да=1.
Также для сценария можно добавить произвольное количество условий начала сценария.

==Состояния==

*'''check_multiple''' - определяется группа игрока, проверяет есть ли сценарии, которые можно запустить;
*'''ok''' - сценарий завершился успехом(покупкой), перед вызовом состояния Salesmamnager'у нужно установить в param id сценария (пишется в машину-обработчик акции, как sales_scenario);
*'''cancel''' - завершить текущую акцию в сценарии, перед вызовом указать id сценария;
*'''cancel_scenario''' - завершить сценарий, указанный в param Salesmamnager'у (ожидается);

==Принцип работы==
При вызове объекту состояния "check_multiple" сначала определяется группа игрока, после чего проверяются все сценарии этой группы.
Если есть сценарий, для которого выполнились условия, то он активируется. При этом машина-обработчик первой акции в сценарии переходит в "show_first". В этом состоянии обработчика настраиваем первый показ акции.
Если на момент вызова состояния "check_multiple" были активные акции, то информация о них будет обновлена а машина-обработчик акции перейдет в "show". В этом состоянии настраиваем обновление акции (оставшееся время и т.д.).
Если акция закончилась (по времени или количеству показов), то при следующей проверке будет показана следующая акция из данного сценария.
Сценарий может закончиться 3 способами:
# Закончились все акции сценария
# Отменой акции
# Покупкой акции
При отмене/покупки акции Salesmanager'у нужно указать сценарий и вызвать состояние "cancel"/"ok", при этом обработчик перейдет в состояние "delete".

==Запись в опции==
объект пишет опции в текущего пользователя, в следующем виде:
<salesmanager5 ev3="1" act_group="4" last_ev="1459770112">
<ev3 tl="915" skip="0" aen="-1" aes="1459770112" ae="0"/>
</salesmanager5>

[[Category:Options|*]]

Salesmanager

2016-04-05T05:35:42Z

Vefimov: /* Состояния */

{{TOC right}}

[[Object|Объект]] '''Salesmaneger''' предназначается для управления всплывающими окошками с различными акциями: скидками, выгодными предложениями и т. д. Для того, чтобы наиболее выгодным образом показывать человеку акции, этот объект будет сам определяет категорию пользователя, и в зависимости от нее показывает игроку различные события. За основу взято окно настройки локации из объекта [[Economics|Economics]].

==Окно акций==

[[Файл:SM Actions.png|600 px|right]]
В данном окне добавляются и редактируются акции, которые потом включаются в сценарии. Каждая запись слева представляет одну акцию. Справа расположены настройки акции. Некоторые из них оставлены для совместимости с [[Salesmanager (Предыдущая версия)|предыдущей версией]] менеджера акций.

Используемые параметры:
*'''id события''' - id акции, берется из текстовой базы ресурсов.
*'''объект''' - Машина-обработчик акции должна иметь состояния '''show_first''' (первый показ акции), '''show'''(показать акцию), '''delete''' - удалить акцию; также в эту машину пишется id сценария, в который входит акция, как параметр '''sales_scenario'''.
*'''Длительность акции''' - время в секундах, в течении которого, акция активна.
*'''Количество показов ''' - сколько раз акция будет показана игроку (для акции будет вызвано show и show_first)
Также можно добавить произвольное количество условий окончания акции. Все условия объединяются логическим "И".

==Окно групп пользователей==

[[Файл:SM Groups.png|600 px|right]]
Есть 6 групп пользователей, в зависимости от их действий в игре:
*1. Не платившие, покинувшие игру;
*2. Платившие, но переставшие платить, продолжающие играть;
*3. Платившие, покинувшие игру;
*4. Не платившие, продолжающие играть;
*5. Платящие, играющие;
*6. Сломали игру.
Изменить количество групп в редакторе нельзя. Но это можно сделать через редактирование лейаута (Но я вам об этом не говорил.)
Эти группы определяются рядом параметров, по которым происходит определение игрока в одну из них. Эти параметры на протяжении игры меняются, поэтому одни и те же игроки со временем могут менять группу.

'''Важно!''' Данные параметры нужно подобрать таким образом, что бы группы не имели пересечений, т.е. в один момент времени игрок может попасть только в одну группу. Иначе сценарии будут отрабатывать некорректно.
[[Файл:SM Switch.png|400 px|right]]
Параметры группы:
*'''от последней сессии мин''' ''(t_last_ses_min)'' - Время от последней сессии в полных сутках.
*'''от последней сессии макс''' ''(t_last_ses_max)'' - Время от последней сессии в полных сутках.
*'''от последней покупки мин''' ''(t_last_buy_min)'' - Время от последней покупки в полных сутках.
*'''от последней покупки макc''' ''(t_last_buy_max)'' - Время от последней покупки в полных сутках.
*'''суток в игре мин''' ''(t_days_min)'' - Количество проведенных в игре полных суток.
*'''суток в игре макс''' ''(t_days_max)'' - Количество проведенных в игре полных суток.

Для каждой группы мы можем добавлять произвольное количество сценариев. Сценарий может включать произвольное количество акций. Для добавления акций в сценарий нужно переключить вид окна групп (кнопка "Switch") и выбрать нужные акции для сценария.

Для активации сценария должны быть выполнены все его условия. Каждый сценарий имеет следующие параметры (описаны только актуальные параметры):

*'''id сценария''' - id сценария, берется из текстовой базы ресурсов.
*'''события сценария''' - список акций, которые входят в этот сценарий.
*'''поле в опциях''' - Поле в опциях, откуда будет взят прогресс игрока.
*'''min уровень''' - Минимальный уровень при котором срабатывает событие.
*'''уровни''' - Через запятую значения для предыдущего поля, при которых сработает событие.
*'''события до''' - События, которые должны были сработать до этого.
*'''время от инсталла min''' - Время от инстала в секундах.
*'''время от покупки min''' - Время от последней покупки в секундах.
*'''время от события min''' - Время от последнего события в секундах.
*'''время от инсталла max''' - Время от инстала в секундах.
*'''время от покупки max''' - Время от последней покупки в секундах.
*'''время от события max''' - Время от последнего события в секундах.
*'''использовать дату''' - 0 - не использовать, 1 - проверять месяц и день, 2 - проверять и год тоже.
*'''год''' - Год, когда сработает оповещение.
*'''месяц''' - Месяц, когда сработает оповещение.
*'''день''' - День, когда сработает оповещение.
*'''повторяемое''' - Повторяемое ли событие нет=0, да=1.
Также для сценария можно добавить произвольное количество условий начала сценария.

==Состояния==

*'''check_multiple''' - определяется группа игрока, проверяет есть ли сценарии, которые можно запустить;
*'''ok''' - сценарий завершился успехом(покупкой), перед вызовом состояния Salesmamnager'у нужно установить в param id сценария (пишется в машину-обработчик акции, как sales_scenario);
*'''cancel''' - завершить текущую акцию в сценарии, перед вызовом указать id сценария;
*'''cancel_scenario''' - завершить сценарий, указанный в param Salesmamnager'у;

==Принцип работы==
При вызове объекту состояния "check_multiple" сначала определяется группа игрока, после чего проверяются все сценарии этой группы.
Если есть сценарий, для которого выполнились условия, то он активируется. При этом машина-обработчик первой акции в сценарии переходит в "show_first". В этом состоянии обработчика настраиваем первый показ акции.
Если на момент вызова состояния "check_multiple" были активные акции, то информация о них будет обновлена а машина-обработчик акции перейдет в "show". В этом состоянии настраиваем обновление акции (оставшееся время и т.д.).
Если акция закончилась (по времени или количеству показов), то при следующей проверке будет показана следующая акция из данного сценария.
Сценарий может закончиться 3 способами:
# Закончились все акции сценария
# Отменой акции
# Покупкой акции
При отмене/покупки акции Salesmanager'у нужно указать сценарий и вызвать состояние "cancel"/"ok", при этом обработчик перейдет в состояние "delete".

==Запись в опции==
объект пишет опции в текущего пользователя, в следующем виде:
<salesmanager5 ev3="1" act_group="4" last_ev="1459770112">
<ev3 tl="915" skip="0" aen="-1" aes="1459770112" ae="0"/>
</salesmanager5>

[[Category:Options|*]]

Salesmanager

2016-04-05T05:23:03Z

Vefimov: /* Окно групп пользователей */

{{TOC right}}

[[Object|Объект]] '''Salesmaneger''' предназначается для управления всплывающими окошками с различными акциями: скидками, выгодными предложениями и т. д. Для того, чтобы наиболее выгодным образом показывать человеку акции, этот объект будет сам определяет категорию пользователя, и в зависимости от нее показывает игроку различные события. За основу взято окно настройки локации из объекта [[Economics|Economics]].

==Окно акций==

[[Файл:SM Actions.png|600 px|right]]
В данном окне добавляются и редактируются акции, которые потом включаются в сценарии. Каждая запись слева представляет одну акцию. Справа расположены настройки акции. Некоторые из них оставлены для совместимости с [[Salesmanager (Предыдущая версия)|предыдущей версией]] менеджера акций.

Используемые параметры:
*'''id события''' - id акции, берется из текстовой базы ресурсов.
*'''объект''' - Машина-обработчик акции должна иметь состояния '''show_first''' (первый показ акции), '''show'''(показать акцию), '''delete''' - удалить акцию; также в эту машину пишется id сценария, в который входит акция, как параметр '''sales_scenario'''.
*'''Длительность акции''' - время в секундах, в течении которого, акция активна.
*'''Количество показов ''' - сколько раз акция будет показана игроку (для акции будет вызвано show и show_first)
Также можно добавить произвольное количество условий окончания акции. Все условия объединяются логическим "И".

==Окно групп пользователей==

[[Файл:SM Groups.png|600 px|right]]
Есть 6 групп пользователей, в зависимости от их действий в игре:
*1. Не платившие, покинувшие игру;
*2. Платившие, но переставшие платить, продолжающие играть;
*3. Платившие, покинувшие игру;
*4. Не платившие, продолжающие играть;
*5. Платящие, играющие;
*6. Сломали игру.
Изменить количество групп в редакторе нельзя. Но это можно сделать через редактирование лейаута (Но я вам об этом не говорил.)
Эти группы определяются рядом параметров, по которым происходит определение игрока в одну из них. Эти параметры на протяжении игры меняются, поэтому одни и те же игроки со временем могут менять группу.

'''Важно!''' Данные параметры нужно подобрать таким образом, что бы группы не имели пересечений, т.е. в один момент времени игрок может попасть только в одну группу. Иначе сценарии будут отрабатывать некорректно.
[[Файл:SM Switch.png|400 px|right]]
Параметры группы:
*'''от последней сессии мин''' ''(t_last_ses_min)'' - Время от последней сессии в полных сутках.
*'''от последней сессии макс''' ''(t_last_ses_max)'' - Время от последней сессии в полных сутках.
*'''от последней покупки мин''' ''(t_last_buy_min)'' - Время от последней покупки в полных сутках.
*'''от последней покупки макc''' ''(t_last_buy_max)'' - Время от последней покупки в полных сутках.
*'''суток в игре мин''' ''(t_days_min)'' - Количество проведенных в игре полных суток.
*'''суток в игре макс''' ''(t_days_max)'' - Количество проведенных в игре полных суток.

Для каждой группы мы можем добавлять произвольное количество сценариев. Сценарий может включать произвольное количество акций. Для добавления акций в сценарий нужно переключить вид окна групп (кнопка "Switch") и выбрать нужные акции для сценария.

Для активации сценария должны быть выполнены все его условия. Каждый сценарий имеет следующие параметры (описаны только актуальные параметры):

*'''id сценария''' - id сценария, берется из текстовой базы ресурсов.
*'''события сценария''' - список акций, которые входят в этот сценарий.
*'''поле в опциях''' - Поле в опциях, откуда будет взят прогресс игрока.
*'''min уровень''' - Минимальный уровень при котором срабатывает событие.
*'''уровни''' - Через запятую значения для предыдущего поля, при которых сработает событие.
*'''события до''' - События, которые должны были сработать до этого.
*'''время от инсталла min''' - Время от инстала в секундах.
*'''время от покупки min''' - Время от последней покупки в секундах.
*'''время от события min''' - Время от последнего события в секундах.
*'''время от инсталла max''' - Время от инстала в секундах.
*'''время от покупки max''' - Время от последней покупки в секундах.
*'''время от события max''' - Время от последнего события в секундах.
*'''использовать дату''' - 0 - не использовать, 1 - проверять месяц и день, 2 - проверять и год тоже.
*'''год''' - Год, когда сработает оповещение.
*'''месяц''' - Месяц, когда сработает оповещение.
*'''день''' - День, когда сработает оповещение.
*'''повторяемое''' - Повторяемое ли событие нет=0, да=1.
Также для сценария можно добавить произвольное количество условий начала сценария.

==Состояния==

==Принцип работы==
При вызове объекту состояния "check_multiple" сначала определяется группа игрока, после чего проверяются все сценарии этой группы.
Если есть сценарий, для которого выполнились условия, то он активируется. При этом машина-обработчик первой акции в сценарии переходит в "show_first". В этом состоянии обработчика настраиваем первый показ акции.
Если на момент вызова состояния "check_multiple" были активные акции, то информация о них будет обновлена а машина-обработчик акции перейдет в "show". В этом состоянии настраиваем обновление акции (оставшееся время и т.д.).
Если акция закончилась (по времени или количеству показов), то при следующей проверке будет показана следующая акция из данного сценария.
Сценарий может закончиться 3 способами:
# Закончились все акции сценария
# Отменой акции
# Покупкой акции
При отмене/покупки акции Salesmanager'у нужно указать сценарий и вызвать состояние "cancel"/"ok", при этом обработчик перейдет в состояние "delete".

==Запись в опции==
объект пишет опции в текущего пользователя, в следующем виде:
<salesmanager5 ev3="1" act_group="4" last_ev="1459770112">
<ev3 tl="915" skip="0" aen="-1" aes="1459770112" ae="0"/>
</salesmanager5>

[[Category:Options|*]]

Salesmanager

2016-04-04T14:00:21Z

Vefimov:

{{TOC right}}

[[Object|Объект]] '''Salesmaneger''' предназначается для управления всплывающими окошками с различными акциями: скидками, выгодными предложениями и т. д. Для того, чтобы наиболее выгодным образом показывать человеку акции, этот объект будет сам определяет категорию пользователя, и в зависимости от нее показывает игроку различные события. За основу взято окно настройки локации из объекта [[Economics|Economics]].

==Окно акций==

[[Файл:SM Actions.png|600 px|right]]
В данном окне добавляются и редактируются акции, которые потом включаются в сценарии. Каждая запись слева представляет одну акцию. Справа расположены настройки акции. Некоторые из них оставлены для совместимости с [[Salesmanager (Предыдущая версия)|предыдущей версией]] менеджера акций.

Используемые параметры:
*'''id события''' - id акции, берется из текстовой базы ресурсов.
*'''объект''' - Машина-обработчик акции должна иметь состояния '''show_first''' (первый показ акции), '''show'''(показать акцию), '''delete''' - удалить акцию; также в эту машину пишется id сценария, в который входит акция, как параметр '''sales_scenario'''.
*'''Длительность акции''' - время в секундах, в течении которого, акция активна.
*'''Количество показов ''' - сколько раз акция будет показана игроку (для акции будет вызвано show и show_first)
Также можно добавить произвольное количество условий окончания акции. Все условия объединяются логическим "И".

==Окно групп пользователей==

[[Файл:SM Groups.png|600 px|right]]
Есть 6 групп пользователей, в зависимости от их действий в игре:
*1. Не платившие, покинувшие игру;
*2. Платившие, но переставшие платить, продолжающие играть;
*3. Платившие, покинувшие игру;
*4. Не платившие, продолжающие играть;
*5. Платящие, играющие;
*6. Сломали игру.
Изменить количество групп в редакторе нельзя. Но это можно сделать через редактирование лейаута (Но я вам об этом не говорил.)
Эти группы определяются рядом параметров, по которым происходит определение игрока в одну из них. Эти параметры на протяжении игры меняются, поэтому одни и те же игроки со временем могут менять группу.
'''Важно!''' Данные параметры нужно подобрать таким образом, что бы группы не имели пересечений, т.е. в один момент времени игрок может попасть только в одну группу. Иначе сценарии будут отрабатывать некорректно.
[[Файл:SM Switch.png|400 px|right]]
Параметры группы:
*'''от последней сессии мин''' ''(t_last_ses_min)'' - Время от последней сессии в полных сутках.
*'''от последней сессии макс''' ''(t_last_ses_max)'' - Время от последней сессии в полных сутках.
*'''от последней покупки мин''' ''(t_last_buy_min)'' - Время от последней покупки в полных сутках.
*'''от последней покупки макc''' ''(t_last_buy_max)'' - Время от последней покупки в полных сутках.
*'''суток в игре мин''' ''(t_days_min)'' - Количество проведенных в игре полных суток.
*'''суток в игре макс''' ''(t_days_max)'' - Количество проведенных в игре полных суток.

Для каждой группы мы можем добавлять произвольное количество сценариев. Сценарий может включать произвольное количество акций. Для добавления акций в сценарий нужно переключить вид окна групп (кнопка "Switch") и выбрать нужные акции для сценария.

Для активации сценария должны быть выполнены все его условия. Каждый сценарий имеет следующие параметры (описаны только актуальные параметры):

*'''id сценария''' - id сценария, берется из текстовой базы ресурсов.
*'''события сценария''' - список акций, которые входят в этот сценарий.
*'''поле в опциях''' - Поле в опциях, откуда будет взят прогресс игрока.
*'''min уровень''' - Минимальный уровень при котором срабатывает событие.
*'''уровни''' - Через запятую значения для предыдущего поля, при которых сработает событие.
*'''события до''' - События, которые должны были сработать до этого.
*'''время от инсталла min''' - Время от инстала в секундах.
*'''время от покупки min''' - Время от последней покупки в секундах.
*'''время от события min''' - Время от последнего события в секундах.
*'''время от инсталла max''' - Время от инстала в секундах.
*'''время от покупки max''' - Время от последней покупки в секундах.
*'''время от события max''' - Время от последнего события в секундах.
*'''использовать дату''' - 0 - не использовать, 1 - проверять месяц и день, 2 - проверять и год тоже.
*'''год''' - Год, когда сработает оповещение.
*'''месяц''' - Месяц, когда сработает оповещение.
*'''день''' - День, когда сработает оповещение.
*'''повторяемое''' - Повторяемое ли событие нет=0, да=1.
Также для сценария можно добавить произвольное количество условий начала сценария.

==Состояния==

==Принцип работы==
При вызове объекту состояния "check_multiple" сначала определяется группа игрока, после чего проверяются все сценарии этой группы.
Если есть сценарий, для которого выполнились условия, то он активируется. При этом машина-обработчик первой акции в сценарии переходит в "show_first". В этом состоянии обработчика настраиваем первый показ акции.
Если на момент вызова состояния "check_multiple" были активные акции, то информация о них будет обновлена а машина-обработчик акции перейдет в "show". В этом состоянии настраиваем обновление акции (оставшееся время и т.д.).
Если акция закончилась (по времени или количеству показов), то при следующей проверке будет показана следующая акция из данного сценария.
Сценарий может закончиться 3 способами:
# Закончились все акции сценария
# Отменой акции
# Покупкой акции
При отмене/покупки акции Salesmanager'у нужно указать сценарий и вызвать состояние "cancel"/"ok", при этом обработчик перейдет в состояние "delete".

==Запись в опции==
объект пишет опции в текущего пользователя, в следующем виде:
<salesmanager5 ev3="1" act_group="4" last_ev="1459770112">
<ev3 tl="915" skip="0" aen="-1" aes="1459770112" ae="0"/>
</salesmanager5>

[[Category:Options|*]]

Файл:SM Groups.png

2016-04-04T12:29:34Z

Vefimov: Vefimov загрузил новую версию Файл:SM Groups.png

Файл:SM Switch.png

2016-04-04T12:29:23Z

Vefimov: Vefimov загрузил новую версию Файл:SM Switch.png

Файл:SM Add condition action.png

2016-04-04T12:22:59Z

Vefimov:

Файл:SM Actions.png

2016-04-04T12:21:10Z

Vefimov: Vefimov загрузил новую версию Файл:SM Actions.png

Salesmanager (Предыдущая версия)

2016-04-04T12:02:05Z

Vefimov: Новая страница: «{{TOC right}} ==Общие сведения== Данная статья описывает предыдущую версию объекта Salesmamnager. Дан…»

{{TOC right}}
==Общие сведения==
Данная статья описывает предыдущую версию объекта Salesmamnager. Данный объект преимущественно использовался для организации специальных тасков (набрать некоторое количество звезд за день, день привязан к конкретной дате).

[[Object|Объект]] '''Salesmaneger''' предназначается для управления всплывающими окошками с различными акциями: скидками, выгодными предложениями и т. д. Для того, чтобы наиболее выгодным образом показывать человеку акции, этот объект будет сам определяет категорию пользователя, и в зависимости от нее показывает игроку различные события. За основу взято окно настройки локации из объекта [[Economics|Economics]].

==Окно настройки==

[[Файл:Salesmeneger.png|600 px|right|Окно настройки]]

С помощью кнопок "Добавить локацию" и "Удалить локацию" можем менять количество групп пользователей в колонке1. "Добавить уровень мастерства" и "Удалить уровень мастерства" добавляют и удаляют акции в колонке 3.

Для примера выделим 5 групп пользователей:
*1. Не платившие, продолжающие играть;
*2. Платившие, но переставшие платить, продолжающие играть;
*3. Платившие, покинувшие игру;
*4. Не платившие, покинувшие игру;
*5. Платящие, играющие.

Все эти группы отличаются рядом параметров (колонка 2) по которым происходит определение игрока в одну из них. Эти параметры на протяжении игры меняются, поэтому одни и те же игроки со временем могут менять группу.

*'''от последней сессии мин''' ''(t_last_ses_min)'' - Время от последней сессии в полных сутках.
*'''от последней сессии макс''' ''(t_last_ses_max)'' - Время от последней сессии в полных сутках.
*'''от последней покупки мин''' ''(t_last_buy_min)'' - Время от последней покупки в полных сутках.
*'''от последней покупки макc''' ''(t_last_buy_max)'' - Время от последней покупки в полных сутках.
*'''суток в игре мин''' ''(t_days_min)'' - Количество проведенных в игре полных суток.
*'''суток в игре макс''' ''(t_days_max)'' - Количество проведенных в игре полных суток.

В зависимости от группы мы ожидаем различное поведение акций и предложений. Поэтому в 4 колонке определяется логика появления событий.

*'''id события''' ''(ev_id)'' - id события, берется из текстовой базы ресурсов.
*'''поле в опциях''' ''(ev_opt)'' - Поле в опциях, откуда будет взят прогресс игрока.
*'''min уровень''' ''(ev_lev)'' - Минимальный уровень при котором срабатывает событие.
*'''уровни''' ''(ev_levs)'' - Через запятую значения для предыдущего поля, при которых сработает событие.
*'''события до''' ''(ev_before)'' - События, которые должны были сработать до этого.
*'''время от инсталла min''' ''(ev_inst_min)'' - Время от инстала в секундах.
*'''время от покупки min''' ''(ev_purch_min)'' - Время от последней покупки в секундах.
*'''время от события min''' ''(ev_ev_min)'' - Время от последнего события в секундах.
*'''время от инсталла max''' ''(ev_inst_max)'' - Время от инстала в секундах.
*'''время от покупки max''' ''(ev_purch_max)'' - Время от последней покупки в секундах.
*'''время от события max''' ''(ev_ev_max)'' - Время от последнего события в секундах.
*'''использовать дату''' ''(ev_date)'' - 0 - не использовать, 1 - проверять месяц и день, 2 - проверять и год тоже.
*'''год''' ''(ev_year)'' - Год, когда сработает оповещение.
*'''месяц''' ''(ev_month)'' - Месяц, когда сработает оповещение.
*'''день''' ''(ev_day)'' - День, когда сработает оповещение.
*'''объект''' ''(ev_obj)'' - При активации события перевести объект в состояние из следующего поля.
*'''состояние''' ''(ev_st)'' - Новое состояние для объекта из предыдущего поля.
*'''повторяемое''' ''(ev_repeat)'' - Повторяемое ли событие нет=0, да=1.

==Особенности использования==

Добавляемых параметров данный объект не имеет. Для запуска проверки условия появления акции объекту нужно передать состояние '''check'''.
Других состояний объект не имеет.

[[Category:Options|*]]

Файл:SM Switch.png

2016-04-04T11:47:05Z

Vefimov:

Файл:SM Groups.png

2016-04-04T11:46:46Z

Vefimov:

Файл:SM Actions.png

2016-04-04T11:46:30Z

Vefimov:

Absolutist Framework

2016-02-19T13:29:59Z

Vefimov: /* Подготовка проекта */

{{TOC right}}
'''[[:category:main|Категории]]'''
== Новости ==
Вышла новая игра HOG созданная с помощью AppSalute Game Сreator. Созданы новые уникальные эффекты и механики для обеспечения незабываемых впечатлений.
Описание и видео:
http://time-gap.com/

== AppSalute Game Сreator ==
* [[Примеры приложений]]
* [[Введение в AppSalute Game Сreator]]
* [[Установка и настройка]]
* [[Интерфейс ScenceEditor ]]
* [[Интерфейс ResourceEditor ]]
* [[Интерфейс TextEditor ]]
*[[Интерфейс Viewer ]]
* [[Книга жалоб и пожеланий]]
* [[Roadmap]]

== Обучение ==

* [[Learning|Уроки по освоению фреймворка]]
* [[Примеры реализации в играх]]
* [[Основные понятия объектов физического мира]]
* [[Использование AppSalute Debugger при отладке]]
* [[FAQ]]

== Подготовка проекта ==
* [[Проектирование экранов игры]]
* [[Подготовка и форматы графики]]
* [[Подготовка и форматы шрифтов]]
* [[Подготовка и форматы звуков]]
* [[Подготовка и форматы видео]]
* [[Создание проекта]]
* [[Загрузка проекта по частям]]
* [[Конфигурация проекта для сборки]]
* [[Подготовка для загрузки на маркеты]]
* [[Сборка проекта]]
* [[Частые ошибки]]
* [[Отличия подготовки проекта для разных платформ]]
* [[Lua|Использование lua-скриптов]]

== Встроенные объекты редактора==

=== Common objects ===

''[[Файл:Screen.png]] - [[Screen]]'' - экран

''[[Файл:Scene.png]] - [[Scene]]'' - сцена

=== Main objects ===

''[[Файл:Objects.png]] - [[Object]]'' - общие параметры для всех игровых объектов

* [[Файл:Kub.png]] - [[Azmanager]] - менеджер активных зон
* [[Файл:Kub.png]] - [[Active zone]] - активная зона
* [[Файл:Picture.png]] - [[Image]] - картинка
* [[Файл:Button.png]] - [[Button]] - кнопка
* [[Файл:Text.png]] - [[Text]] - текст
* [[Файл:Machine.png]] - [[Machine]] - машина состояний
* [[Файл:Tableicon.png]] - [[Table]] - таблица
* [[Файл:Checkbox.png]] - [[Checkbox]] - чекбокс (кнопка в 2-х состояниях)
* [[Файл:Checkgroup.png]] - [[Groupbox]] - группа, содержащая несколько чекбоксов
* [[Файл:Timer.png]] - [[Timer]] - цифровой таймер
** [[Файл:Kub.png]] - [[Globaltimer]] - таймер "реального времени"
* [[Файл:Counter2.png]] - [[Counter]] - счетчик сделанных кликов в игре и т.п.
* [[Файл:Progressbar.png]] - [[Progress]] - прогресс прохождения игры (эчивмент)
* [[Файл:Particle.png]] - [[Flyer]] - флаер (патиклы)
* [[Файл:Rectangle.png]] - [[Rectangle]] - прямоугольник
* [[Файл:Kub.png]] - [[Isomover]] - объект движения в изометрической карте
* [[Файл:Group.png]] - [[Group]] - группа
* [[Файл:Groupset.png‎]] - [[Groupset]] - группа
* [[Файл:Effect.jpg|20px]] - [[Effect]] - Создание различных эффектов
* [[Файл:Graphprogress.png]] - [[Graphprogress]] - создание мини-карты для отображения прогресса прохождения игры.
* [[Файл:Kub.png]] - [[Statesmanager]] - очередь работы с объектами
* [[Файл:Slider icons.png]] - [[Slider]] - объект реализующий листание списка.
* [[Файл:Ribbon.png]] - [[Ribbon]] - объект отображения графики по сплайну
* [[Файл:Kub.png]] - [[Animation]] - объект различных анимаций
* [[Файл:Kub.png]] - [[Magicparticles]] - объект файлов Magic Particles

=== Game mechanic ===

* [[Файл:Puzzle.png]] - [[Puzzle]] - игра пазл
* [[Файл:Memory.png]] - [[Memory]] - класс игр с memory-механикой
* [[Файл:Patchwork.png]] - [[Patchwork]] - класс игр с Patchwork-механикой
* [[Файл:Match3.png]] - [[Match]] - класс match-подобных игр
* [[Файл:Collaps.png]] - [[Collapse]] - класс match-подобных игр
* [[Файл:Bejewelled.png]] - [[Bejewelled]] - класс match-подобных игр
* [[Файл:BubbleShooter.png]] - [[Bubble Shooter]] - класс Bubble игр включая механику Снукер
* [[Файл:Tapthebubble.png]] - [[TapTheBubble]] - механика игры Tap The Bubble
* [[Файл:GemSlider.jpg]] - [[Gem Slider]] - механика игры Gem Slider
* [[Файл:W-57.png]] - [[Words]] - механика игры Words
* [[Файл:Kub.png]] - [[2048]] - механика игры 2048
* [[Файл:Kub.png]] - [[Unblock]] - механика игры unblock
* [[Файл:Matchbattle.png]] - [[Match Battle]] - настройка глобальных параметров для мини-игр
* [[Файл:Move box.png]] - [[DragBox]] - класс игр с dragbox-механикой
* [[Файл:Labyrinth.png]] - [[Labyrinth]] - класс игр лабиринт
* [[Файл:Pipes.png]] - [[Pipes]] - класс игр трубы
* [[Файл:Search object.png]] - [[HiddenObject]] - поисковый объект в хидден играх
* [[Файл:Object list.png]] - [[HiddenList]] - список поисковых объектов в хидден играх
* [[Файл:Hint.png]] - [[HiddenHint]] - подсказка (указатель на спрятанный объект)
* [[Файл:Kub.png]] - [[HiddenHighLighter]] - позволяет показать не найденные объекты в хиддене.
* [[Файл:Collection.png]] - [[Collection]] - "коллекция" поисковых объектов для хидден игр
* [[Файл:Inventory.png]] - [[Inventory]] - "инвентарь" список применяемых объектов для игр
* [[Файл:Tool.png]] - [[Tool]] - "применение" - объект, который можно применить для игр
* [[Файл:Kub.png]] - [[Isomap]] - изометрическая карта
* [[Файл:Slotmachine.png]] - [[Slotmachine]] - объект типа "slot"
* [[Файл:Economics.png]] - [[Economics]] - глобальная настройка игр типа ферма\билдер
** [[Файл:E_items.png]] - [[Eitems]] - объект, служащий для связи инвентаря/магазина и экономики
** [[Файл:E_store_item.png]] - [[Estoreitem]] - шаблон для ячейки магазина
** [[Файл:E_inventory_item.png]] - [[Einventoryitem]] - шаблон для ячейки инвентаря
** [[Файл:Kub.png]] - [[Ecraftitem]] - шаблон для ячейки создания предмета.
** [[Файл:Taskorganizer.png]] - [[Taskorganizer]] - органайзер заданий
** [[Файл:E_task_item.png]] - [[Etaskitem]] - шаблон для ячейки задания
** [[Файл:E_collection.png]] - [[Ecollection]] - шаблон для строки в таблице коллекции
* [[Файл:Paint.png‎]] - [[Paint]] - объект для рисования
* [[Файл:Physicsworld.png]] - [[Physicsworld]] - физический мир Box2D
** [[Файл:Physicsobject.png]] - [[Physicsobject]] - физические объекты
** [[Файл:Physics links.png]] - [[Physicsjoint]] - физические соединения
* [[Файл:Eraser.png]] - [[Eraser]] - стирачка
* [[Файл:Kub.png]] - [[trivia]] - игровая механика - миллионер (trivia)
* [[Файл:Kub.png]] - [[Dailybonus]] - объект для управления механизмом ежедневного бонуса за вход в игру.
* [[Файл:Kub.png]] - [[Pet]] - объект питомца.
* [[Файл:Kub.png]] - [[PetCollectionTemplate]] - объект шаблона ячейки с коллекцией.
* [[Файл:Kub.png]] - [[PetTemplate]] - объект шаблона ячейки с животным.

=== Global score ===
* [[Файл:Gamecenter.png]] - [[Gamecenter]] - объект для отправки данных на GameCenter iTunse
**[[Файл:Kub.png]] - [[Achievementitem]] - шаблон локального достижения (оффлайн ачивка)
* [[Файл:Gamecircle.jpg]] - [[Amazon GameCircle]] - объект для отправки данных Amazon GameCircle
* [[Файл:Google-play-games-android.jpg‎]] - [[Google Play services]] - объект для отправки данных на Google Play services
* [[Файл:Localtoplist.png]] - [[Localtoplist]] - настройки для отображения результатов прохождения игры
* [[Файл:Globaltoplist.png]] - [[Globaltoplist]] - настройки для отображения результатов прохождения игры
* [[Файл:Globaltopsender.png]] - [[Globaltopsender]] - настройки для отображения результатов прохождения игры

=== Options ===
* [[Файл:Options.png]] - [[Options]] - общие настройки игры
* [[Файл:Gamedata.png]] - [[Gamedata]] -
* [[Файл:Controls.png]] - [[Controls]] - обьект для работы с клавишами клавиатуры или девайса
* [[Файл:Editicon.png]] - [[Edit]] - ввод текста
* [[Файл:Store.png]] - [[Store]] - настройки InApp покупок в игре
** [[Файл:Kub.png]] - [[Wallet]] - объект для начисления игровой валюты при InApp покупках через объект economics
* [[Файл:Notification.png]] - [[Notification]] - push-уведомления
* [[Файл:Imagepicker.png]] - [[Imagepiker]] - объект для загрузки фото из галереи
* [[Файл:Video.png]] - [[Video]] - объект для просмотра видео
* [[Файл:Webview.png]] - [[Webview]] - объект для просмотра интернет страниц в приложении
* [[Файл:Flurryobject.png]] - [[Flurry]] - настройки системы статистики для приложений https://dev.flurry.com
* [[Файл:Moregames.png]] - [[MoreGamesList]] - запрос банеров рекламируемых игр
* [[Файл:Advertisement.png]] - [[Advertisement]] - банерная система flurry, amazon
* [[Файл:Splitmanager.png]] - [[Splitmanager or A\B Testing]] - менеджер сплитов
* [[Файл:Tapjoy.png]] - [[Tapjoy]] - система рекламы игр
* [[Файл:Playhaven.png|24px]] - [[Playhaven]] - система рекламы игр с внутренними up-sale
* [[Файл:Mobileapptracker.png|24px]] - [[Mobileapptracking]] -
* [[Файл:Chartboost-logo-new.jpeg]] - [[Chartboost]] - Chartboost-logo-new.jpeg
* [[Файл:Kub.png]] - [[SuperSonic]] - провайдер рекламы SuperSonic
* [[Файл:Kub.png]] - [[System]] - объект для доступа к системным настройкам
* [[Файл:Kub.png]] - [[Salesmanager]] - менеджер акций
* [[Файл:Kub.png]] - [[Cloud]] - объект для синхронизации в облаке
* [[Файл:Kub.png]] - [[Game]] - объект для отправки событий

=== Social ===
* [[Файл:Facebook.png]] - [[Facebook]] - настройки расшаривания Facebook
** [[Файл:Esocialfrienditem.png]] - [[Esocialitem]] - Шаблон для ячейки списка друзей
** [[Файл:Kub.png]] - [[Esocialgiftitem]] - Шаблон для ячейки с предметом, который можно подарить другу
** [[Файл:Esocial.png]] - [[Esocial]] - объект для взаимодействия с Facebook'ом
* [[Файл:Twitter.png]] - [[Twitter]] - настройки расшаривания Twitter
* [[Файл:Odnoklassniki.png]] - [[Odnoklassniki]] - настройки для социальной сети Одноклассники
* [[Файл:Googleplus.png]] - [[GooglePlus]] - настройки для социальной сети GooglePlus

=== Functions ===
* [[Файл:Forward.png]] - [[SendMail]] - отправка письма через почтовый клиент
* [[Файл:footer-icon-rate.png]] - [[Rate]] - вызов окна оценки приложения
----
<gallery widths="50px" heights="50px" >
Изображение:Who.png
Изображение:AnimalHideSeek.png
Изображение:travel.png
Изображение:Game_Adventure_Train.png
Изображение:Gmae_Match_MoveTheDolly.png
Изображение:Game_Patchwork_BigEyes.png
Изображение:Game_Patchwork_Chameleon.png
Изображение:Game_Patchwork_Logicly.png‎
Изображение:Game_Patchwork_Stickers.png‎
Изображение:Elephant.png
Изображение:Elephant2.png
Изображение:Cinderella.png
Изображение:Pigs.png
Изображение:Bremenskye.png
Изображение:Book_SnowWhite.png
Изображение:Book_PussInBoots.png
Изображение:Call.png
Изображение:GreatestArtists.png
Изображение:Game_Puzzle_Kids.png
Изображение:Game_Puzzle_Architect.png‎
Изображение:Game_Puzzle_Science.png
Изображение:Ico_1_114_Full.png
Изображение:Game_Adventure_Dreams.png
Изображение:Abc.png
Изображение:Ico_114_Full.png
Изображение:Ico_114_Paints.png
Изображение:Ico_114_Puzzle.png
</gallery>

[[category:main]]

Unblock

2016-02-08T12:22:36Z

Vefimov:

{{TOC right}}
'''Unblock''' - [[Object|объект]] редактора, который реализует игровую механику "unblock" - передвигая игровые блоки, нужно вывести главный блок к выходу.
----

=='''Основные свойства'''==

[[Файл:Unb1.png|thumb|right]]

* '''''файл уровня''''' - файл с описанием уровней.
* '''''номер уровня''''' - номер текущего уровня.
* '''''скорость доводки''''' - скорость доводки блоков пикс/сек.
* '''счетчики'''
** '''''ходы''''' - счетчик оставшихся ходов.
** '''''время''''' - счетчик оставшегося времени.
* '''звуки'''
** '''''начало движения''''' - звук, который воспроизводится в начале движения блока.
** '''''конец движения''''' - звук, который воспроизводится в конце движения блока.

=='''Дополнительные параметры'''==
[[Файл:Unb2.jpg|330px|left]]
* '''графика блока''' - ресурс, используемый для отрисовки игрового блока. Номер в списке соответствует номеру блока в файле уровней(в 1 свойстве указывается главный блок который нужно довести к выходу, 2 свойство - 2 блок и т.д.)
** '''''клип''''' - клип блока, пивот должен быть в центре левой/верхней клетки, перетаскивается из редактора ресурсов.
** '''''размер''''' - размер блока в игровых клетках.

* '''изменить состояние объекта - победа''' - обработчик победы
** '''''объект''''' - объект, состояние которого меняем.
** '''''состояние''''' - новое состояние для объекта из предыдущего поля.

* '''изменить состояние объекта - поражение''' - обработчик поражения
** '''''объект''''' - объект, состояние которого меняем.
** '''''состояние''''' - новое состояние для объекта из предыдущего поля.

* '''изменить состояние объекта - ход''' - обработчик нужен для активации кнопки "откатить"
** '''''объект''''' - объект, состояние которого меняем.
** '''''состояние''''' - новое состояние для объекта из предыдущего поля.

=='''Состояния'''==
* '''add_time''' - добавить время, перед передачей состояния, установить объекту в param значение, сколько времени добавляем; можно указывать отрицательное значение - уменьшим оставшееся время.
* '''add_turns''' - добавить ходов, перед передачей состояния, установить объекту в param значение, сколько ходов добавляем; можно указывать отрицательное значение - уменьшим оставшееся количество ходов.
* '''hint''' - показать следующий шаг из решения; в файле уровней должно быть указано решение.
* '''reset''' - сбросить уровень - начать игру заново.
* '''undo''' - отменить последний ход; возможность сделать откат должна появляться после сделанного хода (см. изменить состояние объекта - ход)

=='''Файл уровней'''==

<?xml version="1.0" encoding="UTF-8"?>
<levels>
<level id="0" w="6" h="6" exit_x="5" exit_y="2" turns="20" time="120" final_shift="40" final_vx="5">
<field val="0,0,3,0,0,-3,
0,0,-2,0,0,0,
1,0,0,-2,-2,0,
2,0,0,0,0,0,
-2,0,0,0,0,0,
0,2,0,3,0,0"/>
<answer val="0,3,1,3,0,4,0,3,1,5,0,5,3,5,2,5,5,0,5,3,2,0,3,0,2,1,2,0,3,2,3,3,4,2,4,3,0,2,4,2"/>
</level>
</levels>

[[Файл:Unb3.png|thumb|400px|right]]

* '''id''' - номер уровня.
* '''w''' - количество столбцов поля.
* '''h''' - количество строк поля.
* '''exit_x''' - координата x (отсчет от правого верхнего угла) ячейки-выхода.
* '''exit_y''' - координата y (отсчет от правого верхнего угла) ячейки-выхода.
* '''turns''' - количество ходов на прохождение уровня; если указано "0" - ходы не считаются.
* '''time''' - время на прохождение уровня; если указано "0" - игра без учета времени.
* '''final_shift''' - расстояние, которое нужно проехать при анимировании победы.
* '''final_vx''' - скорость по x.
* '''final_vy''' - скорость по y.
* '''field val''' - описание начальной конфигурации поля.
* '''answer val''' - решение уровня.

<field> - описание начального состояния поля, где:
0 - пустая ячейка
1- главный блок, который нужно поместить на ячейку-выход
2 - блок, занимающий 2 ячейки
3 - блок, занимающий 3 ячейки.
Номера блоков соответствуют порядку указания дополнительных свойств "графика блока"
В точке, в которой указано число, находится крайняя левая/верхняя ячейка блока.
Если число указано с знаком “-”, то блок на поле размещается вертикально.

<answer> - решение от первого до последнего хода в виде набора чисел через запятую. Числа сгруппированы по 4: x1, y1, x2, y2.
Где x1,y1 - координаты левой/верхней клетки блока который нужно подвинуть на текущем ходу решения,
x2, y2 - координаты где эта клетка должна оказаться после хода.
Если указано непустое, но невалидное решение, вьювер при попытке сыграть уровень покажет сообщение об ошибке.

=='''Пример'''==
S:\!MOBILE\!!!EditorGames\Wiki_sample

test_unblockme.zip

[[Category:Game mechanic]]

Unblock

2016-02-08T12:19:01Z

Vefimov: /* Пример */

{{TOC right}}
'''Unblock''' - [[Object|объект]] редактора, который реализует игровую механику "unblock" - передвигая игровые блоки, нужно вывести главный блок к выходу.
----

=='''Основные свойства'''==

[[Файл:Unb1.png|thumb|right]]

* ''файл уровня'' - файл с описанием уровней.
* ''номер уровня'' - номер текущего уровня.
* ''скорость доводки'' - скорость доводки блоков пикс/сек.
* '''счетчики'''
** ''ходы'' - счетчик оставшихся ходов.
** ''время'' - счетчик оставшегося времени.
* '''звуки'''
** ''начало движения'' - звук, который воспроизводится в начале движения блока.
** ''конец движения'' - звук, который воспроизводится в конце движения блока.

=='''Дополнительные параметры'''==
[[Файл:Unb2.jpg|330px|left]]
* '''графика блока''' - ресурс, используемый для отрисовки игрового блока. Номер в списке соответствует номеру блока в файле уровней(в 1 свойстве указывается главный блок который нужно довести к выходу, 2 свойство - 2 блок и т.д.)
** ''клип'' - клип блока, пивот должен быть в центре левой/верхней клетки, перетаскивается из редактора ресурсов.
** ''размер'' - размер блока в игровых клетках.

* '''изменить состояние объекта - победа''' - обработчик победы
** ''объект'' - объект, состояние которого меняем.
** ''состояние'' - новое состояние для объекта из предыдущего поля.

* '''изменить состояние объекта - поражение''' - обработчик поражения
** ''объект'' - объект, состояние которого меняем.
** ''состояние'' - новое состояние для объекта из предыдущего поля.

* '''изменить состояние объекта - ход''' - обработчик нужен для активации кнопки "откатить"
** ''объект'' - объект, состояние которого меняем.
** ''состояние'' - новое состояние для объекта из предыдущего поля.

=='''Состояния'''==
* '''add_time''' - добавить время, перед передачей состояния, установить объекту в param значение, сколько времени добавляем; можно указывать отрицательное значение - уменьшим оставшееся время.
* '''add_turns''' - добавить ходов, перед передачей состояния, установить объекту в param значение, сколько ходов добавляем; можно указывать отрицательное значение - уменьшим оставшееся количество ходов.
* '''hint''' - показать следующий шаг из решения; в файле уровней должно быть указано решение.
* '''reset''' - сбросить уровень - начать игру заново.
* '''undo''' - отменить последний ход; возможность сделать откат должна появляться после сделанного хода (см. изменить состояние объекта - ход)

=='''Файл уровней'''==

<?xml version="1.0" encoding="UTF-8"?>
<levels>
<level id="0" w="6" h="6" exit_x="5" exit_y="2" turns="20" time="120" final_shift="40" final_vx="5">
<field val="0,0,3,0,0,-3,
0,0,-2,0,0,0,
1,0,0,-2,-2,0,
2,0,0,0,0,0,
-2,0,0,0,0,0,
0,2,0,3,0,0"/>
<answer val="0,3,1,3,0,4,0,3,1,5,0,5,3,5,2,5,5,0,5,3,2,0,3,0,2,1,2,0,3,2,3,3,4,2,4,3,0,2,4,2"/>
</level>
</levels>

[[Файл:Unb3.png|thumb|400px|right]]

* '''id''' - номер уровня.
* '''w''' - количество столбцов поля.
* '''h''' - количество строк поля.
* '''exit_x''' - координата x (отсчет от правого верхнего угла) ячейки-выхода.
* '''exit_y''' - координата y (отсчет от правого верхнего угла) ячейки-выхода.
* '''turns''' - количество ходов на прохождение уровня; если указано "0" - ходы не считаются.
* '''time''' - время на прохождение уровня; если указано "0" - игра без учета времени.
* '''final_shift''' - расстояние, которое нужно проехать при анимировании победы.
* '''final_vx''' - скорость по x.
* '''final_vy''' - скорость по y.
* '''field val''' - описание начальной конфигурации поля.
* '''answer val''' - решение уровня.

<field> - описание начального состояния поля, где:
0 - пустая ячейка
1- главный блок, который нужно поместить на ячейку-выход
2 - блок, занимающий 2 ячейки
3 - блок, занимающий 3 ячейки.
Номера блоков соответствуют порядку указания дополнительных свойств "графика блока"
В точке, в которой указано число, находится крайняя левая/верхняя ячейка блока.
Если число указано с знаком “-”, то блок поворачиваем на 90 градусов по часовой стрелке и получаем вертикальный блок.

<answer> - решение от первого до последнего хода в виде набора чисел через запятую. Числа сгруппированы по 4: x1, y1, x2, y2.
Где x1,y1 - координаты левой/верхней клетки блока который нужно подвинуть на текущем ходу решения,
x2, y2 - координаты где эта клетка должна оказаться после хода.
Если указано непустое, но невалидное решение, вьювер при попытке сыграть уровень покажет сообщение об ошибке.

=='''Пример'''==
S:\!MOBILE\!!!EditorGames\Wiki_sample

test_unblockme.zip

[[Category:Game mechanic]]

Unblock

2016-02-08T12:18:47Z

Vefimov:

{{TOC right}}
'''Unblock''' - [[Object|объект]] редактора, который реализует игровую механику "unblock" - передвигая игровые блоки, нужно вывести главный блок к выходу.
----

=='''Основные свойства'''==

[[Файл:Unb1.png|thumb|right]]

* ''файл уровня'' - файл с описанием уровней.
* ''номер уровня'' - номер текущего уровня.
* ''скорость доводки'' - скорость доводки блоков пикс/сек.
* '''счетчики'''
** ''ходы'' - счетчик оставшихся ходов.
** ''время'' - счетчик оставшегося времени.
* '''звуки'''
** ''начало движения'' - звук, который воспроизводится в начале движения блока.
** ''конец движения'' - звук, который воспроизводится в конце движения блока.

=='''Дополнительные параметры'''==
[[Файл:Unb2.jpg|330px|left]]
* '''графика блока''' - ресурс, используемый для отрисовки игрового блока. Номер в списке соответствует номеру блока в файле уровней(в 1 свойстве указывается главный блок который нужно довести к выходу, 2 свойство - 2 блок и т.д.)
** ''клип'' - клип блока, пивот должен быть в центре левой/верхней клетки, перетаскивается из редактора ресурсов.
** ''размер'' - размер блока в игровых клетках.

* '''изменить состояние объекта - победа''' - обработчик победы
** ''объект'' - объект, состояние которого меняем.
** ''состояние'' - новое состояние для объекта из предыдущего поля.

* '''изменить состояние объекта - поражение''' - обработчик поражения
** ''объект'' - объект, состояние которого меняем.
** ''состояние'' - новое состояние для объекта из предыдущего поля.

* '''изменить состояние объекта - ход''' - обработчик нужен для активации кнопки "откатить"
** ''объект'' - объект, состояние которого меняем.
** ''состояние'' - новое состояние для объекта из предыдущего поля.

=='''Состояния'''==
* '''add_time''' - добавить время, перед передачей состояния, установить объекту в param значение, сколько времени добавляем; можно указывать отрицательное значение - уменьшим оставшееся время.
* '''add_turns''' - добавить ходов, перед передачей состояния, установить объекту в param значение, сколько ходов добавляем; можно указывать отрицательное значение - уменьшим оставшееся количество ходов.
* '''hint''' - показать следующий шаг из решения; в файле уровней должно быть указано решение.
* '''reset''' - сбросить уровень - начать игру заново.
* '''undo''' - отменить последний ход; возможность сделать откат должна появляться после сделанного хода (см. изменить состояние объекта - ход)

=='''Файл уровней'''==

<?xml version="1.0" encoding="UTF-8"?>
<levels>
<level id="0" w="6" h="6" exit_x="5" exit_y="2" turns="20" time="120" final_shift="40" final_vx="5">
<field val="0,0,3,0,0,-3,
0,0,-2,0,0,0,
1,0,0,-2,-2,0,
2,0,0,0,0,0,
-2,0,0,0,0,0,
0,2,0,3,0,0"/>
<answer val="0,3,1,3,0,4,0,3,1,5,0,5,3,5,2,5,5,0,5,3,2,0,3,0,2,1,2,0,3,2,3,3,4,2,4,3,0,2,4,2"/>
</level>
</levels>

[[Файл:Unb3.png|thumb|400px|right]]

* '''id''' - номер уровня.
* '''w''' - количество столбцов поля.
* '''h''' - количество строк поля.
* '''exit_x''' - координата x (отсчет от правого верхнего угла) ячейки-выхода.
* '''exit_y''' - координата y (отсчет от правого верхнего угла) ячейки-выхода.
* '''turns''' - количество ходов на прохождение уровня; если указано "0" - ходы не считаются.
* '''time''' - время на прохождение уровня; если указано "0" - игра без учета времени.
* '''final_shift''' - расстояние, которое нужно проехать при анимировании победы.
* '''final_vx''' - скорость по x.
* '''final_vy''' - скорость по y.
* '''field val''' - описание начальной конфигурации поля.
* '''answer val''' - решение уровня.

<field> - описание начального состояния поля, где:
0 - пустая ячейка
1- главный блок, который нужно поместить на ячейку-выход
2 - блок, занимающий 2 ячейки
3 - блок, занимающий 3 ячейки.
Номера блоков соответствуют порядку указания дополнительных свойств "графика блока"
В точке, в которой указано число, находится крайняя левая/верхняя ячейка блока.
Если число указано с знаком “-”, то блок поворачиваем на 90 градусов по часовой стрелке и получаем вертикальный блок.

<answer> - решение от первого до последнего хода в виде набора чисел через запятую. Числа сгруппированы по 4: x1, y1, x2, y2.
Где x1,y1 - координаты левой/верхней клетки блока который нужно подвинуть на текущем ходу решения,
x2, y2 - координаты где эта клетка должна оказаться после хода.
Если указано непустое, но невалидное решение, вьювер при попытке сыграть уровень покажет сообщение об ошибке.

=='''Пример'''==
S:\!MOBILE\!!!EditorGames\Wiki_sample
test_unblockme.zip

[[Category:Game mechanic]]

Unblock

2016-02-08T12:16:34Z

Vefimov: /* Файл уровней */

{{TOC right}}
'''Unblock''' - [[Object|объект]] редактора, который реализует игровую механику "unblock" - передвигая игровые блоки, нужно вывести главный блок к выходу.
----

=='''Основные свойства'''==

[[Файл:Unb1.png|thumb|right]]

* ''файл уровня'' - файл с описанием уровней.
* ''номер уровня'' - номер текущего уровня.
* ''скорость доводки'' - скорость доводки блоков пикс/сек.
* '''счетчики'''
** ''ходы'' - счетчик оставшихся ходов.
** ''время'' - счетчик оставшегося времени.
* '''звуки'''
** ''начало движения'' - звук, который воспроизводится в начале движения блока.
** ''конец движения'' - звук, который воспроизводится в конце движения блока.

=='''Дополнительные параметры'''==
[[Файл:Unb2.jpg|330px|left]]
* '''графика блока''' - ресурс, используемый для отрисовки игрового блока. Номер в списке соответствует номеру блока в файле уровней(в 1 свойстве указывается главный блок который нужно довести к выходу, 2 свойство - 2 блок и т.д.)
** ''клип'' - клип блока, пивот должен быть в центре левой/верхней клетки, перетаскивается из редактора ресурсов.
** ''размер'' - размер блока в игровых клетках.

* '''изменить состояние объекта - победа''' - обработчик победы
** ''объект'' - объект, состояние которого меняем.
** ''состояние'' - новое состояние для объекта из предыдущего поля.

* '''изменить состояние объекта - поражение''' - обработчик поражения
** ''объект'' - объект, состояние которого меняем.
** ''состояние'' - новое состояние для объекта из предыдущего поля.

* '''изменить состояние объекта - ход''' - обработчик нужен для активации кнопки "откатить"
** ''объект'' - объект, состояние которого меняем.
** ''состояние'' - новое состояние для объекта из предыдущего поля.

=='''Состояния'''==
* '''add_time''' - добавить время, перед передачей состояния, установить объекту в param значение, сколько времени добавляем; можно указывать отрицательное значение - уменьшим оставшееся время.
* '''add_turns''' - добавить ходов, перед передачей состояния, установить объекту в param значение, сколько ходов добавляем; можно указывать отрицательное значение - уменьшим оставшееся количество ходов.
* '''hint''' - показать следующий шаг из решения; в файле уровней должно быть указано решение.
* '''reset''' - сбросить уровень - начать игру заново.
* '''undo''' - отменить последний ход; возможность сделать откат должна появляться после сделанного хода (см. изменить состояние объекта - ход)

=='''Файл уровней'''==

<?xml version="1.0" encoding="UTF-8"?>
<levels>
<level id="0" w="6" h="6" exit_x="5" exit_y="2" turns="20" time="120" final_shift="40" final_vx="5">
<field val="0,0,3,0,0,-3,
0,0,-2,0,0,0,
1,0,0,-2,-2,0,
2,0,0,0,0,0,
-2,0,0,0,0,0,
0,2,0,3,0,0"/>
<answer val="0,3,1,3,0,4,0,3,1,5,0,5,3,5,2,5,5,0,5,3,2,0,3,0,2,1,2,0,3,2,3,3,4,2,4,3,0,2,4,2"/>
</level>
</levels>

[[Файл:Unb3.png|thumb|400px|right]]

* '''id''' - номер уровня.
* '''w''' - количество столбцов поля.
* '''h''' - количество строк поля.
* '''exit_x''' - координата x (отсчет от правого верхнего угла) ячейки-выхода.
* '''exit_y''' - координата y (отсчет от правого верхнего угла) ячейки-выхода.
* '''turns''' - количество ходов на прохождение уровня; если указано "0" - ходы не считаются.
* '''time''' - время на прохождение уровня; если указано "0" - игра без учета времени.
* '''final_shift''' - расстояние, которое нужно проехать при анимировании победы.
* '''final_vx''' - скорость по x.
* '''final_vy''' - скорость по y.
* '''field val''' - описание начальной конфигурации поля.
* '''answer val''' - решение уровня.

<field> - описание начального состояния поля, где:
0 - пустая ячейка
1- главный блок, который нужно поместить на ячейку-выход
2 - блок, занимающий 2 ячейки
3 - блок, занимающий 3 ячейки.
Номера блоков соответствуют порядку указания дополнительных свойств "графика блока"
В точке, в которой указано число, находится крайняя левая/верхняя ячейка блока.
Если число указано с знаком “-”, то блок поворачиваем на 90 градусов по часовой стрелке и получаем вертикальный блок.

<answer> - решение от первого до последнего хода в виде набора чисел через запятую. Числа сгруппированы по 4: x1, y1, x2, y2.
Где x1,y1 - координаты левой/верхней клетки блока который нужно подвинуть на текущем ходу решения,
x2, y2 - координаты где эта клетка должна оказаться после хода.
Если указано непустое, но невалидное решение, вьювер при попытке сыграть уровень покажет сообщение об ошибке.

[[Category:Game mechanic]]

Unblock

2016-02-08T12:13:39Z

Vefimov:

{{TOC right}}
'''Unblock''' - [[Object|объект]] редактора, который реализует игровую механику "unblock" - передвигая игровые блоки, нужно вывести главный блок к выходу.
----

=='''Основные свойства'''==

[[Файл:Unb1.png|thumb|right]]

* ''файл уровня'' - файл с описанием уровней.
* ''номер уровня'' - номер текущего уровня.
* ''скорость доводки'' - скорость доводки блоков пикс/сек.
* '''счетчики'''
** ''ходы'' - счетчик оставшихся ходов.
** ''время'' - счетчик оставшегося времени.
* '''звуки'''
** ''начало движения'' - звук, который воспроизводится в начале движения блока.
** ''конец движения'' - звук, который воспроизводится в конце движения блока.

=='''Дополнительные параметры'''==
[[Файл:Unb2.jpg|330px|left]]
* '''графика блока''' - ресурс, используемый для отрисовки игрового блока. Номер в списке соответствует номеру блока в файле уровней(в 1 свойстве указывается главный блок который нужно довести к выходу, 2 свойство - 2 блок и т.д.)
** ''клип'' - клип блока, пивот должен быть в центре левой/верхней клетки, перетаскивается из редактора ресурсов.
** ''размер'' - размер блока в игровых клетках.

* '''изменить состояние объекта - победа''' - обработчик победы
** ''объект'' - объект, состояние которого меняем.
** ''состояние'' - новое состояние для объекта из предыдущего поля.

* '''изменить состояние объекта - поражение''' - обработчик поражения
** ''объект'' - объект, состояние которого меняем.
** ''состояние'' - новое состояние для объекта из предыдущего поля.

* '''изменить состояние объекта - ход''' - обработчик нужен для активации кнопки "откатить"
** ''объект'' - объект, состояние которого меняем.
** ''состояние'' - новое состояние для объекта из предыдущего поля.

=='''Состояния'''==
* '''add_time''' - добавить время, перед передачей состояния, установить объекту в param значение, сколько времени добавляем; можно указывать отрицательное значение - уменьшим оставшееся время.
* '''add_turns''' - добавить ходов, перед передачей состояния, установить объекту в param значение, сколько ходов добавляем; можно указывать отрицательное значение - уменьшим оставшееся количество ходов.
* '''hint''' - показать следующий шаг из решения; в файле уровней должно быть указано решение.
* '''reset''' - сбросить уровень - начать игру заново.
* '''undo''' - отменить последний ход; возможность сделать откат должна появляться после сделанного хода (см. изменить состояние объекта - ход)

=='''Файл уровней'''==

<?xml version="1.0" encoding="UTF-8"?>
<levels>
<level id="0" w="6" h="6" exit_x="5" exit_y="2" turns="20" time="120" final_shift="40" final_vx="5">
<field val="0,0,3,0,0,-3,
0,0,-2,0,0,0,
1,0,0,-2,-2,0,
2,0,0,0,0,0,
-2,0,0,0,0,0,
0,2,0,3,0,0"/>
<answer val="0,3,1,3,0,4,0,3,1,5,0,5,3,5,2,5,5,0,5,3,2,0,3,0,2,1,2,0,3,2,3,3,4,2,4,3,0,2,4,2"/>
</level>
</levels>

[[Файл:Unb3.png|thumb|400px|right]]

* '''id''' - номер уровня.
* '''w''' - количество столбцов поля.
* '''h''' - количество строк поля.
* '''exit_x''' - координата x (отсчет от правого верхнего угла) ячейки-выхода.
* '''exit_y''' - координата y (отсчет от правого верхнего угла) ячейки-выхода.
* '''turns''' - количество ходов на прохождение уровня; если указано "0" - ходы не считаются.
* '''time''' - время на прохождение уровня; если указано "0" - игра без учета времени.
* '''final_shift''' - расстояние, которое нужно проехать при анимировании победы.
* '''final_vx''' - скорость по x.
* '''final_vy''' - скорость по y.
* '''field val''' - описание начальной конфигурации поля.
* '''answer val''' - решение уровня.

<field> - описание начального состояния поля, где:
0 - пустая ячейка
1- главный блок, который нужно поместить на ячейку-выход
2 - блок, занимающий 2 ячейки
3 - блок, занимающий 3 ячейки.
В точке, в которой указано число, находится крайняя левая ячейка блока.
Если число указано с знаком “-”, то блок поворачиваем на 90 градусов по часовой стрелке и получаем вертикальный блок.

<answer> - решение от первого до последнего хода в виде набора чисел через запятую. Числа сгруппированы по 4: x1, y1, x2, y2.
Где x1,y1 - координаты левой/верхней клетки блока который нужно подвинуть на текущем ходу решения,
x2, y2 - координаты где эта клетка должна оказаться после хода.
Если указано непустое, но невалидное решение, вьювер при попытке сыграть уровень покажет сообщение об ошибке.

[[Category:Game mechanic]]

Файл:Unb3.png

2016-02-08T11:52:12Z

Vefimov:

Absolutist Framework

2016-02-08T11:45:03Z

Vefimov: /* Game mechanic */

{{TOC right}}
'''[[:category:main|Категории]]'''
== Новости ==
Вышла новая игра HOG созданная с помощью AppSalute Game Сreator. Созданы новые уникальные эффекты и механики для обеспечения незабываемых впечатлений.
Описание и видео:
http://time-gap.com/

== AppSalute Game Сreator ==
* [[Примеры приложений]]
* [[Введение в AppSalute Game Сreator]]
* [[Установка и настройка]]
* [[Интерфейс ScenceEditor ]]
* [[Интерфейс ResourceEditor ]]
* [[Интерфейс TextEditor ]]
*[[Интерфейс Viewer ]]
* [[Книга жалоб и пожеланий]]
* [[Roadmap]]

== Обучение ==

* [[Learning|Уроки по освоению фреймворка]]
* [[Примеры реализации в играх]]
* [[Основные понятия объектов физического мира]]
* [[Использование AppSalute Debugger при отладке]]
* [[FAQ]]

== Подготовка проекта ==
* [[Проектирование экранов игры]]
* [[Подготовка и форматы графики]]
* [[Подготовка и форматы шрифтов]]
* [[Подготовка и форматы звуков]]
* [[Подготовка и форматы видео]]
* [[Создание проекта]]
* [[Загрузка проекта по частям]]
* [[Конфигурация проекта для сборки]]
* [[Подготовка для загрузки на маркеты]]
* [[Сборка проекта]]
* [[Частые ошибки]]
* [[Отличия подготовки проекта для разных платформ]]

== Встроенные объекты редактора==

=== Common objects ===

''[[Файл:Screen.png]] - [[Screen]]'' - экран

''[[Файл:Scene.png]] - [[Scene]]'' - сцена

=== Main objects ===

''[[Файл:Objects.png]] - [[Object]]'' - общие параметры для всех игровых объектов

* [[Файл:Kub.png]] - [[Azmanager]] - менеджер активных зон
* [[Файл:Kub.png]] - [[Active zone]] - активная зона
* [[Файл:Picture.png]] - [[Image]] - картинка
* [[Файл:Button.png]] - [[Button]] - кнопка
* [[Файл:Text.png]] - [[Text]] - текст
* [[Файл:Machine.png]] - [[Machine]] - машина состояний
* [[Файл:Tableicon.png]] - [[Table]] - таблица
* [[Файл:Checkbox.png]] - [[Checkbox]] - чекбокс (кнопка в 2-х состояниях)
* [[Файл:Checkgroup.png]] - [[Groupbox]] - группа, содержащая несколько чекбоксов
* [[Файл:Timer.png]] - [[Timer]] - цифровой таймер
** [[Файл:Kub.png]] - [[Globaltimer]] - таймер "реального времени"
* [[Файл:Counter2.png]] - [[Counter]] - счетчик сделанных кликов в игре и т.п.
* [[Файл:Progressbar.png]] - [[Progress]] - прогресс прохождения игры (эчивмент)
* [[Файл:Particle.png]] - [[Flyer]] - флаер (патиклы)
* [[Файл:Rectangle.png]] - [[Rectangle]] - прямоугольник
* [[Файл:Kub.png]] - [[Isomover]] - объект движения в изометрической карте
* [[Файл:Group.png]] - [[Group]] - группа
* [[Файл:Groupset.png‎]] - [[Groupset]] - группа
* [[Файл:Effect.jpg|20px]] - [[Effect]] - Создание различных эффектов
* [[Файл:Graphprogress.png]] - [[Graphprogress]] - создание мини-карты для отображения прогресса прохождения игры.
* [[Файл:Kub.png]] - [[Statesmanager]] - очередь работы с объектами
* [[Файл:Slider icons.png]] - [[Slider]] - объект реализующий листание списка.
* [[Файл:Ribbon.png]] - [[Ribbon]] - объект отображения графики по сплайну
* [[Файл:Kub.png]] - [[Animation]] - объект различных анимаций
* [[Файл:Kub.png]] - [[Magicparticles]] - объект файлов Magic Particles

=== Game mechanic ===

* [[Файл:Puzzle.png]] - [[Puzzle]] - игра пазл
* [[Файл:Memory.png]] - [[Memory]] - класс игр с memory-механикой
* [[Файл:Patchwork.png]] - [[Patchwork]] - класс игр с Patchwork-механикой
* [[Файл:Match3.png]] - [[Match]] - класс match-подобных игр
* [[Файл:Collaps.png]] - [[Collapse]] - класс match-подобных игр
* [[Файл:Bejewelled.png]] - [[Bejewelled]] - класс match-подобных игр
* [[Файл:BubbleShooter.png]] - [[Bubble Shooter]] - класс Bubble игр включая механику Снукер
* [[Файл:Tapthebubble.png]] - [[TapTheBubble]] - механика игры Tap The Bubble
* [[Файл:GemSlider.jpg]] - [[Gem Slider]] - механика игры Gem Slider
* [[Файл:W-57.png]] - [[Words]] - механика игры Words
* [[Файл:Kub.png]] - [[2048]] - механика игры 2048
* [[Файл:Kub.png]] - [[Unblock]] - механика игры unblock
* [[Файл:Matchbattle.png]] - [[Match Battle]] - настройка глобальных параметров для мини-игр
* [[Файл:Move box.png]] - [[DragBox]] - класс игр с dragbox-механикой
* [[Файл:Labyrinth.png]] - [[Labyrinth]] - класс игр лабиринт
* [[Файл:Pipes.png]] - [[Pipes]] - класс игр трубы
* [[Файл:Search object.png]] - [[HiddenObject]] - поисковый объект в хидден играх
* [[Файл:Object list.png]] - [[HiddenList]] - список поисковых объектов в хидден играх
* [[Файл:Hint.png]] - [[HiddenHint]] - подсказка (указатель на спрятанный объект)
* [[Файл:Kub.png]] - [[HiddenHighLighter]] - позволяет показать не найденные объекты в хиддене.
* [[Файл:Collection.png]] - [[Collection]] - "коллекция" поисковых объектов для хидден игр
* [[Файл:Inventory.png]] - [[Inventory]] - "инвентарь" список применяемых объектов для игр
* [[Файл:Tool.png]] - [[Tool]] - "применение" - объект, который можно применить для игр
* [[Файл:Kub.png]] - [[Isomap]] - изометрическая карта
* [[Файл:Slotmachine.png]] - [[Slotmachine]] - объект типа "slot"
* [[Файл:Economics.png]] - [[Economics]] - глобальная настройка игр типа ферма\билдер
** [[Файл:E_items.png]] - [[Eitems]] - объект, служащий для связи инвентаря/магазина и экономики
** [[Файл:E_store_item.png]] - [[Estoreitem]] - шаблон для ячейки магазина
** [[Файл:E_inventory_item.png]] - [[Einventoryitem]] - шаблон для ячейки инвентаря
** [[Файл:Kub.png]] - [[Ecraftitem]] - шаблон для ячейки создания предмета.
** [[Файл:Taskorganizer.png]] - [[Taskorganizer]] - органайзер заданий
** [[Файл:E_task_item.png]] - [[Etaskitem]] - шаблон для ячейки задания
** [[Файл:E_collection.png]] - [[Ecollection]] - шаблон для строки в таблице коллекции
* [[Файл:Paint.png‎]] - [[Paint]] - объект для рисования
* [[Файл:Physicsworld.png]] - [[Physicsworld]] - физический мир Box2D
** [[Файл:Physicsobject.png]] - [[Physicsobject]] - физические объекты
** [[Файл:Physics links.png]] - [[Physicsjoint]] - физические соединения
* [[Файл:Eraser.png]] - [[Eraser]] - стирачка
* [[Файл:Kub.png]] - [[trivia]] - игровая механика - миллионер (trivia)
* [[Файл:Kub.png]] - [[Dailybonus]] - объект для управления механизмом ежедневного бонуса за вход в игру.
* [[Файл:Kub.png]] - [[Pet]] - объект питомца.

=== Global score ===
* [[Файл:Gamecenter.png]] - [[Gamecenter]] - объект для отправки данных на GameCenter iTunse
**[[Файл:Kub.png]] - [[Achievementitem]] - шаблон локального достижения (оффлайн ачивка)
* [[Файл:Gamecircle.jpg]] - [[Amazon GameCircle]] - объект для отправки данных Amazon GameCircle
* [[Файл:Google-play-games-android.jpg‎]] - [[Google Play services]] - объект для отправки данных на Google Play services
* [[Файл:Localtoplist.png]] - [[Localtoplist]] - настройки для отображения результатов прохождения игры
* [[Файл:Globaltoplist.png]] - [[Globaltoplist]] - настройки для отображения результатов прохождения игры
* [[Файл:Globaltopsender.png]] - [[Globaltopsender]] - настройки для отображения результатов прохождения игры

=== Options ===
* [[Файл:Options.png]] - [[Options]] - общие настройки игры
* [[Файл:Gamedata.png]] - [[Gamedata]] -
* [[Файл:Controls.png]] - [[Controls]] - обьект для работы с клавишами клавиатуры или девайса
* [[Файл:Editicon.png]] - [[Edit]] - ввод текста
* [[Файл:Store.png]] - [[Store]] - настройки InApp покупок в игре
** [[Файл:Kub.png]] - [[Wallet]] - объект для начисления игровой валюты при InApp покупках через объект economics
* [[Файл:Notification.png]] - [[Notification]] - push-уведомления
* [[Файл:Imagepicker.png]] - [[Imagepiker]] - объект для загрузки фото из галереи
* [[Файл:Video.png]] - [[Video]] - объект для просмотра видео
* [[Файл:Webview.png]] - [[Webview]] - объект для просмотра интернет страниц в приложении
* [[Файл:Flurryobject.png]] - [[Flurry]] - настройки системы статистики для приложений https://dev.flurry.com
* [[Файл:Moregames.png]] - [[MoreGamesList]] - запрос банеров рекламируемых игр
* [[Файл:Advertisement.png]] - [[Advertisement]] - банерная система flurry, amazon
* [[Файл:Splitmanager.png]] - [[Splitmanager or A\B Testing]] - менеджер сплитов
* [[Файл:Tapjoy.png]] - [[Tapjoy]] - система рекламы игр
* [[Файл:Playhaven.png|24px]] - [[Playhaven]] - система рекламы игр с внутренними up-sale
* [[Файл:Mobileapptracker.png|24px]] - [[Mobileapptracking]] -
* [[Файл:Chartboost-logo-new.jpeg]] - [[Chartboost]] - Chartboost-logo-new.jpeg
* [[Файл:Kub.png]] - [[SuperSonic]] - провайдер рекламы SuperSonic
* [[Файл:Kub.png]] - [[System]] - объект для доступа к системным настройкам
* [[Файл:Kub.png]] - [[Salesmanager]] - менеджер акций
* [[Файл:Kub.png]] - [[Cloud]] - объект для синхронизации в облаке
* [[Файл:Kub.png]] - [[Game]] - объект для отправки событий

=== Social ===
* [[Файл:Facebook.png]] - [[Facebook]] - настройки расшаривания Facebook
** [[Файл:Esocialfrienditem.png]] - [[Esocialitem]] - Шаблон для ячейки списка друзей
** [[Файл:Kub.png]] - [[Esocialgiftitem]] - Шаблон для ячейки с предметом, который можно подарить другу
** [[Файл:Esocial.png]] - [[Esocial]] - объект для взаимодействия с Facebook'ом
* [[Файл:Twitter.png]] - [[Twitter]] - настройки расшаривания Twitter
* [[Файл:Odnoklassniki.png]] - [[Odnoklassniki]] - настройки для социальной сети Одноклассники
* [[Файл:Googleplus.png]] - [[GooglePlus]] - настройки для социальной сети GooglePlus

=== Functions ===
* [[Файл:Forward.png]] - [[SendMail]] - отправка письма через почтовый клиент
* [[Файл:footer-icon-rate.png]] - [[Rate]] - вызов окна оценки приложения
----
<gallery widths="50px" heights="50px" >
Изображение:Who.png
Изображение:AnimalHideSeek.png
Изображение:travel.png
Изображение:Game_Adventure_Train.png
Изображение:Gmae_Match_MoveTheDolly.png
Изображение:Game_Patchwork_BigEyes.png
Изображение:Game_Patchwork_Chameleon.png
Изображение:Game_Patchwork_Logicly.png‎
Изображение:Game_Patchwork_Stickers.png‎
Изображение:Elephant.png
Изображение:Elephant2.png
Изображение:Cinderella.png
Изображение:Pigs.png
Изображение:Bremenskye.png
Изображение:Book_SnowWhite.png
Изображение:Book_PussInBoots.png
Изображение:Call.png
Изображение:GreatestArtists.png
Изображение:Game_Puzzle_Kids.png
Изображение:Game_Puzzle_Architect.png‎
Изображение:Game_Puzzle_Science.png
Изображение:Ico_1_114_Full.png
Изображение:Game_Adventure_Dreams.png
Изображение:Abc.png
Изображение:Ico_114_Full.png
Изображение:Ico_114_Paints.png
Изображение:Ico_114_Puzzle.png
</gallery>

[[category:main]]

Unblock

2016-02-08T11:41:25Z

Vefimov: Новая страница: «{{TOC right}} '''Unblock''' - объект редактора, который реализует игровую механику "unblock" - пере…»

Файл:Unb2.jpg

2016-02-08T10:38:46Z

Vefimov:

Файл:Unb1.png

2016-02-08T10:31:36Z

Vefimov:

Machine

2015-12-02T08:25:44Z

Vefimov: /* Запись в viewer.log */

{{TOC right}}
[[Machine]] - [[Object|объект]] '''машина состояний''' (state machine) позволяет описывать сложное поведение игровых объектов. Для машин с типовым набором состояний и поведений вводятся отдельные типы объектов. Например, кнопка, по своей сути, является машиной состояний.

== Введение ==

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

Любая машина состояний может быть изображена в виде графа с кружочками и стрелками. У машины всегда активно строго одно состояние (ниже это изображено на левом рисунке темным кружком):
<center>
[[Файл:def_states.png]]
</center>
Машина состояний не обладает памятью. Это означает, что для анализа того, что произойдет в данном состоянии, неважно как мы в него попали, и какова была предыстория переходов. Важно, только, что мы находимся в этом состоянии. Такое отсутствие памяти упрощает анализ логики машины, так как каждый раз мы концентрируемся на одном конкретном состоянии, а всю логику работы разбиваем на отдельные кирпичики-состояния.

Выше на правом рисунке изображено некоторое состояние. При входе в него, происходит инициализация состояния. Если на объект оказываются внешние воздействия, то он может покинуть состояние. Наконец, внутри состояния могут работать различные процессы.

Все команды состояния, разбиваются на три группы:
* '''[[#Инициализация|Инициализация]]''':
** '''[[#draw|draw]]''' - установка графического ресурса;
** '''[[#init|init]]''' - инициализация параметров машины (координаты и т.п.);
** '''[[#set|set]]''' - установка состояния другого объекта;
** '''[[#play|play]]''' - проиграть звук;
** '''[[#var|var]]''' - переменная, которой присваивается значение параметра объекта;
** '''[[#buy|buy]]''' - запуск процедуры in-app покупки;
** '''[[#download|download]]''' - запуск процедуры закачки контента.
* '''[[#Процессы|Процессы]]''':
** '''[[#wait|wait]]''' - задержка по времени;
** '''[[#move|move]]''' - равномерное движение;
** '''[[#rot|rot]]''' - вращение вокруг точки пивота;
** '''[[#alpha|alpha]]''' - изменение прозрачности;
** '''[[#scale|scale]]''' - изменение размера;
** '''[[#phys|phys]]''' - ускоренное движение;
** '''[[#rgb|rgb]]''' - изменить rgb-каналы;
** '''[[#spline|spline]]''' - движение по сплайну (по кривой).
* '''[[#Воздействия|Воздействия]]''':
** '''[[#click|click]]''' - что делать при клике на машине;
** '''[[#drop|drop]]''' - на машине отпущена клавиша мыши;
** '''[[#drag|drag]]''' - машину схватили и тащат;
** '''[[#throw|throw]]''' - машину схватили и кинули;
** '''[[#apply|apply]]''' - сработает при пересечении машины с линией или объектом;
** '''[[#touch_in|touch_in]]''' - наведение мыши/пальца на машину, если палец "тащат" по экрану;
** '''[[#touch_out|touch_out]]''' - выведение мыши из машины, если палец "тащат" по экрану;
** '''[[#touch_up|touch_up]]''' - отжатие мыши от машины;
** '''[[#tap|tap]]''' - умный тач;
** '''[[#mouse_in|mouse_in]]''' - наведение мыши на машину даже если не нажата кнопка мыши;
** '''[[#mouse_out|mouse_out]]''' - выведение мыши из машины даже если не нажата кнопка мыши.

Кроме этого, есть команда '''[[#if|if]]''', вызываемая другими командами. В ней описываются некоторые логические условия, выполнение которых говорит команде (которая вызвала этот '''if'''), что можно завершать работу. Для разных команд использование этого параметра несколько '''отличается'''!

Начальные понятия и методы работы с машинами состояний находятся в [[Learning|уроках]],
начиная с [[Checkbox как машина состояний|третьего]].

== Свойства ==

Общие для всех объектов свойства описаны в документе [[Object|Object]].
Дополнительные свойства:

* '''в опции''' - да - машина будет сохранять свое состояние в опции и при следующей инициализации инициал-ся не в первом состоянии, а в состоянии, записанном в опциях.
* '''Состояние''' - Состояние в котором будет находиться машина при инициализации. Если ничего не указано - первое состояние в списке состояний.
* '''Хранить нажатость''' - нужно ли сбрасывать нажатость при изменении состояния.
* '''res''' - графический ресурс машины. Может отсутствовать. Перетягивается из редактора ресурсов(поле должно быть в состоянии редактирования).
* '''states''' - По двойному клику, или по нажатию на кнопку с тремя точками открывается список состояний.
* '''отладка''' - Отображать в окне состояний текущий объект.
* '''курсор''' - Графический ресурс курсора текущего и всех дочерних объектов.
* '''прокликиваемая''' - 0 - машина не пропускает клик, 1 - машина пропускает клик, 2 - машина обрабатывает клик и пропускает его дальше.

== Инициализация ==

При попадании в состояние, сразу выполняются команды инициализации init, draw, set, buy, var. Если в этих командах нет параметра break, они все выполняются до запуска процессов. Параметр break (со значением 1) прерывает выполнение команд инициализации данного типа. Их можно перезапустить по окончанию команд процессов.

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

=== draw ===

Команда определяет графический ресурс (картинку, которую надо рисовать в данном состоянии). Её параметры:

* '''res''' - ресурс картинки (перетаскивается из редактора ресурсов);
* '''f''' - начальный кадр;
* '''ft''' - длительность кадра в миллисекундах;
* '''loop''' - число повторов (зацикливаний анимации); если -1, то бесконечно; отсутствует или 0 - будет проигран один раз;
* '''rev''' - играть анимацию в обратном порядке; 0 - прямой порядок проигрывания, 1 - обратный порядок проигрывания;
* '''go''' - перейти в состояние;
* '''if''' - номер (начиная с нуля) команды [[#if|if]] для условия перехода; можно использовать логические операторы (см. [[#if|if]]);
* '''break''' - прервать команды.

Пустая команда draw (без параметров) "сбрасывает" текущую картинку и в этом состоянии ничего рисоваться не будет. Если в общих параметрах объекта (в базовой панеле свойств) задан ресурс рисования, и он во всех состояниях одинаков, то его можно в состоянии не задавать.

Если параметра loop нет, кадры анимации проиграются один раз. Чтобы зациклить их, необходимо установить loop=-1 или нужное число раз. Аналогично параметру loop других команд, первый раз draw выполняется в любом случае. Дальнейшие её повторы определяются значением loop. Однако, в отличие от других команд, loop повторяет только '''данную''' команду draw (даже если она не первая).
Для работы loop '''необходимо''' чтобы в редакторе ресурсов в настройках анимации '''было отключено''' зацикливание(looped).
 Если есть анимация открывающейся и закрывающейся книги (коробки, двери и т.д.) не обязательно подгружать в проект две анимации, можно использовать одну, но запускать ее в обратном порядке, для этого есть параметр '''rev'''.

=== init ===

====Параметры объекта====

* '''x''','''y''' - координата точки пивота относительно сцены или родительского объекта;
* '''ang''' - угол поворота в градусах; отчитывается вниз от оси x, или вверх, если отрицательный;
* '''al''' - Прозрачность: от 0 (прозрачен) до 1 (не прозрачен);
* '''sx''','''sy''' - масштаб машины по осям (если 1, то это исходный размер; 0.5 - в два раза меньше);
* '''vis''' - видимость - видимость машины (1 - видима, 0 - невидима), если vis = 0, это равноценно отключению объекта в редакторе;
* '''z координата''' - координата машины по z.
* '''z приращение''' - приращение координаты машины по z относительно текущего
* '''прокликиваемая''' - если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то клик обрабатывается, но передается дальше;

====Параметры движения====

* '''v''' - скорость для команды move
* '''vr''' - угловая скорость для команды rot
* '''vx''','''vy''' - начальная скорость для команды phys
* '''ax''','''ay''' - ускорение для команды phys

====Системные действия====

* '''показать рейтинг''' - значение 1 означает, что при выполнении этого инита будет показано окно iOS рейтинга.
Если на девайсе была нажата кнопка "отрейтинговать", то в опции запишется параметр rating значение 1, если нажата кнопка "позже" - rating 2, "никогда" - rating 3.
* '''закрыть приложение''' - значение 1 означает, что при выполнении этого инита приложение будет закрыто.
* '''перезагрузить лэйаут''' - значение 1 означает, что при выполнении этого инита будет перезагружен лэйаут.
* '''вернуться назад''' - начение 1 означает, что при выполнении этого инита произойдет возврат на предыдущий экран.
* '''реклама AdMob''' - 1 - показать, 0 - спрятать, -1 - не изменять состояние.
* '''курсор''' - меняет текущий курсор мыши на указанный графический ресурс. Перетягивается из редактора ресурсов, поле должно быть в состоянии редактирования.
* '''id внешней ссылки в текстовой базе''' - Ссыслка будет взята из текстовой базы в соответствии с текущим маркетом.
* '''[[#Clone|clone]]''' - Значение 1 означает, что в текущем местоположении машины будет создана ее копия

====Переходы и параметры выполнения====

* '''if''' - номер (начиная с нуля) команды [[#if|if]] для условия выполнения; можно использовать логические операторы (см. [[#if|if]]);
* '''break''' - прервать команды.

Так же, как и при инициализации картинки ('''draw'''), вызов команды ('''init''') переопределяет только те параметры, которые в ней указаны. Остальные параметры (заданные в других состояниях или в общих свойствах объекта) остаются без изменений

=== set ===

Перевод другого объекта в некоторое состояние или изменение его параметров.

* '''obj''' - изменяемый объект (выбирается из списка объектов). В значении объекта можно указать this, это значит что машина сама себе пропишет какой то параметр или состояние.
* '''scr_param''' - глобальный либо текущий экран, параметры которого меняем.
* '''scr_state''' - экран, состояние которого меняем.
* '''parent''' - Объект, который будет установлен в качестве родителя объекту из obj. Объект obj будет оторван от текущего своего родителя и добавлен в детей объекта parent. 
* '''st''' - состояние в которое переводится объект. 
* '''par''' - параметр объекта для установки, используется вместе с val, val_obj, val_txt, val_scr,val_vid,val_res,val_node.
* '''mSt''' - Состояние машины в котором будем изменять параметр команды.
* '''mCmd''' - Имя команды, параметр которой меняем.
* '''mCmdN''' - Порядковый номер в перечне одноименных команд состояния.
* '''mPar''' - Установить этот параметр команды в значение val.
* '''val_obj''' - id объекта, будет записано в в par
* '''val_txt''' - id текста, будет записано в в par(параметр для текстов "txtID")
* '''val_vid''' - id video, будет записано в par(параметр для видео "video" - RGB, "videoA" - Alpha)
* '''val_scr''' - id экрана, будет записано в в par
* '''val_res''' - Новое значение графического ресурса (перетаскивается из редактора ресурсов). (пока не работает)
* '''val_node''' - Новое нода графа (выбирается из списка, при заданном объекте)
* '''val''' - значение параметра объекта для установки
* '''var''' - имя переменной данной машины, значение которой присваивается в параметр par объекта obj
* '''round''' - округлить значение, записываемое в val 
* '''position''' - объект указанный в поле '''obj''' будет отпозиционирован относительно указанного объекта в этом поле ( можно одновременно и задавать состояние '''st''' в которое перевести объект ( поле obj ) );
* '''pos_dx''' - смещение по оси X от точки пивоты объекта из поля выше ( если это поле не указывать, смещение будет = 0 );
* '''pos_dy''' - смещение по оси Y от точки пивоты объекта из поля выше ( если это поле не указывать, смещение будет = 0 )
* '''scr''' - экран на который мы хотим перейти
* '''user''' - 1 - сохранять значения для текущего пользователя. Для всех типов объектов кроме options этот флаг игнорируется 
* '''if''' - номер (начиная с нуля) команды [[#if|if]] при выполнении которого происходит отработка команды set.
* '''break''' - прервать выполнение команд set на этой команде (запустить их снова можно из команд процессов).

Так как все объекты (не только машины) имеют состояния, то при помощи команды set можно их менять. Стоит обратить внимание на то, что когда в параметрах (любых команд) встречается st, речь идет о состоянии другого объекта, а если go, то данной машины состояний.

=== play ===

Проиграть звук

*'''snd''' - Короткий звук (перетаскивается из редактора ресурсов);
*'''voice''' - Голос (перетаскивается из редактора ресурсов);
*'''mus''' - Длинный звук (перетаскивается из редактора ресурсов);
*'''preload''' - Указанный звук будет загружен в память, но не будет проигрываться прямо сейчас. Для ускорения его старта потом;
*'''loop''' - Зациклить указанный звук. Использовать вместе с snd или voice;
*'''mus_loop''' - Зациклить указанную музыку. По умолчанию музыка всегда зацикленна. То есть, фактически этой флаг используется, когда нужно убрать зацикливание.
*'''repeat''' - Число повторов указанного звука при отключенном loop;
*'''mus_stop''' - Остановить музыку. Если используется вместе с mus, то остановится указанная. Если нет - то вся текущая.
*'''stop''' - Остановить указанный звук. Использовать вместе с snd или voice.
*'''mus_fading''' - Время появления/затухания указанной музыки в ms. Использовать вместе с mus.
*'''fading''' - Время появления/затухания указанного звука. Использовать вместе с snd или voice.
*'''volume''' - Установить громкость для всех звуков данной машины - тех что уже играют и тех, что будут запущены впоследствии;
*'''не выгружать''' - Позволяет продолжать проигрывание звука при смене экранов.
*'''go''' - Выбор состояния, в которое нужно перейти после проигрывания музыки/звука/голоса.
*'''if''' - Номер (начиная с нуля) условия перехода [[#if|if]].

Особенности применения:

1) Короткий звук (''snd'') нельзя запустить в первом (инитном) состоянии машины. Для того, чтобы запустить звук сразу при загрузке экрана, нужно в первом состоянии машины записать мгновенный переход во второе состояние мамашины (например, команда ''wait'', поле ''go'', в поле выбрать второе состояние), а во втором состоянии уже запустить звук.

2) Если звук нужно зациклить и проигрывать какое-то количество раз (''loop=1,2,3,..,n'') или бесконечно (''loop=-1''), то нужно проследить чтобы состояние, в котором запускается звук, не вызывалось повторно во время проигрывания звука, иначе возникнет наложение звуков.

3) Если во время проигрывания звука машина меняет свое состояние, звук продолжает играть.

4) Если в одной машине почти одновременно воспроизводится несколько звуков, то они прерывают друг друга.

5) Если каждый звук воспроизводится в отдельной машине, то они звучат параллельно.

6) Если не указан звук и голос, то команда (''stop'') остановит все звуки, запущенные этой машиной.

7) Музыка (''mus'') может быть формата .ogg или .mp3. На экране может воспроизводится только одна .mp3 музыка. Любой запуск .mp3 музыки независимо от того, в какой машине он осуществляется, будет прекращать проигрывание предыдущей .mp3 музыки. В тоже время может воспроизводиться несколько .ogg музыки.

8) Музыка, которая проигрывается на глобальном экране, проигрывается на всех экранах проекта.

=== var ===

Переменная, которой присваивается значение параметра объекта

*'''name''' - имя переменной;
*'''tp''' - тип переменной;
*'''obj''' - объект, используемый далее;
*'''par''' - имя параметра, значение которого присваивается переменной;
*'''val''' - значение переменной, если отсутствуют obj и par;
*'''user''' - если стоит "1", то будет считываться с текущего профиля в опциях
*'''func''' - в выпадающем списке можно выбрать функцию:
**'''random''' - использует arg1 и arg2, возвращает случайное целое число в диапазоне arg1 .. arg2.
**'''conc''' - объединяет 4 строки arg1,arg2,arg3,arg4. Возвращает строку, в которой соединены все строки
**'''exp''' - экспонента от аргумента arg1.
**'''ln''' - натуральный логарифм аргумента arg1.
*'''arg1''' - аргумент функции
*'''arg2''' - аргумент функции
*'''arg3''' - аргумент функции
*'''arg4''' - аргумент функции

Обозначенная переменная существует (может использоваться) только в текущем состоянии. Переменная может определятся в одном состоянии только один раз. Если созданной переменной нужно изменить значение в рамках состояния, это можно сделать через другую переменную или через параметр опций ([[Options]]). Если ее значение нужно использовать в другом состоянии, то оно присваивается параметру опций, а затем заново считывается в новом состоянии. Переменные можно указывать в поле ''val'' с другими математическими действиями и цифрами, при этом каждое действие заключать в скобки. Если в поле ''val'' указать имя переменной ''А'' без скобок - воспримется строка ''А'', если указать в скобках - воспримется значение переменной.

=== buy ===

'''(in-app совершить in-app покупку)'''

При переходе в состояние, данная команда открывает системное окно с предложением совершить in-app покупку. В зависимости от действий игрока, покупка может произойти (успех) или не произойти (провал).

* '''id покупки''' - внутренний id покупки для приложения, указывается в объекте [[Store]];
* '''объект(успех)''' - объект, которому сообщается об удачной покупке;
* '''состояние(успех)''' - состояние в которое переводится выбранный объект в случае успешной покупки;
* '''объект(провал)''' - объект, которому сообщается о неудачной покупке;
* '''состояние(провал)''' - состояние в которое переводится объект в случае неудачной покупки.

=== download ===

'''(скачать загружаемый контент)'''

При переходе в состояние будет совершена попытку закачать контент.
* '''url''' - ссылка на zip архив с контентом в интернете.
* '''объект успех''' - объект, которому в случае успешной закачки будет задаваться указанное состояние.
* '''состояние (успех)''' - состояние, которое будет устанавливаться выше указанному объекту, в случае успешной закачки.
* '''объект (провал)''' -объект, которому, в случае неудачи закачки, будет устанавливаться указанное состояние.
* '''состояние (провал)''' - состояние, которое, в случае неудачи закачки,будет устанавливаться выше указанному объекту.
* '''счетчик прогресса''' - объект, типа счетчик, который отображает прогресс закачки контента. Крайне желательно, что бы он измерялся в диапазоне от 0 до 100.

Существует несколько причин при которых вызывается состояние "провал". Для того что бы сообщить пользователю, по какой именно причине возник провал закачки, следует идентифицировать причины провала. Это возможно сделать с помощью параметра
<pre>
downloadErrCode
</pre>
Ниже приведены значение параметра которые помогут вывести нужное текстовое сообщение :
<pre>
GCUSTOM_ERROR_CODE_ERROR_UNKNOWN = 1, //!< ошибка не классифицирована
GCUSTOM_ERROR_CODE_WIFI_DISABLED = 2, //!< отключен WIFI
GCUSTOM_ERROR_CODE_SDCARD_UNAVAILABLE = 3, //!< SD-карта недоступна
GCUSTOM_ERROR_CODE_SDCARD_FULL = 4, //!< SD-карта переполнена перед закачкой
GCUSTOM_ERROR_CODE_UNZIP_FAIL = 5 //!< ошибка при распаковки пака (скорее всего на SD-карте не
хватает места для распаковки
</pre>

== Процессы ==

Все команды процессов, кроме параметров описанных ниже, могут содержать параметры, совпадающие с именами других команд. В этих параметрах указывается номер (начиная с нуля) команды, которую надо запустить на выполнение, после окончания действия данной команды процесса.

Если в команде процесса есть условие '''[[#if|if]]''', то после окончания работы команды она ждет пока это условие не выполнится. Только после этого переходит к следующей команде этого же типа
или в другое состояние (если есть параметр go).
Исключением является команда wait, которая '''не''' ждёт срабатывания '''[[#if|if]]'''. Если он по окончанию wait сработал, то происходит переходит в другое состояние, если есть параметр go.
Если параметра go нет, то в любом случае запускается следующий wait (т.е. if относится только к переходу go).

=== wait ===

Команда паузы (временной задержки). Если параметра '''t''' нет, то срабатывает сразу.
Может также использоваться для логических ветвлений, случайных переходов в другие состояния и т.д.

* '''t''' - длительность выполнения команды в ms;
* '''dt''' - интервал от t-dt до t+dt, внутри которого команда может быть случайно прервана (при t>t+dt прерывается в любом случае);
* '''p''' - вероятность срабатывания перехода в состояние, указываемое параметром go;
* '''go''' - состояние, в которое нужно перейти поле окончания времени и срабатывания условия [[#if|if]], если оно указано;
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go;
* '''loop''' - зациклить команды;
* '''break''' - прервать выполнение команд wait на этой команде (запустить их снова можно из команд процессов).
* '''init''', '''set''', '''draw''', '''move''', '''rot''', '''alpha''', '''scale''', '''phys''' - Номер запускаемой команды.
Простейший набор параметров команды wait выглядит следующим образом:
<pre>
<wait t="1000" go="next"/> // ждем 1000ms и покидаем состояние
</pre>
Для программирования объектов со случайным поведением можно использовать последовательность команд wait с параметром вероятности перехода p (от 0 до 1):
<pre>
<wait t="100" p="0.5" go="st1"/> // через t с вероятностью 1/2 перейдет в st1
<wait go="st2"/> // иначе, перейдем в st2
</pre>
Этот же синтаксис позволяет делать состояния с различным временем жизни:
<pre>
<wait t="100" p="0.5" go="next"/> // с вероятностью 1/2 живем 100ms
<wait t="100" go="next"/> // или 200ms
</pre>
Впрочем, последнюю задачу можно решить при помощи указывания интервала dt, внутри которого произойдет окончание команды. Так, состояние, живущее от 800 до 1200ms, реализуется следующим образом:
<pre>
<wait t="1000" dt="200" go="next"/>
</pre>

=== move ===

Перемещение по сцене:
* '''tx''', '''ty''' - целевые координаты в пикселях, к которым должен переместиться объект. Можно указывать переменные заданные с помощью [http://ge.absolutist.com/index.php/Machine#var_2 переменной var];
* '''dx''', '''dy''' - величина смещения от текущей (если есть - tx,ty игнорируются); можно задавать смесь tx, dy или dx,ty;
* '''v''' - скорость перемещения в пикселях в секунду; для фреймовой анимации, например, ходьбы скорость рассчитывается исходя из длительности одного кадра и числа кадров на фазу движения. Поэтому, в этом случае, удобнее задавать скорость;
* '''t''' - время перемещения (v игнорируется);
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени;
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду move, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды;
* '''break''' - прервать команды - Прервать выполнение команд move на этой команде (запустить их снова можно из команд процессов).
* '''init''', '''set''', '''draw''', '''move''', '''rot''', '''alpha''', '''scale''', '''phys''' - Номер запускаемой команды.

В большинстве команд процессов, связанных с движением, величина изменения может быть задана в абсолютных или относительных величинах. Так, могут быть указаны целевые координаты tx, ty в которые надо переместиться, или смещение dx, dy относительно текущего положения объекта.

Аналогично, скорость перемещения регулируется, либо явным заданием времени выполнения команды t, либо скоростью v. Исходя из требуемого расстояния, по этой скорости вычисляется необходимое время. Скорость задается в пикселях за секунду (а не миллисекунду!)

=== rot ===

Вращение объекта вокруг точки пивота с координатами px,py. Эти координаты задаются относительно верхнего левого угла объекта в общей секции описания параметров объекта или командой init в данном состоянии.
* '''ta''' - целевой угол поворота объекта;
* '''da''' - на сколько надо повернуться (ta игнорируется);
* '''v''' - угловая скорость поворота в градусах в секунду;
* '''t''' - время поворота (v игнорируется);
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду rot, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды;
* '''break''' - прервать команды - Прервать выполнение команд rot на этой команде (запустить их снова можно из команд процессов).
* '''init''', '''set''', '''draw''', '''move''', '''rot''', '''alpha''', '''scale''', '''phys''' - Номер запускаемой команды.

Угол отсчитывается от оси x. Если он положителен, то поворот происходит по часовой стрелке. Если отрицательный - против часовой.

=== alpha ===

Изменение прозрачности объекта. Меняется от 0 (полностью прозрачен) до 1 (непрозрачен)
* '''ta''' - целевая прозрачность
* '''da''' - на сколько надо изменить прозрачность от текущей (ta игнорируется)
* '''v''' - скорость изменения прозрачности (в долях единицы в ms)
* '''t''' - время изменения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду alpha, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд alpha с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд alpha на этой команде (запустить их снова можно из команд процессов).
* '''init''', '''set''', '''draw''', '''move''', '''rot''', '''alpha''', '''scale''', '''phys''' - Номер запускаемой команды.

Если у объекта прозрачность ''al=0.00'', то он невидим для всякого взаимодействия. Если у объекта прозрачность ''al=0.01'', то он видим для клика, но невидим для дропа(команда drop на объект не видит объект с прозрачностью ''0.01''). Если у объекта ''al=0.02'', то он видим и для клика, и для дропа.

=== scale ===

Изменение размеров объекта
* '''tx''', '''ty''' - целевой масштаб по каждой оси
* '''dx''', '''dy''' - на сколько изменить масштаб по каждой оси
* '''v''' - скорость изменения масштаба (в долях единицы в сек.)
* '''t''' - длительность выполнения команды (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду scale, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд scale с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд scale на этой команде (запустить их сново можно из команд процессов).
* '''init''', '''set''', '''draw''', '''move''', '''rot''', '''alpha''', '''scale''', '''phys''' - Номер запускаемой команды.

=== phys ===

Команда phys позволяет имитировать простую физику. В ней задается начальная скорость и действующая на объект сила (ускорение).

* '''vx''', '''vy''' - начальная скорость
* '''ax''', '''ay''' - величина ускорения по каждой оси
* '''a''' - полное ускорение
* '''tvx''', '''tvy''' - целевая скорость
* '''tx''', '''ty''' - целевая координата
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду phys, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд phys с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд phys на этой команде (запустить их снова можно из команд процессов).
* '''init''', '''set''', '''draw''', '''move''', '''rot''', '''alpha''', '''scale''', '''phys''' - Номер запускаемой команды.

Рассмотрим подпрыгивающий мячик, который при касании с землей деформируется (вертикально сплюскивается). Это можно сделать в 3 состояния (падаем, касаемся и взлетаем). Первоначально мячик находится в координате y=-100, и имеет высоту картинки w=60. Падает он до координаты ty=0. При касании с землёй, мяч сжимается на 20 процентов (sy=0.8). При этом его центр должен опуститься на dy=0.8*w/2 = 24.
<pre>

<st id="down"> // падаем
<phys vy="0" ay="20" ty="0" go="touch"/>
</st>

<st id="touch"> // касаемся земли
<move dy="24" t="300"/> // опускаем центр при сжатии
<scale ty="0.8" t="300"/> // сжимаемся
<move dy="-24" t="300"/> // поднимаем центр при разжатии
<scale ty="1" t="300" go="up"/> // разжимаемся
</st>

<st id="up"> // взлетаем
<phys vy="0" ty="-200" go="down"/>
</st>

</pre>
Напомним, что если объект имеет начальную скорость взлета, равную v=sqrt(2*ay*h), то он подпрыгнет на высоту h. Однако, в данном случае, вместо задания начальной скорости при взлете, мы задаем целевую координату (ty), до которой мяч должен подпрыгнуть.

=== rgb ===

* '''trgb''' - целевой эффект rgb; подразумевает под собой цвет в виде HEX-кода; по-умолчанию: FFFFFF;
* '''t''' - длительность выполнения команды в ms;
* '''go''' - состояние, в которое нужно перейти поле окончания времени и срабатывания условия [[#if|if]], если оно указано;
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go;
* '''loop''' - зациклить команды;
* '''break''' - прервать выполнение команд wait на этой команде (запустить их снова можно из команд процессов).
* '''init''', '''set''', '''draw''', '''move''', '''rot''', '''alpha''', '''scale''', '''phys''' - Номер запускаемой команды.

=== spline ===

Сплайн позволяет перемещать машину по заранее заданной траектории.

====Параметры====

*'''key''' - точки сплайна по которым движется
*'''t''' - время движения по траектории
*'''go''' - по окончанию переход в состояние
*'''if''' - условие перехода
*'''loop''' - количество повторений
*'''break''' - прервать команды на этой
*'''wait''' - номер запускаемого действия
*'''init''' - номер запускаемого действия
*'''alpha''' - номер запускаемого действия
*'''rot''' - номер запускаемого действия
*'''move''' - номер запускаемого действия
*'''set''' - номер запускаемого действия
*'''phys''' - номер запускаемого действия
*'''scale''' - номер запускаемого действия
*'''drow''' - номер запускаемого действия

====Построение сплайна====

# в состоянии машины добавляем правой кнопкой мыши действие "spline"
# добавляем минимально необходимые параметры: '''key''' и '''t''', указываем время движения в '''t'''
# выделяем для редактирования поле '''key'''
# записываем координаты точек через запятую, сначала x потом y, например: -211,-248,-151,-248,-91,-247,59,-246,60,101,60,159,1,190
Если записали все координаты вручную, то можно сохранить и проверять.
Или можно в окне списка состояний нажать на кнопку "build spline" (справа вверху).
[[Файл:Btn spline.jpg|500px]]

Окно с списком состояний закроется, появится дополнительная панель с настройками сплайна и появится возможность указывать мышкой по экрану точки для сплайна.

[[Файл:Spline panel.jpg|500px]]

Точки сплайна указываются кликом левой кнопки мыши по экрану.

Возможности редактирования:

'''режимы:'''
*'''add''' - по нажатию левой кнопкой мыши по экрану - будет добавлена новая точка, которая соединится с предыдущей
*'''select''' - по нажатию левой кнопкой мыши по точке сплайна появится возможность отредактировать её положение перетащив её или поменяв её координаты в полях x и у
*'''delete''' - по нажатию левой кнопкой мыши по точке сплайна точка удалится

Чтобы удалить все точки сплайна необходимо нажать на кнопку "'''delete all knots'''"

Сохранить сплайн можно нажав на кнопку "'''Save spline'''"

====Дополнительные сведения====

* Время движения между двумя соседними точками всегда одинаково, то есть чем дальше друг от друга соседние точки, тем быстрее будет двигаться объект, чем ближе - тем медленней.
* Координаты сплайна просчитываются относительно точки пивота родительского объекта, если соответствующая машина является подобъектом. На координаты могут влиять модификаторы родительского объекта.

== Воздействия ==

=== click ===

Команда вызывается, если на объект кликнули мышкой. Срабатывает на её нажатие.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

По клику машина записывает координаты клика в параметры: clickX, clickY.

=== touch_in ===

Наведение мыши/пальца на машину, если палец "тащат" по экрану.
* '''go''' - состояние в которое при выполнении команды нужно перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход ''go''.

=== touch_out ===
Выведение мыши/пальца из машины, если палец "тащат" по экрану.
* '''go''' - состояние в которое при клике нужно перейти;
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при котором срабатывает переход ''go''.

=== touch_up ===

Отжатие мыши от машины

* '''go''' - состояние в которое при отжатии мыши нужно перейти;
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при котором срабатывает переход ''go''.

=== mouse_in ===

Срабатывает при наведение мыши/пальца на машину даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды нужно перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход ''go''.

=== mouse_out ===
Срабатывает при выведение мыши/пальца из машины даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды нужно перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход ''go''.

=== drag ===

Данная команда позволяет "таскать" объект по сцене нажав и удерживая клавишу мишки или (палец в случае сенсорного устройства) на нем.Так же есть возможность ограничить разрешенную область таскания, за пределы которой объект вытащить невозможно. [[Файл:drag.jpg|right]]
* '''x1''' - разрешено таскать, когда координата объекта правее;
* '''x2''' - разрешено таскать, когда координата объекта левее;
* '''y1''' - разрешено таскать, когда координата объекта ниже;
* '''y2''' - разрешено таскать, когда координата объекта выше;
* '''if''' - номер команды условия (начиная с нуля) разрешения таскания;
* '''obj''' - объект у которого надо изменить состояние;
* '''st''' - новое состояние объекта obj;
* '''за пивот''' - "да" - таскать объект за пивот, "нет" - за ту точку, за которую схватили
* '''приклеивать''' - приклеивать при клике к мышке.

=== dragRot ===

Данная команда позволяет вращать объект вокруг точки пивота. Нажав и удерживая клавишу мишки или палец (в случае сенсорного устройства) на нем, мы можем вращать его по часовой либо против часовой стрелки. При многократном вращении вокруг своей оси значение его угла не накапливается, а обнуляется выходя за границы [360 ; -360] градусов. [[Файл:dragRot.jpg|right]]
* '''if''' - номер команды условия (начиная с нуля) разрешения таскания;
* '''obj''' - объект у которого надо изменить состояние;
* '''st''' - новое состояние объекта obj;
* '''maxVel''' - Максимальная скорость вращения градус/сек;
* '''objStart''' - объект при начале вращения;
* '''stStart''' - его новое состояние;
* '''objEnd''' - объект при завершении вращения;
* '''stEnd''' - его новое состояние;

=== drop ===

Если нажатая кнопка мышки отпускается, вызывается эта команда. Обычно она используется в связке с командой drag
* '''obj''' - объект, на который надо уронить таскаемый объект;
* '''go''' - состояние в которое переходим при отпускании мышки;
* '''if''' - номер (начиная с нуля) условия [[#if|if]] разрешения бросания.

Рассмотрим совместное применение команд drag и drop на следующей задаче. Пусть есть ключ и ящик. Ключ можно взять мышкой и перетащить, бросив на ящик. Ящик при этом должен постепенно стать прозрачным, а ключ уменьшиться до нуля. Машина состояний для ключа выглядит следующим образом:
<pre>

<st id="drag">
<drag x1="-350" x2="350" y1="-250" y2="250"/>
<drop obj="box" go="open"/>
</st>

<st id="open">
<set obj="box" st="open"/>
<scale tx="0.01" ty="0.01" t="500" go="hide"/>
</st>

<st id="hide">
<init x="268" y="30"/>
<scale tx="1" ty="1" t="500" go="drag"/>
</st>

</pre>
Ящик:
<pre>

<st id="close"> // начальное состояние ящика
<init al="1"/> // если его кто-то сюда переведет - он появится.
</st>

<st id="open">
<alpha ta="0" t="500"/> // исчезает по прозрачности за 500 ms
</st>

</pre>

====Использование свойства "Условие перехода" ====

Можно прописать условие, при котором выполняется переход при дропе.
[[Файл:Drop_if.png|300px|thumb|right]]

С помощью этого условия мы можем научить наш объект выполнять разные задачи в зависимости от того, как именно его дропнули.
Пусть есть объект который можно таскать. Когда объект не таскается должен быть включен флаер, привязанный к этому объекту. При клике на объект, он должен поворачиваться на 90 градусов. При дропе на соответствующую маску объект стает на свое место(Если выполнены условия, к примеру: установлен предыдущий объект и наш объект имеет правильный угол). Если дроп в любое другое место, то должен включится флаер.

Для того, чтобы научить машину различать клик по ней и ее таскание сделаем следующее. Пропишем ей 2 состояния: click и drag, а также выставим ей параметр "хранить нажатость" = 1. В click будем вычислять координаты объекта и записывать объекту параметр допустимого смещения при котором таскание будет восприниматься как клик. (В данном примере эти параметры: cx, cy, vx, vy. А допустимое смещение составляет 10 пикселей.)

В состоянии drag будем проверять попадает ли координата объекта при дропе в границы допустимого смещения. Для того чтобы сравнить параметр объекта с переменной, вычтем из нашего объекта, то что мы записали в click. В зависимости от условий и места дропа переходим в соответствующее состояние.

[[Файл:Click.png|330px]] [[Файл:Drag st.png|630px]]

=== throw ===

Если на объект наступили мышкой, не отпуская кнопки, мышку оттащили и затем отпустили, вызывается команда throw со следующими параметрами:
* '''go''' - состояние, в которое, при клике, надо перейти;
* '''if''' - номер (начиная с нуля) команды [[#if|if]] разрешения бросания;
* '''force''' - получаемая скорость равна разнице пикселей от начала бросания (мышь нажата) до его конца (мышь отжата), умноженная на этот параметр. По умолчанию он равен 1.

Сработав, эта команда задает начальные значения скорости для команды phys, поэтому должна использоваться совместно с ней (см. ниже пример).

=== tap ===

* '''go''' - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) условия [[#if|if]] разрешения бросания.

=== apply ===

Вызывается, если данная машина пересеклась с другой. Обычно используется в совокупности с throw, move, phys, drag.
* '''obj''' - сработает , если пересеклись с этим объектом;
* '''x1''' - сработает, если центр объекта левее этого x-са;
* '''x2''' - сработает, если центр объекта правее этого x-са;
* '''y1''' - сработает, если центр объекта выше этого y-ка;
* '''y2''' - сработает, если центр объекта ниже этого y-ка;
* '''rm''' - радиус этой машины (если rm=0, то она считается прямоугольной)
* '''ro''' - радиус объекта obj (если ro=0, то он считается прямоугольным)
* '''st''' - состояние, в которое надо перевести объект obj
* '''go''' - состояние, в которое надо перейти при срабатывании;
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]] разрешения применения команды apply.

[[Файл:Апплай.png|500px]]

Блок схема работы '''apply'''

[[Файл:Блок схема apply.png|500px]]

* Сначала у нас проверяется координаты '''x1''', '''x2''', '''y1''', '''y2'''.
* Далее проверяет если '''obj'''
* Если '''obj''' нет, то идёт проверку, и выдаёт результат
(если при этом если '''x1''', '''x2''', '''y1''', '''y2''' нет, то они считаются по ширине и высоте всего экрана.)
* Если есть '''obj''', то проверяет есть ли радиусы '''rm''', '''ro'''.
* Если он есть, то значит у нас '''apply''' по кругам
* Если нет, то проверяем наличие '''x1''', '''x2''', '''y1''', '''y2'''.
* Если они есть, то проверка и результат.
* Если их нет, то проверка идёт по шейпам объектов, и выдаётся результат/
Если не будет стоять ни каких галочек, то проверка будет идти по шейпам объектов.

Пусть, например, есть снаряд, который при помощи мышки надо кинуть в "тыкву". Если мы промахнулись, снаряд должен вернуться обратно, а с тыквой ничего не произойти. Если мы в тыкву попадаем, снаряд также возвращается, а тыква "взрывается":
<pre>

<st id="trow">
<init x="-350" y="150"/> // начальное положение
<throw go="fly"/> // бросаем
</st>

<st id="fly">
<phys ay="100"/> // летим
<apply y2="300" go="throw"/> // с землей
<apply obj="тыква" rm="8" ro="10" st="bang"/> // с тыквой
</st>

</pre>

== Условия ==

=== if ===

В состоянии может быть произвольное число команд if. Их номера (начиная с нуля) указываются
в параметре if других команд. Эти номера можно соединять при помощи логических связок:
* '''&''' - логическое '''и''' (вместо значка '''&''' можно использовать запятую ''',''');
* '''|''' - логическое '''или''';
* '''!''' - логическое '''не'''.
Пример записи логического выражения в поле if некоторой команды: '''(1&2)|(3&(!4))''',
что означает: выполняется if под номером 1 и под номером 2, или под номером 3 и не под номером 4.

Логические связки используются также как математической логике или любом языке программирования.
Так:
* A '''&''' B - истинно, если истинны оба условия A и B;
* A '''|''' B - истинно, если истинно хотя бы одно условие (или оба);
* '''!''' А - истинно, если условие A ложно.
Скобки в логическом выражении определяют приоритет (порядок) выполнения логических операций.
Отметим несколько тождеств, справедливых при формировании логических высказываний:
* !(A & B) = (!A) | (!B)
* !(A | B) = (!A) & (!B)
* !(!A) = A

Если при формировании условия (ниже) есть несколько проверок, то они соединены логическим '''и'''.
Т.е., если хотя бы одна из них не выполняется, то считается, что условие не выполнилось.

Параметры команды:
* '''obj''' - находится ли объект obj в состоянии st или имеет ли его параметр par значение val. В этом поле можно указать this, это значит что if будет проводить проверку текущего объекта. Добавлено это вместе с параметром clone. Клоны рождаются и умирают в рамках одного экрана. Для различия клонов между собой машина имеет уникальный параметр "clone_num" у оригинала = -1, у клонов от 0 до N, собственно с помощью this машина может сама себя проверить клон ли она и если да то какой у нее номер;
* '''st''' - имя состояния в котором может находиться объект obj;
* '''par''' - имя параметра объекта obj, значение которого сравнивается с полем val;
* '''val''' - значение параметра par, которое проверяется у объекта obj;
* '''val_txt''' - Значение текстового параметра объекта для проверки условия;
* '''val_res''' - Значение ресурсного параметра объекта для проверки условия;
* '''op''' - операция сравнения par op val. Если операции нет, то предполагается проверка на равенство par=val. Иначе используются операторы:
** '''<''' - меньше (par < val);
** '''>''' - больше (par > val);
** '''!=''' - не равно (par != val);
** '''<>''' - не равно (par <> val);
** '''>=''' - больше или равно (par >= val);
** '''<=''' - меньше или равно (par <= val);
* '''curScr''' - если текущий экран совпадает с этим, то условие выполнилось;
* '''prScr''' - если предыдущий экран совпадает с этим, то условие выполнилось;
* '''wasScr''' - если был (когда либо) этот экран, то условие выполнилось.
* '''buy''' - был ли куплен данный inn-app (проверяется флаг поля в объекте [[Options]]);
* '''url''' - валиден (правилен и может быть запущен) ли данный интернет-адрес;
* '''is_mus''' - играет ли сейчас музыка (значение 1);
* '''guest''' - объект который установил состояние (используется вместо параметра obj). Если указанный объект не менял состояние этой машины, то условие не срабатывает.

Если использовать obj, par, val, то будет происходить проверка на равенство значения параметра объекта и значения записанного в поле val.
Если же использовать obj, par, op, val, то будет происходить проверка в соответствии с операцией сравнения значения параметра объекта и значения записанного в поле val.

Для проверки текущего значения прозрачности у объекта можно воспользоваться параметром ''cur_al''

У машины (другой или самой себя) можно проверить текущее состояние '''st''' и предыдущее состояние '''prev_st''', эти параметры живут на время сессии.

== Математика ==

=== Основные математические операции ===
Математика в appsalute creator представлена 6-ю основными операциями: (плюс), (минус), (умножить), (поделить), (целочисленное деление), (остаток от деления) 
Организована благодаря совместному использованию '''[[#var|var]]''' и '''[[#set|set]]'''.
[[Файл:Example_mod.png|300px|right|Пример использования операции остатка от деления]]
''(плюс)'' '''+''' 
''(минус)'' '''-''' 
''(умножить)'' '''*''' 
''(поделить)'' '''/''' 
''(целочисленное деление)'' '''\''' 
''(остаток от деления)'' '''%''' 
 
Примеры использования последних двух операций: 
5\2=2 
5%2=1 

=== var ===
Благодаря использованию '''[[#var|var]]''' существует возможность cчитать любой числовой параметр любого объекта. Например: x - координату какой-то машины, текущее значение любого объекта counter или timer и конечно же считывание значения любого параметра из опций! Каким образом это устроено? Рассмотрим подробнее '''[[#var|var]]''': 
[[Файл:VAR.png|right]]
*'''name''' - здесь выбираем имя для нашей будущей переменной, которой будем оперировать далее
*'''obj''' - выбирается объект, параметры которого мы хотим считать
*'''par''' - параметр, который нужно вычитать из объекта, указанного выше
*'''val''' - указывается числовое значение, которое будет установлено по умолчанию в случае отсутствия obj и par
*'''user''' - если стоит "1", то будет считываться с текущего профиля в опциях
На изображении справа можно наблюдать каким образом организован '''[[#var|var]]'''. В данном случае объявлена переменная x_cor, которая считывает x-координату объекта actor_1, при этом считывание переменной происходит из текущего профиля, так, как в поле user установлено значение равное "1".

=== set ===
[[Файл:SET.png|right]]
Использование '''[[#var|var]]''' без '''[[#set|set]]''' не имеет смысла. Так, как переменная создается, но не используется дальше. Рассмотрим следующий пример, где вычитаем x - координату из одного объекта и сохраним ее в опции, предварительно увеличив ее на 50 единиц (в данном случае 50 пикселей).
На рисунке справа можно наблюдать, каким образом это сделано. В состоянии '''init''' объявляется переменная '''x_cor''', которая считывает координату '''x''' из объекта '''actor_1''', таким образом в переменную '''x_cor''' запишется положение по '''x''' объекта '''actor_1'''. Поле '''user''' в данном случае в '''1''' не обязательно устанавливать, так как работа ведется с машинами, а не с опциями. Если бы на месте '''actor_1''' оказался объект '''options''', то это было бы просто необходимо, иначе программа считает значение не из профиля. Далее в '''[[#set|set]]''' выбран объект '''options''', в параметр '''x_position''' которого будет сохранятся значение переменной '''x_cor''' увеличенной на 50. В поле '''round''' идет округление вычисляемого значения, если оно установлено в 1. Поле '''user ''' установлено в 1, это значит, что параметр '''x_position''' будет сохранен в профиль. После это выполняется сохранение опций путем задания объекту '''options''' состояния '''save'''. 
! ! !ВАЖНО: чтобы выполнить какие-то действия с '''[[#var|var]]''' его обязательно нужно указывать в поле '''val''' в '''set''', при этом, если он используется, то все выражение должно стоять в скобках. Если в поле '''val''' не используется переменная, то скобки необязательны.
 
 
Существует также возможность использовать '''[[#var|var]]''' совместно с '''[[#if|if]]''', а также '''[[#var|var]]''' с '''[[#move|move]]'''
 
Так же добавилась возможность записывать значение переменной в состояние "st", что значительно уменьшает
необходимость в записи 1000 if-ов. При этом, тип переменной в '''[[#var|var]]''' должен быть "строка".
И добавилась возможность записи переменной boolean: ((a)==(b)). true = 1, false = 0. Довольно полезная вещь,
если не хотите забивать "память" ненужной математикой.

=== var и if ===
[[Файл:IF.png|right]]
При подробном рассмотрении '''[[#if|if]]''' можно заметить, что в нем есть поле '''val''', соответственно в этом поле можно указать переменную. Таким образом в поле '''val''' необязательно указывать константу, а можно указать какую-то переменную, которая может постоянно изменяться. Например, существует два объекта, один находится состоянии покоя, а другой находится в движении. При этом первый объект (тот, который в состоянии покоя) постоянно опрашивает положение второго объекта, и в случае, если у объекта, который движется, '''х''' координата равна '''х''' координате первого объекта, то первый объект входит в состояние, где он начинает свое движение. На рисунке показан объект, который находится в состоянии покоя, рассмотрим его состояния: 
В данном объекте существует два состояния: '''init''' и '''move'''. В '''init''' объект опрашивает другой объект и в случае, когда условие срабатывает, то переходит в состояние '''move''', где начинает свое движение.
В '''init''' создаем переменную, в которую записываем положение по '''x''' объекта '''actor_2''', в '''if''' проверяется условие на соответствие координат объектов '''actor_1''' и '''actor_2''', в данном случае координата объекта '''actor_2''' представлена в виде переменной '''x_cor'''. Если условие выполняется, то происходит переход в состояние '''move''', если нет, то заново проходим состояние '''init''' и повторяем вышеописанную последовательность действий.
 
 
 
 

=== var и move ===
Также с помощью '''[[#var|var]]''' есть возможность указать целевые координаты в '''[[#move|move]]'''. То есть, не обязательно указывать целевые координаты в виде констант, их можно указать теперь с помощью переменных. При использовании '''[[#var|var]]''' и '''[[#move|move]]''' можно организовать обмен двух объектов местами с анимацией движения. Для этого необходимо определять какой объект нажат первым, а какой вторым, сохранять их координаты через объект '''options''' и только потом менять их местами. На рисунке можно увидеть, как это организовано.
[[Файл:var_move.png|1000px|thumb|center|]]
Рассмотрим подробнее состояние данной машины:
 
* '''init''' 
В этом состоянии ожидаем клик на объект и обнуляем параметр, который отвечает за то, какой по счету объект сейчас нажат. Так, как при обмене объектов, если мы делаем это по клику, важно знать, по какому кликнули первым, а по какому вторым.
* '''check''' 
Проверяется параметр '''number''', если он равен '''0''', то это значит, что еще ничего не кликали и мы переходим в состояние, где в опции записываются координаты этого объекта, который считается нажатым первым. Если не равен '''0''', то считается, что этот объект нажат вторым и переходит в состояние, где в опции записываются координаты этого объекта, который считается нажатым вторым по счету.
* '''first_object''' 
В этом состоянии записываются координаты объекта в опции. Чтобы записать координаты в опции используются '''[[#var|var]]''' и '''[[#set|set]]''' упоминаемые выше. В опции координаты первого нажатого объекта сохраняются под параметрами '''x_first''' и '''y_first'''. В конце параметру '''number''' присваиваем значение '''1''', чтобы указать, что следующий нажатый объект будет вторым по счету.
* '''second_object''' 
В этом состоянии объект будет в том случае, если он будет нажатым вторым по счету, то есть после состояния '''check''' объект попадет в это состояние, где он запишет свои текущие координаты под параметрами '''x_second''' и '''y_second'''. Запись координат происходит таким же самым образом, что и в состоянии '''first_object'''. После этого он автоматически переходит в следующее состояние.
* '''move_first''' 
В этом состоянии объект будет в том случае, если он был нажат первым, поэтому он будет двигаться на место второго нажатого объекта, который сохранил свои координаты в параметры'''x_second''' и '''y_second'''. Движение происходит следующим образом: сперва в переменную вычитываем координаты второго объекта, а потом в '''move''' вместо целевых координат записываем переменные, которые обязательно должны быть взяты в скобки.
* '''move_second''' 
В этом состоянии объект будет в том случае, если он был нажат вторым, поэтому он будет двигаться на место первого нажатого объекта, который сохранил свои координаты в параметры '''x_first''' и '''y_first'''. Движение происходит следующим образом: сперва в переменную вычитываем координаты первого объекта, а потом в '''move''' вместо целевых координат записываем переменные, которые обязательно должны быть взяты в скобки.

В результате проделанных манипуляций с машинами по кликам на две машины, они обменяются местами с анимацией движения. Это может быть очень полезным во многих мини играх!!!

=== Важно знать ===
* Переменная действует в рамках одного состояния, если нужно, чтобы она была глобальной, нужно сохранить ее в опции и потом в нужный момент считывать ее из опций.
* Если складываем два числа, то в поле '''val''' они должны быть записаны в скобках: (5+3).
* Если возникает необходимость написать какое-то более сложное арифметическое вычисление, то следует помнить, что на одно действие приходятся одни скобки. Например: (((5+3)\2)*2).
* Количество открывающих и закрывающих скобок должно быть одинаковым.
* В скобках можно писать переменную, если она была объявлена выше: (5+a).
* Переменная может состоять из цифр и букв и знака нижнего подчеркивания.
* Иногда бывает необходимым использование '''round''' в '''set''', так например, если какой-то параметр получен с помощью арифметических вычислений и потом используется его в каком-то условии, и условие проверяет параметр, как целочисленное значение, то могут возникнуть ошибки. Так, как число будет записано в следующем виде 123.0000 и программа будет считать, что оно не целочисленное, а дробное. И чтобы избавится от лишних нулей в дробной части следует округлять число.
* Действия, которые требуют времени, такие как move, rot, wait и другие перестают работать для уменьшения вычислительной нагрузки на устройство.
* Действия, которые не требуют времени, такие как set, init и другие продолжают функционировать.

<pre>
Если с помощью переменной менять объекту любой параметр, например, координату X, то она
запомнится (запишется как значение по умолчанию).
Тогда при повторном попадании на экран считается не тот X, который указан в свойствах,
а тот, который установлен через переменную.
Если нужно при ините экрана возвращать начальные значения параметров,
то можно сделать это двумя способами:
- не использовать переменную;
- создать отдельное состояние, которое будет "вручную" устанавливать начальные значения
параметрам при ините экрана.
Если координата (или другой параметр) меняется другим способом, то будут автоматически
при ините экрана подтягиваться значения из свойств объекта.
</pre>

=== Примеры применений ===
С помощью математики можно организовать следующее:
* динамические опции (изменение звука и музыки с помощью ползунка);
* анимацию каунтера в играх (по окончанию уровня можно наблюдать, как изменяются очки);
* подсчет очков (гибкая система подсчета очков);
* обмен объектов местами (использование var и move)
* увеличение z-координаты любого объекта (когда необходимо, чтобы нажатый или таскаемый объект был выше других по z);
* простейший калькулятор;
* и много других.

== Копирование машины состояния с сохранением ссылки на себя ==
Довольно часто бывает, что машина состояний ссылается только на глобальные объекты и на саму себя. При этом, если мы просто скопируем объект, он будет ссылаться на свою предыдущую копию. Этого можно избежать, сделав 3 шага:
1. Переместить объект в отдельную сцену
2. Скопировать данную сцену(имеется в виду обычное копирование, без ссылки)
3. Перенести объект и его копию обратно, в нужную сцену
4. Созданные сцены можно удалить :)

== Guest ==

'''Guest (гость)''' - объект, который перевел машину в текущее состояние. Пример: кнопка ''btn1'' по клику переводит машину ''mch1'' в состояние ''st1'', в этом состоянии у машины ''mch1'' гостем является кнопка ''btn1''. Гостем может быть объект любого типа, если он может менять состояние другому объекту (например: хидден-объект по нахождению может менять состояние объекту, кнопка, машина, пэчворк и т.д.)

В машине состояний можно считывать (проверять) и передавать параметры и состояния гостя. Любое поле ''obj'' в выпадающем списке содержит строку ''guest'', что позволяет работать с гостем, как с любым другим объектом.

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

[[Файл:Guest1.jpg|left]]
Пускай экран содержит 3 кнопки (''btn1'', ''btn2'' и ''btn3'') и одну машину ''mch1''. Нужно сделать так, чтобы по клику на любую из кнопок машина перемещалась в ее координаты и переводила кнопку в состояние ''disable''. Так же по клику на кнопку ''btn2'', машина должна перейти в состояние ''bonus''. 
Всем трем кнопкам по клику пропишем передавать объекту ''mch1'' состояние ''check''. 
Создадим в машине три состояния: ''init'' - состояние в котором машина будет находиться по умолчанию, ''check'' - состояние, которое будет вызываться тремя кнопками, в этом состоянии у машины ''mch1'' одна из трех кнопок будет гостем, ''bonus'' - последнее состояние. 
Две команды ''var'' считывают у гостя координаты, т.к. мы не знаем, какая именно кнопка перевела машину ''mch1'' в состояние ''check'', то обращаемся к гостю, а не к кнопкам. За ними следует две команды ''set'', которые передают координаты гостя машине. Еще один ''set'' переводит гостя в состояние ''disable''. И через ''wait'' осуществляется переход в состояние ''bonus'', если гость ''btn2''.

<pre>
При смене состояния гость сохраняется, т.е. в состоянии bonus гостем останется btn2.
</pre>
<pre>
Если машина изначально сама себе меняет состояния, то у нее нет гостя.
</pre>

[[Файл:Guest2.jpg]]

== Массив (Array) ==

В данном объекте реализован массив, имеющий максимальную длину в 20 элементов.

=== Свойства объекта массив: ===

len - длинна массива. Длинна массива может как считываться, так и записываться. Влияет на количество сохраняемых объектов в Options.

index1 - индекс элемента. (данный массив можно расширить до многомерного и использовать несколько индексов)

val - значение элемента массива, с индексом index1

a1..a20 - внутренние элементы массива(обращаться можно через свойство par объекта). Предполагается, что пользователь редактора к ним обращаться напрямую не будет, однако иногда для удобства полезны.

=== Состояния объекта массив: ===

get - при вызове этого состояния во внутреннюю переменную val записывается значение элемента с индексом index1

set - при вызове этого состояния во внутреннюю переменную a1..a20, соответствующую индексу index1 записывается значение val

load - загрузить значения массива из xml.

save - сохранить элементы массива от 1 до len

=== Как использовать? ===

1. Загружаем массив, переводя объект array в состояние load

2. Записываем значения массива

а). Задаём значение свойству index1 объекта array (устанавливаем индекс ячейки, в которую будет заноситься число)
б). Задаём значение свойству val объекта array (устанавливаем значение, которое будет заноситься в ячейку
с индексом index1)
в). Переводим объект array в состояние set

3. Считываем значения массива
а). Задаём значение свойству index1 объекта array (устанавливаем индекс ячейки, из которой будет считываться число)
б). Переводим объект array в состояние get
в). Считываем значение из свойства val объекта array

4. Сохраняем массив, переводя объект array в состояние save. Если хотите изменить количество сохраняемых элементов - предварительно измените параметр len.

=== Копирование объекта ===

При копировании, необходимо заменить в состояниях load и save array.имя_параметра на другое имя. Например, array2.имя_параметра. Копировать следует через использование доп. сцены (см. выше)

=== Достоинства ===

Позволяет избежать необходимости каждый раз создавать большое количество if-ов и set-ов, если необходимо работать с нумерованным списком. Можно один раз создать структуру и копировать её неограниченное количество раз

=== Недостатки ===

Данный объект содержит довольно большое количество кода, поэтому при большом их обилии/длине может занизить скорость работы сцены и скорость загрузки сцены.

=== Исходный XML код===
Прим. id="369" - идентификатор объекта Options, сохраняющего все переменные приложения. id="7845" - идентификатор объекта

<pre>
<obj id="7845" type="machine" nm="array" sync="1" w="1" h="1">
<st id="init"/>
<st id="get">
<var nm="a1" obj="7845" par="a1"/>
<var nm="a2" obj="7845" par="a2"/>
<var nm="a3" obj="7845" par="a3"/>
<var nm="a4" obj="7845" par="a4"/>
<var nm="a5" obj="7845" par="a5"/>
<var nm="a6" obj="7845" par="a6"/>
<var nm="a7" obj="7845" par="a7"/>
<var nm="a8" obj="7845" par="a8"/>
<var nm="a9" obj="7845" par="a9"/>
<var nm="a10" obj="7845" par="a10"/>
<var nm="a11" obj="7845" par="a11"/>
<var nm="a12" obj="7845" par="a12"/>
<var nm="a13" obj="7845" par="a13"/>
<var nm="a14" obj="7845" par="a14"/>
<var nm="a15" obj="7845" par="a15"/>
<var nm="a16" obj="7845" par="a16"/>
<var nm="a17" obj="7845" par="a17"/>
<var nm="a18" obj="7845" par="a18"/>
<var nm="a19" obj="7845" par="a19"/>
<var nm="a20" obj="7845" par="a20"/>
<set obj="7845" par="val" val="(a1)" round="1" if="0"/>
<set obj="7845" par="val" val="(a2)" round="1" if="1"/>
<set obj="7845" par="val" val="(a3)" round="1" if="2"/>
<set obj="7845" par="val" val="(a4)" round="1" if="3"/>
<set obj="7845" par="val" val="(a5)" round="1" if="4"/>
<set obj="7845" par="val" val="(a6)" round="1" if="5"/>
<set obj="7845" par="val" val="(a7)" round="1" if="6"/>
<set obj="7845" par="val" val="(a8)" round="1" if="7"/>
<set obj="7845" par="val" val="(a9)" round="1" if="8"/>
<set obj="7845" par="val" val="(a10)" round="1" if="9"/>
<set obj="7845" par="val" val="(a11)" round="1" if="10"/>
<set obj="7845" par="val" val="(a12)" round="1" if="11"/>
<set obj="7845" par="val" val="(a13)" round="1" if="12"/>
<set obj="7845" par="val" val="(a14)" round="1" if="13"/>
<set obj="7845" par="val" val="(a15)" round="1" if="14"/>
<set obj="7845" par="val" val="(a16)" round="1" if="15"/>
<set obj="7845" par="val" val="(a17)" round="1" if="16"/>
<set obj="7845" par="val" val="(a18)" round="1" if="17"/>
<set obj="7845" par="val" val="(a19)" round="1" if="18"/>
<set obj="7845" par="val" val="(a20)" round="1" if="19"/>
<if obj="7845" par="index1" val="1"/>
<if obj="7845" par="index1" val="2"/>
<if obj="7845" par="index1" val="3"/>
<if obj="7845" par="index1" val="4"/>
<if obj="7845" par="index1" val="5"/>
<if obj="7845" par="index1" val="6"/>
<if obj="7845" par="index1" val="7"/>
<if obj="7845" par="index1" val="8"/>
<if obj="7845" par="index1" val="9"/>
<if obj="7845" par="index1" val="10"/>
<if obj="7845" par="index1" val="11"/>
<if obj="7845" par="index1" val="12"/>
<if obj="7845" par="index1" val="13"/>
<if obj="7845" par="index1" val="14"/>
<if obj="7845" par="index1" val="15"/>
<if obj="7845" par="index1" val="16"/>
<if obj="7845" par="index1" val="17"/>
<if obj="7845" par="index1" val="18"/>
<if obj="7845" par="index1" val="19"/>
<if obj="7845" par="index1" val="20"/>
</st>
<st id="set">
<var nm="val" obj="7845" par="val"/>
<set obj="7845" par="a1" val="(val)" round="1" if="0"/>
<set obj="7845" par="a2" val="(val)" round="1" if="1"/>
<set obj="7845" par="a3" val="(val)" round="1" if="2"/>
<set obj="7845" par="a4" val="(val)" round="1" if="3"/>
<set obj="7845" par="a5" val="(val)" round="1" if="4"/>
<set obj="7845" par="a6" val="(val)" round="1" if="5"/>
<set obj="7845" par="a7" val="(val)" round="1" if="6"/>
<set obj="7845" par="a8" val="(val)" round="1" if="7"/>
<set obj="7845" par="a9" val="(val)" round="1" if="8"/>
<set obj="7845" par="a10" val="(val)" round="1" if="9"/>
<set obj="7845" par="a11" val="(val)" round="1" if="10"/>
<set obj="7845" par="a12" val="(val)" round="1" if="11"/>
<set obj="7845" par="a13" val="(val)" round="1" if="12"/>
<set obj="7845" par="a14" val="(val)" round="1" if="13"/>
<set obj="7845" par="a15" val="(val)" round="1" if="14"/>
<set obj="7845" par="a16" val="(val)" round="1" if="15"/>
<set obj="7845" par="a17" val="(val)" round="1" if="16"/>
<set obj="7845" par="a18" val="(val)" round="1" if="17"/>
<set obj="7845" par="a19" val="(val)" round="1" if="18"/>
<set obj="7845" par="a20" val="(val)" round="1" if="19"/>
<if obj="7845" par="index1" val="1"/>
<if obj="7845" par="index1" val="2"/>
<if obj="7845" par="index1" val="3"/>
<if obj="7845" par="index1" val="4"/>
<if obj="7845" par="index1" val="5"/>
<if obj="7845" par="index1" val="6"/>
<if obj="7845" par="index1" val="7"/>
<if obj="7845" par="index1" val="8"/>
<if obj="7845" par="index1" val="9"/>
<if obj="7845" par="index1" val="10"/>
<if obj="7845" par="index1" val="11"/>
<if obj="7845" par="index1" val="12"/>
<if obj="7845" par="index1" val="13"/>
<if obj="7845" par="index1" val="14"/>
<if obj="7845" par="index1" val="15"/>
<if obj="7845" par="index1" val="16"/>
<if obj="7845" par="index1" val="17"/>
<if obj="7845" par="index1" val="18"/>
<if obj="7845" par="index1" val="19"/>
<if obj="7845" par="index1" val="20"/>
</st>
<st id="load">
<var nm="a1" obj="369" par="array.a1" user="1"/>
<var nm="a2" obj="369" par="array.a2" user="1"/>
<var nm="a3" obj="369" par="array.a3" user="1"/>
<var nm="a4" obj="369" par="array.a4" user="1"/>
<var nm="a5" obj="369" par="array.a5" user="1"/>
<var nm="a6" obj="369" par="array.a6" user="1"/>
<var nm="a7" obj="369" par="array.a7" user="1"/>
<var nm="a8" obj="369" par="array.a8" user="1"/>
<var nm="a9" obj="369" par="array.a9" user="1"/>
<var nm="a10" obj="369" par="array.a10" user="1"/>
<var nm="a11" obj="369" par="array.a11" user="1"/>
<var nm="a12" obj="369" par="array.a12" user="1"/>
<var nm="a13" obj="369" par="array.a13" user="1"/>
<var nm="a14" obj="369" par="array.a14" user="1"/>
<var nm="a15" obj="369" par="array.a15" user="1"/>
<var nm="a16" obj="369" par="array.a16" user="1"/>
<var nm="a17" obj="369" par="array.a17" user="1"/>
<var nm="a18" obj="369" par="array.a18" user="1"/>
<var nm="a19" obj="369" par="array.a19" user="1"/>
<var nm="a20" obj="369" par="array.a20" user="1"/>
<set obj="7845" par="a1" val="(a1)" round="1" if="0"/>
<set obj="7845" par="a2" val="(a2)" round="1" if="1"/>
<set obj="7845" par="a3" val="(a3)" round="1" if="2"/>
<set obj="7845" par="a4" val="(a4)" round="1" if="3"/>
<set obj="7845" par="a5" val="(a5)" round="1" if="4"/>
<set obj="7845" par="a6" val="(a6)" round="1" if="5"/>
<set obj="7845" par="a7" val="(a7)" round="1" if="6"/>
<set obj="7845" par="a8" val="(a8)" round="1" if="7"/>
<set obj="7845" par="a9" val="(a9)" round="1" if="8"/>
<set obj="7845" par="a10" val="(a10)" round="1" if="9"/>
<set obj="7845" par="a11" val="(a11)" round="1" if="10"/>
<set obj="7845" par="a12" val="(a12)" round="1" if="11"/>
<set obj="7845" par="a13" val="(a13)" round="1" if="12"/>
<set obj="7845" par="a14" val="(a14)" round="1" if="13"/>
<set obj="7845" par="a15" val="(a15)" round="1" if="14"/>
<set obj="7845" par="a16" val="(a16)" round="1" if="15"/>
<set obj="7845" par="a17" val="(a17)" round="1" if="16"/>
<set obj="7845" par="a18" val="(a18)" round="1" if="17"/>
<set obj="7845" par="a19" val="(a19)" round="1" if="18"/>
<set obj="7845" par="a20" val="(a20)" round="1" if="19"/>
<if obj="7845" par="len" op=">" val="0"/>
<if obj="7845" par="len" op=">" val="1"/>
<if obj="7845" par="len" op=">" val="2"/>
<if obj="7845" par="len" op=">" val="3"/>
<if obj="7845" par="len" op=">" val="4"/>
<if obj="7845" par="len" op=">" val="5"/>
<if obj="7845" par="len" op=">" val="6"/>
<if obj="7845" par="len" op=">" val="7"/>
<if obj="7845" par="len" op=">" val="8"/>
<if obj="7845" par="len" op=">" val="9"/>
<if obj="7845" par="len" op=">" val="10"/>
<if obj="7845" par="len" op=">" val="11"/>
<if obj="7845" par="len" op=">" val="12"/>
<if obj="7845" par="len" op=">" val="13"/>
<if obj="7845" par="len" op=">" val="14"/>
<if obj="7845" par="len" op=">" val="15"/>
<if obj="7845" par="len" op=">" val="16"/>
<if obj="7845" par="len" op=">" val="17"/>
<if obj="7845" par="len" op=">" val="18"/>
<if obj="7845" par="len" op=">" val="19"/>
</st>
<st id="save">
<var nm="len" obj="7845" par="len"/>
<var nm="a1" obj="7845" par="a1"/>
<var nm="a2" obj="7845" par="a2"/>
<var nm="a3" obj="7845" par="a3"/>
<var nm="a4" obj="7845" par="a4"/>
<var nm="a5" obj="7845" par="a5"/>
<var nm="a6" obj="7845" par="a6"/>
<var nm="a7" obj="7845" par="a7"/>
<var nm="a8" obj="7845" par="a8"/>
<var nm="a9" obj="7845" par="a9"/>
<var nm="a10" obj="7845" par="a10"/>
<var nm="a11" obj="7845" par="a11"/>
<var nm="a12" obj="7845" par="a12"/>
<var nm="a13" obj="7845" par="a13"/>
<var nm="a14" obj="7845" par="a14"/>
<var nm="a15" obj="7845" par="a15"/>
<var nm="a16" obj="7845" par="a16"/>
<var nm="a17" obj="7845" par="a17"/>
<var nm="a18" obj="7845" par="a18"/>
<var nm="a19" obj="7845" par="a19"/>
<var nm="a20" obj="7845" par="a20"/>
<set obj="369" par="array.a1" val="(a1)" round="1" user="1" if="0"/>
<set obj="369" par="array.a2" val="(a2)" round="1" user="1" if="1"/>
<set obj="369" par="array.a3" val="(a3)" round="1" user="1" if="2"/>
<set obj="369" par="array.a4" val="(a4)" round="1" user="1" if="3"/>
<set obj="369" par="array.a5" val="(a5)" round="1" user="1" if="4"/>
<set obj="369" par="array.a6" val="(a6)" round="1" user="1" if="5"/>
<set obj="369" par="array.a7" val="(a7)" round="1" user="1" if="6"/>
<set obj="369" par="array.a8" val="(a8)" round="1" user="1" if="7"/>
<set obj="369" par="array.a9" val="(a9)" round="1" user="1" if="8"/>
<set obj="369" par="array.a10" val="(a10)" round="1" user="1" if="9"/>
<set obj="369" par="array.a11" val="(a11)" round="1" user="1" if="10"/>
<set obj="369" par="array.a12" val="(a12)" round="1" user="1" if="11"/>
<set obj="369" par="array.a13" val="(a13)" round="1" user="1" if="12"/>
<set obj="369" par="array.a14" val="(a14)" round="1" user="1" if="13"/>
<set obj="369" par="array.a15" val="(a15)" round="1" user="1" if="14"/>
<set obj="369" par="array.a16" val="(a16)" round="1" user="1" if="15"/>
<set obj="369" par="array.a17" val="(a17)" round="1" user="1" if="16"/>
<set obj="369" par="array.a18" val="(a18)" round="1" user="1" if="17"/>
<set obj="369" par="array.a19" val="(a19)" round="1" user="1" if="18"/>
<set obj="369" par="array.a20" val="(a20)" round="1" user="1" if="19"/>
<set obj="369" par="array.len" val="(len)" round="1" user="1"/>
<if obj="7845" par="len" op=">" val="0"/>
<if obj="7845" par="len" op=">" val="1"/>
<if obj="7845" par="len" op=">" val="2"/>
<if obj="7845" par="len" op=">" val="3"/>
<if obj="7845" par="len" op=">" val="4"/>
<if obj="7845" par="len" op=">" val="5"/>
<if obj="7845" par="len" op=">" val="6"/>
<if obj="7845" par="len" op=">" val="7"/>
<if obj="7845" par="len" op=">" val="8"/>
<if obj="7845" par="len" op=">" val="9"/>
<if obj="7845" par="len" op=">" val="10"/>
<if obj="7845" par="len" op=">" val="11"/>
<if obj="7845" par="len" op=">" val="12"/>
<if obj="7845" par="len" op=">" val="13"/>
<if obj="7845" par="len" op=">" val="14"/>
<if obj="7845" par="len" op=">" val="15"/>
<if obj="7845" par="len" op=">" val="16"/>
<if obj="7845" par="len" op=">" val="17"/>
<if obj="7845" par="len" op=">" val="18"/>
<if obj="7845" par="len" op=">" val="19"/>
</st>
</obj>
</pre>

=== Машина состояний объекта ===
[[Файл:array.jpg]]

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

[http://fs5.absolutist.com/files/wikisample/machine.rar Download]

== Clone ==
Clone - параметр команды init в разделе "системные действия".

[[Файл:Clone1.PNG]]

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

[[Файл:Clone2.PNG]]

=== Свойства ===

1) Клонированная машина состояний имеет все свойства, состояния и параметры исходного объекта клонирования.

2) Клоны рождаются и умирают в рамках одного экрана.

3) Клоны отличаются друг от друга лишь параметром '''clone_num''', который у оригинала равен "-1", а у клонов от 0 до N.

4) Нежелательно применять клонирование к клону во избежание путаницы значений параметра '''clone_num'''.

5) Если при проверке условия [[#if|if]] в поле '''obj''' указать this, это значит что if будет проводить проверку текущего объекта. Таким образом машина может сама себя проверить по параметру '''clone_num''' клон ли она и если да то какой у нее номер;

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

По ссылке пример использования с подробным описанием машин.

[http://fs5.absolutist.com/files/wikisample/Clone.zip Download]

== Параметр команды машины состояний ==

В случае, когда необходимо изменить значение какого-либо параметра в командах машины состояний (например v в команде move) в процессе работы приложения, можно использовать блок "Параметр команды машины состояний" в команде ''set'' машины состояний. Приведу пример использования этого блока.

Пусть есть 2 машины: управляющая и управляемая.

[[Файл:Stm1.jpg|300px]][[Файл:Stm2.jpg|300px]]

Управляемая машина практически пустая и не содержит каких либо данных о движении, но тем не менее при запуске она будет двигаться, меняя направление. Это движение - заслуга управляющей машины, которая на ходу изменяет параметры движения управляемой. Рассмотрим более детально ее состояния.

В первом состоянии "wait" мы пытаемся изменить скорость движения управляемой машины. Для этого указали объект (sun), состояние в котором хотим поменять параметр (у машины sun это состояние move), имя команды в которой меняем параметр (в данном случае это move), номер команды (если таких команд несколько, то нужно указать порядковый номер начиная с 0; в нашем случае команда одна), имя параметра (мы хотим изменить скорость, поэтому имя параметра v) и значение (указали значение 200). После этого переходим в следующее состояние.

В состоянии "1" управляющей машины сначала мы вывели объект sun из состояния move, изменили параметр целевой координаты x на 512 и затем вернули в состояние move, чтобы применить изменения параметров. Таким образом управляемая машина начала движение в x=512 со скоростью 200. Через 2 секунды мы переводим управляющую машину в состояние "2", где аналогичным образом изменяется целевая координата на -512.

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

==Запись в viewer.log ==

Во время работы приложения, машина состояний может писать информацию о своей работе в viewer.log. Для этого параметр '''Level''', в разделе '''[GameTrace]''' файла '''app.icf''' должен быть выставлен в значение '''Verbose'''.

При этом нужно иметь ввиду, что приложение работает более медленно, чем при обычном использовании. При настройке процессов, привязанных к времени (анимация и т.д.) логирование нужно отключать, путем установки флага '''Level''' в значение '''Info'''.

Ниже приведен пример записи из viewer.log. Жирным шрифтом выделено полезную информацию.

*Machine::state() state machine '''stat_google_gold (id:30818)''' from '''enough_coins''' to '''enough_coins''' through object '''c_current_gold (id:8807)''' from state '''inc''' - машина с именем и id: '''stat_google_gold (id:30818)''' перешла из состояния: '''enough_coins''' в: '''enough_coins'''; ее состояние изменил объект с именем и id: '''c_current_gold (id:8807)''' из состояния: '''inc'''.
*GMachine::Set::init() GMachine'''(id:28076)'''::Set::init '''set id:17''' - машина с id '''(id:28076)''' начала выполнять команду '''set id:17'''; сначала проверяется истинно ли условие выполнения команды (if).
*GMachine::Command::calcExpr() GMachine::Command::calcExpr ((0|(!1))|(!2)) '''checkIf(0)=no''' - имеем некоторое сложное условие, проверяем его составляющие; if(0) не выполняется (имеет значение false).
*GMachine::Command::calcExpr() GMachine::Command::calcExpr ((0|(!1))|(!2)) '''checkIf(1)=yes''' - условие if(1) выполняется (имеет значение true).
*GMachine::Command::calcExpr() GMachine::Command::calcExpr ((0|(!1))|(!2)) '''checkIf(2)=yes''' - условие if(2) выполняется (имеет значение true).
*GMachine::Command::checkIf() GMachine'''(id:28076)'''::Command::'''checkIf id:17 expr:((0|(!1))|(!2)) res:false''' - проверяется все выражение; общий результат false, set(17) не выполняется.
*GMachine::Set::init() GMachine'''(id:28076)'''::Set::init '''set id:18''' - машина с id '''(id:28076)''' начала выполнять команду '''set id:18''', в данном set условие if отсутствует.
*GMachine::Command::checkIf() GMachine'''(id:28076)'''::Command::'''checkIf id:18 expr: res:true''' - в команде set(18) условие '''checkIf id:18 expr: res:true''' есть истинно (точнее - не есть ложным, так как оно отсутствует); set(18) будет выполнен.
*GMachine::Set::init() GMachine'''(id:28076)'''::Set::init '''set id:18 checkIf success''' - проверка условия прошла успешно, выполняем set(18).
*GMachine::Set::init() GMachine'''(id:28076)'''::Set::init '''set id:18 obj:16039 -> par:param_name val:bundle_coins us:0''' - результат выполнения set(18) - объекту '''obj:16039''' устанавливаем параметр '''par:param_name val:bundle_coins''' равным '''us:0'''.
*GMachine::Command::getVarValue() Command::'''getVarValue(bundle_item): float result = 0.00''' - вычитываем переменную с помощью команды var; вычитываем параметр '''bundle_item''', результат операции '''float result = 0.00'''.
*GMachine::Set::init() Set::init: Expression: '''(bundle_coins)=0.000000(float)''' - используем значение переменной в команде set; переменная вчитывается в момент обращения к ней из другой команды (set, move и др.).

[[Category:Main objects]]

Machine

2015-12-02T07:51:26Z

Vefimov:

{{TOC right}}
[[Machine]] - [[Object|объект]] '''машина состояний''' (state machine) позволяет описывать сложное поведение игровых объектов. Для машин с типовым набором состояний и поведений вводятся отдельные типы объектов. Например, кнопка, по своей сути, является машиной состояний.

== Введение ==

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

Любая машина состояний может быть изображена в виде графа с кружочками и стрелками. У машины всегда активно строго одно состояние (ниже это изображено на левом рисунке темным кружком):
<center>
[[Файл:def_states.png]]
</center>
Машина состояний не обладает памятью. Это означает, что для анализа того, что произойдет в данном состоянии, неважно как мы в него попали, и какова была предыстория переходов. Важно, только, что мы находимся в этом состоянии. Такое отсутствие памяти упрощает анализ логики машины, так как каждый раз мы концентрируемся на одном конкретном состоянии, а всю логику работы разбиваем на отдельные кирпичики-состояния.

Выше на правом рисунке изображено некоторое состояние. При входе в него, происходит инициализация состояния. Если на объект оказываются внешние воздействия, то он может покинуть состояние. Наконец, внутри состояния могут работать различные процессы.

Все команды состояния, разбиваются на три группы:
* '''[[#Инициализация|Инициализация]]''':
** '''[[#draw|draw]]''' - установка графического ресурса;
** '''[[#init|init]]''' - инициализация параметров машины (координаты и т.п.);
** '''[[#set|set]]''' - установка состояния другого объекта;
** '''[[#play|play]]''' - проиграть звук;
** '''[[#var|var]]''' - переменная, которой присваивается значение параметра объекта;
** '''[[#buy|buy]]''' - запуск процедуры in-app покупки;
** '''[[#download|download]]''' - запуск процедуры закачки контента.
* '''[[#Процессы|Процессы]]''':
** '''[[#wait|wait]]''' - задержка по времени;
** '''[[#move|move]]''' - равномерное движение;
** '''[[#rot|rot]]''' - вращение вокруг точки пивота;
** '''[[#alpha|alpha]]''' - изменение прозрачности;
** '''[[#scale|scale]]''' - изменение размера;
** '''[[#phys|phys]]''' - ускоренное движение;
** '''[[#rgb|rgb]]''' - изменить rgb-каналы;
** '''[[#spline|spline]]''' - движение по сплайну (по кривой).
* '''[[#Воздействия|Воздействия]]''':
** '''[[#click|click]]''' - что делать при клике на машине;
** '''[[#drop|drop]]''' - на машине отпущена клавиша мыши;
** '''[[#drag|drag]]''' - машину схватили и тащат;
** '''[[#throw|throw]]''' - машину схватили и кинули;
** '''[[#apply|apply]]''' - сработает при пересечении машины с линией или объектом;
** '''[[#touch_in|touch_in]]''' - наведение мыши/пальца на машину, если палец "тащат" по экрану;
** '''[[#touch_out|touch_out]]''' - выведение мыши из машины, если палец "тащат" по экрану;
** '''[[#touch_up|touch_up]]''' - отжатие мыши от машины;
** '''[[#tap|tap]]''' - умный тач;
** '''[[#mouse_in|mouse_in]]''' - наведение мыши на машину даже если не нажата кнопка мыши;
** '''[[#mouse_out|mouse_out]]''' - выведение мыши из машины даже если не нажата кнопка мыши.

Кроме этого, есть команда '''[[#if|if]]''', вызываемая другими командами. В ней описываются некоторые логические условия, выполнение которых говорит команде (которая вызвала этот '''if'''), что можно завершать работу. Для разных команд использование этого параметра несколько '''отличается'''!

Начальные понятия и методы работы с машинами состояний находятся в [[Learning|уроках]],
начиная с [[Checkbox как машина состояний|третьего]].

== Свойства ==

Общие для всех объектов свойства описаны в документе [[Object|Object]].
Дополнительные свойства:

* '''в опции''' - да - машина будет сохранять свое состояние в опции и при следующей инициализации инициал-ся не в первом состоянии, а в состоянии, записанном в опциях.
* '''Состояние''' - Состояние в котором будет находиться машина при инициализации. Если ничего не указано - первое состояние в списке состояний.
* '''Хранить нажатость''' - нужно ли сбрасывать нажатость при изменении состояния.
* '''res''' - графический ресурс машины. Может отсутствовать. Перетягивается из редактора ресурсов(поле должно быть в состоянии редактирования).
* '''states''' - По двойному клику, или по нажатию на кнопку с тремя точками открывается список состояний.
* '''отладка''' - Отображать в окне состояний текущий объект.
* '''курсор''' - Графический ресурс курсора текущего и всех дочерних объектов.
* '''прокликиваемая''' - 0 - машина не пропускает клик, 1 - машина пропускает клик, 2 - машина обрабатывает клик и пропускает его дальше.

== Инициализация ==

При попадании в состояние, сразу выполняются команды инициализации init, draw, set, buy, var. Если в этих командах нет параметра break, они все выполняются до запуска процессов. Параметр break (со значением 1) прерывает выполнение команд инициализации данного типа. Их можно перезапустить по окончанию команд процессов.

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

=== draw ===

Команда определяет графический ресурс (картинку, которую надо рисовать в данном состоянии). Её параметры:

* '''res''' - ресурс картинки (перетаскивается из редактора ресурсов);
* '''f''' - начальный кадр;
* '''ft''' - длительность кадра в миллисекундах;
* '''loop''' - число повторов (зацикливаний анимации); если -1, то бесконечно; отсутствует или 0 - будет проигран один раз;
* '''rev''' - играть анимацию в обратном порядке; 0 - прямой порядок проигрывания, 1 - обратный порядок проигрывания;
* '''go''' - перейти в состояние;
* '''if''' - номер (начиная с нуля) команды [[#if|if]] для условия перехода; можно использовать логические операторы (см. [[#if|if]]);
* '''break''' - прервать команды.

Пустая команда draw (без параметров) "сбрасывает" текущую картинку и в этом состоянии ничего рисоваться не будет. Если в общих параметрах объекта (в базовой панеле свойств) задан ресурс рисования, и он во всех состояниях одинаков, то его можно в состоянии не задавать.

Если параметра loop нет, кадры анимации проиграются один раз. Чтобы зациклить их, необходимо установить loop=-1 или нужное число раз. Аналогично параметру loop других команд, первый раз draw выполняется в любом случае. Дальнейшие её повторы определяются значением loop. Однако, в отличие от других команд, loop повторяет только '''данную''' команду draw (даже если она не первая).
Для работы loop '''необходимо''' чтобы в редакторе ресурсов в настройках анимации '''было отключено''' зацикливание(looped).
 Если есть анимация открывающейся и закрывающейся книги (коробки, двери и т.д.) не обязательно подгружать в проект две анимации, можно использовать одну, но запускать ее в обратном порядке, для этого есть параметр '''rev'''.

=== init ===

====Параметры объекта====

* '''x''','''y''' - координата точки пивота относительно сцены или родительского объекта;
* '''ang''' - угол поворота в градусах; отчитывается вниз от оси x, или вверх, если отрицательный;
* '''al''' - Прозрачность: от 0 (прозрачен) до 1 (не прозрачен);
* '''sx''','''sy''' - масштаб машины по осям (если 1, то это исходный размер; 0.5 - в два раза меньше);
* '''vis''' - видимость - видимость машины (1 - видима, 0 - невидима), если vis = 0, это равноценно отключению объекта в редакторе;
* '''z координата''' - координата машины по z.
* '''z приращение''' - приращение координаты машины по z относительно текущего
* '''прокликиваемая''' - если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то клик обрабатывается, но передается дальше;

====Параметры движения====

* '''v''' - скорость для команды move
* '''vr''' - угловая скорость для команды rot
* '''vx''','''vy''' - начальная скорость для команды phys
* '''ax''','''ay''' - ускорение для команды phys

====Системные действия====

* '''показать рейтинг''' - значение 1 означает, что при выполнении этого инита будет показано окно iOS рейтинга.
Если на девайсе была нажата кнопка "отрейтинговать", то в опции запишется параметр rating значение 1, если нажата кнопка "позже" - rating 2, "никогда" - rating 3.
* '''закрыть приложение''' - значение 1 означает, что при выполнении этого инита приложение будет закрыто.
* '''перезагрузить лэйаут''' - значение 1 означает, что при выполнении этого инита будет перезагружен лэйаут.
* '''вернуться назад''' - начение 1 означает, что при выполнении этого инита произойдет возврат на предыдущий экран.
* '''реклама AdMob''' - 1 - показать, 0 - спрятать, -1 - не изменять состояние.
* '''курсор''' - меняет текущий курсор мыши на указанный графический ресурс. Перетягивается из редактора ресурсов, поле должно быть в состоянии редактирования.
* '''id внешней ссылки в текстовой базе''' - Ссыслка будет взята из текстовой базы в соответствии с текущим маркетом.
* '''[[#Clone|clone]]''' - Значение 1 означает, что в текущем местоположении машины будет создана ее копия

====Переходы и параметры выполнения====

* '''if''' - номер (начиная с нуля) команды [[#if|if]] для условия выполнения; можно использовать логические операторы (см. [[#if|if]]);
* '''break''' - прервать команды.

Так же, как и при инициализации картинки ('''draw'''), вызов команды ('''init''') переопределяет только те параметры, которые в ней указаны. Остальные параметры (заданные в других состояниях или в общих свойствах объекта) остаются без изменений

=== set ===

Перевод другого объекта в некоторое состояние или изменение его параметров.

* '''obj''' - изменяемый объект (выбирается из списка объектов). В значении объекта можно указать this, это значит что машина сама себе пропишет какой то параметр или состояние.
* '''scr_param''' - глобальный либо текущий экран, параметры которого меняем.
* '''scr_state''' - экран, состояние которого меняем.
* '''parent''' - Объект, который будет установлен в качестве родителя объекту из obj. Объект obj будет оторван от текущего своего родителя и добавлен в детей объекта parent. 
* '''st''' - состояние в которое переводится объект. 
* '''par''' - параметр объекта для установки, используется вместе с val, val_obj, val_txt, val_scr,val_vid,val_res,val_node.
* '''mSt''' - Состояние машины в котором будем изменять параметр команды.
* '''mCmd''' - Имя команды, параметр которой меняем.
* '''mCmdN''' - Порядковый номер в перечне одноименных команд состояния.
* '''mPar''' - Установить этот параметр команды в значение val.
* '''val_obj''' - id объекта, будет записано в в par
* '''val_txt''' - id текста, будет записано в в par(параметр для текстов "txtID")
* '''val_vid''' - id video, будет записано в par(параметр для видео "video" - RGB, "videoA" - Alpha)
* '''val_scr''' - id экрана, будет записано в в par
* '''val_res''' - Новое значение графического ресурса (перетаскивается из редактора ресурсов). (пока не работает)
* '''val_node''' - Новое нода графа (выбирается из списка, при заданном объекте)
* '''val''' - значение параметра объекта для установки
* '''var''' - имя переменной данной машины, значение которой присваивается в параметр par объекта obj
* '''round''' - округлить значение, записываемое в val 
* '''position''' - объект указанный в поле '''obj''' будет отпозиционирован относительно указанного объекта в этом поле ( можно одновременно и задавать состояние '''st''' в которое перевести объект ( поле obj ) );
* '''pos_dx''' - смещение по оси X от точки пивоты объекта из поля выше ( если это поле не указывать, смещение будет = 0 );
* '''pos_dy''' - смещение по оси Y от точки пивоты объекта из поля выше ( если это поле не указывать, смещение будет = 0 )
* '''scr''' - экран на который мы хотим перейти
* '''user''' - 1 - сохранять значения для текущего пользователя. Для всех типов объектов кроме options этот флаг игнорируется 
* '''if''' - номер (начиная с нуля) команды [[#if|if]] при выполнении которого происходит отработка команды set.
* '''break''' - прервать выполнение команд set на этой команде (запустить их снова можно из команд процессов).

Так как все объекты (не только машины) имеют состояния, то при помощи команды set можно их менять. Стоит обратить внимание на то, что когда в параметрах (любых команд) встречается st, речь идет о состоянии другого объекта, а если go, то данной машины состояний.

=== play ===

Проиграть звук

*'''snd''' - Короткий звук (перетаскивается из редактора ресурсов);
*'''voice''' - Голос (перетаскивается из редактора ресурсов);
*'''mus''' - Длинный звук (перетаскивается из редактора ресурсов);
*'''preload''' - Указанный звук будет загружен в память, но не будет проигрываться прямо сейчас. Для ускорения его старта потом;
*'''loop''' - Зациклить указанный звук. Использовать вместе с snd или voice;
*'''mus_loop''' - Зациклить указанную музыку. По умолчанию музыка всегда зацикленна. То есть, фактически этой флаг используется, когда нужно убрать зацикливание.
*'''repeat''' - Число повторов указанного звука при отключенном loop;
*'''mus_stop''' - Остановить музыку. Если используется вместе с mus, то остановится указанная. Если нет - то вся текущая.
*'''stop''' - Остановить указанный звук. Использовать вместе с snd или voice.
*'''mus_fading''' - Время появления/затухания указанной музыки в ms. Использовать вместе с mus.
*'''fading''' - Время появления/затухания указанного звука. Использовать вместе с snd или voice.
*'''volume''' - Установить громкость для всех звуков данной машины - тех что уже играют и тех, что будут запущены впоследствии;
*'''не выгружать''' - Позволяет продолжать проигрывание звука при смене экранов.
*'''go''' - Выбор состояния, в которое нужно перейти после проигрывания музыки/звука/голоса.
*'''if''' - Номер (начиная с нуля) условия перехода [[#if|if]].

Особенности применения:

1) Короткий звук (''snd'') нельзя запустить в первом (инитном) состоянии машины. Для того, чтобы запустить звук сразу при загрузке экрана, нужно в первом состоянии машины записать мгновенный переход во второе состояние мамашины (например, команда ''wait'', поле ''go'', в поле выбрать второе состояние), а во втором состоянии уже запустить звук.

2) Если звук нужно зациклить и проигрывать какое-то количество раз (''loop=1,2,3,..,n'') или бесконечно (''loop=-1''), то нужно проследить чтобы состояние, в котором запускается звук, не вызывалось повторно во время проигрывания звука, иначе возникнет наложение звуков.

3) Если во время проигрывания звука машина меняет свое состояние, звук продолжает играть.

4) Если в одной машине почти одновременно воспроизводится несколько звуков, то они прерывают друг друга.

5) Если каждый звук воспроизводится в отдельной машине, то они звучат параллельно.

6) Если не указан звук и голос, то команда (''stop'') остановит все звуки, запущенные этой машиной.

7) Музыка (''mus'') может быть формата .ogg или .mp3. На экране может воспроизводится только одна .mp3 музыка. Любой запуск .mp3 музыки независимо от того, в какой машине он осуществляется, будет прекращать проигрывание предыдущей .mp3 музыки. В тоже время может воспроизводиться несколько .ogg музыки.

8) Музыка, которая проигрывается на глобальном экране, проигрывается на всех экранах проекта.

=== var ===

Переменная, которой присваивается значение параметра объекта

*'''name''' - имя переменной;
*'''tp''' - тип переменной;
*'''obj''' - объект, используемый далее;
*'''par''' - имя параметра, значение которого присваивается переменной;
*'''val''' - значение переменной, если отсутствуют obj и par;
*'''user''' - если стоит "1", то будет считываться с текущего профиля в опциях
*'''func''' - в выпадающем списке можно выбрать функцию:
**'''random''' - использует arg1 и arg2, возвращает случайное целое число в диапазоне arg1 .. arg2.
**'''conc''' - объединяет 4 строки arg1,arg2,arg3,arg4. Возвращает строку, в которой соединены все строки
**'''exp''' - экспонента от аргумента arg1.
**'''ln''' - натуральный логарифм аргумента arg1.
*'''arg1''' - аргумент функции
*'''arg2''' - аргумент функции
*'''arg3''' - аргумент функции
*'''arg4''' - аргумент функции

Обозначенная переменная существует (может использоваться) только в текущем состоянии. Переменная может определятся в одном состоянии только один раз. Если созданной переменной нужно изменить значение в рамках состояния, это можно сделать через другую переменную или через параметр опций ([[Options]]). Если ее значение нужно использовать в другом состоянии, то оно присваивается параметру опций, а затем заново считывается в новом состоянии. Переменные можно указывать в поле ''val'' с другими математическими действиями и цифрами, при этом каждое действие заключать в скобки. Если в поле ''val'' указать имя переменной ''А'' без скобок - воспримется строка ''А'', если указать в скобках - воспримется значение переменной.

=== buy ===

'''(in-app совершить in-app покупку)'''

При переходе в состояние, данная команда открывает системное окно с предложением совершить in-app покупку. В зависимости от действий игрока, покупка может произойти (успех) или не произойти (провал).

* '''id покупки''' - внутренний id покупки для приложения, указывается в объекте [[Store]];
* '''объект(успех)''' - объект, которому сообщается об удачной покупке;
* '''состояние(успех)''' - состояние в которое переводится выбранный объект в случае успешной покупки;
* '''объект(провал)''' - объект, которому сообщается о неудачной покупке;
* '''состояние(провал)''' - состояние в которое переводится объект в случае неудачной покупки.

=== download ===

'''(скачать загружаемый контент)'''

При переходе в состояние будет совершена попытку закачать контент.
* '''url''' - ссылка на zip архив с контентом в интернете.
* '''объект успех''' - объект, которому в случае успешной закачки будет задаваться указанное состояние.
* '''состояние (успех)''' - состояние, которое будет устанавливаться выше указанному объекту, в случае успешной закачки.
* '''объект (провал)''' -объект, которому, в случае неудачи закачки, будет устанавливаться указанное состояние.
* '''состояние (провал)''' - состояние, которое, в случае неудачи закачки,будет устанавливаться выше указанному объекту.
* '''счетчик прогресса''' - объект, типа счетчик, который отображает прогресс закачки контента. Крайне желательно, что бы он измерялся в диапазоне от 0 до 100.

Существует несколько причин при которых вызывается состояние "провал". Для того что бы сообщить пользователю, по какой именно причине возник провал закачки, следует идентифицировать причины провала. Это возможно сделать с помощью параметра
<pre>
downloadErrCode
</pre>
Ниже приведены значение параметра которые помогут вывести нужное текстовое сообщение :
<pre>
GCUSTOM_ERROR_CODE_ERROR_UNKNOWN = 1, //!< ошибка не классифицирована
GCUSTOM_ERROR_CODE_WIFI_DISABLED = 2, //!< отключен WIFI
GCUSTOM_ERROR_CODE_SDCARD_UNAVAILABLE = 3, //!< SD-карта недоступна
GCUSTOM_ERROR_CODE_SDCARD_FULL = 4, //!< SD-карта переполнена перед закачкой
GCUSTOM_ERROR_CODE_UNZIP_FAIL = 5 //!< ошибка при распаковки пака (скорее всего на SD-карте не
хватает места для распаковки
</pre>

== Процессы ==

Все команды процессов, кроме параметров описанных ниже, могут содержать параметры, совпадающие с именами других команд. В этих параметрах указывается номер (начиная с нуля) команды, которую надо запустить на выполнение, после окончания действия данной команды процесса.

Если в команде процесса есть условие '''[[#if|if]]''', то после окончания работы команды она ждет пока это условие не выполнится. Только после этого переходит к следующей команде этого же типа
или в другое состояние (если есть параметр go).
Исключением является команда wait, которая '''не''' ждёт срабатывания '''[[#if|if]]'''. Если он по окончанию wait сработал, то происходит переходит в другое состояние, если есть параметр go.
Если параметра go нет, то в любом случае запускается следующий wait (т.е. if относится только к переходу go).

=== wait ===

Команда паузы (временной задержки). Если параметра '''t''' нет, то срабатывает сразу.
Может также использоваться для логических ветвлений, случайных переходов в другие состояния и т.д.

* '''t''' - длительность выполнения команды в ms;
* '''dt''' - интервал от t-dt до t+dt, внутри которого команда может быть случайно прервана (при t>t+dt прерывается в любом случае);
* '''p''' - вероятность срабатывания перехода в состояние, указываемое параметром go;
* '''go''' - состояние, в которое нужно перейти поле окончания времени и срабатывания условия [[#if|if]], если оно указано;
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go;
* '''loop''' - зациклить команды;
* '''break''' - прервать выполнение команд wait на этой команде (запустить их снова можно из команд процессов).
* '''init''', '''set''', '''draw''', '''move''', '''rot''', '''alpha''', '''scale''', '''phys''' - Номер запускаемой команды.
Простейший набор параметров команды wait выглядит следующим образом:
<pre>
<wait t="1000" go="next"/> // ждем 1000ms и покидаем состояние
</pre>
Для программирования объектов со случайным поведением можно использовать последовательность команд wait с параметром вероятности перехода p (от 0 до 1):
<pre>
<wait t="100" p="0.5" go="st1"/> // через t с вероятностью 1/2 перейдет в st1
<wait go="st2"/> // иначе, перейдем в st2
</pre>
Этот же синтаксис позволяет делать состояния с различным временем жизни:
<pre>
<wait t="100" p="0.5" go="next"/> // с вероятностью 1/2 живем 100ms
<wait t="100" go="next"/> // или 200ms
</pre>
Впрочем, последнюю задачу можно решить при помощи указывания интервала dt, внутри которого произойдет окончание команды. Так, состояние, живущее от 800 до 1200ms, реализуется следующим образом:
<pre>
<wait t="1000" dt="200" go="next"/>
</pre>

=== move ===

Перемещение по сцене:
* '''tx''', '''ty''' - целевые координаты в пикселях, к которым должен переместиться объект. Можно указывать переменные заданные с помощью [http://ge.absolutist.com/index.php/Machine#var_2 переменной var];
* '''dx''', '''dy''' - величина смещения от текущей (если есть - tx,ty игнорируются); можно задавать смесь tx, dy или dx,ty;
* '''v''' - скорость перемещения в пикселях в секунду; для фреймовой анимации, например, ходьбы скорость рассчитывается исходя из длительности одного кадра и числа кадров на фазу движения. Поэтому, в этом случае, удобнее задавать скорость;
* '''t''' - время перемещения (v игнорируется);
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени;
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду move, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды;
* '''break''' - прервать команды - Прервать выполнение команд move на этой команде (запустить их снова можно из команд процессов).
* '''init''', '''set''', '''draw''', '''move''', '''rot''', '''alpha''', '''scale''', '''phys''' - Номер запускаемой команды.

В большинстве команд процессов, связанных с движением, величина изменения может быть задана в абсолютных или относительных величинах. Так, могут быть указаны целевые координаты tx, ty в которые надо переместиться, или смещение dx, dy относительно текущего положения объекта.

Аналогично, скорость перемещения регулируется, либо явным заданием времени выполнения команды t, либо скоростью v. Исходя из требуемого расстояния, по этой скорости вычисляется необходимое время. Скорость задается в пикселях за секунду (а не миллисекунду!)

=== rot ===

Вращение объекта вокруг точки пивота с координатами px,py. Эти координаты задаются относительно верхнего левого угла объекта в общей секции описания параметров объекта или командой init в данном состоянии.
* '''ta''' - целевой угол поворота объекта;
* '''da''' - на сколько надо повернуться (ta игнорируется);
* '''v''' - угловая скорость поворота в градусах в секунду;
* '''t''' - время поворота (v игнорируется);
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду rot, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды;
* '''break''' - прервать команды - Прервать выполнение команд rot на этой команде (запустить их снова можно из команд процессов).
* '''init''', '''set''', '''draw''', '''move''', '''rot''', '''alpha''', '''scale''', '''phys''' - Номер запускаемой команды.

Угол отсчитывается от оси x. Если он положителен, то поворот происходит по часовой стрелке. Если отрицательный - против часовой.

=== alpha ===

Изменение прозрачности объекта. Меняется от 0 (полностью прозрачен) до 1 (непрозрачен)
* '''ta''' - целевая прозрачность
* '''da''' - на сколько надо изменить прозрачность от текущей (ta игнорируется)
* '''v''' - скорость изменения прозрачности (в долях единицы в ms)
* '''t''' - время изменения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду alpha, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд alpha с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд alpha на этой команде (запустить их снова можно из команд процессов).
* '''init''', '''set''', '''draw''', '''move''', '''rot''', '''alpha''', '''scale''', '''phys''' - Номер запускаемой команды.

Если у объекта прозрачность ''al=0.00'', то он невидим для всякого взаимодействия. Если у объекта прозрачность ''al=0.01'', то он видим для клика, но невидим для дропа(команда drop на объект не видит объект с прозрачностью ''0.01''). Если у объекта ''al=0.02'', то он видим и для клика, и для дропа.

=== scale ===

Изменение размеров объекта
* '''tx''', '''ty''' - целевой масштаб по каждой оси
* '''dx''', '''dy''' - на сколько изменить масштаб по каждой оси
* '''v''' - скорость изменения масштаба (в долях единицы в сек.)
* '''t''' - длительность выполнения команды (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду scale, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд scale с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд scale на этой команде (запустить их сново можно из команд процессов).
* '''init''', '''set''', '''draw''', '''move''', '''rot''', '''alpha''', '''scale''', '''phys''' - Номер запускаемой команды.

=== phys ===

Команда phys позволяет имитировать простую физику. В ней задается начальная скорость и действующая на объект сила (ускорение).

* '''vx''', '''vy''' - начальная скорость
* '''ax''', '''ay''' - величина ускорения по каждой оси
* '''a''' - полное ускорение
* '''tvx''', '''tvy''' - целевая скорость
* '''tx''', '''ty''' - целевая координата
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду phys, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд phys с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд phys на этой команде (запустить их снова можно из команд процессов).
* '''init''', '''set''', '''draw''', '''move''', '''rot''', '''alpha''', '''scale''', '''phys''' - Номер запускаемой команды.

Рассмотрим подпрыгивающий мячик, который при касании с землей деформируется (вертикально сплюскивается). Это можно сделать в 3 состояния (падаем, касаемся и взлетаем). Первоначально мячик находится в координате y=-100, и имеет высоту картинки w=60. Падает он до координаты ty=0. При касании с землёй, мяч сжимается на 20 процентов (sy=0.8). При этом его центр должен опуститься на dy=0.8*w/2 = 24.
<pre>

<st id="down"> // падаем
<phys vy="0" ay="20" ty="0" go="touch"/>
</st>

<st id="touch"> // касаемся земли
<move dy="24" t="300"/> // опускаем центр при сжатии
<scale ty="0.8" t="300"/> // сжимаемся
<move dy="-24" t="300"/> // поднимаем центр при разжатии
<scale ty="1" t="300" go="up"/> // разжимаемся
</st>

<st id="up"> // взлетаем
<phys vy="0" ty="-200" go="down"/>
</st>

</pre>
Напомним, что если объект имеет начальную скорость взлета, равную v=sqrt(2*ay*h), то он подпрыгнет на высоту h. Однако, в данном случае, вместо задания начальной скорости при взлете, мы задаем целевую координату (ty), до которой мяч должен подпрыгнуть.

=== rgb ===

* '''trgb''' - целевой эффект rgb; подразумевает под собой цвет в виде HEX-кода; по-умолчанию: FFFFFF;
* '''t''' - длительность выполнения команды в ms;
* '''go''' - состояние, в которое нужно перейти поле окончания времени и срабатывания условия [[#if|if]], если оно указано;
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go;
* '''loop''' - зациклить команды;
* '''break''' - прервать выполнение команд wait на этой команде (запустить их снова можно из команд процессов).
* '''init''', '''set''', '''draw''', '''move''', '''rot''', '''alpha''', '''scale''', '''phys''' - Номер запускаемой команды.

=== spline ===

Сплайн позволяет перемещать машину по заранее заданной траектории.

====Параметры====

*'''key''' - точки сплайна по которым движется
*'''t''' - время движения по траектории
*'''go''' - по окончанию переход в состояние
*'''if''' - условие перехода
*'''loop''' - количество повторений
*'''break''' - прервать команды на этой
*'''wait''' - номер запускаемого действия
*'''init''' - номер запускаемого действия
*'''alpha''' - номер запускаемого действия
*'''rot''' - номер запускаемого действия
*'''move''' - номер запускаемого действия
*'''set''' - номер запускаемого действия
*'''phys''' - номер запускаемого действия
*'''scale''' - номер запускаемого действия
*'''drow''' - номер запускаемого действия

====Построение сплайна====

# в состоянии машины добавляем правой кнопкой мыши действие "spline"
# добавляем минимально необходимые параметры: '''key''' и '''t''', указываем время движения в '''t'''
# выделяем для редактирования поле '''key'''
# записываем координаты точек через запятую, сначала x потом y, например: -211,-248,-151,-248,-91,-247,59,-246,60,101,60,159,1,190
Если записали все координаты вручную, то можно сохранить и проверять.
Или можно в окне списка состояний нажать на кнопку "build spline" (справа вверху).
[[Файл:Btn spline.jpg|500px]]

Окно с списком состояний закроется, появится дополнительная панель с настройками сплайна и появится возможность указывать мышкой по экрану точки для сплайна.

[[Файл:Spline panel.jpg|500px]]

Точки сплайна указываются кликом левой кнопки мыши по экрану.

Возможности редактирования:

'''режимы:'''
*'''add''' - по нажатию левой кнопкой мыши по экрану - будет добавлена новая точка, которая соединится с предыдущей
*'''select''' - по нажатию левой кнопкой мыши по точке сплайна появится возможность отредактировать её положение перетащив её или поменяв её координаты в полях x и у
*'''delete''' - по нажатию левой кнопкой мыши по точке сплайна точка удалится

Чтобы удалить все точки сплайна необходимо нажать на кнопку "'''delete all knots'''"

Сохранить сплайн можно нажав на кнопку "'''Save spline'''"

====Дополнительные сведения====

* Время движения между двумя соседними точками всегда одинаково, то есть чем дальше друг от друга соседние точки, тем быстрее будет двигаться объект, чем ближе - тем медленней.
* Координаты сплайна просчитываются относительно точки пивота родительского объекта, если соответствующая машина является подобъектом. На координаты могут влиять модификаторы родительского объекта.

== Воздействия ==

=== click ===

Команда вызывается, если на объект кликнули мышкой. Срабатывает на её нажатие.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

По клику машина записывает координаты клика в параметры: clickX, clickY.

=== touch_in ===

Наведение мыши/пальца на машину, если палец "тащат" по экрану.
* '''go''' - состояние в которое при выполнении команды нужно перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход ''go''.

=== touch_out ===
Выведение мыши/пальца из машины, если палец "тащат" по экрану.
* '''go''' - состояние в которое при клике нужно перейти;
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при котором срабатывает переход ''go''.

=== touch_up ===

Отжатие мыши от машины

* '''go''' - состояние в которое при отжатии мыши нужно перейти;
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при котором срабатывает переход ''go''.

=== mouse_in ===

Срабатывает при наведение мыши/пальца на машину даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды нужно перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход ''go''.

=== mouse_out ===
Срабатывает при выведение мыши/пальца из машины даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды нужно перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход ''go''.

=== drag ===

Данная команда позволяет "таскать" объект по сцене нажав и удерживая клавишу мишки или (палец в случае сенсорного устройства) на нем.Так же есть возможность ограничить разрешенную область таскания, за пределы которой объект вытащить невозможно. [[Файл:drag.jpg|right]]
* '''x1''' - разрешено таскать, когда координата объекта правее;
* '''x2''' - разрешено таскать, когда координата объекта левее;
* '''y1''' - разрешено таскать, когда координата объекта ниже;
* '''y2''' - разрешено таскать, когда координата объекта выше;
* '''if''' - номер команды условия (начиная с нуля) разрешения таскания;
* '''obj''' - объект у которого надо изменить состояние;
* '''st''' - новое состояние объекта obj;
* '''за пивот''' - "да" - таскать объект за пивот, "нет" - за ту точку, за которую схватили
* '''приклеивать''' - приклеивать при клике к мышке.

=== dragRot ===

Данная команда позволяет вращать объект вокруг точки пивота. Нажав и удерживая клавишу мишки или палец (в случае сенсорного устройства) на нем, мы можем вращать его по часовой либо против часовой стрелки. При многократном вращении вокруг своей оси значение его угла не накапливается, а обнуляется выходя за границы [360 ; -360] градусов. [[Файл:dragRot.jpg|right]]
* '''if''' - номер команды условия (начиная с нуля) разрешения таскания;
* '''obj''' - объект у которого надо изменить состояние;
* '''st''' - новое состояние объекта obj;
* '''maxVel''' - Максимальная скорость вращения градус/сек;
* '''objStart''' - объект при начале вращения;
* '''stStart''' - его новое состояние;
* '''objEnd''' - объект при завершении вращения;
* '''stEnd''' - его новое состояние;

=== drop ===

Если нажатая кнопка мышки отпускается, вызывается эта команда. Обычно она используется в связке с командой drag
* '''obj''' - объект, на который надо уронить таскаемый объект;
* '''go''' - состояние в которое переходим при отпускании мышки;
* '''if''' - номер (начиная с нуля) условия [[#if|if]] разрешения бросания.

Рассмотрим совместное применение команд drag и drop на следующей задаче. Пусть есть ключ и ящик. Ключ можно взять мышкой и перетащить, бросив на ящик. Ящик при этом должен постепенно стать прозрачным, а ключ уменьшиться до нуля. Машина состояний для ключа выглядит следующим образом:
<pre>

<st id="drag">
<drag x1="-350" x2="350" y1="-250" y2="250"/>
<drop obj="box" go="open"/>
</st>

<st id="open">
<set obj="box" st="open"/>
<scale tx="0.01" ty="0.01" t="500" go="hide"/>
</st>

<st id="hide">
<init x="268" y="30"/>
<scale tx="1" ty="1" t="500" go="drag"/>
</st>

</pre>
Ящик:
<pre>

<st id="close"> // начальное состояние ящика
<init al="1"/> // если его кто-то сюда переведет - он появится.
</st>

<st id="open">
<alpha ta="0" t="500"/> // исчезает по прозрачности за 500 ms
</st>

</pre>

====Использование свойства "Условие перехода" ====

Можно прописать условие, при котором выполняется переход при дропе.
[[Файл:Drop_if.png|300px|thumb|right]]

С помощью этого условия мы можем научить наш объект выполнять разные задачи в зависимости от того, как именно его дропнули.
Пусть есть объект который можно таскать. Когда объект не таскается должен быть включен флаер, привязанный к этому объекту. При клике на объект, он должен поворачиваться на 90 градусов. При дропе на соответствующую маску объект стает на свое место(Если выполнены условия, к примеру: установлен предыдущий объект и наш объект имеет правильный угол). Если дроп в любое другое место, то должен включится флаер.

Для того, чтобы научить машину различать клик по ней и ее таскание сделаем следующее. Пропишем ей 2 состояния: click и drag, а также выставим ей параметр "хранить нажатость" = 1. В click будем вычислять координаты объекта и записывать объекту параметр допустимого смещения при котором таскание будет восприниматься как клик. (В данном примере эти параметры: cx, cy, vx, vy. А допустимое смещение составляет 10 пикселей.)

В состоянии drag будем проверять попадает ли координата объекта при дропе в границы допустимого смещения. Для того чтобы сравнить параметр объекта с переменной, вычтем из нашего объекта, то что мы записали в click. В зависимости от условий и места дропа переходим в соответствующее состояние.

[[Файл:Click.png|330px]] [[Файл:Drag st.png|630px]]

=== throw ===

Если на объект наступили мышкой, не отпуская кнопки, мышку оттащили и затем отпустили, вызывается команда throw со следующими параметрами:
* '''go''' - состояние, в которое, при клике, надо перейти;
* '''if''' - номер (начиная с нуля) команды [[#if|if]] разрешения бросания;
* '''force''' - получаемая скорость равна разнице пикселей от начала бросания (мышь нажата) до его конца (мышь отжата), умноженная на этот параметр. По умолчанию он равен 1.

Сработав, эта команда задает начальные значения скорости для команды phys, поэтому должна использоваться совместно с ней (см. ниже пример).

=== tap ===

* '''go''' - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) условия [[#if|if]] разрешения бросания.

=== apply ===

Вызывается, если данная машина пересеклась с другой. Обычно используется в совокупности с throw, move, phys, drag.
* '''obj''' - сработает , если пересеклись с этим объектом;
* '''x1''' - сработает, если центр объекта левее этого x-са;
* '''x2''' - сработает, если центр объекта правее этого x-са;
* '''y1''' - сработает, если центр объекта выше этого y-ка;
* '''y2''' - сработает, если центр объекта ниже этого y-ка;
* '''rm''' - радиус этой машины (если rm=0, то она считается прямоугольной)
* '''ro''' - радиус объекта obj (если ro=0, то он считается прямоугольным)
* '''st''' - состояние, в которое надо перевести объект obj
* '''go''' - состояние, в которое надо перейти при срабатывании;
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]] разрешения применения команды apply.

[[Файл:Апплай.png|500px]]

Блок схема работы '''apply'''

[[Файл:Блок схема apply.png|500px]]

* Сначала у нас проверяется координаты '''x1''', '''x2''', '''y1''', '''y2'''.
* Далее проверяет если '''obj'''
* Если '''obj''' нет, то идёт проверку, и выдаёт результат
(если при этом если '''x1''', '''x2''', '''y1''', '''y2''' нет, то они считаются по ширине и высоте всего экрана.)
* Если есть '''obj''', то проверяет есть ли радиусы '''rm''', '''ro'''.
* Если он есть, то значит у нас '''apply''' по кругам
* Если нет, то проверяем наличие '''x1''', '''x2''', '''y1''', '''y2'''.
* Если они есть, то проверка и результат.
* Если их нет, то проверка идёт по шейпам объектов, и выдаётся результат/
Если не будет стоять ни каких галочек, то проверка будет идти по шейпам объектов.

Пусть, например, есть снаряд, который при помощи мышки надо кинуть в "тыкву". Если мы промахнулись, снаряд должен вернуться обратно, а с тыквой ничего не произойти. Если мы в тыкву попадаем, снаряд также возвращается, а тыква "взрывается":
<pre>

<st id="trow">
<init x="-350" y="150"/> // начальное положение
<throw go="fly"/> // бросаем
</st>

<st id="fly">
<phys ay="100"/> // летим
<apply y2="300" go="throw"/> // с землей
<apply obj="тыква" rm="8" ro="10" st="bang"/> // с тыквой
</st>

</pre>

== Условия ==

=== if ===

В состоянии может быть произвольное число команд if. Их номера (начиная с нуля) указываются
в параметре if других команд. Эти номера можно соединять при помощи логических связок:
* '''&''' - логическое '''и''' (вместо значка '''&''' можно использовать запятую ''',''');
* '''|''' - логическое '''или''';
* '''!''' - логическое '''не'''.
Пример записи логического выражения в поле if некоторой команды: '''(1&2)|(3&(!4))''',
что означает: выполняется if под номером 1 и под номером 2, или под номером 3 и не под номером 4.

Логические связки используются также как математической логике или любом языке программирования.
Так:
* A '''&''' B - истинно, если истинны оба условия A и B;
* A '''|''' B - истинно, если истинно хотя бы одно условие (или оба);
* '''!''' А - истинно, если условие A ложно.
Скобки в логическом выражении определяют приоритет (порядок) выполнения логических операций.
Отметим несколько тождеств, справедливых при формировании логических высказываний:
* !(A & B) = (!A) | (!B)
* !(A | B) = (!A) & (!B)
* !(!A) = A

Если при формировании условия (ниже) есть несколько проверок, то они соединены логическим '''и'''.
Т.е., если хотя бы одна из них не выполняется, то считается, что условие не выполнилось.

Параметры команды:
* '''obj''' - находится ли объект obj в состоянии st или имеет ли его параметр par значение val. В этом поле можно указать this, это значит что if будет проводить проверку текущего объекта. Добавлено это вместе с параметром clone. Клоны рождаются и умирают в рамках одного экрана. Для различия клонов между собой машина имеет уникальный параметр "clone_num" у оригинала = -1, у клонов от 0 до N, собственно с помощью this машина может сама себя проверить клон ли она и если да то какой у нее номер;
* '''st''' - имя состояния в котором может находиться объект obj;
* '''par''' - имя параметра объекта obj, значение которого сравнивается с полем val;
* '''val''' - значение параметра par, которое проверяется у объекта obj;
* '''val_txt''' - Значение текстового параметра объекта для проверки условия;
* '''val_res''' - Значение ресурсного параметра объекта для проверки условия;
* '''op''' - операция сравнения par op val. Если операции нет, то предполагается проверка на равенство par=val. Иначе используются операторы:
** '''<''' - меньше (par < val);
** '''>''' - больше (par > val);
** '''!=''' - не равно (par != val);
** '''<>''' - не равно (par <> val);
** '''>=''' - больше или равно (par >= val);
** '''<=''' - меньше или равно (par <= val);
* '''curScr''' - если текущий экран совпадает с этим, то условие выполнилось;
* '''prScr''' - если предыдущий экран совпадает с этим, то условие выполнилось;
* '''wasScr''' - если был (когда либо) этот экран, то условие выполнилось.
* '''buy''' - был ли куплен данный inn-app (проверяется флаг поля в объекте [[Options]]);
* '''url''' - валиден (правилен и может быть запущен) ли данный интернет-адрес;
* '''is_mus''' - играет ли сейчас музыка (значение 1);
* '''guest''' - объект который установил состояние (используется вместо параметра obj). Если указанный объект не менял состояние этой машины, то условие не срабатывает.

Если использовать obj, par, val, то будет происходить проверка на равенство значения параметра объекта и значения записанного в поле val.
Если же использовать obj, par, op, val, то будет происходить проверка в соответствии с операцией сравнения значения параметра объекта и значения записанного в поле val.

Для проверки текущего значения прозрачности у объекта можно воспользоваться параметром ''cur_al''

У машины (другой или самой себя) можно проверить текущее состояние '''st''' и предыдущее состояние '''prev_st''', эти параметры живут на время сессии.

== Математика ==

=== Основные математические операции ===
Математика в appsalute creator представлена 6-ю основными операциями: (плюс), (минус), (умножить), (поделить), (целочисленное деление), (остаток от деления) 
Организована благодаря совместному использованию '''[[#var|var]]''' и '''[[#set|set]]'''.
[[Файл:Example_mod.png|300px|right|Пример использования операции остатка от деления]]
''(плюс)'' '''+''' 
''(минус)'' '''-''' 
''(умножить)'' '''*''' 
''(поделить)'' '''/''' 
''(целочисленное деление)'' '''\''' 
''(остаток от деления)'' '''%''' 
 
Примеры использования последних двух операций: 
5\2=2 
5%2=1 

=== var ===
Благодаря использованию '''[[#var|var]]''' существует возможность cчитать любой числовой параметр любого объекта. Например: x - координату какой-то машины, текущее значение любого объекта counter или timer и конечно же считывание значения любого параметра из опций! Каким образом это устроено? Рассмотрим подробнее '''[[#var|var]]''': 
[[Файл:VAR.png|right]]
*'''name''' - здесь выбираем имя для нашей будущей переменной, которой будем оперировать далее
*'''obj''' - выбирается объект, параметры которого мы хотим считать
*'''par''' - параметр, который нужно вычитать из объекта, указанного выше
*'''val''' - указывается числовое значение, которое будет установлено по умолчанию в случае отсутствия obj и par
*'''user''' - если стоит "1", то будет считываться с текущего профиля в опциях
На изображении справа можно наблюдать каким образом организован '''[[#var|var]]'''. В данном случае объявлена переменная x_cor, которая считывает x-координату объекта actor_1, при этом считывание переменной происходит из текущего профиля, так, как в поле user установлено значение равное "1".

=== set ===
[[Файл:SET.png|right]]
Использование '''[[#var|var]]''' без '''[[#set|set]]''' не имеет смысла. Так, как переменная создается, но не используется дальше. Рассмотрим следующий пример, где вычитаем x - координату из одного объекта и сохраним ее в опции, предварительно увеличив ее на 50 единиц (в данном случае 50 пикселей).
На рисунке справа можно наблюдать, каким образом это сделано. В состоянии '''init''' объявляется переменная '''x_cor''', которая считывает координату '''x''' из объекта '''actor_1''', таким образом в переменную '''x_cor''' запишется положение по '''x''' объекта '''actor_1'''. Поле '''user''' в данном случае в '''1''' не обязательно устанавливать, так как работа ведется с машинами, а не с опциями. Если бы на месте '''actor_1''' оказался объект '''options''', то это было бы просто необходимо, иначе программа считает значение не из профиля. Далее в '''[[#set|set]]''' выбран объект '''options''', в параметр '''x_position''' которого будет сохранятся значение переменной '''x_cor''' увеличенной на 50. В поле '''round''' идет округление вычисляемого значения, если оно установлено в 1. Поле '''user ''' установлено в 1, это значит, что параметр '''x_position''' будет сохранен в профиль. После это выполняется сохранение опций путем задания объекту '''options''' состояния '''save'''. 
! ! !ВАЖНО: чтобы выполнить какие-то действия с '''[[#var|var]]''' его обязательно нужно указывать в поле '''val''' в '''set''', при этом, если он используется, то все выражение должно стоять в скобках. Если в поле '''val''' не используется переменная, то скобки необязательны.
 
 
Существует также возможность использовать '''[[#var|var]]''' совместно с '''[[#if|if]]''', а также '''[[#var|var]]''' с '''[[#move|move]]'''
 
Так же добавилась возможность записывать значение переменной в состояние "st", что значительно уменьшает
необходимость в записи 1000 if-ов. При этом, тип переменной в '''[[#var|var]]''' должен быть "строка".
И добавилась возможность записи переменной boolean: ((a)==(b)). true = 1, false = 0. Довольно полезная вещь,
если не хотите забивать "память" ненужной математикой.

=== var и if ===
[[Файл:IF.png|right]]
При подробном рассмотрении '''[[#if|if]]''' можно заметить, что в нем есть поле '''val''', соответственно в этом поле можно указать переменную. Таким образом в поле '''val''' необязательно указывать константу, а можно указать какую-то переменную, которая может постоянно изменяться. Например, существует два объекта, один находится состоянии покоя, а другой находится в движении. При этом первый объект (тот, который в состоянии покоя) постоянно опрашивает положение второго объекта, и в случае, если у объекта, который движется, '''х''' координата равна '''х''' координате первого объекта, то первый объект входит в состояние, где он начинает свое движение. На рисунке показан объект, который находится в состоянии покоя, рассмотрим его состояния: 
В данном объекте существует два состояния: '''init''' и '''move'''. В '''init''' объект опрашивает другой объект и в случае, когда условие срабатывает, то переходит в состояние '''move''', где начинает свое движение.
В '''init''' создаем переменную, в которую записываем положение по '''x''' объекта '''actor_2''', в '''if''' проверяется условие на соответствие координат объектов '''actor_1''' и '''actor_2''', в данном случае координата объекта '''actor_2''' представлена в виде переменной '''x_cor'''. Если условие выполняется, то происходит переход в состояние '''move''', если нет, то заново проходим состояние '''init''' и повторяем вышеописанную последовательность действий.
 
 
 
 

=== var и move ===
Также с помощью '''[[#var|var]]''' есть возможность указать целевые координаты в '''[[#move|move]]'''. То есть, не обязательно указывать целевые координаты в виде констант, их можно указать теперь с помощью переменных. При использовании '''[[#var|var]]''' и '''[[#move|move]]''' можно организовать обмен двух объектов местами с анимацией движения. Для этого необходимо определять какой объект нажат первым, а какой вторым, сохранять их координаты через объект '''options''' и только потом менять их местами. На рисунке можно увидеть, как это организовано.
[[Файл:var_move.png|1000px|thumb|center|]]
Рассмотрим подробнее состояние данной машины:
 
* '''init''' 
В этом состоянии ожидаем клик на объект и обнуляем параметр, который отвечает за то, какой по счету объект сейчас нажат. Так, как при обмене объектов, если мы делаем это по клику, важно знать, по какому кликнули первым, а по какому вторым.
* '''check''' 
Проверяется параметр '''number''', если он равен '''0''', то это значит, что еще ничего не кликали и мы переходим в состояние, где в опции записываются координаты этого объекта, который считается нажатым первым. Если не равен '''0''', то считается, что этот объект нажат вторым и переходит в состояние, где в опции записываются координаты этого объекта, который считается нажатым вторым по счету.
* '''first_object''' 
В этом состоянии записываются координаты объекта в опции. Чтобы записать координаты в опции используются '''[[#var|var]]''' и '''[[#set|set]]''' упоминаемые выше. В опции координаты первого нажатого объекта сохраняются под параметрами '''x_first''' и '''y_first'''. В конце параметру '''number''' присваиваем значение '''1''', чтобы указать, что следующий нажатый объект будет вторым по счету.
* '''second_object''' 
В этом состоянии объект будет в том случае, если он будет нажатым вторым по счету, то есть после состояния '''check''' объект попадет в это состояние, где он запишет свои текущие координаты под параметрами '''x_second''' и '''y_second'''. Запись координат происходит таким же самым образом, что и в состоянии '''first_object'''. После этого он автоматически переходит в следующее состояние.
* '''move_first''' 
В этом состоянии объект будет в том случае, если он был нажат первым, поэтому он будет двигаться на место второго нажатого объекта, который сохранил свои координаты в параметры'''x_second''' и '''y_second'''. Движение происходит следующим образом: сперва в переменную вычитываем координаты второго объекта, а потом в '''move''' вместо целевых координат записываем переменные, которые обязательно должны быть взяты в скобки.
* '''move_second''' 
В этом состоянии объект будет в том случае, если он был нажат вторым, поэтому он будет двигаться на место первого нажатого объекта, который сохранил свои координаты в параметры '''x_first''' и '''y_first'''. Движение происходит следующим образом: сперва в переменную вычитываем координаты первого объекта, а потом в '''move''' вместо целевых координат записываем переменные, которые обязательно должны быть взяты в скобки.

В результате проделанных манипуляций с машинами по кликам на две машины, они обменяются местами с анимацией движения. Это может быть очень полезным во многих мини играх!!!

=== Важно знать ===
* Переменная действует в рамках одного состояния, если нужно, чтобы она была глобальной, нужно сохранить ее в опции и потом в нужный момент считывать ее из опций.
* Если складываем два числа, то в поле '''val''' они должны быть записаны в скобках: (5+3).
* Если возникает необходимость написать какое-то более сложное арифметическое вычисление, то следует помнить, что на одно действие приходятся одни скобки. Например: (((5+3)\2)*2).
* Количество открывающих и закрывающих скобок должно быть одинаковым.
* В скобках можно писать переменную, если она была объявлена выше: (5+a).
* Переменная может состоять из цифр и букв и знака нижнего подчеркивания.
* Иногда бывает необходимым использование '''round''' в '''set''', так например, если какой-то параметр получен с помощью арифметических вычислений и потом используется его в каком-то условии, и условие проверяет параметр, как целочисленное значение, то могут возникнуть ошибки. Так, как число будет записано в следующем виде 123.0000 и программа будет считать, что оно не целочисленное, а дробное. И чтобы избавится от лишних нулей в дробной части следует округлять число.
* Действия, которые требуют времени, такие как move, rot, wait и другие перестают работать для уменьшения вычислительной нагрузки на устройство.
* Действия, которые не требуют времени, такие как set, init и другие продолжают функционировать.

<pre>
Если с помощью переменной менять объекту любой параметр, например, координату X, то она
запомнится (запишется как значение по умолчанию).
Тогда при повторном попадании на экран считается не тот X, который указан в свойствах,
а тот, который установлен через переменную.
Если нужно при ините экрана возвращать начальные значения параметров,
то можно сделать это двумя способами:
- не использовать переменную;
- создать отдельное состояние, которое будет "вручную" устанавливать начальные значения
параметрам при ините экрана.
Если координата (или другой параметр) меняется другим способом, то будут автоматически
при ините экрана подтягиваться значения из свойств объекта.
</pre>

=== Примеры применений ===
С помощью математики можно организовать следующее:
* динамические опции (изменение звука и музыки с помощью ползунка);
* анимацию каунтера в играх (по окончанию уровня можно наблюдать, как изменяются очки);
* подсчет очков (гибкая система подсчета очков);
* обмен объектов местами (использование var и move)
* увеличение z-координаты любого объекта (когда необходимо, чтобы нажатый или таскаемый объект был выше других по z);
* простейший калькулятор;
* и много других.

== Копирование машины состояния с сохранением ссылки на себя ==
Довольно часто бывает, что машина состояний ссылается только на глобальные объекты и на саму себя. При этом, если мы просто скопируем объект, он будет ссылаться на свою предыдущую копию. Этого можно избежать, сделав 3 шага:
1. Переместить объект в отдельную сцену
2. Скопировать данную сцену(имеется в виду обычное копирование, без ссылки)
3. Перенести объект и его копию обратно, в нужную сцену
4. Созданные сцены можно удалить :)

== Guest ==

'''Guest (гость)''' - объект, который перевел машину в текущее состояние. Пример: кнопка ''btn1'' по клику переводит машину ''mch1'' в состояние ''st1'', в этом состоянии у машины ''mch1'' гостем является кнопка ''btn1''. Гостем может быть объект любого типа, если он может менять состояние другому объекту (например: хидден-объект по нахождению может менять состояние объекту, кнопка, машина, пэчворк и т.д.)

В машине состояний можно считывать (проверять) и передавать параметры и состояния гостя. Любое поле ''obj'' в выпадающем списке содержит строку ''guest'', что позволяет работать с гостем, как с любым другим объектом.

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

[[Файл:Guest1.jpg|left]]
Пускай экран содержит 3 кнопки (''btn1'', ''btn2'' и ''btn3'') и одну машину ''mch1''. Нужно сделать так, чтобы по клику на любую из кнопок машина перемещалась в ее координаты и переводила кнопку в состояние ''disable''. Так же по клику на кнопку ''btn2'', машина должна перейти в состояние ''bonus''. 
Всем трем кнопкам по клику пропишем передавать объекту ''mch1'' состояние ''check''. 
Создадим в машине три состояния: ''init'' - состояние в котором машина будет находиться по умолчанию, ''check'' - состояние, которое будет вызываться тремя кнопками, в этом состоянии у машины ''mch1'' одна из трех кнопок будет гостем, ''bonus'' - последнее состояние. 
Две команды ''var'' считывают у гостя координаты, т.к. мы не знаем, какая именно кнопка перевела машину ''mch1'' в состояние ''check'', то обращаемся к гостю, а не к кнопкам. За ними следует две команды ''set'', которые передают координаты гостя машине. Еще один ''set'' переводит гостя в состояние ''disable''. И через ''wait'' осуществляется переход в состояние ''bonus'', если гость ''btn2''.

<pre>
При смене состояния гость сохраняется, т.е. в состоянии bonus гостем останется btn2.
</pre>
<pre>
Если машина изначально сама себе меняет состояния, то у нее нет гостя.
</pre>

[[Файл:Guest2.jpg]]

== Массив (Array) ==

В данном объекте реализован массив, имеющий максимальную длину в 20 элементов.

=== Свойства объекта массив: ===

len - длинна массива. Длинна массива может как считываться, так и записываться. Влияет на количество сохраняемых объектов в Options.

index1 - индекс элемента. (данный массив можно расширить до многомерного и использовать несколько индексов)

val - значение элемента массива, с индексом index1

a1..a20 - внутренние элементы массива(обращаться можно через свойство par объекта). Предполагается, что пользователь редактора к ним обращаться напрямую не будет, однако иногда для удобства полезны.

=== Состояния объекта массив: ===

get - при вызове этого состояния во внутреннюю переменную val записывается значение элемента с индексом index1

set - при вызове этого состояния во внутреннюю переменную a1..a20, соответствующую индексу index1 записывается значение val

load - загрузить значения массива из xml.

save - сохранить элементы массива от 1 до len

=== Как использовать? ===

1. Загружаем массив, переводя объект array в состояние load

2. Записываем значения массива

а). Задаём значение свойству index1 объекта array (устанавливаем индекс ячейки, в которую будет заноситься число)
б). Задаём значение свойству val объекта array (устанавливаем значение, которое будет заноситься в ячейку
с индексом index1)
в). Переводим объект array в состояние set

3. Считываем значения массива
а). Задаём значение свойству index1 объекта array (устанавливаем индекс ячейки, из которой будет считываться число)
б). Переводим объект array в состояние get
в). Считываем значение из свойства val объекта array

4. Сохраняем массив, переводя объект array в состояние save. Если хотите изменить количество сохраняемых элементов - предварительно измените параметр len.

=== Копирование объекта ===

При копировании, необходимо заменить в состояниях load и save array.имя_параметра на другое имя. Например, array2.имя_параметра. Копировать следует через использование доп. сцены (см. выше)

=== Достоинства ===

Позволяет избежать необходимости каждый раз создавать большое количество if-ов и set-ов, если необходимо работать с нумерованным списком. Можно один раз создать структуру и копировать её неограниченное количество раз

=== Недостатки ===

Данный объект содержит довольно большое количество кода, поэтому при большом их обилии/длине может занизить скорость работы сцены и скорость загрузки сцены.

=== Исходный XML код===
Прим. id="369" - идентификатор объекта Options, сохраняющего все переменные приложения. id="7845" - идентификатор объекта

<pre>
<obj id="7845" type="machine" nm="array" sync="1" w="1" h="1">
<st id="init"/>
<st id="get">
<var nm="a1" obj="7845" par="a1"/>
<var nm="a2" obj="7845" par="a2"/>
<var nm="a3" obj="7845" par="a3"/>
<var nm="a4" obj="7845" par="a4"/>
<var nm="a5" obj="7845" par="a5"/>
<var nm="a6" obj="7845" par="a6"/>
<var nm="a7" obj="7845" par="a7"/>
<var nm="a8" obj="7845" par="a8"/>
<var nm="a9" obj="7845" par="a9"/>
<var nm="a10" obj="7845" par="a10"/>
<var nm="a11" obj="7845" par="a11"/>
<var nm="a12" obj="7845" par="a12"/>
<var nm="a13" obj="7845" par="a13"/>
<var nm="a14" obj="7845" par="a14"/>
<var nm="a15" obj="7845" par="a15"/>
<var nm="a16" obj="7845" par="a16"/>
<var nm="a17" obj="7845" par="a17"/>
<var nm="a18" obj="7845" par="a18"/>
<var nm="a19" obj="7845" par="a19"/>
<var nm="a20" obj="7845" par="a20"/>
<set obj="7845" par="val" val="(a1)" round="1" if="0"/>
<set obj="7845" par="val" val="(a2)" round="1" if="1"/>
<set obj="7845" par="val" val="(a3)" round="1" if="2"/>
<set obj="7845" par="val" val="(a4)" round="1" if="3"/>
<set obj="7845" par="val" val="(a5)" round="1" if="4"/>
<set obj="7845" par="val" val="(a6)" round="1" if="5"/>
<set obj="7845" par="val" val="(a7)" round="1" if="6"/>
<set obj="7845" par="val" val="(a8)" round="1" if="7"/>
<set obj="7845" par="val" val="(a9)" round="1" if="8"/>
<set obj="7845" par="val" val="(a10)" round="1" if="9"/>
<set obj="7845" par="val" val="(a11)" round="1" if="10"/>
<set obj="7845" par="val" val="(a12)" round="1" if="11"/>
<set obj="7845" par="val" val="(a13)" round="1" if="12"/>
<set obj="7845" par="val" val="(a14)" round="1" if="13"/>
<set obj="7845" par="val" val="(a15)" round="1" if="14"/>
<set obj="7845" par="val" val="(a16)" round="1" if="15"/>
<set obj="7845" par="val" val="(a17)" round="1" if="16"/>
<set obj="7845" par="val" val="(a18)" round="1" if="17"/>
<set obj="7845" par="val" val="(a19)" round="1" if="18"/>
<set obj="7845" par="val" val="(a20)" round="1" if="19"/>
<if obj="7845" par="index1" val="1"/>
<if obj="7845" par="index1" val="2"/>
<if obj="7845" par="index1" val="3"/>
<if obj="7845" par="index1" val="4"/>
<if obj="7845" par="index1" val="5"/>
<if obj="7845" par="index1" val="6"/>
<if obj="7845" par="index1" val="7"/>
<if obj="7845" par="index1" val="8"/>
<if obj="7845" par="index1" val="9"/>
<if obj="7845" par="index1" val="10"/>
<if obj="7845" par="index1" val="11"/>
<if obj="7845" par="index1" val="12"/>
<if obj="7845" par="index1" val="13"/>
<if obj="7845" par="index1" val="14"/>
<if obj="7845" par="index1" val="15"/>
<if obj="7845" par="index1" val="16"/>
<if obj="7845" par="index1" val="17"/>
<if obj="7845" par="index1" val="18"/>
<if obj="7845" par="index1" val="19"/>
<if obj="7845" par="index1" val="20"/>
</st>
<st id="set">
<var nm="val" obj="7845" par="val"/>
<set obj="7845" par="a1" val="(val)" round="1" if="0"/>
<set obj="7845" par="a2" val="(val)" round="1" if="1"/>
<set obj="7845" par="a3" val="(val)" round="1" if="2"/>
<set obj="7845" par="a4" val="(val)" round="1" if="3"/>
<set obj="7845" par="a5" val="(val)" round="1" if="4"/>
<set obj="7845" par="a6" val="(val)" round="1" if="5"/>
<set obj="7845" par="a7" val="(val)" round="1" if="6"/>
<set obj="7845" par="a8" val="(val)" round="1" if="7"/>
<set obj="7845" par="a9" val="(val)" round="1" if="8"/>
<set obj="7845" par="a10" val="(val)" round="1" if="9"/>
<set obj="7845" par="a11" val="(val)" round="1" if="10"/>
<set obj="7845" par="a12" val="(val)" round="1" if="11"/>
<set obj="7845" par="a13" val="(val)" round="1" if="12"/>
<set obj="7845" par="a14" val="(val)" round="1" if="13"/>
<set obj="7845" par="a15" val="(val)" round="1" if="14"/>
<set obj="7845" par="a16" val="(val)" round="1" if="15"/>
<set obj="7845" par="a17" val="(val)" round="1" if="16"/>
<set obj="7845" par="a18" val="(val)" round="1" if="17"/>
<set obj="7845" par="a19" val="(val)" round="1" if="18"/>
<set obj="7845" par="a20" val="(val)" round="1" if="19"/>
<if obj="7845" par="index1" val="1"/>
<if obj="7845" par="index1" val="2"/>
<if obj="7845" par="index1" val="3"/>
<if obj="7845" par="index1" val="4"/>
<if obj="7845" par="index1" val="5"/>
<if obj="7845" par="index1" val="6"/>
<if obj="7845" par="index1" val="7"/>
<if obj="7845" par="index1" val="8"/>
<if obj="7845" par="index1" val="9"/>
<if obj="7845" par="index1" val="10"/>
<if obj="7845" par="index1" val="11"/>
<if obj="7845" par="index1" val="12"/>
<if obj="7845" par="index1" val="13"/>
<if obj="7845" par="index1" val="14"/>
<if obj="7845" par="index1" val="15"/>
<if obj="7845" par="index1" val="16"/>
<if obj="7845" par="index1" val="17"/>
<if obj="7845" par="index1" val="18"/>
<if obj="7845" par="index1" val="19"/>
<if obj="7845" par="index1" val="20"/>
</st>
<st id="load">
<var nm="a1" obj="369" par="array.a1" user="1"/>
<var nm="a2" obj="369" par="array.a2" user="1"/>
<var nm="a3" obj="369" par="array.a3" user="1"/>
<var nm="a4" obj="369" par="array.a4" user="1"/>
<var nm="a5" obj="369" par="array.a5" user="1"/>
<var nm="a6" obj="369" par="array.a6" user="1"/>
<var nm="a7" obj="369" par="array.a7" user="1"/>
<var nm="a8" obj="369" par="array.a8" user="1"/>
<var nm="a9" obj="369" par="array.a9" user="1"/>
<var nm="a10" obj="369" par="array.a10" user="1"/>
<var nm="a11" obj="369" par="array.a11" user="1"/>
<var nm="a12" obj="369" par="array.a12" user="1"/>
<var nm="a13" obj="369" par="array.a13" user="1"/>
<var nm="a14" obj="369" par="array.a14" user="1"/>
<var nm="a15" obj="369" par="array.a15" user="1"/>
<var nm="a16" obj="369" par="array.a16" user="1"/>
<var nm="a17" obj="369" par="array.a17" user="1"/>
<var nm="a18" obj="369" par="array.a18" user="1"/>
<var nm="a19" obj="369" par="array.a19" user="1"/>
<var nm="a20" obj="369" par="array.a20" user="1"/>
<set obj="7845" par="a1" val="(a1)" round="1" if="0"/>
<set obj="7845" par="a2" val="(a2)" round="1" if="1"/>
<set obj="7845" par="a3" val="(a3)" round="1" if="2"/>
<set obj="7845" par="a4" val="(a4)" round="1" if="3"/>
<set obj="7845" par="a5" val="(a5)" round="1" if="4"/>
<set obj="7845" par="a6" val="(a6)" round="1" if="5"/>
<set obj="7845" par="a7" val="(a7)" round="1" if="6"/>
<set obj="7845" par="a8" val="(a8)" round="1" if="7"/>
<set obj="7845" par="a9" val="(a9)" round="1" if="8"/>
<set obj="7845" par="a10" val="(a10)" round="1" if="9"/>
<set obj="7845" par="a11" val="(a11)" round="1" if="10"/>
<set obj="7845" par="a12" val="(a12)" round="1" if="11"/>
<set obj="7845" par="a13" val="(a13)" round="1" if="12"/>
<set obj="7845" par="a14" val="(a14)" round="1" if="13"/>
<set obj="7845" par="a15" val="(a15)" round="1" if="14"/>
<set obj="7845" par="a16" val="(a16)" round="1" if="15"/>
<set obj="7845" par="a17" val="(a17)" round="1" if="16"/>
<set obj="7845" par="a18" val="(a18)" round="1" if="17"/>
<set obj="7845" par="a19" val="(a19)" round="1" if="18"/>
<set obj="7845" par="a20" val="(a20)" round="1" if="19"/>
<if obj="7845" par="len" op=">" val="0"/>
<if obj="7845" par="len" op=">" val="1"/>
<if obj="7845" par="len" op=">" val="2"/>
<if obj="7845" par="len" op=">" val="3"/>
<if obj="7845" par="len" op=">" val="4"/>
<if obj="7845" par="len" op=">" val="5"/>
<if obj="7845" par="len" op=">" val="6"/>
<if obj="7845" par="len" op=">" val="7"/>
<if obj="7845" par="len" op=">" val="8"/>
<if obj="7845" par="len" op=">" val="9"/>
<if obj="7845" par="len" op=">" val="10"/>
<if obj="7845" par="len" op=">" val="11"/>
<if obj="7845" par="len" op=">" val="12"/>
<if obj="7845" par="len" op=">" val="13"/>
<if obj="7845" par="len" op=">" val="14"/>
<if obj="7845" par="len" op=">" val="15"/>
<if obj="7845" par="len" op=">" val="16"/>
<if obj="7845" par="len" op=">" val="17"/>
<if obj="7845" par="len" op=">" val="18"/>
<if obj="7845" par="len" op=">" val="19"/>
</st>
<st id="save">
<var nm="len" obj="7845" par="len"/>
<var nm="a1" obj="7845" par="a1"/>
<var nm="a2" obj="7845" par="a2"/>
<var nm="a3" obj="7845" par="a3"/>
<var nm="a4" obj="7845" par="a4"/>
<var nm="a5" obj="7845" par="a5"/>
<var nm="a6" obj="7845" par="a6"/>
<var nm="a7" obj="7845" par="a7"/>
<var nm="a8" obj="7845" par="a8"/>
<var nm="a9" obj="7845" par="a9"/>
<var nm="a10" obj="7845" par="a10"/>
<var nm="a11" obj="7845" par="a11"/>
<var nm="a12" obj="7845" par="a12"/>
<var nm="a13" obj="7845" par="a13"/>
<var nm="a14" obj="7845" par="a14"/>
<var nm="a15" obj="7845" par="a15"/>
<var nm="a16" obj="7845" par="a16"/>
<var nm="a17" obj="7845" par="a17"/>
<var nm="a18" obj="7845" par="a18"/>
<var nm="a19" obj="7845" par="a19"/>
<var nm="a20" obj="7845" par="a20"/>
<set obj="369" par="array.a1" val="(a1)" round="1" user="1" if="0"/>
<set obj="369" par="array.a2" val="(a2)" round="1" user="1" if="1"/>
<set obj="369" par="array.a3" val="(a3)" round="1" user="1" if="2"/>
<set obj="369" par="array.a4" val="(a4)" round="1" user="1" if="3"/>
<set obj="369" par="array.a5" val="(a5)" round="1" user="1" if="4"/>
<set obj="369" par="array.a6" val="(a6)" round="1" user="1" if="5"/>
<set obj="369" par="array.a7" val="(a7)" round="1" user="1" if="6"/>
<set obj="369" par="array.a8" val="(a8)" round="1" user="1" if="7"/>
<set obj="369" par="array.a9" val="(a9)" round="1" user="1" if="8"/>
<set obj="369" par="array.a10" val="(a10)" round="1" user="1" if="9"/>
<set obj="369" par="array.a11" val="(a11)" round="1" user="1" if="10"/>
<set obj="369" par="array.a12" val="(a12)" round="1" user="1" if="11"/>
<set obj="369" par="array.a13" val="(a13)" round="1" user="1" if="12"/>
<set obj="369" par="array.a14" val="(a14)" round="1" user="1" if="13"/>
<set obj="369" par="array.a15" val="(a15)" round="1" user="1" if="14"/>
<set obj="369" par="array.a16" val="(a16)" round="1" user="1" if="15"/>
<set obj="369" par="array.a17" val="(a17)" round="1" user="1" if="16"/>
<set obj="369" par="array.a18" val="(a18)" round="1" user="1" if="17"/>
<set obj="369" par="array.a19" val="(a19)" round="1" user="1" if="18"/>
<set obj="369" par="array.a20" val="(a20)" round="1" user="1" if="19"/>
<set obj="369" par="array.len" val="(len)" round="1" user="1"/>
<if obj="7845" par="len" op=">" val="0"/>
<if obj="7845" par="len" op=">" val="1"/>
<if obj="7845" par="len" op=">" val="2"/>
<if obj="7845" par="len" op=">" val="3"/>
<if obj="7845" par="len" op=">" val="4"/>
<if obj="7845" par="len" op=">" val="5"/>
<if obj="7845" par="len" op=">" val="6"/>
<if obj="7845" par="len" op=">" val="7"/>
<if obj="7845" par="len" op=">" val="8"/>
<if obj="7845" par="len" op=">" val="9"/>
<if obj="7845" par="len" op=">" val="10"/>
<if obj="7845" par="len" op=">" val="11"/>
<if obj="7845" par="len" op=">" val="12"/>
<if obj="7845" par="len" op=">" val="13"/>
<if obj="7845" par="len" op=">" val="14"/>
<if obj="7845" par="len" op=">" val="15"/>
<if obj="7845" par="len" op=">" val="16"/>
<if obj="7845" par="len" op=">" val="17"/>
<if obj="7845" par="len" op=">" val="18"/>
<if obj="7845" par="len" op=">" val="19"/>
</st>
</obj>
</pre>

=== Машина состояний объекта ===
[[Файл:array.jpg]]

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

[http://fs5.absolutist.com/files/wikisample/machine.rar Download]

== Clone ==
Clone - параметр команды init в разделе "системные действия".

[[Файл:Clone1.PNG]]

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

[[Файл:Clone2.PNG]]

=== Свойства ===

1) Клонированная машина состояний имеет все свойства, состояния и параметры исходного объекта клонирования.

2) Клоны рождаются и умирают в рамках одного экрана.

3) Клоны отличаются друг от друга лишь параметром '''clone_num''', который у оригинала равен "-1", а у клонов от 0 до N.

4) Нежелательно применять клонирование к клону во избежание путаницы значений параметра '''clone_num'''.

5) Если при проверке условия [[#if|if]] в поле '''obj''' указать this, это значит что if будет проводить проверку текущего объекта. Таким образом машина может сама себя проверить по параметру '''clone_num''' клон ли она и если да то какой у нее номер;

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

По ссылке пример использования с подробным описанием машин.

[http://fs5.absolutist.com/files/wikisample/Clone.zip Download]

== Параметр команды машины состояний ==

В случае, когда необходимо изменить значение какого-либо параметра в командах машины состояний (например v в команде move) в процессе работы приложения, можно использовать блок "Параметр команды машины состояний" в команде ''set'' машины состояний. Приведу пример использования этого блока.

Пусть есть 2 машины: управляющая и управляемая.

[[Файл:Stm1.jpg|300px]][[Файл:Stm2.jpg|300px]]

Управляемая машина практически пустая и не содержит каких либо данных о движении, но тем не менее при запуске она будет двигаться, меняя направление. Это движение - заслуга управляющей машины, которая на ходу изменяет параметры движения управляемой. Рассмотрим более детально ее состояния.

В первом состоянии "wait" мы пытаемся изменить скорость движения управляемой машины. Для этого указали объект (sun), состояние в котором хотим поменять параметр (у машины sun это состояние move), имя команды в которой меняем параметр (в данном случае это move), номер команды (если таких команд несколько, то нужно указать порядковый номер начиная с 0; в нашем случае команда одна), имя параметра (мы хотим изменить скорость, поэтому имя параметра v) и значение (указали значение 200). После этого переходим в следующее состояние.

В состоянии "1" управляющей машины сначала мы вывели объект sun из состояния move, изменили параметр целевой координаты x на 512 и затем вернули в состояние move, чтобы применить изменения параметров. Таким образом управляемая машина начала движение в x=512 со скоростью 200. Через 2 секунды мы переводим управляющую машину в состояние "2", где аналогичным образом изменяется целевая координата на -512.

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

==Запись в viewer.log ==

В процессе работы машина состояний пишет информацию о своей работе. Она имеет следующий вид. Жирным шрифтом выделено полезную информацию.

*Machine::state() state machine '''stat_google_gold (id:30818)''' from '''enough_coins''' to '''enough_coins''' through object '''c_current_gold (id:8807)''' from state '''inc''' - машина с именем и id '''stat_google_gold (id:30818)''' перешла из состояния '''enough_coins''' в '''enough_coins'''; ее состояние изменил объект с именем и id '''c_current_gold (id:8807)''' из состояния '''inc'''.
*GMachine::Set::init() GMachine(id:28076)::Set::init set id:17
*GMachine::Command::calcExpr() GMachine::Command::calcExpr ((0|(!1))|(!2)) checkIf(0)=no
*GMachine::Command::calcExpr() GMachine::Command::calcExpr ((0|(!1))|(!2)) checkIf(1)=yes
*GMachine::Command::calcExpr() GMachine::Command::calcExpr ((0|(!1))|(!2)) checkIf(2)=yes
*GMachine::Command::checkIf() GMachine(id:28076)::Command::checkIf id:17 expr:((0|(!1))|(!2)) res:false
*GMachine::Set::init() GMachine(id:28076)::Set::init set id:18
*GMachine::Command::checkIf() GMachine(id:28076)::Command::checkIf id:18 expr: res:true
*GMachine::Set::init() GMachine(id:28076)::Set::init set id:18 checkIf success
*GMachine::Set::init() GMachine(id:28076)::Set::init set id:18 obj:16039 -> par:param_name val:bundle_coins us:0
*GMachine::Command::getVarValue() Command::getVarValue(bundle_item): float result = 0.00

[[Category:Main objects]]

Cloud

2015-11-26T15:05:08Z

Vefimov: /* Параметры объекта Cloud */

Объект необходим для синхронизации приложения с облаком.

=Параметры объекта Cloud=

==parse general==

*'''app''' - Код приложения из parse
*'''key''' - Ключ приложения из parse
*'''имя игры''' - Наше внутреннее имя игры в parse
*'''имя игрока''' - Имя игрока. Заполнить до любых вызовов состояний
*'''cloud major field''' - Главное поле в опциях, по которому будет выбираться версия опций в cloud при кофликте (наибольшее из значений будет приоритетнее)
*'''автоприменение''' - Применять лучшие опции автоматически. Если "нет" то нужно подтверждение пользователя.

==parse leaderboards==

*'''лидерборд''' - id таблицы на сервере, в которую будет засылать очки. Начинается с латинской буквы! Не содержит левых символов!
*'''очки''' - Очки для отправки. Валидное целое число!
*'''таблица''' - объект-таблица, в который сложим очки. Должна иметь три колонки (место-имя-очки), заполнение по строкам - в случае если не указан "шаблон".
*'''шаблон''' - объект типа leaderboardsitem для помещения в таблицу
*'''свое место''' - каунтер в котором будет место игрока
*'''свои очки''' - каунтер в котором будут очки игрока
*'''запрашивать записей''' - сколько записей запросить из таблицы

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

[[Файл:+.png]] '''ошибка загрузки данных из cloud: изменить состояние объекта''' - сейчас не применяется, т.к. используем ErrorManager.
*'''объект''' - объект у которого мы меняем состояние.
*'''состояние''' - Значение нового состояния.

[[Файл:+.png]] '''нечего загружать из cloud: изменить состояние объекта''' - обработчик неуспеха ''parse_load'' в случае отсутствия данных на сервере.
*'''объект''' - объект у которого мы меняем состояние.
*'''состояние''' - Значение нового состояния.

[[Файл:+.png]] '''подтверждение применения данных из cloud: изменить состояние объекта''' - обработчик успеха ''parse_load'' в случае наличия данных на сервере с таким же ''device_id''
*'''объект''' - объект у которого мы меняем состояние.
*'''состояние''' - Значение нового состояния.

[[Файл:+.png]] '''применены данные из cloud: изменить состояние объекта''' - обработчик успеха ''parse_apply'', желательно перегрузить лайаут.
*'''объект''' - объект у которого мы меняем состояние.
*'''состояние''' - Значение нового состояния.

[[Файл:+.png]] '''подтверждение применения данных из cloud при наличии двух комплектов данных в сети: изменить состояние объекта''' - обработчик успеха ''parse_load'' в случае наличия двух комплектов данных на сервере (например, по facebook_id)
*'''объект''' - объект, состояние которого меняем.
*'''состояние''' - новое состояние для объекта из предыдущего поля.

[[Файл:+.png]] '''в cloud опции хуже, не применям их: изменить состояние объекта''' - обработчик неуспеха ''parse_load'' в случае, когда данные на сервере хуже, чем на текущем устройстве.
*'''объект''' - объект, состояние которого меняем.
*'''состояние''' - новое состояние для объекта из предыдущего поля.

[[Файл:+.png]] '''голосование загружено: изменить состояние объекта'''
*'''объект''' - объект, состояние которого меняем.
*'''состояние''' - новое состояние для объекта из предыдущего поля.

[[Файл:+.png]] '''успешно проголосовали: изменить состояние объекта'''
*'''объект''' - объект, состояние которого меняем.
*'''состояние''' - новое состояние для объекта из предыдущего поля.

[[Файл:+.png]] '''запрос в парсе успешно выполнен (любой)''' - обработчик успеха любого запроса.
*'''объект''' - объект, состояние которого меняем.
*'''состояние''' - новое состояние для объекта из предыдущего поля.

[[Файл:+.png]] '''ошибка, нужно обновить приложение''' - обработчик неуспеха ''parse_load'', когда версия текущего приложения ниже, чем версия опциях на сервере.
*'''объект''' - объект, состояние которого меняем.
*'''состояние''' - новое состояние для объекта из предыдущего поля.

[[Файл:+.png]] '''успешно проведен серверный resolve''' - обработчик успеха ''parse_apply_server'', желательно перезагрузить лэйаут.
*'''объект''' - объект, состояние которого меняем.
*'''состояние''' - новое состояние для объекта из предыдущего поля.

[[Файл:+.png]] '''успешно проведена изоляция''' - обработчик успеха ''parse_isolate''.
*'''объект''' - объект, состояние которого меняем.
*'''состояние'''- новое состояние для объекта из предыдущего поля.

[[Файл:+.png]] '''успешно проведена разизоляция''' - обработчик успеха ''parse_un_isolate''.
*'''объект''' - объект, состояние которого меняем.
*'''состояние''' - новое состояние для объекта из предыдущего поля.

[[Файл:+.png]] '''синхронизируемый параметр между приложениями устройства''' - позволяет синхронизировать конкретный параметр между разными приложениями через parse.
*'''группа''' - имя группы, общее для различных приложений, которые синхронизируют данный параметр
*'''параметр''' - имя параметра в группе, общее для различных приложений
*'''объект''' - объект у которого синхронизируем параметр.
*'''параметр объекта''' - параметр который синхронизируем.

==Особенности использования==

Есть несколько платформ, которые не поддерживают работу с фейсбуком. Это blackberry, win 8.1, windows phone 8.
При этом эти устройства могут взаимодействовать с клаудом. При этом есть ряд проблем с этими платформами: каждый пользователь будет отправлять свои результаты в лидерборды под ником new_user (или другим дефолтным); не до конца прозрачна ситуация с включением/отключением изоляции игроков.
Для того, что бы отключить сохранение в клауд для этих платформ нужно установить в опциях флаг disable_cloud_save = 1.
Опросник при этом работает нормально.

=Состояния=

*'''parse_load''' - загружает из облака опции
*'''parse_save''' - сохраняет опции в клауд. Автоматически сохраняется при переходе с экрана на экран и при выходе из приложения.
*'''parse_apply''' - применяет загруженные опции при условии совпадения по device_id.
*'''parse_apply_server''' - выбирает лучшие и применяет опции при условии наличии на сервере двух наборов.
*'''parse_isolate''' - проводит изоляцию опций (сохраняет 2 набора).
*'''parse_un_isolate''' - проводит объединение опций.
*'''parse_leaderboards''' - заполняет таблицу глобальных лидербордов.
*'''parse_leaderboards_friends''' - заполняет таблицу лидербордов-друзей.
*'''parse_friends''' - заполняет таблицу парсовых друзей для отправки подарков.
*'''parse_submit''' - отправляет очки в клауд. Предварительно нужно записать кол-во очков в параметр score.
*'''parse_get_public_lb''' - показывает информацию о друге из таблицы лидербордов.
*'''parse_poll''' - загружает опросник.
*'''parse_vote''' - отправляет голос в опроснике.
*'''parse_poll_prev''' - загружает результаты предыдущего опросника.

=Сообщения в лог=

Объект пишет в опции строки:
I/GCloud GCloud::state() state val = 2 state = 3

Где val = 2 - это состояние в которое хотим перейти в дальнейшем ( в зависимости от текущего состояния, или сстанет в очередь или выполниться следующим тиком).
:state = 3 - это состояние в котором сейчас находиться объект;

Номера состояний:

*'''0 - ST_LOCAL_DEVICE_SYNCHRONIZATION''' //!< синхронизация параметров между приложениями одного устройства;

*'''1 - ST_PARSE_RESOLVE''' //!< ресолвим конфликт и ждем подтверждения;

*'''2 - ST_PARSE_IDLE''' //!< состояние простоя, означает, что мы не ждем ответа ни на один запрос;

*'''3 - ST_PARSE_LOAD''' //!< загрузить опции из парса (вызываться должно снаружи, после ввода имени) ;

*'''4 - ST_PARSE_SAVE''' //!< сохранить опции в парс c учетом предохранительной задержки SAVE_DELAY_SEC (на 2014-09-17 вызывается из единственного места - GOptions::save);

*'''5 - ST_PARSE_LEADERBOARDS''' //!< загрузить лидерборды из парса и сложить в соответствующую таблицу;

*'''6 - ST_PARSE_LEADERBOARDS_FRIENDS''' //!< загрузить лидерборды из парса и сложить в соответствующую таблицу;

*'''7 - ST_PARSE_SUBMIT''' //!< заслать очки в парс взяв очки из поля score и уровень из поля level;

*'''8 - ST_PARSE_APPLY''' //!< применить скачанные опции;

*'''9 - ST_GET_PUBLIC_LB''' //!< скопировать паблик данные кликнутого юзера из лидербордов в доступную область;

*'''10 - ST_PARSE_POLL''' //!< получить данные о текущем опроснике от клауда. Заполнить таблицу ответов;

*'''11 - ST_PARSE_POLL_PREV''' //!< получить данные о предыдущем опроснике от клауда. Заполнить таблицу ответов №2;

*'''12 - ST_PARSE_VOTE''' //!< проголосовать в текущем опроснике (номер ответа возьмем из таблицы) TODO - не нужно ли состояний против и за?;

*'''13 - ST_PARSE_SHARE_POLL''' //!< зашарить результаты текущего опроса;

*'''14 - ST_PARSE_FORCED_SAVE''' //!< сохранить опции в парс незамедлительно (на 2014-09-17 вызывается из единственного места - GOptions::save);

*'''15 - ST_PARSE_APPLY_SERVER''' //!< применить опции и отправить ресолв;

*'''16 - ST_PARSE_CLEAR_NOTIFICATIONS''' //!< отписаться от уведомлений;

*'''17 - ST_PARSE_ADD_NOTIFICATION''' //!< добавить уведомление (не требует действий с сетью, реальная отправка - по потере фокуса);

*'''18 - ST_PARSE_TIME''' //!< запросить время;

*'''19 - ST_PARSE_FRIENDS''' //!< заполнить таблицу всех друзей (новые подарки);

*'''20 - ST_PARSE_ISOLATE''' //!< отказаться от слияния аккаунтов;

*'''21 - ST_PARSE_UN_ISOLATE''' //!< отменить изоляцию

[[Category:Options|*]]

Отличия подготовки проекта для разных платформ

2015-11-11T15:07:26Z

Vefimov:

{{TOC right}}
[[Файл:Simple.png|thumb|right]]
AppSalute Game Сreator позволяет использовать один проект (один лейаут), чтобы собирать приложение для разных платформ (маркетов).
Значительная часть проекта одинакова для всех платформ, но существуют некоторые различия. Для того чтобы иметь один лейаут для всех платформ используется внутренняя переменная "market", которая задается в конфигурационном файле platform.icf. И которая переносится в приложении непосредственно при сборке.

В самом же проекте, проверяя значение этой переменной реализуем нужную логику. На данный момент такую проверку можно делать в [[Machine|машине состояний]], а также в [[Taskorganizer|таскорганайзере]].

На данный момент существует 2 основных вида сборок - для мобильных платформ (google, ios) и для веб-платформ (facebook).
Как подготовить версию для веб-платформ из версии для мобильных платформ описано в этой статье: https://docs.google.com/document/d/1seTO3nphCsqqYHjumkl6b4r9RWLNGdokHjpDyDDP1T4/edit#

Кроме отличий в самом проекте, также есть отличия при сборке проекта. Эти особенности также будут описаны ниже, но на данный момент эти отличия применяются автоматически при сборке через артефактори.

=Google Play=
*Значение переменной market = "android".
*Если в проекте есть курсоры (для веб-версий), то при запуске (на глобальном экране) приложения [[Options|опциям]] нужно вызывать состояние disableCursor.
*Для приложений GP есть возможность использовать социальную сеть G+. Для этого при запуске приложения (на глобальном экране) нужно установить объекту [[Esocial]] параметр socialnet = 2.
*На GP есть система внутриигровых достижений (ачивок). Для их корректной работы должен быть настроен объект [[Gamecenter]]. В частности в нем должны быть указаны ключи ачивок. Ачивки заводят маркетологи, они же дают ключи.
*Для доступа к сервису GP в проекте должно быть 2 кнопки: одна для доступа к ачивкам, вторая для доступа к лидерам. Также, если в проект поддерживаются локальные достижения, то в [[Gamecenter]] нужно указать текст для этого достижения.
*По системной кнопке "back" должно закрываться открытое окно. Если открытых окон нет, показывается окно выхода из приложения / хиддена / миниигы и тд.
*Если в приложении есть реклама, то в файле конфигурации (platform.icf) должны быть указаны параметры для провайдера рекламы.
*Если используется [[Flurry|флурри]] в файле viewer_google.xml должен быть указан game_id.
*Так как упаковка экранов оптимизирована для веб-платформ, то на данный момент после экспорта в файле *.sirx нужно найти ноду в которой указан адрес для закачки 1-го пака(имеет вид <pack fsize="406951055" url="imgs1/res.dat" md5="7a...d" p="1"/>) и изменить в ней url на следующий: "http://imgs1/res.dat".
*Размер apk файла для приложения на GP ограничено 100 мб. Если приложение больше этого размера, то его нужно разделить на 2 пака. Содержимое второго пака нужно поместить в zip архив и переименовать его в соответствии с шаблоном main.v1.v2.v3.****.obb (v1, v2, v3 - составные версии приложения, ***** - некое имя приложения на GP). Потом этот файл нужно будет поместить в соответствующий каталог для сборки.
*'''Перед тестированием версию всегда нужно заливать в альфу GP. Что бы версию можно было залить в альфу, нужно чтобы текущая версия была выше предыдущей.'''

=iTunes=
*Значение переменной market = "ios".
*Если в проекте есть курсоры (для веб-версий), то при запуске (на глобальном экране) приложения [[Options|опциям]] нужно вызывать состояние disableCursor.
*На iTunse есть система внутриигровых достижений (ачивок). Для их корректной работы должен быть настроен объект [[Gamecenter]]. В частности в нем должны быть указаны ключи ачивок. Ачивки заводят маркетологи, они же дают ключи.
*Для доступа к геймцентру в проекте должно быть кнопка, которая вызывает состояние achievements_show. Также, если в проект поддерживаются локальные достижения, то в [[Gamecenter]] нужно указать текст для этого достижения.
*Если в приложении есть реклама, то в файле конфигурации (platform.icf) должны быть указаны параметры для провайдера рекламы.
*Если используется [[Flurry|флурри]] в файле viewer_iphone.xml должен быть указан game_id.
*Приложение пакуем в 2 пака(настройки как для GP), 2 пак архивом не жмем.

=Amazon Appstore=
*Значение переменной market = "amazon".
*Если в проекте есть курсоры (для веб-версий), то при запуске (на глобальном экране) приложения [[Options|опциям]] нужно вызывать состояние disableCursor.
*На Amazon Appstore есть система внутриигровых достижений (ачивок). Для их корректной работы должен быть настроен объект [[Gamecenter]]. В частности в нем должны быть указаны ключи ачивок. Ачивки заводят маркетологи, они же дают ключи.
*Для доступа к геймцентру в проекте должно быть кнопка, которая вызывает состояние achievements_show. Также, если в проект поддерживаются локальные достижения, то в [[Gamecenter]] нужно указать текст для этого достижения.
*По системной кнопке "back" должно закрываться открытое окно. Если открытых окон нет, показывается окно выхода из приложения / хиддена / миниигы и тд.
*Если в приложении есть реклама, то в файле конфигурации (platform.icf) должны быть указаны параметры для провайдера рекламы.
*Если используется [[Flurry|флурри]] в файле viewer_amazon.xml должен быть указан game_id.
*Так как упаковка экранов оптимизирована для веб-платформ, то на данный момент после экспорта в файле *.sirx нужно найти ноду в которой указан адрес для закачки 1-го пака(имеет вид <pack fsize="406951055" url="imgs1/res.dat" md5="7a...d" p="1"/>) и изменить в ней url на следующий: "http://imgs1/res.dat".
*Приложение разбивается на 2 пака. Содержимое второго пака нужно поместить в zip архив и переименовать его в pack.zip. Потом этот файл нужно будет поместить в соответствующий каталог для сборки.

=Samsung Galaxy Apps=
*Значение переменной market = "samsung".
*Если в проекте есть курсоры (для веб-версий), то при запуске (на глобальном экране) приложения [[Options|опциям]] нужно вызывать состояние disableCursor.
*Данный маркет не имеет собственного геймцентра, но на нем можно использовать локальные достижения. Для этого в [[Gamecenter]] нужно указать текст для этого достижения.
*По системной кнопке "back" должно закрываться открытое окно. Если открытых окон нет, показывается окно выхода из приложения / хиддена / миниигы и тд.
*Если используется [[Flurry|флурри]] в файле viewer_samsung.xml должен быть указан game_id.
*Так как упаковка экранов оптимизирована для веб-платформ, то на данный момент после экспорта в файле *.sirx нужно найти ноду в которой указан адрес для закачки 1-го пака(имеет вид <pack fsize="406951055" url="imgs1/res.dat" md5="7a...d" p="1"/>) и изменить в ней url на следующий: "http://imgs1/res.dat".
*Приложение разбивается на 2 пака. Содержимое второго пака нужно поместить в zip архив и переименовать его в pack.zip. Потом этот файл нужно будет поместить в соответствующий каталог для сборки.
*Samsung Galaxy Apps просит, чтобы их приложение чем то отличалось, от версии на GP. На начальном этапе игры можно сделать подарок, где указать, что это уникальная особенность для пользователей данного маркета.

=BlackBerry World=
*Значение переменной market = "blackberry".
*Если в проекте есть курсоры (для веб-версий), то при запуске (на глобальном экране) приложения [[Options|опциям]] нужно вызывать состояние disableCursor.
*Данный маркет не имеет собственного геймцентра, но на нем можно использовать локальные достижения. Для этого в [[Gamecenter]] нужно указать текст для этого достижения.
*[[Flurry|Флурри]] не используется, но для работы других сервисов статистики в файле viewer_blackberry.xml должна быть указана заглушка в параметре game_id.
*Так как упаковка экранов оптимизирована для веб-платформ, то на данный момент после экспорта в файле *.sirx нужно найти ноду в которой указан адрес для закачки 1-го пака(имеет вид <pack fsize="406951055" url="imgs1/res.dat" md5="7a...d" p="1"/>) и изменить в ней url на следующий: "http://imgs1/res.dat".
*Приложение разбивается на 2 пака. Содержимое второго пака нужно поместить в zip архив и переименовать его в pack.zip. Потом этот файл нужно будет поместить в соответствующий каталог для сборки.
*'''Данная платформа не поддерживает социальные сети.''' Поэтому после сборки, нужно в layout.xml найти объект "facebook" и изменить его тип на "image". В самом проекте, в тех местах где идет обращение к социальным сервисам нужно подключить сообщение заглушку. В основном такую проверку нужно делать для кнопок, открывающих окна с социалкой и попап-окна логина.

=Windows Store 8.1=
*Значение переменной market = "ws81".
*Если в проекте есть курсоры (для веб-версий), то при запуске (на глобальном экране) приложения [[Options|опциям]] нужно вызывать состояние disableCursor.
*Данный маркет не имеет собственного геймцентра, но на нем можно использовать локальные достижения. Для этого в [[Gamecenter]] нужно указать текст для этого достижения.
*[[Flurry|Флурри]] не используется, но для работы других сервисов статистики в файле viewer_blackberry.xml должна быть указана заглушка в параметре game_id.
*Приложение пакуем в 2 пака(настройки как для GP), 2 пак архивом не жмем.
*'''Данная платформа не поддерживает социальные сети.''' Поэтому после сборки, нужно в layout.xml найти объект "facebook" и изменить его тип на "image". В самом проекте, в тех местах где идет обращение к социальным сервисам нужно подключить сообщение заглушку. В основном такую проверку нужно делать для кнопок, открывающих окна с социалкой и попап-окна логина.

=Facebook=
*Значение переменной market = "webfb".
*Для корректной работы курсора нужно указать его для каждого экрана в проекте, а также поместить на расшаренной сцене с альфой = 0. (Чтобы подтягивался ресурс при экспорте и но не было переключений между текстурами). При загрузке приложения [[Options|опциям]] нужно вызывать состояние readCursor. Также в файле app.icf в параметрах нужно указать id ресурса для курсора (используя param_name и param_value).
*Геймцентра нет, но есть механизм постов на стену при получении очередного достижения. В [[Gamecenter]] указываем ключи этих достижений. Ключи представляют собой адрес к файлу ачивки на сервере. Для показа ачивок используются локальные достижения. Для этого в [[Gamecenter]] нужно указать текст для этих достижений.
*В веб-версиях человек может играть в фулскрине, для этого нужно сделать кнопки смены режима (обычный/фулскрин). Также нужно предусмотреть выход из фулскрина, при совершении покупки (Устанавливать опциям fullScreen = 0, при нажатии на кнопку совершения покупки).
*Для веб-версий нужно отключить иконку социальной сети, выключив vis картинке, указанной в поле snIco, в темплейте иконки друга.
*Для каждой покупки нужен специальный файл, который должен быть загружен на сервер. Так же обстоит дело с постами на стену (при сдаче коллекций, получении нового уровня, ачивки и тд). При получении очередного достижения (сдача коллекции, новый уровень и тд), человек может отправить себе на стену пост об этом достижении. При этом на соответствующей кнопке вместо "Принять" нужно писать "Поделиться".
*Каждый экран должен быть упакован в отдельный пак. После экспорта, видео в формате absmp4 нужно изменить формат на mp4. Также нужно изменить расширение для видео в файле *.sirx.

=Yahoo=
*Значение переменной market = "webya".
*Для корректной работы курсора нужно указать его для каждого экрана в проекте, а также поместить на расшаренной сцене с альфой = 0. (Чтобы подтягивался ресурс при экспорте и но не было переключений между текстурами). При загрузке приложения [[Options|опциям]] нужно вызывать состояние readCursor. Также в файле app.icf в параметрах нужно указать id ресурса для курсора (используя param_name и param_value).
*Таким же образом (используя param_name и param_value) указываем параметр lang = en.
*Геймцентра нет, но есть локальные достижения. Для их показа в [[Gamecenter]] нужно указать текст для этих достижений.
*В веб-версиях человек может играть в фулскрине, для этого нужно сделать кнопки смены режима (обычный/фулскрин). Также нужно предусмотреть выход из фулскрина, при совершении покупки (Устанавливать опциям fullScreen = 0, при нажатии на кнопку совершения покупки).
*Для веб-версий нужно отключить иконку социальной сети, выключив vis картинке, указанной в поле snIco, в темплейте иконки друга.
*Механизма постов на стену нет, надписи "Поделиться" быть не должно. Кнопку "Поделиться" из окна коллекций делаем недоступной.
*Также прячем в настройках чекбокс "Уведомления". На Yahoo их нет.
*Каждый экран должен быть упакован в отдельный пак. После экспорта, видео в формате absmp4 нужно изменить формат на mp4. Также нужно изменить расширение для видео в файле *.sirx.

[[Category:Projects]]

Absolutist Framework

2015-11-11T14:00:22Z

Vefimov: /* Подготовка проекта */

{{TOC right}}
'''[[:category:main|Категории]]'''
== Новости ==
Вышла новая игра HOG созданная с помощью AppSalute Game Сreator. Созданы новые уникальные эффекты и механики для обеспечения незабываемых впечатлений.
Описание и видео:
http://time-gap.com/

== AppSalute Game Сreator ==
* [[Примеры приложений]]
* [[Введение в AppSalute Game Сreator]]
* [[Установка и настройка]]
* [[Интерфейс ScenceEditor ]]
* [[Интерфейс ResourceEditor ]]
* [[Интерфейс TextEditor ]]
*[[Интерфейс Viewer ]]
* [[Книга жалоб и пожеланий]]
* [[Roadmap]]

== Обучение ==

* [[Learning|Уроки по освоению фреймворка]]
* [[Примеры реализации в играх]]
* [[Основные понятия объектов физического мира]]
* [[FAQ]]
== Подготовка проекта ==
* [[Проектирование экранов игры]]
* [[Подготовка и форматы графики]]
* [[Подготовка и форматы шрифтов]]
* [[Подготовка и форматы звуков]]
* [[Подготовка и форматы видео]]
* [[Создание проекта]]
* [[Загрузка проекта по частям]]
* [[Конфигурация проекта для сборки]]
* [[Подготовка для загрузки на маркеты]]
* [[Сборка проекта]]
* [[Частые ошибки]]
* [[Отличия подготовки проекта для разных платформ]]

== Встроенные объекты редактора==

=== Common objects ===

''[[Файл:Screen.png]] - [[Screen]]'' - экран

''[[Файл:Scene.png]] - [[Scene]]'' - сцена

=== Main objects ===

''[[Файл:Objects.png]] - [[Object]]'' - общие параметры для всех игровых объектов

* [[Файл:Kub.png]] - [[Azmanager]] - менеджер активных зон
* [[Файл:Kub.png]] - [[Active zone]] - активная зона
* [[Файл:Picture.png]] - [[Image]] - картинка
* [[Файл:Button.png]] - [[Button]] - кнопка
* [[Файл:Text.png]] - [[Text]] - текст
* [[Файл:Machine.png]] - [[Machine]] - машина состояний
* [[Файл:Tableicon.png]] - [[Table]] - таблица
* [[Файл:Checkbox.png]] - [[Checkbox]] - чекбокс (кнопка в 2-х состояниях)
* [[Файл:Checkgroup.png]] - [[Groupbox]] - группа, содержащая несколько чекбоксов
* [[Файл:Timer.png]] - [[Timer]] - цифровой таймер
** [[Файл:Kub.png]] - [[Globaltimer]] - таймер "реального времени"
* [[Файл:Counter2.png]] - [[Counter]] - счетчик сделанных кликов в игре и т.п.
* [[Файл:Progressbar.png]] - [[Progress]] - прогресс прохождения игры (эчивмент)
* [[Файл:Particle.png]] - [[Flyer]] - флаер (патиклы)
* [[Файл:Rectangle.png]] - [[Rectangle]] - прямоугольник
* [[Файл:Kub.png]] - [[Isomover]] - объект движения в изометрической карте
* [[Файл:Group.png]] - [[Group]] - группа
* [[Файл:Groupset.png‎]] - [[Groupset]] - группа
* [[Файл:Effect.jpg|20px]] - [[Effect]] - Создание различных эффектов
* [[Файл:Graphprogress.png]] - [[Graphprogress]] - создание мини-карты для отображения прогресса прохождения игры.
* [[Файл:Kub.png]] - [[Statesmanager]] - очередь работы с объектами
* [[Файл:Slider icons.png]] - [[Slider]] - объект реализующий листание списка.
* [[Файл:Ribbon.png]] - [[Ribbon]] - объект отображения графики по сплайну
* [[Файл:Kub.png]] - [[Animation]] - объект различных анимаций
* [[Файл:Kub.png]] - [[Magicparticles]] - объект файлов Magic Particles

=== Game mechanic ===

* [[Файл:Puzzle.png]] - [[Puzzle]] - игра пазл
* [[Файл:Memory.png]] - [[Memory]] - класс игр с memory-механикой
* [[Файл:Patchwork.png]] - [[Patchwork]] - класс игр с Patchwork-механикой
* [[Файл:Match3.png]] - [[Match]] - класс match-подобных игр
* [[Файл:Collaps.png]] - [[Collapse]] - класс match-подобных игр
* [[Файл:Bejewelled.png]] - [[Bejewelled]] - класс match-подобных игр
* [[Файл:BubbleShooter.png]] - [[Bubble Shooter]] - класс Bubble игр включая механику Снукер
* [[Файл:Tapthebubble.png]] - [[TapTheBubble]] - механика игры Tap The Bubble
* [[Файл:GemSlider.jpg]] - [[Gem Slider]] - механика игры Gem Slider
* [[Файл:W-57.png]] - [[Words]] - механика игры Words
* [[Файл:Kub.png]] - [[2048]] - механика игры 2048
* [[Файл:Matchbattle.png]] - [[Match Battle]] - настройка глобальных параметров для мини-игр
* [[Файл:Move box.png]] - [[DragBox]] - класс игр с dragbox-механикой
* [[Файл:Labyrinth.png]] - [[Labyrinth]] - класс игр лабиринт
* [[Файл:Pipes.png]] - [[Pipes]] - класс игр трубы
* [[Файл:Search object.png]] - [[HiddenObject]] - поисковый объект в хидден играх
* [[Файл:Object list.png]] - [[HiddenList]] - список поисковых объектов в хидден играх
* [[Файл:Hint.png]] - [[HiddenHint]] - подсказка (указатель на спрятанный объект)
* [[Файл:Kub.png]] - [[HiddenHighLighter]] - позволяет показать не найденные объекты в хиддене.
* [[Файл:Collection.png]] - [[Collection]] - "коллекция" поисковых объектов для хидден игр
* [[Файл:Inventory.png]] - [[Inventory]] - "инвентарь" список применяемых объектов для игр
* [[Файл:Tool.png]] - [[Tool]] - "применение" - объект, который можно применить для игр
* [[Файл:Kub.png]] - [[Isomap]] - изометрическая карта
* [[Файл:Slotmachine.png]] - [[Slotmachine]] - объект типа "slot"
* [[Файл:Economics.png]] - [[Economics]] - глобальная настройка игр типа ферма\билдер
** [[Файл:E_items.png]] - [[Eitems]] - объект, служащий для связи инвентаря/магазина и экономики
** [[Файл:E_store_item.png]] - [[Estoreitem]] - шаблон для ячейки магазина
** [[Файл:E_inventory_item.png]] - [[Einventoryitem]] - шаблон для ячейки инвентаря
** [[Файл:Kub.png]] - [[Ecraftitem]] - шаблон для ячейки создания предмета.
** [[Файл:Taskorganizer.png]] - [[Taskorganizer]] - органайзер заданий
** [[Файл:E_task_item.png]] - [[Etaskitem]] - шаблон для ячейки задания
** [[Файл:E_collection.png]] - [[Ecollection]] - шаблон для строки в таблице коллекции
* [[Файл:Paint.png‎]] - [[Paint]] - объект для рисования
* [[Файл:Physicsworld.png]] - [[Physicsworld]] - физический мир Box2D
** [[Файл:Physicsobject.png]] - [[Physicsobject]] - физические объекты
** [[Файл:Physics links.png]] - [[Physicsjoint]] - физические соединения
* [[Файл:Eraser.png]] - [[Eraser]] - стирачка
* [[Файл:Kub.png]] - [[trivia]] - игровая механика - миллионер (trivia)
* [[Файл:Kub.png]] - [[Dailybonus]] - объект для управления механизмом ежедневного бонуса за вход в игру.

=== Global score ===
* [[Файл:Gamecenter.png]] - [[Gamecenter]] - объект для отправки данных на GameCenter iTunse
**[[Файл:Kub.png]] - [[Achievementitem]] - шаблон локального достижения (оффлайн ачивка)
* [[Файл:Gamecircle.jpg]] - [[Amazon GameCircle]] - объект для отправки данных Amazon GameCircle
* [[Файл:Google-play-games-android.jpg‎]] - [[Google Play services]] - объект для отправки данных на Google Play services
* [[Файл:Localtoplist.png]] - [[Localtoplist]] - настройки для отображения результатов прохождения игры
* [[Файл:Globaltoplist.png]] - [[Globaltoplist]] - настройки для отображения результатов прохождения игры
* [[Файл:Globaltopsender.png]] - [[Globaltopsender]] - настройки для отображения результатов прохождения игры

=== Options ===
* [[Файл:Options.png]] - [[Options]] - общие настройки игры
* [[Файл:Gamedata.png]] - [[Gamedata]] -
* [[Файл:Controls.png]] - [[Controls]] - обьект для работы с клавишами клавиатуры или девайса
* [[Файл:Editicon.png]] - [[Edit]] - ввод текста
* [[Файл:Store.png]] - [[Store]] - настройки InApp покупок в игре
** [[Файл:Kub.png]] - [[Wallet]] - объект для начисления игровой валюты при InApp покупках через объект economics
* [[Файл:Notification.png]] - [[Notification]] - push-уведомления
* [[Файл:Imagepicker.png]] - [[Imagepiker]] - объект для загрузки фото из галереи
* [[Файл:Video.png]] - [[Video]] - объект для просмотра видео
* [[Файл:Webview.png]] - [[Webview]] - объект для просмотра интернет страниц в приложении
* [[Файл:Flurryobject.png]] - [[Flurry]] - настройки системы статистики для приложений https://dev.flurry.com
* [[Файл:Moregames.png]] - [[MoreGamesList]] - запрос банеров рекламируемых игр
* [[Файл:Advertisement.png]] - [[Advertisement]] - банерная система flurry, amazon
* [[Файл:Splitmanager.png]] - [[Splitmanager or A\B Testing]] - менеджер сплитов
* [[Файл:Tapjoy.png]] - [[Tapjoy]] - система рекламы игр
* [[Файл:Playhaven.png|24px]] - [[Playhaven]] - система рекламы игр с внутренними up-sale
* [[Файл:Mobileapptracker.png|24px]] - [[Mobileapptracking]] -
* [[Файл:Chartboost-logo-new.jpeg]] - [[Chartboost]] - Chartboost-logo-new.jpeg
* [[Файл:Kub.png]] - [[System]] - объект для доступа к системным настройкам
* [[Файл:Kub.png]] - [[Salesmanager]] - менеджер акций
* [[Файл:Kub.png]] - [[Cloud]] - объект для синхронизации в облаке
* [[Файл:Kub.png]] - [[Game]] - объект для отправки событий

=== Social ===
* [[Файл:Facebook.png]] - [[Facebook]] - настройки расшаривания Facebook
** [[Файл:Esocialfrienditem.png]] - [[Esocialitem]] - Шаблон для ячейки списка друзей
** [[Файл:Kub.png]] - [[Esocialgiftitem]] - Шаблон для ячейки с предметом, который можно подарить другу
** [[Файл:Esocial.png]] - [[Esocial]] - объект для взаимодействия с Facebook'ом
* [[Файл:Twitter.png]] - [[Twitter]] - настройки расшаривания Twitter
* [[Файл:Odnoklassniki.png]] - [[Odnoklassniki]] - настройки для социальной сети Одноклассники
* [[Файл:Googleplus.png]] - [[GooglePlus]] - настройки для социальной сети GooglePlus

=== Functions ===
* [[Файл:Forward.png]] - [[SendMail]] - отправка письма через почтовый клиент
* [[Файл:footer-icon-rate.png]] - [[Rate]] - вызов окна оценки приложения
----
<gallery widths="50px" heights="50px" >
Изображение:Who.png
Изображение:AnimalHideSeek.png
Изображение:travel.png
Изображение:Game_Adventure_Train.png
Изображение:Gmae_Match_MoveTheDolly.png
Изображение:Game_Patchwork_BigEyes.png
Изображение:Game_Patchwork_Chameleon.png
Изображение:Game_Patchwork_Logicly.png‎
Изображение:Game_Patchwork_Stickers.png‎
Изображение:Elephant.png
Изображение:Elephant2.png
Изображение:Cinderella.png
Изображение:Pigs.png
Изображение:Bremenskye.png
Изображение:Book_SnowWhite.png
Изображение:Book_PussInBoots.png
Изображение:Call.png
Изображение:GreatestArtists.png
Изображение:Game_Puzzle_Kids.png
Изображение:Game_Puzzle_Architect.png‎
Изображение:Game_Puzzle_Science.png
Изображение:Ico_1_114_Full.png
Изображение:Game_Adventure_Dreams.png
Изображение:Abc.png
Изображение:Ico_114_Full.png
Изображение:Ico_114_Paints.png
Изображение:Ico_114_Puzzle.png
</gallery>

[[category:main]]