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

Timer

2020-10-15T10:08:33Z

Vlegkun: /* Основные параметры и свойства таймера */

{{TOC right}}
== Общие сведения ==

Данный [[Object|объект]] предназначен для различных действий в игре связанных со временем. Например: длительность игры на каком-то из уровней, время между ходами и т.д. Он может использоваться в качестве таймера (время отнимается) и секундомера (время наращивается).

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

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

[[Файл:Timer 01.jpg|right]]
* '''тип''' - тип объекта
* '''имя''' - имя объекта
* '''синхронизация''' - синхронизация между лейаутами

* '''положение'''
** '''x''' - положение объекта по оси х
** '''y''' - положение объекта по оси y

* '''размер'''
** '''w''' - ширина объекта в пикслях
** '''h''' - высота объекта в пикселях

* '''модификаторы'''
** '''alpha''' - прозрачность объекта от 0 (прозрачен) до 1 (не прозрачен)
** '''blending''' - Alpha смешивание
** '''angle''' - угол поворота в градусах. 0 - не повернут. Отсчитывается от оси х вниз. Вверх идут отрицательные углы.
** '''scale x''' - масштаб по оси х: 1 - не изменен, 1.5 - увеличен в полтора раза, и т.д.
** '''scale y''' - масштаб по оси y: 1 - не изменен, 1.5 - увеличен в полтора раза, и т.д.

* '''z''' - параметр порядка рисования объекта. Сначала рисуются объекты с большим z, а под ними с меньшим
* '''память''' - если 1 - не обновляет свои параметры при последующем открытии экрана, 0 - обновляет . '''Если таймер подвязан к опциям''' и включена память, то таймер не будет перевычитывать значение из опций после получения состояний '''init''', '''run'''

* '''cостояние''' - начальное состояние таймера:
** '''beg''' - начальное состояние (таймер не идет)
** '''run''' - запуск таймера
** '''fast''' - таймер работает с ускорением( кооф. ускорения задаем в "ускорение" )
** '''pause''' - таймер перходит в состояние паузы. (снять с паузы состоянием - run, fast)
** '''add''' - добавление времени к таймеру
** '''del''' - отнимание времен из таймера
** '''end''' - конечное состояние таймера
** '''stop''' - останавливает таймер, если потом он будет запущен снова, то пойдет с нуля
** '''save''' - записывает текущее значение в опции под именем, указанным в ключе (игра, уровень)

* '''отладка''' - отображать в окне состояний текущий объект
* '''значение''' - начальное значение таймера в ms
* '''дельта''' - используется в состояниях add и del, количество времени которое будет добавлено или удалено из таймера (время в секундах)
* '''остановка без кликов''' - если > 0, то таймер остановится, если кликов не было более заданного числа секунд
* '''обратный ход''' - если "0" объект "таймер" работает, как секундомер (время увеличивается), если "1", то работает как таймер (время отнимается)
* '''отображать дни''' - параметр days (количество дней), необходим для настройки отображения таймера. Настраивается во "внешний вид".
* '''настройки при автозаполнении''' - перегружать - экономика меняет настройки отображения HH:MM:SS(обратная совместимость); сохранять - настройки задаются в лейауте.
* '''прогресс''' - прогрессбар, отображающий то же, что и таймер
* '''выравнивание''' - Выравнивание отображаемого времени 0 - центр, 1 - лево, 2 - право

* '''графика'''
** '''res''' - основной графический ресурс для таймера, в качестве графического ресурса подгружается анимация из 10 фреймов, на которых изображены числа от 0 до 9
** '''цифры нормальные''' - поле куда добавляется анимация цифр в нормальном виде (не обязательно заполнять, если таймер будет использоваться в одном режиме)
** '''цифры окончания''' - анимация цифр, которая будут показываться в том случае, когда время таймера будет истекать
** '''цифры при добавлении''' - анимация цифр, которая будет показываться в том случае, когда к таймеру было добавлено время
** '''цифры при удалении''' - анимация цифр, которая будет показываться в том случае, когда от таймера было отнято время
** '''двоеточие нормальное''' - графика двоеточия, которое разделяет секунды, минуты, подгражается обычный графический ресурс двоеточия
** '''двоеточие окончания''' - графика двоеточия, которое показывается в случае, когда у таймера истекает время
** '''двоеточие при добавлении''' - графика двоеточия, будет использовать при прибавлении время к таймеру
** '''двоеточие при удалении''' - графика двоеточия, будет использовать при удалении время от таймера

* '''шрифт'''
** '''имя''' - номер шрифта - целое число, начиная с 0 (порядковый номер шрифта), а если -1 то рисовать каунтер клипами
** '''размер''' - размер шрифта в пикселях
** '''цвет 1''' - цвет текста

* '''внешний вид'''
** '''дни''' - 0 - прятать, 1 - отображать, 2 - отображать всегда два разряда, 3 - отображать, когда дней больше, чем в days, 4 - отображать только дни, когда дней больше, чем в days, 5 - отображать две макс. единицы времени (если применить 5, сколько бы ни было времени, будут показываться максимальные два разряда, к примеру dd:hh, если 3д 04ч).
** '''часы''' - 0 - прятать, 1 - отображать, 2 - отображать, если время больше одного часа
** '''минуты''' - 0 - прятать, 1 - отображать
** '''секунды''' - 0 - прятать, 1 - отображать, 2 - отображать, если время меньше одного часа
** '''dx''' - сдвинуть все относительно подложки вдоль х
** '''dy''' - сдвинуть все относительно подложки вдоль y
** '''dx между цифрами''' - расстояние между цифрами внутри разряда, между hh или mm
** '''dx от ":"''' - расстояние между разрядами и клипом двоеточия (справа и слева от него)
** '''разделитель после дней''' - символ, который отображается после разряда дней. Если указан, двоеточие после разряда дней не отображается. Перетаскивается из текстового редактора
** '''разделитель после часов''' - символ, который отображается после разряда часов. Если указан, двоеточие после разряда часов не отображается. Перетаскивается из текстового редактора
** '''разделитель после минут''' - символ, который отображается после разряда минут. Если указан, двоеточие после разряда минут не отображается. Перетаскивается из текстового редактора
** '''разделитель после секунд''' - символ, который отображается после разряда секунд. Если указан, двоеточие после разряда секунд не отображается. Перетаскивается из текстового редактора

* '''часы''' - Число разрядов для отображения часов
* '''ускорение''' - коэффициент ускорения, когда таймер находится в состоянии fast
* '''сохранять в профиль''' - если "0" - то не сохраняет значение в профиль, а значит значение будет глобальным
* '''сохранять при потере фокуса''' - Если ==1, то таймер будет сохранять себя при потере фокуса
* '''игра''' - ключ (параметр), совместно с параметром '''уровень''' образует переменную, с помощью которой можно управлять таймерому
* '''уровень''' - совместно с параметром '''игра''' образует переменную, с помощью которой можно управлять таймером (Строит заметить, что при переходе объекта в состояние init - он автоматически считывает значение, записанное по адресу игра.уровень в [[Options|Options]]. При этом таймер не имеет состояния read, как [[Counter|Counter]])
* '''Время истекло: изменить состояние объекта''' - если достигнет нуля, то есть используется, как таймер, он изменит состояние какого-то объекта
* '''Время истекло: изменить параметр (свойство) объекта''' - если достигнет нуля, то есть используется, как таймер, он изменит параметр какого-то объекта

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

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

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

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

== Основные состояние ==

Следует помнить следующие основные состояния: '''run''', '''beg''', '''pause''', '''save''', '''stop''', '''fast''','''add''','''del'''. Эти состояния используется чаще всего. 
Состояния таймеру мы можем передавать с помощью любого игрового объекта который может менять состояние другому объекту. 
*'''run''' - состояние которое передаем таймеру для его запуска(если таймер был на паузе то снимет с нее) ( таймер подвязанный к опциям схватит время из опций, если не стоит память) 
*'''start''' - состояние которое передаем таймеру для его запуска(если таймер был на паузе то сбросит его и запустит заново) 
*'''pause''','''stop''' - состояние которое передаем таймеру для его остановки 
*'''save''' - если заполнены поля "игра и уровень" то таймер запишет свое значение в [[Options]] 
*'''fast''' - состояние ускоренного хода таймера, ускорение определяется параметром ускорение в настройках таймера, или можно передавать параметром(fast) с помощью другого объекта. 
*'''add''' - состояние добавления времени к таймеру, добавляемое время определяется параметром дельта в настройках таймера, или можно передать параметром(delta) с помощью другого объекта. 
*'''del''' - состояние вычитания времени из таймера, вычитаемое время определяется параметром дельта в настройках таймера, или можно передать параметром(delta) с помощью другого объекта. 
*'''value''' - состояние при котором таймер в своё поле "value" запишет текущее значение в мсек. (Если вызвать до инита объекта, может записать "левое число").

== Примеры применений ==
Благодаря разнообразию состояний таймера есть возможность гибкой их настройки под различные проекты. 
Например, можно считать время проведенное на уровне, время между двумя ходами, время затраченное на один ход, также если есть время, то можно высчитать и скорость и расстояние при наличии необходимых данных. Можно привязать игровое время в [[Flurry]] и отправлять количество минут проведенных в той или другой локации и т.д. 
Предположим, есть необходимость запустить таймер, для этого, с помощью какого-то объекта необходимо задать таймеру состояние '''run'''. 
Предварительно нужно настроить его в зависимости от того, в каком режиме нужно использовать его. 
Если нам необходимо поставить игру на паузу и нужно, чтобы таймер тоже стал на паузу, то нужно указать таймеру состояние '''pause'''. 
Чтобы продолжить игру нужно опять же указать ему состояние '''run'''. 
Если указать таймеру состояние '''beg''' или '''init''', то таймер сбросится в свое первоначальное значение. 
Чтобы оперировать значением таймера, необходимо сохранить его значение. Для этого ему нужно указать ключи: игра, уровень. А в нужный момент, когда нужно, чтобы таймер сохранил свое значение необходимо последовательно ему задать два состояния: сперва нужно поставить на паузу с помощью состояния '''pause''', а потом указать состояние '''save'''. В этом случае, таймер сохранит свое текущее значение в параметр, который образует ключ игра/уровень. 
Если указать таймеру состояние '''fast''', то он должен начать идти быстрее с коэффициентом ускорения указанным в соответствующем поле. (это бывает необходимо в тех случаях, когда игрок делает подряд необдуманные ходы и нужно показать ему, что нельзя наугад делать ходы, наказать игрока) 
Состояниями '''add''' либо '''del''' можно поощрять игрока за хорошую игру прибавлением времени к таймеру, или наказывать - вычитанием при беспорядочных кликах и т.д.

[[Файл:Timer11.jpg|1000px]]

Результат вьювера:

[[Файл:Timer21.jpg|600px]]

'''Проект с таймером и демонстрацией его состояний можно посмотреть: s:\!MOBILE\!!!EditorGames\Wiki_sample\'''

[[Category:Main objects]]

App.icf

2020-10-02T09:31:30Z

Vlegkun: /* [Game] */

==[S3E]==

'''WinWidth'''=960 - Ширина окна

'''WinHeight'''=640 - Высота окна

'''DispFixRot'''="Landscape" - ориентация приложения (Free/Landscape/Portrait/FixedLandscape/FixedPortrait)

'''MemSize'''=32000000 - Размер "кучи" для основного приложения в байтах. По-умолчанию 3Mб. '''MemSize''' должен быть больше чем '''MB_GRAFICS'''

'''MemSize1'''=15000000 - Размер "кучи" для звуков приложения в байтах. По-умолчанию 0Mб.

'''SysStackSize'''=65536

'''MemSizeDebug'''=200000000

'''WindowAllowResize'''=1 - Разрешить изменение размера окна

'''WinResizable'''=1 - 0 или 1. На устройствах с оконным менеджером даёт возможность изменять размеры окна.

'''SoundOutputFreq'''=44100 - Частота звука

''Параметры для вьювера из-под редактора:''

'''WinTitle'''="Viewer"

'''SysAppVersion'''=0.0.1

'''SysAppCaption'''="viewer"

==[GxFont]==

'''CacheTextureMaxSize=1024''' - кэш для текстовой текстуры

==[Default]==

'''save'''="0" - сохранять экран на котором были перед выходом из приложения. необходимо для книжек(1), для пазлов и прочего отключить(0). Может быть вынесено в viewer.xml

'''cut'''="0" - обрезать изображение по размеру layout-а. В случае если предполагается что отмасштабированое изображение будет мало по отношению к окну(окно больше, а картинка меньше) ставим "0" и изображение не будет обрезано а будет выходить за рамки окна. Может быть вынесено в viewer.xml

==[Fonts]==

'''font_1'''="1_arial_16" - шрифт и его номер который используется

'''size_1=16''' - размер шрифта для формирования текстуры (чем больше значение, тем меньше знаков поместятся на текстуре. Необходимо будет увеличивать значение CacheTextureMaxSize=1024 что приведет к излишнему использованию памяти)

'''chars_1=256''' - Число знаков помещенных в кеш для отрисовки в единицу времени на экране. Иначе говоря - максимальное количество разных знаков, которое может отображаться на отдельных экранах.

'''koef_6=1''' - масштаб шрифта

'''koef_6_de=1.3''' - масштаб шрифта для определённого языка

==[Game]==

'''Market'''="amazon" - задаёт какие будут использованы инапы, если они есть, и ссылки в текстовой базе. возможны варианты: samsung, amazon, ios, wildtangent, android, blackberry, fortumo, google, mac, windows, phone8

'''debug="Absolutist-2253"''' - режим отладки, если ненужен, или для выгрузки в магазин - удалить.

'''show_build_date=1''' - показывать дату билда вьювера

'''mouseOver''' - 1 send mouse over events to viewer (for PC projects) 0 - don't send (for Mobile projects)

'''DispFixRot'''='''"Landscape"''' програмная ориентация приложения. Не путать с параметром в [S3E]

'''alignType'''=1 позиционирование объектов, если указано в объекте. 1 - по логическому экрану, 0 - по физическому. 1 - по умолчанию.

'''allow_background'''=1 - не ставить вьювер на паузу при потере фокуса.

'''purchaseEverything'''=1 - совершать эмуляцию покупки (для тестирования покупок из-под редактора).

'''fps'''=1 - показывать fps в верхнем левом углу.

'''dt'''=17 - таймер с мс (17 по умолчанию, для замедления уменьшать).

==[GameTrace]==

'''flurry=1''' - заносить в логи активность flurry

'''memorymanager=1''' - заносить в логи количество памяти затраченной приложением

'''Level'''="Verbose" - уровень записи в лог. Verbose - самый детальный, используется по умолчанию (Verbose/Info/Warnings/Errors). Info - в лог попадает только информация (Info,Warnings,Errors). Warnings - в лог пишутся только предупреждения и ошибки (Warnings,Errors). Errors - в лог пишутся только ошибки (Errors).

'''All'''=0 - 0-выключены все логи от объектов кроме тех, у которых стоит параметр 1 (см. ниже). 1 - логи от объектов включены, кроме тех у которых параметр 0 (см. ниже)

'''GMachine'''=1 - 1 логи от объекта включены, 0 - выключены

'''GESocial'''=0

==[GameMemory]==

'''MB_GRAFICS=18000000''' - размер буфера для загрузки изображений. Сначала изображение помещается в этот буфер, потом из него в видеопамять. По умолчанию - 9 мб. Память для буфера входит в '''MemSize''' - тоесть для объектов выделяется объём памяти равный '''MemSize''' - '''MB_GRAFICS'''.

==[s3eAndroidAppirater]==

'''title="App name"''' - название приложения

'''app_name="market://id?=com.your_company.application"''' - package id приложения

'''days=0'''

'''launches=0'''

'''events=0'''

'''need_email_button=1''' - нужна ли кнопка "отправить письмо"

'''email_addr="user@yourcompany.com"''' - email на который будет отправлено письмо

'''email_subj="Subject of email"''' - тема письма

'''email_text="Hello!"''' - текст письма

==[Parameters]==
Добавляет в options параметр и значение при запуске приложения. Параметры этой секции будут установлены в опции; нумерация должна быть последовательной от 1 до бесконечности

'''param1_name="param1.param"''' - имя параметра

'''param1_value="12"''' - значение параметра

'''param1_overwrite="0"''' - перезаписывать параметр, если был ранее 1 - по умолчанию. 1 - перезаписывать, 0 - неперезаписывать

'''param2_name="param2"'''

'''param2_value="13"'''

==[GHiddenList]==

'''HitTest''' - мода автотеста; (0- выкл.; 1 - разовая логика, пишется в файл раз в сессию для одного хидден листа ; 2 - при каждом init любого хидн листа дописывается статистика в файл);

'''HitTestDx''' = 5 - шаг с которым проходит автокликер по X;

'''HitTestDy''' = 5 - шаг с которым проходит автокликер по Y.

==[Splash]==

'''inscribe''' - вписывать видео сплэшскрина в текущий экран; (1 - вписывать);

Видео должно называться Splash.ogv и находиться рядом с вьювером

==[Advertisement]==
'''OfflineMode''' - включить оффлайн режим, при котором конфиг рекламы не будет качаться с сервера (будет браться из кеша); Если в кеше нет конфига - реклама работать не будет.

'''DebugMode''' - включить отладочный режим при котором загружается дебажный конфиг с серврера независимо от того с какого адреса идет запрос

'''ReleaseMode''' - включить релизный режим при котором загружается релизный конфиг с серврера независимо от того с какого адреса идет запрос

(если установлены оба последних параметра, выбирается отладочный режим)

==[DynamicConfig]==
'''offline''' - включить оффлайн режим использования динамического конфига (конфиг при помощи которого можно патчить приложение - пока используется только в H365 и HiddenBattle); при включённом режиме конфиг будет браться локально (из кеша), если имеется в наличии.

[[Category:Projects]]

Создание игры «Hidden Object Game»

2020-09-25T11:35:29Z

Vlegkun: /* Упражнение № 6 */

{| width="100%"
| width="40%"|[[Редактор текстовых ресурсов|Урок 6]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Настройка миниигр|Урок 8]]
|}
----
{{TOC right}}

'''Цель:''' Изучить настройки объектов [[HiddenList]], [[HiddenObject]] и [[Table]] для типа механики Hidden Object Game на базе создания уровня из игры Travel.

'''Задача:''' Создать уровень игры содержащей 10 поисковых объектов расположенных на одном бэкграунде (фоне). При инициализации сцены обеспечить размещение 5 объектов для поиска.

== Создание экрана и сцены в игровом проекте ==

Откроем проект lessons. Создадим экран Lesson_7. [[Файл:Lesson7_textbase.png|right]]
В экране Lesson_7 добавляем новую сцену* stg_7 с разрешением 960*640 (по умолчанию), в которую (через ResourcesEditor) добавим графические ресурсы из папки Lesson_7. (см. подготовка к работе [[Создание проекта]])

* Графические объекты должны разместиться точно на местах предназначенных для их «Прятанья». Перетягиваем сначала '''bg''', потом остальные объекты с папки ''hiddenObj''.

Создадим папку Lesson_7 в базе текстовых описаний с помощью TextEditor. Добавим в неё 10 текстовых записей, соответствующих именам поисковых объектов. Заполним для каждой текстовой записи 2 значения, один из которых называет сам предмет, а второе - является его синонимом или ассоцией, которая укажет на него ([[Интерфейс TextEditor#Создание и заполнение текстовой базы проекта | Word]], [[Интерфейс TextEditor#Создание и заполнение текстовой базы проекта | Sentence-En]]), добавим графическое отображение поискового объекта. Сделать это можно вручную, перетащив картинку соответствующего объекта из редактора ресурсов и, по нажатию на картинке правой кнопкой мыши, выберем тип "icon1". Или же более быстрым [[Интерфейс TextEditor#Добавление иконок в текстовый элемент | способом]].

== Общая настройка объектов ==

1. Для всех поисковых графических объектов изменяем тип с image на [[HiddenObject]]: выделяем первый и последний элементы, удерживая кнопку Shift, в окне Property выбраем соответствующий параметр.

[[Файл:Lesson7_hidden_obj.png]]

2. Создаем новую сцену, которую называем 7_1 и добавляем на нее специальные объекты [[Table]] и [[HiddenList]]. Для этого переносим графическое изображение table и изменяем его тип с image на Table. Название объекта изменить на table**

[[Файл:07 5.png]]

3. Для объекта HiddenList создаем новый объект и меняем его тип с image на HiddenList. Для данного типа объекта не требуется графический ресурс. Название объекта изменить на HiddenList**

[[Файл:Lesson7_HiddenList.png]]

'''**''' Имена для специальных объектов могут использоваться любые.

== Детальная настройка объектов ==

'''1. Описание HiddenObject.'''

''HiddenObject'' - это поисковый объект, взаимодействующий со списком HiddenList. Каждому поисковому объекту необходимо указать графический ресурс (картинку), идентификатор объекта HiddenList и идентификатор текстового ресурса (строки описания) в HiddenList.[[Файл:07 7.png|right]]

Необходимо выбрать используемый объект с именем HiddenList (тип HiddenObjectList) в поле list.

''текстID'' – название хидден-объекта, которое будет отображаться в списке. Перетаскивается мышкой из текстового редактора;

''текст'' – обычный текст (будет отображаться в таблице при отсутствии ТекстID, для быстрых экспериментов);

''list'' – ссылка на HiddenList, к которому будет подключен объект, для обеспечения связи между ними;

''flyer'' – объект типа flyer, который запустится в работу при нахождении поискового объекта. Неудачный клик обрабатывает HiddenList. Если параметр не задан, используется fly_ok объекта HiddenList.(objid);

''actor'' – объект, который отображает анимацию спрятанного объекта после удачного клика на него (обычно это машина состояния). Парметр необязателен. Актёры нужны тогда, когда отличается графика объекта, который непосредственно находится на сцене и который летит к таблице. Это может быть случай, когда на сцене лежит часть объекта, а летит целый. Или же на сцене - с тенью, а летит - без.

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

'''2. Описание HiddenObjectList.'''

HiddenList - это список поисковых объектов (Hidden), которые надо найти в хидден-сцене. [[Файл:07 8.png|right]] Каждый поисковый объект на сцене связывают со списком. Объектов может быть больше, чем будет показано в данной игровой сессии (поле "объектов"). В этом случае они выбираются случайным образом. Запоминаются те из них, по которым произошёл клик (увеличивается счетчик их кликов). При следующем заходе на сцену, поисковые слова сортируются по возрастанию числа кликов и снова активизируется количество спрятанных объектов, указанных в поле "количество".

HiddenList определяет основные параметры для настройки HiddenObject (скорость полета и т.п.). В дальнейшем, при необходимости, эти же параметры можно добавить в HiddenObject, чтобы для данного объекта они "перебивали" общие значения для всех.

Подготовка спрятанных объектов:

''num'' (поле "объектов") – максимальное количество объектов, участвующие в поиске. (int)

''hide'' (поле "прятать") – если 1, то делать невидимыми объекты, не участвующие в поиске. (int)

Визуальные параметры списка:

''table'' (поле "таблица") – идентификатор объекта Table. (objid)

''kind'' (внешний вид - поле "тип списка") – тип отображения объекта в списке (0-слово,1-ассоциация, 2-иконка, 3-иконка). (int)

''cross'' (внешний вид - поле "вычеркнуть") – зачеркивать найденный элемент списка. Eсли 0 (по умолчанию), то найденный элемент удаляется, иначе "зачеркивается".(int).

'''3. Настройка Table'''

[[Файл:Table lesson7.png]]

Хотелось бы напомнить , что вы можете “поиграться” с вкладкой “таблица”, чтобы настроить внешний вид , вспомогательную область для поиска предметов.

'''4. Параметры, общие для всех спрятанных объектов:'''

''die'' – тип исчезания при удачном клике на объект (если нет актера) (int):

0: просто исчезает;

1: летит к пункту с описанием в списке HiddenList;

2: улетает в случайном направлении;

3: улетает к заданным координатам (fx, fy).

vm - скорость движения при полете к списку предметов после клика в px/sec (float)

vr - скорость вращения при полете к списку предметов после клик в град/sec (float)

fw - финальная ширина к которой надо уменьшится при подлете к финальной точке (int)

fh - финальная высота к которой надо уменьшится при подлете к финальной точке (int). Объект не должен изменять своих пропорций, поэтому fw или fh (или оба) всегда отрицательны.

fx - финальная координата x, к которой объект должен перелететь, при удачном клике (см. тип исчезания). (int)

fy - финальная координата x, к которой объект должен перелететь, при удачном клике (см. тип исчезания). (int)

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' HiddenList не будет работать без объекта [[Редактор текстовых ресурсов#Упражнения|Options]], который вы должны были создать в предыдущем уроке, а так же без параметра ''id игры'' (Очковая система -> id игры; для теста заполним его любой строкой).
</blockquote>

== Упражнения ==

1. Щелкнув правой кнопкой мыши по экрану Lesson_7, создать новый экран Lesson_7_1.

2. Создать новую сцену (с названием stg_7_1).

3. Скопировать все объекты из сцены stg_7 (экрана Lesson_7).

4. Вставить скопированые объекты в новую сцену stg_7_1.

[[Файл:Screenshot 1.png]]

5. В новой сцене:

a) добавить еще 3 графических ресурса и перевести в тип HiddenObject;

b) разместить на местах предназначенных для их «Прятанья»;

c) добавить текстовое описание в TextEditor;

e) установить время игры 20 секунд, паузу 2 секунды с переходом на экран Lesson_7_1.

6. Модифицировать экран Lesson_7 в полноценный уровень с выводом количества очков, игрой на время и графикой.

=== Упражнение № 6 ===
Экран lesson_7 необходимо модифицировать в полноценный уровень.

Для этого создаем еще одну сцену 7_3 в первом экране с объектами, которые сделают игру полноценной: первый экран дополняем 2 счетчиками ([[counter]]), таймером ([[timer]]), машиной-блокатором ([[machine]]) и прогрессом ([[progress]]). Второй экран с выводом очков составим позже.

[[Файл:1.png]]

Счетчик «amt» ([[counter]]) показывает сколько объектов найдено. Счетчик «score_H» ([[counter]]) насчитывает баллы за собранные объекты. Таймер ([[timer]]) запускается при старте игры и отсчитывает заданное время на игру, машина-блокатор «ban_H» блокирует сцену при серии ошибочных кликов. Прогресс «progr» ([[progress]]) активируется во время комбо.

Чтобы всё заработало необходимо указать счетчики, таймер, машину-блокатор и прогресс в свойствах HiddenList ([[hiddenList]]).

== СЧЕТЧИК ==

В редакторе ресурсов выбираем анимацию и добавляем графику для счетчика.

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' Если в редакторе ресурсов нету анимации, то [[Интерфейс_ResourceEditor#Анимация|создайте]] её - это просто). Анимация создается с названием папки, в которой хранились картинки, избегайте кириллицы в названии папок.
</blockquote>

‎[[Файл:Count 0.png]] ‎[[Файл:Count 1.png]] [[Файл:Count 2.png]] [[Файл:Count 3.png]] ‎[[Файл:Count 4.png]] [[Файл:Count 5.png]] ‎[[Файл:Count 6.png]] ‎[[Файл:Count 7.png]] ‎‎[[Файл:Count 8.png]] ‎[[Файл:Count 9.png]] ‎[[‎Файл:Coun (5).png]]

Создаем объект сцены с типом «[[counter]]», в поле res перетаскиваем анимацию с цифрами от 0 до 9, разделитель уже указан в настройках. Настройки для счетчика:

[[Файл:243.png]]

== ТАЙМЕР ==

В свойствах таймера «[[timer]]» необходимо указать «значение» с которого начнется отсчет времени (18000 = 18 сек.).
В свойство «графика» из графического редактора перетаскиваем анимацию которую делали для счетчика и двоеточие или делаем его обычным шрифтом, редактируя в свойствах параметр '''шрифт'''. Настройки для таймера:

[[Файл:444.png]]

Также стоит обновить настройки в HiddenObjectList , т.к. если мы их не укажем, то отсчет времени просто не начнется. Время таймера и время указанное в HiddenObjectList должны совпадать, иначе отсчет времени будет идти от меньшего времени вне зависимости указано оно в HOL или в таймере.
[[Файл:HOL Time.png]]

== ПРОГРЕСС И ОКНО ВЫВОДА==

[[Progress]] используют для отображения каких либо ачивментов, например когда игрок проходит уровень он может получить 1,2,3 звезды или бронзовую, серебряную, золотую или совершая необходимые действия в игре, например комбо.
Настройки для '''прогресса''' :

[[Файл:555.png]]

Графика для Progress: [[Файл:666.png]]

Настройки для машины-блокатора «ban_H» (machine) (подобъектe '''black''' изменяем тип на rectangle, более подробно о нем дальше):

[[Файл:Ban h na max.png]]
[[Файл:9.png]]

Настройки для '''hiddenList''':

[[Файл:HOL Final.png]]

Машина ''win_lose'' помогает определить победителя и вызывает соответствующее окно ''win'' после победы или поражения.

Добавим правой кнопкой мыши функцию "разбор: изменить состояние объекта" и укажем там машину ''win_lose'' состояние win. Состояние lose укажем в таймере timer_H также через добавление функции правой копкой мыши "время истекло: изменить состояние объекта".

Группа - звезды combo num =1 - количество быстро найденных объектов, нужное для получения звезды Combo. Combo time = 3000 - интервал между кликами, считающимися быстрыми. Combo accuracy = 0,85 - точность кликов для получения звезды Accuracy (1 = 100%, все клики должны быть только удачные). Лимит ложных кликов = 5 - количество неверных кликов. Формула расчета его: количество верных кликов делим на общее количество получаем коэффициент, если он равен или больше указного нами, то в опции пишем параметр, если нет то не пишем.

Для HiddenList и Counter пункт "сохранить в профиль" должен совпадать. Если в HiddenList указано "глобально", то и в Counter также необходимо установить "глобально".

Создаем новую сцену '''w''' и создаем в ней объект c типом machine ''win'', на которой формируем окно вывода результатов из ректангла (Rectangle), текстовых объектов и счетчиков. Окно
должно открываться по окончанию игры и при выигрыше показывать набранные очки и надпись об удаче, при проигрыше - нулевые очки и надпись о неудаче.

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

Графика для Rectangle rec: [[Файл:0001.png]] [[Файл:0002.png]] [[Файл:0003.png]] [[Файл:0004.png]] [[Файл:0005.png]] [[Файл:0006.png]] [[Файл:0007.png]] [[Файл:0008.png]] [[Файл:0009.png]] [[Файл:00010.png]]

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' Rectangle black (Цвет задается в свойстве фон->цвет заливки) используется в качестве фона, на котором будет размещаться всплывающие окно с показаниями результата пройденной игры.
</blockquote>

[[Файл:1012.png]] [[Файл:0102.png]]

Далее копируем Rectangle "black" и делаем подобъектом блокатора ban_H, а также меняем размеры rectangle black (устанавливаем не нулевые!), устанавливаем параметр фон и alpha на свое усмотрение.

Создадим еще 5 счетчиков. Они нам понадобятся в конце игры для выведения бонусного счета.

В свойствах счетчиков необходимо прописать уровень!

1) счетчик 7_4_1 — игровые очки;

уровень: last_game.score30_total

2) счетчик 7_4_2 — бонус за время;

уровень: last_game.score30_time

3) счетчик 7_4_3 — бонус за аккуратность;

уровень: last_game.score30_accuracy

4) счетчик 7_4_4 — бонус за комбо;

уровень: last_game.ecmbRowMax

5) счетчик 7_4_5 — очки за уровень;

уровень: last_game.score30_level

Важный аспект: после того как вы добавили last.game.xxx в графу уровень в каждом счетчике , графа игра должна остаться пустой и так же не стоит эти счетчики закидывать в HOL , т.к. одни и те же данные могут конфликтовать между собой. Также обязательным условием является включение графы “очки 3.0” в HOL`e.

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

Настройки для машины — '''star1'''
(проверка в опциях параметра last_game.last_star_accuracy0,
last_game.last_star_time0, )

[[Файл:0303.png]]

Настройки для машины — '''star2'''
(если параметр accuracy=0)

[[Файл:0304.png]]

Настройки для машины — '''star3'''
(если игра пройдена за указанное время)

[[Файл:0305.png]]

Настройки для машины — '''win'''

[[Файл:0306.png]]

Машина '''win''' считывает «read» показания счетчика и запускает star1 если игра пройдена.

Также создаем кнопку ''close'' (button), которая должна закрывать окно результатов. Добавляем "изменить состояние объекта"; объект win, состояние close.

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

----

{| width="100%"
| width="40%"|[[Редактор текстовых ресурсов|Урок 6]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Настройка миниигр|Урок 8]]
|}

[[Category:Learning]]

Esocial

2020-07-30T11:05:36Z

Vlegkun:

[[Object|Объект]] '''Esocial''' обеспечивает связь между приложением и Facebook'ом.

=Параметры=

[[Файл:Esocial_full.jpg|right]]

==Общие==

*'''facebook''' ''(facebook)'' - Ссылка на объект типа ''[[Facebook]]'', с которым будет работать объект.
*'''economics''' ''(economics)'' - Ссылка на объект типа ''[[Economics]]'', с которым будет работать объект.
*'''esocialfrienditem''' ''(esocialfrienditem)'' - Ссылка на объект типа ''[[esocialfrienditem]]'', с которым будет работать объект.
*'''таблица друзей''' ''(friends)'' - Ссылка на таблицу, в которую будем клонировать esocialfrienditem. Заполнить таблицу - вызвать объекту состояние friends
*'''таблица приглашаемых друзей''' ''(friendsnotinst)'' - Ссылка на таблицу, в которую будем клонировать esocialfrienditem. Заполнить таблицу - вызвать объекту состояние friends_not_inst
*'''шаблон вверху таблтицы''' ''(invtemplate)'' - Объект, который всегда будет первым в таблице приглошаемых друзей, если он задан
*'''индикатор активности''' ''(activity)'' - Объект - индикатор активности. Будем менять ему визибл
*'''опции для facebook''' ''(fbopt)'' - Поле в опциях, куда мы будем сохранять упакованное в 32-битное целое Уровень + Коллекции. ESocial добавит к ним число друзей и засабмит при вызове соотв. состояние.
*'''социальная сеть''' ''(socialnet)'' - социальная сеть: фейсбук=0,гугл=1,обе=2.
*'''дублировать очки в parse''' ''(parse)'' - дублировать очки в parse: нет=0,да=1.
*'''лидерборд parse''' ''(parselb)'' - Имя главной таблицы в parse.
*'''перемешивать приглашаемых''' ''(shuffleinv)'' - перемешивать или сортировать приглашаемых друзей: нет=0,да=1,сортировать=2.
*'''добавлять из лидербордов''' ''(addinv)'' - добавлять приглашаемых друзей из глобальных лидербордов (кол-во).
*'''прятать приглашенных''' ''(hideinv)'' - прятать приглашенных друзей (аналогично вайберу): нет=0, да=1.
*'''размер аватарки''' ''(picsize)'' - размер автарки (value="128" min="32").
*'''проверять группу''' ''(checkgroup)'' - Проверять вхождение в группу с id.
*'''вступать в сообщество''' ''(joincommunity)'' - вступать в сообщество (пока только вконтакте).
*'''дарение коллекционных''' ''(gift_type)'' - 0 - дарим то что есть, при успехе вычитаем, 1 - дарим любой, при успехе не вычитаем.
*'''подарки через parse''' ''(gift_parse)'' - 0 - дарим через соцсеть, 1 - дарим через парс, через соцсеть - только уведомления: нет=0, да=1.

==Подарки==

*'''специальные подарки'''
**'''подарок энергия id''' ''(gift_en_id)'' - подарок энергия id;
**'''подарок энергия количество''' ''(gift_en_amount)'' - подарок энергия количество;
**'''учитывать максимум энергии''' ''(gift_en_max)'' - 0 - не учитывать, 1 - учитывать; нет=0,да=1;
**'''подарок монеты id''' ''(gift_res1_id)'' - подарок монеты id;
**'''подарок монеты количество''' ''(gift_res1_amount)'' - подарок монеты количество;
**'''принимать подарки не чаще (сек)''' ''(gift_delay)'' - Принимать подарки с ресурсами не чаще заданного количества секунд. Работает только для энергии/res1 и только для парсовых подарков.

*'''запрос подарка'''
**'''текст''' ''(wishtxt)'' - Общий текст запроса подарка;
**'''завершающий текст''' ''(wishtxt2)'' - Текст, который будет добавлен после списка предметов;
**'''таблица''' ''(wishtbl)'' - Таблица, куда сложим множественный запрос подарков;
**'''ссылка''' ''(href)'' - Ссылка для публикации вишлиста на стене гугл.

*'''отправка подарка'''
**'''заголовок''' ''(gift_t)'' - заголовок инвайта;
**'''сообщение''' ''(gift_m)'' - текст инвайта;
**'''ограничение''' ''(gift_max)'' - ограничение на число подарков в день;
**'''счетчик''' ''(gift_cnt)'' - счетчик текущих подарков;
**'''заголовок уведомления''' ''(gift_not_t)'' - заголовок уведомления;
**'''сообщение уведомления''' ''(gift_not_m)'' - сообщение уведомления;
**'''viber url''' ''(gift_viber_url)'' - viber url инвайта.

*'''запрос подарка'''
**'''заголовок''' ''(ask_t)'' - заголовок инвайта;
**'''сообщение''' ''(ask_m)'' - текст инвайта.

*'''окно дарения из окна коллекций'''
**'''окно''' ''(wndcolgift)'' - Некая машина, олицетворяющая собой само окно предмета. Должна иметь состояние open;
**'''иконка''' ''(icocolgift)'' - Иконка предмета;
**'''текст (объект)''' ''(txtcolgift)'' - Текстовый объект в окошке;
**'''описание (объект)''' ''(dsccolgift)'' - Текстовый объект в окошке, в который сложим описание предмета;
**'''esocialfrienditem''' ''(itemcolgift)'' - Ссылка на объект типа esocialfrienditem, с которым будет работать объект;
**'''таблица друзей''' ''(tblcolgift)'' - Ссылка на таблицу, в которую будем клонировать esocialfrienditem.

*'''окно дарения с двумя списками'''
**'''скроллить таблицы''' ''(scroll_gifts)'' - Скроллть таблицы;
**'''esocialfrienditem''' ''(fritwndgift)'' - Ссылка на объект типа esocialfrienditem, с которым будет работать объект;
**'''таблица друзей''' ''(frtblwndgift)'' - Ссылка на таблицу, в которую будем клонировать esocialfrienditem;
**'''esocialgiftitem''' ''(giitwndgift)'' - Ссылка на объект типа esocialfrienditem, с которым будет работать объект;
**'''таблица подарков''' ''(gitblwndgift)'' - Ссылка на таблицу, в которую будем клонировать esocialfrienditem;
**'''иконка''' ''(icowndgift)'' - Иконка предмета;
**'''текст (объект)''' ''(txtwndgift)'' - Текстовый объект в окошке;
**'''описание (объект)''' ''(dscwndgift)'' - Текстовый объект в окошке, в который сложим описание предмета;
**'''esocialgiftitem инв.''' ''(giitwndgift_i)'' - Ссылка на объект типа esocialfrienditem, с которым будет работать объект;
**'''таблица подарков инв.''' ''(gitblwndgift_i)'' - Ссылка на таблицу, в которую будем клонировать esocialfrienditem.

*'''окно дарения из лидербордов'''
**'''иконка друга''' ''(icofrwndgift)'' - Иконка друга;
**'''имя друга''' ''(txtfrwndgift)'' - Имя друга;
**'''таблица вишлиста''' ''(wishtblwndgift)'' - Таблица вишлиста друга;
**'''таблица подарков''' ''(gitblwndgift2)'' - Ссылка на таблицу, в которую будем клонировать esocialfrienditem;
**'''иконка выбранного подарка''' ''(icofrgiwndgift)'' - Иконка выбранного подарка;
**'''цена выбранного подарка''' ''(cntfrgiwndgift)'' - Цена выбранного подарка;
**'''иконка выбранного подарка 2''' ''(icofrgiwndgift2)'' - Иконка выбранного подарка;
**'''цена выбранного подарка 2''' ''(cntfrgiwndgift2)'' - Цена выбранного подарка.

*'''окно приема подарка'''
**'''окно''' ''(wndgetgift)'' - Некая машина, олицетворяющая собой само окно предмета. Должна иметь состояние open;
**'''иконка''' ''(icogetgift)'' - Иконка предмета;
**'''текст (объект)''' ''(txtgetgift)'' - Текстовый объект в окошке;
**'''имя''' ''(namegetgift)'' - Тектовый объект куда будет занесено имя друга;
**'''аватарка''' ''(avagetgift)'' - Аватарка друга;
**'''giftreceiveitem''' ''(giftreceiveitem)'' - Объект типа giftreceiveitem;
**'''таблица''' ''(giftreceivetable)'' - Таблица, в которую будем складывать giftreceiveitem.

*'''окно входящих запросов подарков'''
**'''giftreceiveitem''' ''(giftaskitem)'' - Объект типа giftreceiveitem;
**'''таблица''' ''(giftasktable)'' - Таблица, в которую будем складывать giftreceiveitem.

==Инвайты==

*'''инвайт'''
**'''заголовок''' ''(invite_t)'' - заголовок инвайта;
**'''сообщение''' ''(invite_m)'' - текст инвайта;
**'''viber url''' ''(invite_viber_url)'' - viber url инвайта;
**'''время повтора''' ''(invite_tm)'' - время в секундах, когда можно повторно пригласить того же игрочка.

*'''успешный инвайт'''
**'''окно''' ''(invsuc_w)'' - само окошко успешного инвайта, должно иметь состояние show, на закрытие вызывать next_inv есошиалу;
**'''портрет''' ''(invite_i)'' - портрет игрока;
**'''имя''' ''(invite_n)'' - имя игрока;

В опции пишутся параметры инвайтов (вместо %d - айдишник объекта):

*'''esocial%d.max_invite_total''' - всего инвайтов отправлено
*'''esocial%d.max_invite_this''' - за последнюю отправку

Можно проверять в "nst_invite_sent"

==Остальное==

*'''случайные друзья'''
**'''таблица случайных друзей''' ''(friendrandom)'' - Ссылка на таблицу, в которую будем клонировать esocialfrienditem. Заполнить таблицу - вызвать объекту состояние friends_random;
**'''количество''' ''(frrandomnum)'' - Количество случайных друзей в таблицу.

*'''уведомление другу'''
**'''заголовок''' ''(notif_t)'' - заголовок уведомления;
**'''сообщение''' ''(notif_m)'' - текст уведомления.

*'''facebook story'''
**'''имя действия - первый me''' ''(fbstoryactionme)'' - Имя действия при первом успешном me;
**'''имя объекта - первый me''' ''(fbstoryobjectme)'' - Имя объекта при первом успешном me;
**'''урл - первый me''' ''(fbstoryurlme)'' - Шаблон урла при первом успешном me;
**'''урл картинки - первый me''' ''(fbstoryurlpicme)'' - Шаблон урла картинки при первом успешном me;
**'''имя действия - кастомное''' ''(fbstoryactioncustom)'' - Имя действия при первом успешном me;
**'''имя объекта - кастомное''' ''(fbstoryobjectcustom)'' - Имя объекта при первом успешном me;
**'''урл - кастомное''' ''(fbstoryurlcustom)'' - Шаблон урла при первом успешном me;
**'''урл картинки - кастомное''' ''(fbstoryurlpiccustom)'' - Шаблон урла картинки при первом успешном me;
**'''forced login - кастомное''' ''(fbstoryforcedcustom)'' - Принудительный логин при вызове состояния. ДЕЙСТВУЕТ ТОЛЬКО НА ОДИН ВЫЗОВ, потом сбрасывается в 0; нет=0,да=1.

*'''adjust'''
**'''включить adjust''' ''(adjust_on)'' - нет=0, да=1;
**'''инвайт для iOS''' ''(adjinvite_ios)'';
**'''инвайт для Ansroid''' ''(adjinvite_andrd)''.

==Обработчики==

*'''изменить состояние объекта - инвайт принят''' ''(nst_invite)'' - изменить состояние объекта при принятии инвайта.
*'''изменить состояние объекта - успех задачи''' ''(nst_compl_task)'' - изменить состояние объекта при успешном выполнении задачи
*'''изменить состояние объекта - ошибка задачи - Facebook''' ''(nst_err_task)'' - изменить состояние объекта при ошибке выполнения задачи - Facebook
*'''изменить состояние объекта - ошибка задачи - Google''' ''(nst_err_task_google)'' - изменить состояние объекта при ошибке выполнения задачи - Google
*'''изменить состояние объекта - превышено число подарков в день''' ''(nst_many_gifts)'' - изменить состояние объекта при ошибке выполнения задачи
*'''изменить состояние объекта - превышено число подарков одному другу''' ''(nst_many_gifts_fr)'' - изменить состояние объекта при ошибке выполнения задачи
*'''изменить состояние объекта - заход в приложение через соц. сеть''' ''(nst_from_social_net)'' - изменить состояние объекта - заход в приложение через соц. сеть
*'''изменить состояние объекта - получен в подарок объект из вишлиста''' ''(nst_wishlist_got)'' - изменить состояние объекта - получен в подарок объект из вишлиста
*'''изменить состояние объекта - заполнена таблица с подарками''' ''(nst_gifts_table)'' - изменить состояние объекта - заполнена таблица с подарками
*'''изменить состояние объекта - клик по пустому вишлисту''' ''(nst_empty_wishlist)'' - изменить состояние объекта - клик по пустому вишлисту
*'''изменить состояние объекта - клик по непустому вишлисту''' ''(nst_norm_wishlist)'' - изменить состояние объекта - клик по пустому вишлисту
*'''изменить состояние объекта - клик по вип''' ''(nst_vip_wishlist)'' - изменить состояние объекта - клик по пустому вишлисту
*'''изменить состояние объекта - fb post story''' ''(nst_fbpoststory)'' - изменить состояние объекта - fb post story
*'''изменить состояние объекта - инвайт отослан''' ''(nst_invite_sent)'' - изменить состояние объекта - инвайт отослан
*'''изменить состояние объекта - гифт отослан''' ''(nst_gift_sent)'' - изменить состояние объекта - гифт отослан
*'''изменить состояние объекта - внешний лайк - успех''' ''(nst_externallike_yes)'' - изменить состояние объекта - внешний лайк - успех
*'''изменить состояние объекта - внешний лайк - отмена''' ''(nst_externallike_no)'' - изменить состояние объекта - внешний лайк - отмена
*'''изменить состояние объекта - дарим энергию выше max''' ''(nst_energy_above_max)'' - изменить состояние объекта - дарим энергию выше max
*'''изменить состояние объекта - состоялось вступление в сообщество''' ''(nst_join_community)'' - изменить состояние объекта - состоялось вступление в сообщество
*'''изменить состояние объекта - попросили подарок''' ''(nst_ask_gift)'' - изменить состояние объекта - попросили подарок
*'''изменить состояние объекта - слишком много запросов подарков''' ''(nst_ask_fail)'' - изменить состояние объекта - попросили подарок
*'''изменить состояние объекта - заполнена таблица с запросами подарков''' ''(nst_asks_table)'' - изменить состояние объекта - заполнена таблица с запросами подарков
*'''изменить состояние объекта - логин через эппл (успех)''' ''(nst_apple_success)'' - изменить состояние объекта - огин через эппл (успех)
*'''изменить состояние объекта - логин через эппл (ошибка)''' ''(nst_apple_fail)'' - изменить состояние объекта - огин через эппл (ошибка)
*'''еще одна табличка для вишлиста''' ''(one_more_wishlist)'' - еще одна табличка для вишлиста
*'''еще одна экономика''' ''(one_more_economics)'' - еще одна экономика

=Состояния=

*0. '''ready''' - состояние готовности
*1. '''friends'''
*2. '''friends_debug''' - добавляем фейковых друзей
*3. '''friends_inst''' - заполнить таблицу друзьями с установленной игрой
*4. '''friends_not_inst''' - заполнить таблицу друзьями с неустановленной игрой
*5. '''report''' - заслать полезную информацию (32бита)
*6. '''invite''' - показать окно инвайта
*7. '''cancel''' - отменить весь стек задач
*8. '''retry''' - повторить текущую задачу
*9. '''continue_fb''' - пропустить текущую задачу и перейти к следующей
*10. '''continue_google''' - пропустить текущую задачу и перейти к следующей
*11. '''next_inv''' - следующее окошко успешного инвайта
*12. '''gift''' - показать окно посылки подарка из окна коллекций
*13. '''gift_confirm''' - в окне посылки гифта из окна коллекций нажали кнопку ок
*14. '''wish''' - запостить на стену "попрошайку"
*15. '''check_requests''' - проверить реквесты от других пользователей
*16. '''next_gift''' - следующее окошко про полученный подарок17.
*17. '''refresh_gifts''' - актуализировать содержимое таблицы гифтов
*18. '''refresh_vip_gifts''' - актуализировать содержимое таблицы гифтов используя исключительно вип подарки
*19. '''gift_send''' - послать подарок из окна с двумя таблицами
*20. '''logout''' - разлогиниться из фейсбука удалив всю информацию о друзьях
*21. '''clear_gifts''' - сбросить ограничения на число подарков
*22. '''wish_table''' - добавить пожелание в таблицу пожеланий
*23. '''wish_all''' - пожелать все содержимое таблицы в фейсбук //Теперь только в фейсбук, а для гугла состояние ниже
*24. '''remove_gift''' - убрать подарок из таблицы
*25. '''gift_fb''' - подарить текущий подарок через фейбук используя нативный интерфейс фейсбука (т.е. так как сейчас работает гугл, без таблицы друзей)
*26. '''gift_info''' - Обновить информацию о текущих подарках в специальном окне
*27. '''gift_lb''' - Показать окно подарка из лидерборда
*28. '''gift_send_lb''' - Подтвердить отсылку подарка из лидерборда
*29. '''gift_receive''' - Получить подарок из окна получения подарков
*30. '''invite_lb''' - Послать приглашение другу из лидербордов
*31. '''get_me_google''' - запросить информацию о себе с гугла
*32. '''friends_inst_google''' - заполнить таблицу друзьями с установленной игрой
*33. '''friends_not_inst_google''' - заполнить таблицу друзьями с неустановленной игрой
*34. '''message_friend''' - послать другу уведомление
*35. '''friends_random''' - заполнить таблицу случайных друзей
*36. '''wish_all_google''' - пожелать все содержимое таблицы в гугл
*37. '''get_me_fb''' - запросить информацию о себе с фейсбука
*38. '''check_requests_fb''' - проверить реквесты от других пользователей для fb
*39. '''check_requests_google''' - проверить реквесты от других пользователей для гугл
*40. '''logout_google''' - разлогиниться из гугла, удалив всю информацию о друзьях
*41. '''gift_parse''' - Показать окно подарка из парсовой таблицы друзей
*42. '''gift_send_parse''' - Подтвердить отсылку подарка из парсовой таблицы друзей
*43. '''gift_parse_energy''' - Показать окно подарка энергии из парсовой таблицы друзей
*44. '''gift_parse_vip''' - Подарок вип-подарка из окна лидербордов
*45. '''gift_parse_res1''' - Подарок монет из окна лидербордов
*46. '''gift_receive_no_delete''' - Получить подарок из окна получения подарков без запроса
*47. '''gift_reply_energy''' - Послать в ответ энергию.
*48. '''gift_reply_more''' - Промотать таблицу подарков в клауде на нужного юзера
*49. '''gift_reply_res1''' - Послать в ответ ресурс1.
*50. '''gift_reply_universal''' - ответить тем же, что прислали
*51. '''gift_reply_vip''' - Послать в ответ vip.
*52. '''invite_parse''' - Послать приглашение другу из парса (но из общей таблицы, не из лидербордов)
*53. '''gift_parse_res1_multiple''' - отправить множественный подарок в виде монет
*54. '''gift_parse_item_multiple''' - отправить множественный подарок в виде предмета, взяв его из поля gift_param
*55. '''post_story''' - фоновое сообщение
*56. '''external_like''' - "внешнее" окошко лайка
*57. '''clear_timeouts''' - обнулить таймауты для некоторых тасков
*58. '''refresh_inv_gifts''' - актуализировать содержимое таблицы инвентарных гифтов
*59. '''wish_inv_add''' - добавить предмет из таблицы инвентарных в вишлист
*60. '''wish_inv_remove''' - убрать предмет из таблицы инвентарных в вишлист
*61. '''gift_parse_refresh''' - Обновить информацию о подарке в соотв. иконках и каунтерах
*62. '''check_requests_abs''' - проверить реквесты от других пользователей, но только parse
*63. '''switch_social_network''' - переключить активную социальную сеть, взяв ее айдишник из param
*64. '''invite_random''' - показать окно инвайта для случайных друзей

*66. '''join_community''' - пригласиться к группе, задать в параметр ''joincommunity'' id группы (для ВК).
*--. '''sign_in_with_apple''' - залогинится через Apple.

=Debug=
Для того, что бы отслеживать работу объекта Facebook в папке Documents создаются три файла, которые хранят в себе все знания относительно друзей данного пользователя, их коллекций и уровня:
 - '''facebook_debug_e.xml''' - создается во время отправки приглашения и при вызове состояния ''invite''
 - '''facebook_debug_s.xml''' - создается после фидбэка от Facebook'a.
 - '''facebook_debug.xml''' - создается исключительно в дебажной версии во время отправки объекту Facebook состояния ''friends'' или ''friends_inst''
Выглядит этот файл приблизительно вот так:
[[Файл:17-03-2014 11-09-06.png|right]]
Поля: '''request''' означает отправлен ли запрос. '''invite''' - принял ли запрос и поле '''inst'''(возможна ошибка в названии) - установлено ли приложение у данного друга.

=Задачи (команды) и ошибки=

В опции пишется номер успешной задачи, неуспешной и номер ошибки
*'''esocial%d.compl_task''' - поле в опциях, куда запишется номер успешно выполненной задачи. %d - id объекта esocial в проекте.
*'''esocial%d.err_task''' - поле в опциях, куда запишется номер неуспешной задачи. %d - id объекта esocial в проекте.
*'''esocial%d.err_code''' - поле в опциях, куда запишется номер ошибки. %d - id объекта esocial в проекте.

==Задачи==

При выполнении состояния Esocial пишет в лог следующее:

''onComplete state = %d task = %d,''

где номер таска берется из следующего списка (состояния Facebook):

*0 - провести авторизацию
*1 - закрыть текущую авторизованную сессию
*2 - создать диалог для отправки на стену
*3 - возвращает данные обо мне
*4 - возвращает данные о друзьях
*5 - возвращает данные о друзьях, которых можно пригласить в игру
*6 - получить список игровых сообщений
*7 - получить список групп пользователя
*8 - лайкал пользователь приложение или нет
*9 - обновить мои очки на facebook сервере
*10 - отправить игровое сообщение
*11 - удалить игровое сообщение на facebook сервере
*12 - отправить фоновое сообщение в ленту пользователя

След. сост. выполняются автоматически, если необходимо:
*13 - (ST_AUTO_CHECK_USER_PERMISSIONS) - получить список прав которые пользователь предоставил преложению
*14 - (ST_AUTO_CHECK_APP_PERMISSIONS) - получить список прав которые facebook предоставил преложению
*15 - (ST_AUTO_GET_WRITE_PERMISSIONS) - запросить у пользователя права на запись
*16 - (ST_AUTO_GET_READ_PERMISSIONS) - запросить у пользователя права на чтение
*17 - (ST_AUTO_POST_APP_REQUEST) - отправить application request пользователю
*18 - (ST_AUTO_CHECK_USER_ACHIEVEMENTS) - проверить текущие ачивки пользователя
*19 - (ST_CHANGE_SOCIAL_NETWORK) - изменить соц сеть

==Ошибки==

*0 - неизвестная ошибка
*1 - неизвестная задача
*2 - facebook не поддерживается
*3 - нет интернета
*4 - превышен лимит ожидания запроса
*5 - не указаны параметры для выполнения задачи
*6 - отмена диалогового окна пользователем
*7 - ошибка логина
*8 - ошибка авторизации
*9 - ошибка прав доступа

Если ошибка связана с запросами в Google Play Games, то к коду добавляется 1000, к примеру:
*1007 - ошибка логина в Google Play Games

Если ошибка связана с логином в Apple, то к коду добавляется 2000.

*2000 - ABS_SYSTEM_SIGNINWITHAPPLE_SUCCESS, // успех - не показываем
*2001 - ABS_SYSTEM_SIGNINWITHAPPLE_ERROR_CANCELED, // отмена пользователем - не показываеем
*2002 - ABS_SYSTEM_SIGNINWITHAPPLE_ERROR_FAILED, // ошибка логина
*2003 - ABS_SYSTEM_SIGNINWITHAPPLE_ERROR_INVALID_RESPONSE, // ошибка логина
*2004 - ABS_SYSTEM_SIGNINWITHAPPLE_ERROR_INVALID_NOT_HANDLED, // ошибка логина
*2005 - ABS_SYSTEM_SIGNINWITHAPPLE_ERROR_UNKNOWN // ошибка логина

Для обработки ошибок использовать [[Errormanager|ErrorManager]].

'''Пример запроса:'''
*подали запрос выполнить задачу (например ST_GET_FRIENDS)
*сначала проверяем есть ли права у приложения facebook (ST_AUTO_CHECK_APP_PERMISSIONS)
*потом проверяем есть ли права от пользователя (ST_AUTO_CHECK_USER_PERMISSIONS)
*если пользователь не давал прав, то просим (ST_AUTO_GET_READ_PERMISSIONS)
*потом снова проверяем дал ли нам пользователь права (ST_AUTO_CHECK_USER_PERMISSIONS)
*если весь цикл прошел успешно, то возвращаемся к поставленной задаче (ST_GET_FRIENDS)

'''ВАЖНО:'''
Если в любом месте произошел сбой, то ты НЕ увидишь конкретное состояние, ты увидишь только что "ST_GET_FRIENDS" отработал с ошибкой "9" или словами "ERR_PERMISSION". Других логик или кодов там нет.

==Слушатели заполнения таблиц==
Чтобы узнать когда окончательно заполниться таблица, нужно подвязать слушателя в нужном месте:
*Таблица лидеров:
**'''Cloud.table ''' - добавляемое свойство объекту 'Cloud' '''успешно загружены лидерборды''';
*Друзья и подарки:
**'''Cloud.table_fr ''' - добавляемое свойство объекту 'Cloud' '''успешно загружены друзья''';
*Неиграющие друзья:
** '''Esocial.friendsnotinst ''' - машинка-слушатель успеха объекта 'Esocial 'состояние '''5''' (изменить состояние объекта - успех задачи)
*Окно приёма подарка ( заполненность таблицы проверям у объекта "esocial" параметры "new_gifts" и "all_gifts"):
**'''Esocial.giftreceivetable ''' - машинка-слушатель объекта 'Esocial' (изменить состояние объекта - '''заполнена таблица с подарками''')

=Записи в логах=
==Отправка подарка==
21/3/2017 13:8:59.800: I/GESocial state() state 42
21/3/2017 13:8:59.800: I/GESocial state() New social system state = 42 gift = 11674 starting to search usid
21/3/2017 13:8:59.800: I/GESocial state() New social system state = 42 fb login = 1 gc login = 0
21/3/2017 13:8:59.800: I/GESocial state() state 13
21/3/2017 13:8:59.800: I/GESocial state() STATE_GIFT_CONFIRM gift = 11674
21/3/2017 13:8:59.800: I/GESocial state() STATE_GIFT_CONFIRM Got id from param, id = 258188181311449
21/3/2017 13:8:59.801: I/GESocial load() load curTime = 1492769339 saveTime = 1492769335 (curTime - saveTime) = 4
21/3/2017 13:8:59.801: I/GESocial state() STATE_GIFT_CONFIRM _giftsCur = 0, gift = 11674, id = 258188181311449, _giftsLimit = 50
21/3/2017 13:8:59.801: I/GESocial state() STATE_GIFT_CONFIRM soc_net == netFacebook id = 258188181311449, data = 3,241016273040597,11674
21/3/2017 13:8:59.805: I/GESocial state() Viber request gift urlId = -1, url = , text =
21/3/2017 13:8:59.808: I/GFacebook stPostRequest() stPostRequest -> title = Gift!, message = Иван Козаченко: Here is a gift for you!,
data = 3,241016273040597,11674, userId = 258188181311449,
excludeUserIds = , frictionless = 1, type = 2, forcedLogin=1

[[Category:Facebook]]

Esocial

2020-07-30T11:04:12Z

Vlegkun: /* Обработчики */

Esocial

2020-07-30T11:01:48Z

Vlegkun: /* Обработчики */

[[Object|Объект]] '''Esocial''' обеспечивает связь между приложением и Facebook'ом.

=Параметры=

[[Файл:Esocial_full.jpg|right]]

==Общие==

*'''facebook''' ''(facebook)'' - Ссылка на объект типа ''[[Facebook]]'', с которым будет работать объект.
*'''economics''' ''(economics)'' - Ссылка на объект типа ''[[Economics]]'', с которым будет работать объект.
*'''esocialfrienditem''' ''(esocialfrienditem)'' - Ссылка на объект типа ''[[esocialfrienditem]]'', с которым будет работать объект.
*'''таблица друзей''' ''(friends)'' - Ссылка на таблицу, в которую будем клонировать esocialfrienditem. Заполнить таблицу - вызвать объекту состояние friends
*'''таблица приглашаемых друзей''' ''(friendsnotinst)'' - Ссылка на таблицу, в которую будем клонировать esocialfrienditem. Заполнить таблицу - вызвать объекту состояние friends_not_inst
*'''шаблон вверху таблтицы''' ''(invtemplate)'' - Объект, который всегда будет первым в таблице приглошаемых друзей, если он задан
*'''индикатор активности''' ''(activity)'' - Объект - индикатор активности. Будем менять ему визибл
*'''опции для facebook''' ''(fbopt)'' - Поле в опциях, куда мы будем сохранять упакованное в 32-битное целое Уровень + Коллекции. ESocial добавит к ним число друзей и засабмит при вызове соотв. состояние.
*'''социальная сеть''' ''(socialnet)'' - социальная сеть: фейсбук=0,гугл=1,обе=2.
*'''дублировать очки в parse''' ''(parse)'' - дублировать очки в parse: нет=0,да=1.
*'''лидерборд parse''' ''(parselb)'' - Имя главной таблицы в parse.
*'''перемешивать приглашаемых''' ''(shuffleinv)'' - перемешивать или сортировать приглашаемых друзей: нет=0,да=1,сортировать=2.
*'''добавлять из лидербордов''' ''(addinv)'' - добавлять приглашаемых друзей из глобальных лидербордов (кол-во).
*'''прятать приглашенных''' ''(hideinv)'' - прятать приглашенных друзей (аналогично вайберу): нет=0, да=1.
*'''размер аватарки''' ''(picsize)'' - размер автарки (value="128" min="32").
*'''проверять группу''' ''(checkgroup)'' - Проверять вхождение в группу с id.
*'''вступать в сообщество''' ''(joincommunity)'' - вступать в сообщество (пока только вконтакте).
*'''дарение коллекционных''' ''(gift_type)'' - 0 - дарим то что есть, при успехе вычитаем, 1 - дарим любой, при успехе не вычитаем.
*'''подарки через parse''' ''(gift_parse)'' - 0 - дарим через соцсеть, 1 - дарим через парс, через соцсеть - только уведомления: нет=0, да=1.

==Подарки==

*'''специальные подарки'''
**'''подарок энергия id''' ''(gift_en_id)'' - подарок энергия id;
**'''подарок энергия количество''' ''(gift_en_amount)'' - подарок энергия количество;
**'''учитывать максимум энергии''' ''(gift_en_max)'' - 0 - не учитывать, 1 - учитывать; нет=0,да=1;
**'''подарок монеты id''' ''(gift_res1_id)'' - подарок монеты id;
**'''подарок монеты количество''' ''(gift_res1_amount)'' - подарок монеты количество;
**'''принимать подарки не чаще (сек)''' ''(gift_delay)'' - Принимать подарки с ресурсами не чаще заданного количества секунд. Работает только для энергии/res1 и только для парсовых подарков.

*'''запрос подарка'''
**'''текст''' ''(wishtxt)'' - Общий текст запроса подарка;
**'''завершающий текст''' ''(wishtxt2)'' - Текст, который будет добавлен после списка предметов;
**'''таблица''' ''(wishtbl)'' - Таблица, куда сложим множественный запрос подарков;
**'''ссылка''' ''(href)'' - Ссылка для публикации вишлиста на стене гугл.

*'''отправка подарка'''
**'''заголовок''' ''(gift_t)'' - заголовок инвайта;
**'''сообщение''' ''(gift_m)'' - текст инвайта;
**'''ограничение''' ''(gift_max)'' - ограничение на число подарков в день;
**'''счетчик''' ''(gift_cnt)'' - счетчик текущих подарков;
**'''заголовок уведомления''' ''(gift_not_t)'' - заголовок уведомления;
**'''сообщение уведомления''' ''(gift_not_m)'' - сообщение уведомления;
**'''viber url''' ''(gift_viber_url)'' - viber url инвайта.

*'''запрос подарка'''
**'''заголовок''' ''(ask_t)'' - заголовок инвайта;
**'''сообщение''' ''(ask_m)'' - текст инвайта.

*'''окно дарения из окна коллекций'''
**'''окно''' ''(wndcolgift)'' - Некая машина, олицетворяющая собой само окно предмета. Должна иметь состояние open;
**'''иконка''' ''(icocolgift)'' - Иконка предмета;
**'''текст (объект)''' ''(txtcolgift)'' - Текстовый объект в окошке;
**'''описание (объект)''' ''(dsccolgift)'' - Текстовый объект в окошке, в который сложим описание предмета;
**'''esocialfrienditem''' ''(itemcolgift)'' - Ссылка на объект типа esocialfrienditem, с которым будет работать объект;
**'''таблица друзей''' ''(tblcolgift)'' - Ссылка на таблицу, в которую будем клонировать esocialfrienditem.

*'''окно дарения с двумя списками'''
**'''скроллить таблицы''' ''(scroll_gifts)'' - Скроллть таблицы;
**'''esocialfrienditem''' ''(fritwndgift)'' - Ссылка на объект типа esocialfrienditem, с которым будет работать объект;
**'''таблица друзей''' ''(frtblwndgift)'' - Ссылка на таблицу, в которую будем клонировать esocialfrienditem;
**'''esocialgiftitem''' ''(giitwndgift)'' - Ссылка на объект типа esocialfrienditem, с которым будет работать объект;
**'''таблица подарков''' ''(gitblwndgift)'' - Ссылка на таблицу, в которую будем клонировать esocialfrienditem;
**'''иконка''' ''(icowndgift)'' - Иконка предмета;
**'''текст (объект)''' ''(txtwndgift)'' - Текстовый объект в окошке;
**'''описание (объект)''' ''(dscwndgift)'' - Текстовый объект в окошке, в который сложим описание предмета;
**'''esocialgiftitem инв.''' ''(giitwndgift_i)'' - Ссылка на объект типа esocialfrienditem, с которым будет работать объект;
**'''таблица подарков инв.''' ''(gitblwndgift_i)'' - Ссылка на таблицу, в которую будем клонировать esocialfrienditem.

*'''окно дарения из лидербордов'''
**'''иконка друга''' ''(icofrwndgift)'' - Иконка друга;
**'''имя друга''' ''(txtfrwndgift)'' - Имя друга;
**'''таблица вишлиста''' ''(wishtblwndgift)'' - Таблица вишлиста друга;
**'''таблица подарков''' ''(gitblwndgift2)'' - Ссылка на таблицу, в которую будем клонировать esocialfrienditem;
**'''иконка выбранного подарка''' ''(icofrgiwndgift)'' - Иконка выбранного подарка;
**'''цена выбранного подарка''' ''(cntfrgiwndgift)'' - Цена выбранного подарка;
**'''иконка выбранного подарка 2''' ''(icofrgiwndgift2)'' - Иконка выбранного подарка;
**'''цена выбранного подарка 2''' ''(cntfrgiwndgift2)'' - Цена выбранного подарка.

*'''окно приема подарка'''
**'''окно''' ''(wndgetgift)'' - Некая машина, олицетворяющая собой само окно предмета. Должна иметь состояние open;
**'''иконка''' ''(icogetgift)'' - Иконка предмета;
**'''текст (объект)''' ''(txtgetgift)'' - Текстовый объект в окошке;
**'''имя''' ''(namegetgift)'' - Тектовый объект куда будет занесено имя друга;
**'''аватарка''' ''(avagetgift)'' - Аватарка друга;
**'''giftreceiveitem''' ''(giftreceiveitem)'' - Объект типа giftreceiveitem;
**'''таблица''' ''(giftreceivetable)'' - Таблица, в которую будем складывать giftreceiveitem.

*'''окно входящих запросов подарков'''
**'''giftreceiveitem''' ''(giftaskitem)'' - Объект типа giftreceiveitem;
**'''таблица''' ''(giftasktable)'' - Таблица, в которую будем складывать giftreceiveitem.

==Инвайты==

*'''инвайт'''
**'''заголовок''' ''(invite_t)'' - заголовок инвайта;
**'''сообщение''' ''(invite_m)'' - текст инвайта;
**'''viber url''' ''(invite_viber_url)'' - viber url инвайта;
**'''время повтора''' ''(invite_tm)'' - время в секундах, когда можно повторно пригласить того же игрочка.

*'''успешный инвайт'''
**'''окно''' ''(invsuc_w)'' - само окошко успешного инвайта, должно иметь состояние show, на закрытие вызывать next_inv есошиалу;
**'''портрет''' ''(invite_i)'' - портрет игрока;
**'''имя''' ''(invite_n)'' - имя игрока;

В опции пишутся параметры инвайтов (вместо %d - айдишник объекта):

*'''esocial%d.max_invite_total''' - всего инвайтов отправлено
*'''esocial%d.max_invite_this''' - за последнюю отправку

Можно проверять в "nst_invite_sent"

==Остальное==

*'''случайные друзья'''
**'''таблица случайных друзей''' ''(friendrandom)'' - Ссылка на таблицу, в которую будем клонировать esocialfrienditem. Заполнить таблицу - вызвать объекту состояние friends_random;
**'''количество''' ''(frrandomnum)'' - Количество случайных друзей в таблицу.

*'''уведомление другу'''
**'''заголовок''' ''(notif_t)'' - заголовок уведомления;
**'''сообщение''' ''(notif_m)'' - текст уведомления.

*'''facebook story'''
**'''имя действия - первый me''' ''(fbstoryactionme)'' - Имя действия при первом успешном me;
**'''имя объекта - первый me''' ''(fbstoryobjectme)'' - Имя объекта при первом успешном me;
**'''урл - первый me''' ''(fbstoryurlme)'' - Шаблон урла при первом успешном me;
**'''урл картинки - первый me''' ''(fbstoryurlpicme)'' - Шаблон урла картинки при первом успешном me;
**'''имя действия - кастомное''' ''(fbstoryactioncustom)'' - Имя действия при первом успешном me;
**'''имя объекта - кастомное''' ''(fbstoryobjectcustom)'' - Имя объекта при первом успешном me;
**'''урл - кастомное''' ''(fbstoryurlcustom)'' - Шаблон урла при первом успешном me;
**'''урл картинки - кастомное''' ''(fbstoryurlpiccustom)'' - Шаблон урла картинки при первом успешном me;
**'''forced login - кастомное''' ''(fbstoryforcedcustom)'' - Принудительный логин при вызове состояния. ДЕЙСТВУЕТ ТОЛЬКО НА ОДИН ВЫЗОВ, потом сбрасывается в 0; нет=0,да=1.

*'''adjust'''
**'''включить adjust''' ''(adjust_on)'' - нет=0, да=1;
**'''инвайт для iOS''' ''(adjinvite_ios)'';
**'''инвайт для Ansroid''' ''(adjinvite_andrd)''.

==Обработчики==

*'''изменить состояние объекта - инвайт принят''' ''(nst_invite)'' - изменить состояние объекта при принятии инвайта.
**'''объект''' ''(obj)'' - После принятия инвайта изменить состояние объекта.
**'''состояние''' ''(st)'' - Новое состояние для объекта из предыдущего поля.

*'''изменить состояние объекта - успех задачи''' ''(nst_compl_task)'' - изменить состояние объекта при успешном выполнении задачи
**'''объект''' ''(obj)'' - После успешного выполнения задачи изменить состояние объекта.
**'''состояние''' ''(st)'' - Новое состояние для объекта из предыдущего поля.

*'''изменить состояние объекта - ошибка задачи - Facebook''' ''(nst_err_task)'' - изменить состояние объекта при ошибке выполнения задачи - Facebook
**'''объект''' ''(obj)'' - После ошибки выполнения задачи изменить состояние объекта.
**'''состояние''' ''(st)'' - Новое состояние для объекта из предыдущего поля.

*'''изменить состояние объекта - ошибка задачи - Google''' ''(nst_err_task_google)'' - изменить состояние объекта при ошибке выполнения задачи - Google
**'''объект''' ''(obj)'' - После ошибки выполнения задачи изменить состояние объекта.
**'''состояние''' ''(st)'' - Новое состояние для объекта из предыдущего поля.

*'''изменить состояние объекта - превышено число подарков в день''' ''(nst_many_gifts)'' - изменить состояние объекта при ошибке выполнения задачи
**'''объект''' ''(obj)'' - После ошибки выполнения задачи изменить состояние объекта.
**'''состояние''' ''(st)'' - Новое состояние для объекта из предыдущего поля.

*'''изменить состояние объекта - превышено число подарков одному другу''' ''(nst_many_gifts_fr)'' - изменить состояние объекта при ошибке выполнения задачи
**'''объект''' ''(obj)'' - После ошибки выполнения задачи изменить состояние объекта.
**'''состояние''' ''(st)'' - Новое состояние для объекта из предыдущего поля.

*'''изменить состояние объекта - заход в приложение через соц. сеть''' ''(nst_from_social_net)'' - изменить состояние объекта - заход в приложение через соц. сеть
**'''объект''' ''(obj)'' - После ошибки выполнения задачи изменить состояние объекта.
**'''состояние''' ''(st)'' - Новое состояние для объекта из предыдущего поля.

*'''изменить состояние объекта - получен в подарок объект из вишлиста''' ''(nst_wishlist_got)'' - изменить состояние объекта - получен в подарок объект из вишлиста
**'''объект''' ''(obj)'' - После ошибки выполнения задачи изменить состояние объекта.
**'''состояние''' ''(st)'' - Новое состояние для объекта из предыдущего поля.

*'''изменить состояние объекта - заполнена таблица с подарками''' ''(nst_gifts_table)'' - изменить состояние объекта - заполнена таблица с подарками
**'''объект''' ''(obj)'' - После ошибки выполнения задачи изменить состояние объекта.
**'''состояние''' ''(st)'' - Новое состояние для объекта из предыдущего поля.

*'''изменить состояние объекта - клик по пустому вишлисту''' ''(nst_empty_wishlist)'' - изменить состояние объекта - клик по пустому вишлисту
**'''объект''' ''(obj)'' - изменить состояние объекта - клик по пустому вишлисту.
**'''состояние''' ''(st)'' - Новое состояние для объекта из предыдущего поля.

*'''изменить состояние объекта - клик по непустому вишлисту''' ''(nst_norm_wishlist)'' - изменить состояние объекта - клик по пустому вишлисту
**'''объект''' ''(obj)'' - изменить состояние объекта - клик по пустому вишлисту.
**'''состояние''' ''(st)'' - Новое состояние для объекта из предыдущего поля.

*'''изменить состояние объекта - клик по вип''' ''(nst_vip_wishlist)'' - изменить состояние объекта - клик по пустому вишлисту
**'''объект''' ''(obj)'' - изменить состояние объекта - клик по пустому вишлисту.
**'''состояние''' ''(st)'' - Новое состояние для объекта из предыдущего поля.

*'''изменить состояние объекта - fb post story''' ''(nst_fbpoststory)'' - изменить состояние объекта - fb post story
**'''объект''' ''(obj)'' - изменить состояние объекта - fb post story.
**'''состояние''' ''(st)'' - Новое состояние для объекта из предыдущего поля.

*'''изменить состояние объекта - инвайт отослан''' ''(nst_invite_sent)'' - изменить состояние объекта - инвайт отослан
**'''объект''' ''(obj)'' - изменить состояние объекта - инвайт отослан.
**'''состояние''' ''(st)'' - Новое состояние для объекта из предыдущего поля.

*'''изменить состояние объекта - гифт отослан''' ''(nst_gift_sent)'' - изменить состояние объекта - гифт отослан
**'''объект''' ''(obj)'' - изменить состояние объекта - инвайт отослан.
**'''состояние''' ''(st)'' - Новое состояние для объекта из предыдущего поля.

*'''изменить состояние объекта - внешний лайк - успех''' ''(nst_externallike_yes)'' - изменить состояние объекта - внешний лайк - успех
**'''объект''' ''(obj)'' - изменить состояние объекта - внешний лайк - успех.
**'''состояние''' ''(st)'' - Новое состояние для объекта из предыдущего поля.

*'''изменить состояние объекта - внешний лайк - отмена''' ''(nst_externallike_no)'' - изменить состояние объекта - внешний лайк - отмена
**'''объект''' ''(obj)'' - изменить состояние объекта - внешний лайк - отмена.
**'''состояние''' ''(st)'' - Новое состояние для объекта из предыдущего поля.

*'''изменить состояние объекта - дарим энергию выше max''' ''(nst_energy_above_max)'' - изменить состояние объекта - дарим энергию выше max
**'''объект''' ''(obj)'' - изменить состояние объекта - внешний лайк - отмена.
**'''состояние''' ''(st)'' - Новое состояние для объекта из предыдущего поля.

*'''изменить состояние объекта - состоялось вступление в сообщество''' ''(nst_join_community)'' - изменить состояние объекта - состоялось вступление в сообщество
**'''объект''' ''(obj)'' - изменить состояние объекта - внешний лайк - отмена.
**'''состояние''' ''(st)'' - Новое состояние для объекта из предыдущего поля.

*'''изменить состояние объекта - попросили подарок''' ''(nst_ask_gift)'' - изменить состояние объекта - попросили подарок
**'''объект''' ''(obj)'' - изменить состояние объекта - попросили подарок.
**'''состояние''' ''(st)'' - Новое состояние для объекта из предыдущего поля.

*'''изменить состояние объекта - слишком много запросов подарков''' ''(nst_ask_fail)'' - изменить состояние объекта - попросили подарок
**'''объект''' ''(obj)'' - изменить состояние объекта - попросили подарок.
**'''состояние''' ''(st)'' - Новое состояние для объекта из предыдущего поля.

*'''изменить состояние объекта - заполнена таблица с запросами подарков''' ''(nst_asks_table)'' - изменить состояние объекта - заполнена таблица с запросами подарков
**'''объект''' ''(obj)'' - После ошибки выполнения задачи изменить состояние объекта.
**'''состояние''' ''(st)'' - Новое состояние для объекта из предыдущего поля.

*'''изменить состояние объекта - логин через эппл (успех)''' ''(nst_apple_success)'' - изменить состояние объекта - огин через эппл (успех)
**'''объект''' ''(obj)'' - изменить состояние объекта.
**'''состояние''' ''(st)'' - Новое состояние для объекта из предыдущего поля.

*'''изменить состояние объекта - логин через эппл (ошибка)''' ''(nst_apple_fail)'' - изменить состояние объекта - огин через эппл (ошибка)
**'''объект''' ''(obj)'' - изменить состояние объекта.
**'''состояние''' ''(st)'' - Новое состояние для объекта из предыдущего поля.

*'''еще одна табличка для вишлиста''' ''(one_more_wishlist)'' - еще одна табличка для вишлиста
**'''объект''' ''(obj" hint="Объект типа таблица.

*'''еще одна экономика''' ''(one_more_economics)'' - еще одна экономика
**'''объект''' ''(obj" hint="Объект типа экономика.

=Состояния=

*0. '''ready''' - состояние готовности
*1. '''friends'''
*2. '''friends_debug''' - добавляем фейковых друзей
*3. '''friends_inst''' - заполнить таблицу друзьями с установленной игрой
*4. '''friends_not_inst''' - заполнить таблицу друзьями с неустановленной игрой
*5. '''report''' - заслать полезную информацию (32бита)
*6. '''invite''' - показать окно инвайта
*7. '''cancel''' - отменить весь стек задач
*8. '''retry''' - повторить текущую задачу
*9. '''continue_fb''' - пропустить текущую задачу и перейти к следующей
*10. '''continue_google''' - пропустить текущую задачу и перейти к следующей
*11. '''next_inv''' - следующее окошко успешного инвайта
*12. '''gift''' - показать окно посылки подарка из окна коллекций
*13. '''gift_confirm''' - в окне посылки гифта из окна коллекций нажали кнопку ок
*14. '''wish''' - запостить на стену "попрошайку"
*15. '''check_requests''' - проверить реквесты от других пользователей
*16. '''next_gift''' - следующее окошко про полученный подарок17.
*17. '''refresh_gifts''' - актуализировать содержимое таблицы гифтов
*18. '''refresh_vip_gifts''' - актуализировать содержимое таблицы гифтов используя исключительно вип подарки
*19. '''gift_send''' - послать подарок из окна с двумя таблицами
*20. '''logout''' - разлогиниться из фейсбука удалив всю информацию о друзьях
*21. '''clear_gifts''' - сбросить ограничения на число подарков
*22. '''wish_table''' - добавить пожелание в таблицу пожеланий
*23. '''wish_all''' - пожелать все содержимое таблицы в фейсбук //Теперь только в фейсбук, а для гугла состояние ниже
*24. '''remove_gift''' - убрать подарок из таблицы
*25. '''gift_fb''' - подарить текущий подарок через фейбук используя нативный интерфейс фейсбука (т.е. так как сейчас работает гугл, без таблицы друзей)
*26. '''gift_info''' - Обновить информацию о текущих подарках в специальном окне
*27. '''gift_lb''' - Показать окно подарка из лидерборда
*28. '''gift_send_lb''' - Подтвердить отсылку подарка из лидерборда
*29. '''gift_receive''' - Получить подарок из окна получения подарков
*30. '''invite_lb''' - Послать приглашение другу из лидербордов
*31. '''get_me_google''' - запросить информацию о себе с гугла
*32. '''friends_inst_google''' - заполнить таблицу друзьями с установленной игрой
*33. '''friends_not_inst_google''' - заполнить таблицу друзьями с неустановленной игрой
*34. '''message_friend''' - послать другу уведомление
*35. '''friends_random''' - заполнить таблицу случайных друзей
*36. '''wish_all_google''' - пожелать все содержимое таблицы в гугл
*37. '''get_me_fb''' - запросить информацию о себе с фейсбука
*38. '''check_requests_fb''' - проверить реквесты от других пользователей для fb
*39. '''check_requests_google''' - проверить реквесты от других пользователей для гугл
*40. '''logout_google''' - разлогиниться из гугла, удалив всю информацию о друзьях
*41. '''gift_parse''' - Показать окно подарка из парсовой таблицы друзей
*42. '''gift_send_parse''' - Подтвердить отсылку подарка из парсовой таблицы друзей
*43. '''gift_parse_energy''' - Показать окно подарка энергии из парсовой таблицы друзей
*44. '''gift_parse_vip''' - Подарок вип-подарка из окна лидербордов
*45. '''gift_parse_res1''' - Подарок монет из окна лидербордов
*46. '''gift_receive_no_delete''' - Получить подарок из окна получения подарков без запроса
*47. '''gift_reply_energy''' - Послать в ответ энергию.
*48. '''gift_reply_more''' - Промотать таблицу подарков в клауде на нужного юзера
*49. '''gift_reply_res1''' - Послать в ответ ресурс1.
*50. '''gift_reply_universal''' - ответить тем же, что прислали
*51. '''gift_reply_vip''' - Послать в ответ vip.
*52. '''invite_parse''' - Послать приглашение другу из парса (но из общей таблицы, не из лидербордов)
*53. '''gift_parse_res1_multiple''' - отправить множественный подарок в виде монет
*54. '''gift_parse_item_multiple''' - отправить множественный подарок в виде предмета, взяв его из поля gift_param
*55. '''post_story''' - фоновое сообщение
*56. '''external_like''' - "внешнее" окошко лайка
*57. '''clear_timeouts''' - обнулить таймауты для некоторых тасков
*58. '''refresh_inv_gifts''' - актуализировать содержимое таблицы инвентарных гифтов
*59. '''wish_inv_add''' - добавить предмет из таблицы инвентарных в вишлист
*60. '''wish_inv_remove''' - убрать предмет из таблицы инвентарных в вишлист
*61. '''gift_parse_refresh''' - Обновить информацию о подарке в соотв. иконках и каунтерах
*62. '''check_requests_abs''' - проверить реквесты от других пользователей, но только parse
*63. '''switch_social_network''' - переключить активную социальную сеть, взяв ее айдишник из param
*64. '''invite_random''' - показать окно инвайта для случайных друзей

*66. '''join_community''' - пригласиться к группе, задать в параметр ''joincommunity'' id группы (для ВК).
*--. '''sign_in_with_apple''' - залогинится через Apple.

=Debug=
Для того, что бы отслеживать работу объекта Facebook в папке Documents создаются три файла, которые хранят в себе все знания относительно друзей данного пользователя, их коллекций и уровня:
 - '''facebook_debug_e.xml''' - создается во время отправки приглашения и при вызове состояния ''invite''
 - '''facebook_debug_s.xml''' - создается после фидбэка от Facebook'a.
 - '''facebook_debug.xml''' - создается исключительно в дебажной версии во время отправки объекту Facebook состояния ''friends'' или ''friends_inst''
Выглядит этот файл приблизительно вот так:
[[Файл:17-03-2014 11-09-06.png|right]]
Поля: '''request''' означает отправлен ли запрос. '''invite''' - принял ли запрос и поле '''inst'''(возможна ошибка в названии) - установлено ли приложение у данного друга.

=Задачи (команды) и ошибки=

В опции пишется номер успешной задачи, неуспешной и номер ошибки
*'''esocial%d.compl_task''' - поле в опциях, куда запишется номер успешно выполненной задачи. %d - id объекта esocial в проекте.
*'''esocial%d.err_task''' - поле в опциях, куда запишется номер неуспешной задачи. %d - id объекта esocial в проекте.
*'''esocial%d.err_code''' - поле в опциях, куда запишется номер ошибки. %d - id объекта esocial в проекте.

==Задачи==

При выполнении состояния Esocial пишет в лог следующее:

''onComplete state = %d task = %d,''

где номер таска берется из следующего списка (состояния Facebook):

*0 - провести авторизацию
*1 - закрыть текущую авторизованную сессию
*2 - создать диалог для отправки на стену
*3 - возвращает данные обо мне
*4 - возвращает данные о друзьях
*5 - возвращает данные о друзьях, которых можно пригласить в игру
*6 - получить список игровых сообщений
*7 - получить список групп пользователя
*8 - лайкал пользователь приложение или нет
*9 - обновить мои очки на facebook сервере
*10 - отправить игровое сообщение
*11 - удалить игровое сообщение на facebook сервере
*12 - отправить фоновое сообщение в ленту пользователя

След. сост. выполняются автоматически, если необходимо:
*13 - (ST_AUTO_CHECK_USER_PERMISSIONS) - получить список прав которые пользователь предоставил преложению
*14 - (ST_AUTO_CHECK_APP_PERMISSIONS) - получить список прав которые facebook предоставил преложению
*15 - (ST_AUTO_GET_WRITE_PERMISSIONS) - запросить у пользователя права на запись
*16 - (ST_AUTO_GET_READ_PERMISSIONS) - запросить у пользователя права на чтение
*17 - (ST_AUTO_POST_APP_REQUEST) - отправить application request пользователю
*18 - (ST_AUTO_CHECK_USER_ACHIEVEMENTS) - проверить текущие ачивки пользователя
*19 - (ST_CHANGE_SOCIAL_NETWORK) - изменить соц сеть

==Ошибки==

*0 - неизвестная ошибка
*1 - неизвестная задача
*2 - facebook не поддерживается
*3 - нет интернета
*4 - превышен лимит ожидания запроса
*5 - не указаны параметры для выполнения задачи
*6 - отмена диалогового окна пользователем
*7 - ошибка логина
*8 - ошибка авторизации
*9 - ошибка прав доступа

Если ошибка связана с запросами в Google Play Games, то к коду добавляется 1000, к примеру:
*1007 - ошибка логина в Google Play Games

Если ошибка связана с логином в Apple, то к коду добавляется 2000.

*2000 - ABS_SYSTEM_SIGNINWITHAPPLE_SUCCESS, // успех - не показываем
*2001 - ABS_SYSTEM_SIGNINWITHAPPLE_ERROR_CANCELED, // отмена пользователем - не показываеем
*2002 - ABS_SYSTEM_SIGNINWITHAPPLE_ERROR_FAILED, // ошибка логина
*2003 - ABS_SYSTEM_SIGNINWITHAPPLE_ERROR_INVALID_RESPONSE, // ошибка логина
*2004 - ABS_SYSTEM_SIGNINWITHAPPLE_ERROR_INVALID_NOT_HANDLED, // ошибка логина
*2005 - ABS_SYSTEM_SIGNINWITHAPPLE_ERROR_UNKNOWN // ошибка логина

Для обработки ошибок использовать [[Errormanager|ErrorManager]].

'''Пример запроса:'''
*подали запрос выполнить задачу (например ST_GET_FRIENDS)
*сначала проверяем есть ли права у приложения facebook (ST_AUTO_CHECK_APP_PERMISSIONS)
*потом проверяем есть ли права от пользователя (ST_AUTO_CHECK_USER_PERMISSIONS)
*если пользователь не давал прав, то просим (ST_AUTO_GET_READ_PERMISSIONS)
*потом снова проверяем дал ли нам пользователь права (ST_AUTO_CHECK_USER_PERMISSIONS)
*если весь цикл прошел успешно, то возвращаемся к поставленной задаче (ST_GET_FRIENDS)

'''ВАЖНО:'''
Если в любом месте произошел сбой, то ты НЕ увидишь конкретное состояние, ты увидишь только что "ST_GET_FRIENDS" отработал с ошибкой "9" или словами "ERR_PERMISSION". Других логик или кодов там нет.

==Слушатели заполнения таблиц==
Чтобы узнать когда окончательно заполниться таблица, нужно подвязать слушателя в нужном месте:
*Таблица лидеров:
**'''Cloud.table ''' - добавляемое свойство объекту 'Cloud' '''успешно загружены лидерборды''';
*Друзья и подарки:
**'''Cloud.table_fr ''' - добавляемое свойство объекту 'Cloud' '''успешно загружены друзья''';
*Неиграющие друзья:
** '''Esocial.friendsnotinst ''' - машинка-слушатель успеха объекта 'Esocial 'состояние '''5''' (изменить состояние объекта - успех задачи)
*Окно приёма подарка ( заполненность таблицы проверям у объекта "esocial" параметры "new_gifts" и "all_gifts"):
**'''Esocial.giftreceivetable ''' - машинка-слушатель объекта 'Esocial' (изменить состояние объекта - '''заполнена таблица с подарками''')

=Записи в логах=
==Отправка подарка==
21/3/2017 13:8:59.800: I/GESocial state() state 42
21/3/2017 13:8:59.800: I/GESocial state() New social system state = 42 gift = 11674 starting to search usid
21/3/2017 13:8:59.800: I/GESocial state() New social system state = 42 fb login = 1 gc login = 0
21/3/2017 13:8:59.800: I/GESocial state() state 13
21/3/2017 13:8:59.800: I/GESocial state() STATE_GIFT_CONFIRM gift = 11674
21/3/2017 13:8:59.800: I/GESocial state() STATE_GIFT_CONFIRM Got id from param, id = 258188181311449
21/3/2017 13:8:59.801: I/GESocial load() load curTime = 1492769339 saveTime = 1492769335 (curTime - saveTime) = 4
21/3/2017 13:8:59.801: I/GESocial state() STATE_GIFT_CONFIRM _giftsCur = 0, gift = 11674, id = 258188181311449, _giftsLimit = 50
21/3/2017 13:8:59.801: I/GESocial state() STATE_GIFT_CONFIRM soc_net == netFacebook id = 258188181311449, data = 3,241016273040597,11674
21/3/2017 13:8:59.805: I/GESocial state() Viber request gift urlId = -1, url = , text =
21/3/2017 13:8:59.808: I/GFacebook stPostRequest() stPostRequest -> title = Gift!, message = Иван Козаченко: Here is a gift for you!,
data = 3,241016273040597,11674, userId = 258188181311449,
excludeUserIds = , frictionless = 1, type = 2, forcedLogin=1

[[Category:Facebook]]

Esocial

2020-07-30T10:52:52Z

Vlegkun: /* Параметры */

[[Object|Объект]] '''Esocial''' обеспечивает связь между приложением и Facebook'ом.

=Параметры=

[[Файл:Esocial_full.jpg|right]]

==Общие==

*'''facebook''' ''(facebook)'' - Ссылка на объект типа ''[[Facebook]]'', с которым будет работать объект.
*'''economics''' ''(economics)'' - Ссылка на объект типа ''[[Economics]]'', с которым будет работать объект.
*'''esocialfrienditem''' ''(esocialfrienditem)'' - Ссылка на объект типа ''[[esocialfrienditem]]'', с которым будет работать объект.
*'''таблица друзей''' ''(friends)'' - Ссылка на таблицу, в которую будем клонировать esocialfrienditem. Заполнить таблицу - вызвать объекту состояние friends
*'''таблица приглашаемых друзей''' ''(friendsnotinst)'' - Ссылка на таблицу, в которую будем клонировать esocialfrienditem. Заполнить таблицу - вызвать объекту состояние friends_not_inst
*'''шаблон вверху таблтицы''' ''(invtemplate)'' - Объект, который всегда будет первым в таблице приглошаемых друзей, если он задан
*'''индикатор активности''' ''(activity)'' - Объект - индикатор активности. Будем менять ему визибл
*'''опции для facebook''' ''(fbopt)'' - Поле в опциях, куда мы будем сохранять упакованное в 32-битное целое Уровень + Коллекции. ESocial добавит к ним число друзей и засабмит при вызове соотв. состояние.
*'''социальная сеть''' ''(socialnet)'' - социальная сеть: фейсбук=0,гугл=1,обе=2.
*'''дублировать очки в parse''' ''(parse)'' - дублировать очки в parse: нет=0,да=1.
*'''лидерборд parse''' ''(parselb)'' - Имя главной таблицы в parse.
*'''перемешивать приглашаемых''' ''(shuffleinv)'' - перемешивать или сортировать приглашаемых друзей: нет=0,да=1,сортировать=2.
*'''добавлять из лидербордов''' ''(addinv)'' - добавлять приглашаемых друзей из глобальных лидербордов (кол-во).
*'''прятать приглашенных''' ''(hideinv)'' - прятать приглашенных друзей (аналогично вайберу): нет=0, да=1.
*'''размер аватарки''' ''(picsize)'' - размер автарки (value="128" min="32").
*'''проверять группу''' ''(checkgroup)'' - Проверять вхождение в группу с id.
*'''вступать в сообщество''' ''(joincommunity)'' - вступать в сообщество (пока только вконтакте).
*'''дарение коллекционных''' ''(gift_type)'' - 0 - дарим то что есть, при успехе вычитаем, 1 - дарим любой, при успехе не вычитаем.
*'''подарки через parse''' ''(gift_parse)'' - 0 - дарим через соцсеть, 1 - дарим через парс, через соцсеть - только уведомления: нет=0, да=1.

==Подарки==

*'''специальные подарки'''
**'''подарок энергия id''' ''(gift_en_id)'' - подарок энергия id;
**'''подарок энергия количество''' ''(gift_en_amount)'' - подарок энергия количество;
**'''учитывать максимум энергии''' ''(gift_en_max)'' - 0 - не учитывать, 1 - учитывать; нет=0,да=1;
**'''подарок монеты id''' ''(gift_res1_id)'' - подарок монеты id;
**'''подарок монеты количество''' ''(gift_res1_amount)'' - подарок монеты количество;
**'''принимать подарки не чаще (сек)''' ''(gift_delay)'' - Принимать подарки с ресурсами не чаще заданного количества секунд. Работает только для энергии/res1 и только для парсовых подарков.

*'''запрос подарка'''
**'''текст''' ''(wishtxt)'' - Общий текст запроса подарка;
**'''завершающий текст''' ''(wishtxt2)'' - Текст, который будет добавлен после списка предметов;
**'''таблица''' ''(wishtbl)'' - Таблица, куда сложим множественный запрос подарков;
**'''ссылка''' ''(href)'' - Ссылка для публикации вишлиста на стене гугл.

*'''отправка подарка'''
**'''заголовок''' ''(gift_t)'' - заголовок инвайта;
**'''сообщение''' ''(gift_m)'' - текст инвайта;
**'''ограничение''' ''(gift_max)'' - ограничение на число подарков в день;
**'''счетчик''' ''(gift_cnt)'' - счетчик текущих подарков;
**'''заголовок уведомления''' ''(gift_not_t)'' - заголовок уведомления;
**'''сообщение уведомления''' ''(gift_not_m)'' - сообщение уведомления;
**'''viber url''' ''(gift_viber_url)'' - viber url инвайта.

*'''запрос подарка'''
**'''заголовок''' ''(ask_t)'' - заголовок инвайта;
**'''сообщение''' ''(ask_m)'' - текст инвайта.

*'''окно дарения из окна коллекций'''
**'''окно''' ''(wndcolgift)'' - Некая машина, олицетворяющая собой само окно предмета. Должна иметь состояние open;
**'''иконка''' ''(icocolgift)'' - Иконка предмета;
**'''текст (объект)''' ''(txtcolgift)'' - Текстовый объект в окошке;
**'''описание (объект)''' ''(dsccolgift)'' - Текстовый объект в окошке, в который сложим описание предмета;
**'''esocialfrienditem''' ''(itemcolgift)'' - Ссылка на объект типа esocialfrienditem, с которым будет работать объект;
**'''таблица друзей''' ''(tblcolgift)'' - Ссылка на таблицу, в которую будем клонировать esocialfrienditem.

*'''окно дарения с двумя списками'''
**'''скроллить таблицы''' ''(scroll_gifts)'' - Скроллть таблицы;
**'''esocialfrienditem''' ''(fritwndgift)'' - Ссылка на объект типа esocialfrienditem, с которым будет работать объект;
**'''таблица друзей''' ''(frtblwndgift)'' - Ссылка на таблицу, в которую будем клонировать esocialfrienditem;
**'''esocialgiftitem''' ''(giitwndgift)'' - Ссылка на объект типа esocialfrienditem, с которым будет работать объект;
**'''таблица подарков''' ''(gitblwndgift)'' - Ссылка на таблицу, в которую будем клонировать esocialfrienditem;
**'''иконка''' ''(icowndgift)'' - Иконка предмета;
**'''текст (объект)''' ''(txtwndgift)'' - Текстовый объект в окошке;
**'''описание (объект)''' ''(dscwndgift)'' - Текстовый объект в окошке, в который сложим описание предмета;
**'''esocialgiftitem инв.''' ''(giitwndgift_i)'' - Ссылка на объект типа esocialfrienditem, с которым будет работать объект;
**'''таблица подарков инв.''' ''(gitblwndgift_i)'' - Ссылка на таблицу, в которую будем клонировать esocialfrienditem.

*'''окно дарения из лидербордов'''
**'''иконка друга''' ''(icofrwndgift)'' - Иконка друга;
**'''имя друга''' ''(txtfrwndgift)'' - Имя друга;
**'''таблица вишлиста''' ''(wishtblwndgift)'' - Таблица вишлиста друга;
**'''таблица подарков''' ''(gitblwndgift2)'' - Ссылка на таблицу, в которую будем клонировать esocialfrienditem;
**'''иконка выбранного подарка''' ''(icofrgiwndgift)'' - Иконка выбранного подарка;
**'''цена выбранного подарка''' ''(cntfrgiwndgift)'' - Цена выбранного подарка;
**'''иконка выбранного подарка 2''' ''(icofrgiwndgift2)'' - Иконка выбранного подарка;
**'''цена выбранного подарка 2''' ''(cntfrgiwndgift2)'' - Цена выбранного подарка.

*'''окно приема подарка'''
**'''окно''' ''(wndgetgift)'' - Некая машина, олицетворяющая собой само окно предмета. Должна иметь состояние open;
**'''иконка''' ''(icogetgift)'' - Иконка предмета;
**'''текст (объект)''' ''(txtgetgift)'' - Текстовый объект в окошке;
**'''имя''' ''(namegetgift)'' - Тектовый объект куда будет занесено имя друга;
**'''аватарка''' ''(avagetgift)'' - Аватарка друга;
**'''giftreceiveitem''' ''(giftreceiveitem)'' - Объект типа giftreceiveitem;
**'''таблица''' ''(giftreceivetable)'' - Таблица, в которую будем складывать giftreceiveitem.

*'''окно входящих запросов подарков'''
**'''giftreceiveitem''' ''(giftaskitem)'' - Объект типа giftreceiveitem;
**'''таблица''' ''(giftasktable)'' - Таблица, в которую будем складывать giftreceiveitem.

==Инвайты==

*'''инвайт'''
**'''заголовок''' ''(invite_t)'' - заголовок инвайта;
**'''сообщение''' ''(invite_m)'' - текст инвайта;
**'''viber url''' ''(invite_viber_url)'' - viber url инвайта;
**'''время повтора''' ''(invite_tm)'' - время в секундах, когда можно повторно пригласить того же игрочка.

*'''успешный инвайт'''
**'''окно''' ''(invsuc_w)'' - само окошко успешного инвайта, должно иметь состояние show, на закрытие вызывать next_inv есошиалу;
**'''портрет''' ''(invite_i)'' - портрет игрока;
**'''имя''' ''(invite_n)'' - имя игрока;

В опции пишутся параметры инвайтов (вместо %d - айдишник объекта):

*'''esocial%d.max_invite_total''' - всего инвайтов отправлено
*'''esocial%d.max_invite_this''' - за последнюю отправку

Можно проверять в "nst_invite_sent"

==Остальное==

*'''случайные друзья'''
**'''таблица случайных друзей''' ''(friendrandom)'' - Ссылка на таблицу, в которую будем клонировать esocialfrienditem. Заполнить таблицу - вызвать объекту состояние friends_random;
**'''количество''' ''(frrandomnum)'' - Количество случайных друзей в таблицу.

*'''уведомление другу'''
**'''заголовок''' ''(notif_t)'' - заголовок уведомления;
**'''сообщение''' ''(notif_m)'' - текст уведомления.

*'''facebook story'''
**'''имя действия - первый me''' ''(fbstoryactionme)'' - Имя действия при первом успешном me;
**'''имя объекта - первый me''' ''(fbstoryobjectme)'' - Имя объекта при первом успешном me;
**'''урл - первый me''' ''(fbstoryurlme)'' - Шаблон урла при первом успешном me;
**'''урл картинки - первый me''' ''(fbstoryurlpicme)'' - Шаблон урла картинки при первом успешном me;
**'''имя действия - кастомное''' ''(fbstoryactioncustom)'' - Имя действия при первом успешном me;
**'''имя объекта - кастомное''' ''(fbstoryobjectcustom)'' - Имя объекта при первом успешном me;
**'''урл - кастомное''' ''(fbstoryurlcustom)'' - Шаблон урла при первом успешном me;
**'''урл картинки - кастомное''' ''(fbstoryurlpiccustom)'' - Шаблон урла картинки при первом успешном me;
**'''forced login - кастомное''' ''(fbstoryforcedcustom)'' - Принудительный логин при вызове состояния. ДЕЙСТВУЕТ ТОЛЬКО НА ОДИН ВЫЗОВ, потом сбрасывается в 0; нет=0,да=1.

*'''adjust'''
**'''включить adjust''' ''(adjust_on)'' - нет=0, да=1;
**'''инвайт для iOS''' ''(adjinvite_ios)'';
**'''инвайт для Ansroid''' ''(adjinvite_andrd)''.

==Обработчики==

*'''Изменить состояние объекта при принятии инвайта''' - при успешном принятии приглашения (друг установил приложение) переводит объект в состояние.
*'''Изменить состояние объекта при успешном выполнении задачи''' - при успешном выполнении задачи переводит объект в состояние
*'''Изменить состояние объекта при ошибке выполнения задачи''' - при ошибке выполнения задачи переводит объект в состояние
*'''изменить состояние объекта - дарим энергию выше max''' - обработчик применения энергии, когда дошли за максимум (сработает если '''учитывать максимум энергии''');

=Состояния=

*0. '''ready''' - состояние готовности
*1. '''friends'''
*2. '''friends_debug''' - добавляем фейковых друзей
*3. '''friends_inst''' - заполнить таблицу друзьями с установленной игрой
*4. '''friends_not_inst''' - заполнить таблицу друзьями с неустановленной игрой
*5. '''report''' - заслать полезную информацию (32бита)
*6. '''invite''' - показать окно инвайта
*7. '''cancel''' - отменить весь стек задач
*8. '''retry''' - повторить текущую задачу
*9. '''continue_fb''' - пропустить текущую задачу и перейти к следующей
*10. '''continue_google''' - пропустить текущую задачу и перейти к следующей
*11. '''next_inv''' - следующее окошко успешного инвайта
*12. '''gift''' - показать окно посылки подарка из окна коллекций
*13. '''gift_confirm''' - в окне посылки гифта из окна коллекций нажали кнопку ок
*14. '''wish''' - запостить на стену "попрошайку"
*15. '''check_requests''' - проверить реквесты от других пользователей
*16. '''next_gift''' - следующее окошко про полученный подарок17.
*17. '''refresh_gifts''' - актуализировать содержимое таблицы гифтов
*18. '''refresh_vip_gifts''' - актуализировать содержимое таблицы гифтов используя исключительно вип подарки
*19. '''gift_send''' - послать подарок из окна с двумя таблицами
*20. '''logout''' - разлогиниться из фейсбука удалив всю информацию о друзьях
*21. '''clear_gifts''' - сбросить ограничения на число подарков
*22. '''wish_table''' - добавить пожелание в таблицу пожеланий
*23. '''wish_all''' - пожелать все содержимое таблицы в фейсбук //Теперь только в фейсбук, а для гугла состояние ниже
*24. '''remove_gift''' - убрать подарок из таблицы
*25. '''gift_fb''' - подарить текущий подарок через фейбук используя нативный интерфейс фейсбука (т.е. так как сейчас работает гугл, без таблицы друзей)
*26. '''gift_info''' - Обновить информацию о текущих подарках в специальном окне
*27. '''gift_lb''' - Показать окно подарка из лидерборда
*28. '''gift_send_lb''' - Подтвердить отсылку подарка из лидерборда
*29. '''gift_receive''' - Получить подарок из окна получения подарков
*30. '''invite_lb''' - Послать приглашение другу из лидербордов
*31. '''get_me_google''' - запросить информацию о себе с гугла
*32. '''friends_inst_google''' - заполнить таблицу друзьями с установленной игрой
*33. '''friends_not_inst_google''' - заполнить таблицу друзьями с неустановленной игрой
*34. '''message_friend''' - послать другу уведомление
*35. '''friends_random''' - заполнить таблицу случайных друзей
*36. '''wish_all_google''' - пожелать все содержимое таблицы в гугл
*37. '''get_me_fb''' - запросить информацию о себе с фейсбука
*38. '''check_requests_fb''' - проверить реквесты от других пользователей для fb
*39. '''check_requests_google''' - проверить реквесты от других пользователей для гугл
*40. '''logout_google''' - разлогиниться из гугла, удалив всю информацию о друзьях
*41. '''gift_parse''' - Показать окно подарка из парсовой таблицы друзей
*42. '''gift_send_parse''' - Подтвердить отсылку подарка из парсовой таблицы друзей
*43. '''gift_parse_energy''' - Показать окно подарка энергии из парсовой таблицы друзей
*44. '''gift_parse_vip''' - Подарок вип-подарка из окна лидербордов
*45. '''gift_parse_res1''' - Подарок монет из окна лидербордов
*46. '''gift_receive_no_delete''' - Получить подарок из окна получения подарков без запроса
*47. '''gift_reply_energy''' - Послать в ответ энергию.
*48. '''gift_reply_more''' - Промотать таблицу подарков в клауде на нужного юзера
*49. '''gift_reply_res1''' - Послать в ответ ресурс1.
*50. '''gift_reply_universal''' - ответить тем же, что прислали
*51. '''gift_reply_vip''' - Послать в ответ vip.
*52. '''invite_parse''' - Послать приглашение другу из парса (но из общей таблицы, не из лидербордов)
*53. '''gift_parse_res1_multiple''' - отправить множественный подарок в виде монет
*54. '''gift_parse_item_multiple''' - отправить множественный подарок в виде предмета, взяв его из поля gift_param
*55. '''post_story''' - фоновое сообщение
*56. '''external_like''' - "внешнее" окошко лайка
*57. '''clear_timeouts''' - обнулить таймауты для некоторых тасков
*58. '''refresh_inv_gifts''' - актуализировать содержимое таблицы инвентарных гифтов
*59. '''wish_inv_add''' - добавить предмет из таблицы инвентарных в вишлист
*60. '''wish_inv_remove''' - убрать предмет из таблицы инвентарных в вишлист
*61. '''gift_parse_refresh''' - Обновить информацию о подарке в соотв. иконках и каунтерах
*62. '''check_requests_abs''' - проверить реквесты от других пользователей, но только parse
*63. '''switch_social_network''' - переключить активную социальную сеть, взяв ее айдишник из param
*64. '''invite_random''' - показать окно инвайта для случайных друзей

*66. '''join_community''' - пригласиться к группе, задать в параметр ''joincommunity'' id группы (для ВК).
*--. '''sign_in_with_apple''' - залогинится через Apple.

=Debug=
Для того, что бы отслеживать работу объекта Facebook в папке Documents создаются три файла, которые хранят в себе все знания относительно друзей данного пользователя, их коллекций и уровня:
 - '''facebook_debug_e.xml''' - создается во время отправки приглашения и при вызове состояния ''invite''
 - '''facebook_debug_s.xml''' - создается после фидбэка от Facebook'a.
 - '''facebook_debug.xml''' - создается исключительно в дебажной версии во время отправки объекту Facebook состояния ''friends'' или ''friends_inst''
Выглядит этот файл приблизительно вот так:
[[Файл:17-03-2014 11-09-06.png|right]]
Поля: '''request''' означает отправлен ли запрос. '''invite''' - принял ли запрос и поле '''inst'''(возможна ошибка в названии) - установлено ли приложение у данного друга.

=Задачи (команды) и ошибки=

В опции пишется номер успешной задачи, неуспешной и номер ошибки
*'''esocial%d.compl_task''' - поле в опциях, куда запишется номер успешно выполненной задачи. %d - id объекта esocial в проекте.
*'''esocial%d.err_task''' - поле в опциях, куда запишется номер неуспешной задачи. %d - id объекта esocial в проекте.
*'''esocial%d.err_code''' - поле в опциях, куда запишется номер ошибки. %d - id объекта esocial в проекте.

==Задачи==

При выполнении состояния Esocial пишет в лог следующее:

''onComplete state = %d task = %d,''

где номер таска берется из следующего списка (состояния Facebook):

*0 - провести авторизацию
*1 - закрыть текущую авторизованную сессию
*2 - создать диалог для отправки на стену
*3 - возвращает данные обо мне
*4 - возвращает данные о друзьях
*5 - возвращает данные о друзьях, которых можно пригласить в игру
*6 - получить список игровых сообщений
*7 - получить список групп пользователя
*8 - лайкал пользователь приложение или нет
*9 - обновить мои очки на facebook сервере
*10 - отправить игровое сообщение
*11 - удалить игровое сообщение на facebook сервере
*12 - отправить фоновое сообщение в ленту пользователя

След. сост. выполняются автоматически, если необходимо:
*13 - (ST_AUTO_CHECK_USER_PERMISSIONS) - получить список прав которые пользователь предоставил преложению
*14 - (ST_AUTO_CHECK_APP_PERMISSIONS) - получить список прав которые facebook предоставил преложению
*15 - (ST_AUTO_GET_WRITE_PERMISSIONS) - запросить у пользователя права на запись
*16 - (ST_AUTO_GET_READ_PERMISSIONS) - запросить у пользователя права на чтение
*17 - (ST_AUTO_POST_APP_REQUEST) - отправить application request пользователю
*18 - (ST_AUTO_CHECK_USER_ACHIEVEMENTS) - проверить текущие ачивки пользователя
*19 - (ST_CHANGE_SOCIAL_NETWORK) - изменить соц сеть

==Ошибки==

*0 - неизвестная ошибка
*1 - неизвестная задача
*2 - facebook не поддерживается
*3 - нет интернета
*4 - превышен лимит ожидания запроса
*5 - не указаны параметры для выполнения задачи
*6 - отмена диалогового окна пользователем
*7 - ошибка логина
*8 - ошибка авторизации
*9 - ошибка прав доступа

Если ошибка связана с запросами в Google Play Games, то к коду добавляется 1000, к примеру:
*1007 - ошибка логина в Google Play Games

Если ошибка связана с логином в Apple, то к коду добавляется 2000.

*2000 - ABS_SYSTEM_SIGNINWITHAPPLE_SUCCESS, // успех - не показываем
*2001 - ABS_SYSTEM_SIGNINWITHAPPLE_ERROR_CANCELED, // отмена пользователем - не показываеем
*2002 - ABS_SYSTEM_SIGNINWITHAPPLE_ERROR_FAILED, // ошибка логина
*2003 - ABS_SYSTEM_SIGNINWITHAPPLE_ERROR_INVALID_RESPONSE, // ошибка логина
*2004 - ABS_SYSTEM_SIGNINWITHAPPLE_ERROR_INVALID_NOT_HANDLED, // ошибка логина
*2005 - ABS_SYSTEM_SIGNINWITHAPPLE_ERROR_UNKNOWN // ошибка логина

Для обработки ошибок использовать [[Errormanager|ErrorManager]].

'''Пример запроса:'''
*подали запрос выполнить задачу (например ST_GET_FRIENDS)
*сначала проверяем есть ли права у приложения facebook (ST_AUTO_CHECK_APP_PERMISSIONS)
*потом проверяем есть ли права от пользователя (ST_AUTO_CHECK_USER_PERMISSIONS)
*если пользователь не давал прав, то просим (ST_AUTO_GET_READ_PERMISSIONS)
*потом снова проверяем дал ли нам пользователь права (ST_AUTO_CHECK_USER_PERMISSIONS)
*если весь цикл прошел успешно, то возвращаемся к поставленной задаче (ST_GET_FRIENDS)

'''ВАЖНО:'''
Если в любом месте произошел сбой, то ты НЕ увидишь конкретное состояние, ты увидишь только что "ST_GET_FRIENDS" отработал с ошибкой "9" или словами "ERR_PERMISSION". Других логик или кодов там нет.

==Слушатели заполнения таблиц==
Чтобы узнать когда окончательно заполниться таблица, нужно подвязать слушателя в нужном месте:
*Таблица лидеров:
**'''Cloud.table ''' - добавляемое свойство объекту 'Cloud' '''успешно загружены лидерборды''';
*Друзья и подарки:
**'''Cloud.table_fr ''' - добавляемое свойство объекту 'Cloud' '''успешно загружены друзья''';
*Неиграющие друзья:
** '''Esocial.friendsnotinst ''' - машинка-слушатель успеха объекта 'Esocial 'состояние '''5''' (изменить состояние объекта - успех задачи)
*Окно приёма подарка ( заполненность таблицы проверям у объекта "esocial" параметры "new_gifts" и "all_gifts"):
**'''Esocial.giftreceivetable ''' - машинка-слушатель объекта 'Esocial' (изменить состояние объекта - '''заполнена таблица с подарками''')

=Записи в логах=
==Отправка подарка==
21/3/2017 13:8:59.800: I/GESocial state() state 42
21/3/2017 13:8:59.800: I/GESocial state() New social system state = 42 gift = 11674 starting to search usid
21/3/2017 13:8:59.800: I/GESocial state() New social system state = 42 fb login = 1 gc login = 0
21/3/2017 13:8:59.800: I/GESocial state() state 13
21/3/2017 13:8:59.800: I/GESocial state() STATE_GIFT_CONFIRM gift = 11674
21/3/2017 13:8:59.800: I/GESocial state() STATE_GIFT_CONFIRM Got id from param, id = 258188181311449
21/3/2017 13:8:59.801: I/GESocial load() load curTime = 1492769339 saveTime = 1492769335 (curTime - saveTime) = 4
21/3/2017 13:8:59.801: I/GESocial state() STATE_GIFT_CONFIRM _giftsCur = 0, gift = 11674, id = 258188181311449, _giftsLimit = 50
21/3/2017 13:8:59.801: I/GESocial state() STATE_GIFT_CONFIRM soc_net == netFacebook id = 258188181311449, data = 3,241016273040597,11674
21/3/2017 13:8:59.805: I/GESocial state() Viber request gift urlId = -1, url = , text =
21/3/2017 13:8:59.808: I/GFacebook stPostRequest() stPostRequest -> title = Gift!, message = Иван Козаченко: Here is a gift for you!,
data = 3,241016273040597,11674, userId = 258188181311449,
excludeUserIds = , frictionless = 1, type = 2, forcedLogin=1

[[Category:Facebook]]

Esocial

2020-07-30T10:50:57Z

Vlegkun: /* Инвайты */

Esocial

2020-07-30T10:50:20Z

Vlegkun: /* Подарки */

Esocial

2020-07-30T10:08:12Z

Vlegkun: /* Общие */

Esocial

2020-07-30T09:58:43Z

Vlegkun: /* Общие */

[[Object|Объект]] '''Esocial''' обеспечивает связь между приложением и Facebook'ом.

=Параметры=

[[Файл:Esocial_full.jpg|right]]

==Общие==

*'''facebook''' - ссылка на объект ''[[facebook]]'', с которым будет работать объект
*'''esocialfriendsitem''' - ссылка на объект esocialfriendsitem, с которым будет работать объект
*'''таблица друзей''' - ссылка на таблицу, в которую будем клонировать esocialfriendsitem.
*'''индикатор активности''' - объект который видимый когда загружаются друзья. Видимость выключается, когда задача загрузки друзей выполнена (успех или провал не важно).
*'''опции для facebook''' - поле в опциях, куда мы будем записывать 32битное целое: Уровень + Коллекции.ESocial добавит к ним число друзей и засабмит при вызове соотв. состояние
*'''социальная сеть''' - выбор социальной сети с которой взаимодействовать. На данный момент можно выбрать facebook, google+ и обе.

==Подарки==

*'''специальные подарки'''
**'''подарок энергия id''' - id предметы из экономики;
**'''подарок энергия количество''' - количество;
**'''учитывать максимум энергии''' - если да, то не будет начисляться энергия выше максимума;

*'''Запрос подарка'''
**'''Текст''' - текстовый id, в котором будет хранится текст типа:"Мне нужны коллекционные предметы:". После ":" будут перечисляться предметы (названия будут браться из id коллекционных предметов), которые нужны игроку, через запятую.
**'''Таблица''' - таблица, в которую будут сложены желаемые предметы из окна коллекции для последующего поста их на стену.

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

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

*'''Окно дарения с двумя списками'''
**'''esocialfrienditem ''' - объект типа esocialfriendsitem (темплейт друга в таблице), который заполнит таблицу друзей.
**'''таблица друзей''' - ссылка на таблицу в которую мы клонируем объект esocialfriendsitem из поля выше.
**'''esocialgiftitem ''' - объект типа esocialgiftitem (темплейт подарка в таблице), который заполнит таблицу подарков.
**'''таблица подарков''' - ссылка на таблицу в которую мы клонируем объект esocialgiftitem из поля выше.

==Инвайты==

*'''Инвайт'''
**'''Заголовок''' - Заголовок сообщения, которое увидит пользователь в фейсбуке, перетаскивается из текстового редактора
**'''Сообщение''' - Сообщение, которое увидит пользователь в фейсбуке, перетаскивается из текстового редактора

*'''Успешный инвайт'''
**'''Окно''' - Машина, открывающая форму, которая содержит информацию об успешно приглашенном друге. Должна иметь состояние show. На закрытие должна вызывать состояние next_inv объекту esocial
**'''Портрет''' - Объект, в который будет сложена иконка друга, подтянутая с facebook
**'''Имя''' - Объект, в который будет сложено имя друга, подтянутое с facebook

В опции пишутся параметры инвайтов (вместо %d - айдишник объекта):

*'''esocial%d.max_invite_total''' - всего инвайтов отправлено
*'''esocial%d.max_invite_this''' - за последнюю отправку

Можно проверять в "nst_invite_sent"

==Обработчики==

*'''Изменить состояние объекта при принятии инвайта''' - при успешном принятии приглашения (друг установил приложение) переводит объект в состояние.
*'''Изменить состояние объекта при успешном выполнении задачи''' - при успешном выполнении задачи переводит объект в состояние
*'''Изменить состояние объекта при ошибке выполнения задачи''' - при ошибке выполнения задачи переводит объект в состояние
*'''изменить состояние объекта - дарим энергию выше max''' - обработчик применения энергии, когда дошли за максимум (сработает если '''учитывать максимум энергии''');

=Состояния=

*0. '''ready''' - состояние готовности
*1. '''friends'''
*2. '''friends_debug''' - добавляем фейковых друзей
*3. '''friends_inst''' - заполнить таблицу друзьями с установленной игрой
*4. '''friends_not_inst''' - заполнить таблицу друзьями с неустановленной игрой
*5. '''report''' - заслать полезную информацию (32бита)
*6. '''invite''' - показать окно инвайта
*7. '''cancel''' - отменить весь стек задач
*8. '''retry''' - повторить текущую задачу
*9. '''continue_fb''' - пропустить текущую задачу и перейти к следующей
*10. '''continue_google''' - пропустить текущую задачу и перейти к следующей
*11. '''next_inv''' - следующее окошко успешного инвайта
*12. '''gift''' - показать окно посылки подарка из окна коллекций
*13. '''gift_confirm''' - в окне посылки гифта из окна коллекций нажали кнопку ок
*14. '''wish''' - запостить на стену "попрошайку"
*15. '''check_requests''' - проверить реквесты от других пользователей
*16. '''next_gift''' - следующее окошко про полученный подарок17.
*17. '''refresh_gifts''' - актуализировать содержимое таблицы гифтов
*18. '''refresh_vip_gifts''' - актуализировать содержимое таблицы гифтов используя исключительно вип подарки
*19. '''gift_send''' - послать подарок из окна с двумя таблицами
*20. '''logout''' - разлогиниться из фейсбука удалив всю информацию о друзьях
*21. '''clear_gifts''' - сбросить ограничения на число подарков
*22. '''wish_table''' - добавить пожелание в таблицу пожеланий
*23. '''wish_all''' - пожелать все содержимое таблицы в фейсбук //Теперь только в фейсбук, а для гугла состояние ниже
*24. '''remove_gift''' - убрать подарок из таблицы
*25. '''gift_fb''' - подарить текущий подарок через фейбук используя нативный интерфейс фейсбука (т.е. так как сейчас работает гугл, без таблицы друзей)
*26. '''gift_info''' - Обновить информацию о текущих подарках в специальном окне
*27. '''gift_lb''' - Показать окно подарка из лидерборда
*28. '''gift_send_lb''' - Подтвердить отсылку подарка из лидерборда
*29. '''gift_receive''' - Получить подарок из окна получения подарков
*30. '''invite_lb''' - Послать приглашение другу из лидербордов
*31. '''get_me_google''' - запросить информацию о себе с гугла
*32. '''friends_inst_google''' - заполнить таблицу друзьями с установленной игрой
*33. '''friends_not_inst_google''' - заполнить таблицу друзьями с неустановленной игрой
*34. '''message_friend''' - послать другу уведомление
*35. '''friends_random''' - заполнить таблицу случайных друзей
*36. '''wish_all_google''' - пожелать все содержимое таблицы в гугл
*37. '''get_me_fb''' - запросить информацию о себе с фейсбука
*38. '''check_requests_fb''' - проверить реквесты от других пользователей для fb
*39. '''check_requests_google''' - проверить реквесты от других пользователей для гугл
*40. '''logout_google''' - разлогиниться из гугла, удалив всю информацию о друзьях
*41. '''gift_parse''' - Показать окно подарка из парсовой таблицы друзей
*42. '''gift_send_parse''' - Подтвердить отсылку подарка из парсовой таблицы друзей
*43. '''gift_parse_energy''' - Показать окно подарка энергии из парсовой таблицы друзей
*44. '''gift_parse_vip''' - Подарок вип-подарка из окна лидербордов
*45. '''gift_parse_res1''' - Подарок монет из окна лидербордов
*46. '''gift_receive_no_delete''' - Получить подарок из окна получения подарков без запроса
*47. '''gift_reply_energy''' - Послать в ответ энергию.
*48. '''gift_reply_more''' - Промотать таблицу подарков в клауде на нужного юзера
*49. '''gift_reply_res1''' - Послать в ответ ресурс1.
*50. '''gift_reply_universal''' - ответить тем же, что прислали
*51. '''gift_reply_vip''' - Послать в ответ vip.
*52. '''invite_parse''' - Послать приглашение другу из парса (но из общей таблицы, не из лидербордов)
*53. '''gift_parse_res1_multiple''' - отправить множественный подарок в виде монет
*54. '''gift_parse_item_multiple''' - отправить множественный подарок в виде предмета, взяв его из поля gift_param
*55. '''post_story''' - фоновое сообщение
*56. '''external_like''' - "внешнее" окошко лайка
*57. '''clear_timeouts''' - обнулить таймауты для некоторых тасков
*58. '''refresh_inv_gifts''' - актуализировать содержимое таблицы инвентарных гифтов
*59. '''wish_inv_add''' - добавить предмет из таблицы инвентарных в вишлист
*60. '''wish_inv_remove''' - убрать предмет из таблицы инвентарных в вишлист
*61. '''gift_parse_refresh''' - Обновить информацию о подарке в соотв. иконках и каунтерах
*62. '''check_requests_abs''' - проверить реквесты от других пользователей, но только parse
*63. '''switch_social_network''' - переключить активную социальную сеть, взяв ее айдишник из param
*64. '''invite_random''' - показать окно инвайта для случайных друзей

*66. '''join_community''' - пригласиться к группе, задать в параметр ''joincommunity'' id группы (для ВК).
*--. '''sign_in_with_apple''' - залогинится через Apple.

=Debug=
Для того, что бы отслеживать работу объекта Facebook в папке Documents создаются три файла, которые хранят в себе все знания относительно друзей данного пользователя, их коллекций и уровня:
 - '''facebook_debug_e.xml''' - создается во время отправки приглашения и при вызове состояния ''invite''
 - '''facebook_debug_s.xml''' - создается после фидбэка от Facebook'a.
 - '''facebook_debug.xml''' - создается исключительно в дебажной версии во время отправки объекту Facebook состояния ''friends'' или ''friends_inst''
Выглядит этот файл приблизительно вот так:
[[Файл:17-03-2014 11-09-06.png|right]]
Поля: '''request''' означает отправлен ли запрос. '''invite''' - принял ли запрос и поле '''inst'''(возможна ошибка в названии) - установлено ли приложение у данного друга.

=Задачи (команды) и ошибки=

В опции пишется номер успешной задачи, неуспешной и номер ошибки
*'''esocial%d.compl_task''' - поле в опциях, куда запишется номер успешно выполненной задачи. %d - id объекта esocial в проекте.
*'''esocial%d.err_task''' - поле в опциях, куда запишется номер неуспешной задачи. %d - id объекта esocial в проекте.
*'''esocial%d.err_code''' - поле в опциях, куда запишется номер ошибки. %d - id объекта esocial в проекте.

==Задачи==

При выполнении состояния Esocial пишет в лог следующее:

''onComplete state = %d task = %d,''

где номер таска берется из следующего списка (состояния Facebook):

*0 - провести авторизацию
*1 - закрыть текущую авторизованную сессию
*2 - создать диалог для отправки на стену
*3 - возвращает данные обо мне
*4 - возвращает данные о друзьях
*5 - возвращает данные о друзьях, которых можно пригласить в игру
*6 - получить список игровых сообщений
*7 - получить список групп пользователя
*8 - лайкал пользователь приложение или нет
*9 - обновить мои очки на facebook сервере
*10 - отправить игровое сообщение
*11 - удалить игровое сообщение на facebook сервере
*12 - отправить фоновое сообщение в ленту пользователя

След. сост. выполняются автоматически, если необходимо:
*13 - (ST_AUTO_CHECK_USER_PERMISSIONS) - получить список прав которые пользователь предоставил преложению
*14 - (ST_AUTO_CHECK_APP_PERMISSIONS) - получить список прав которые facebook предоставил преложению
*15 - (ST_AUTO_GET_WRITE_PERMISSIONS) - запросить у пользователя права на запись
*16 - (ST_AUTO_GET_READ_PERMISSIONS) - запросить у пользователя права на чтение
*17 - (ST_AUTO_POST_APP_REQUEST) - отправить application request пользователю
*18 - (ST_AUTO_CHECK_USER_ACHIEVEMENTS) - проверить текущие ачивки пользователя
*19 - (ST_CHANGE_SOCIAL_NETWORK) - изменить соц сеть

==Ошибки==

*0 - неизвестная ошибка
*1 - неизвестная задача
*2 - facebook не поддерживается
*3 - нет интернета
*4 - превышен лимит ожидания запроса
*5 - не указаны параметры для выполнения задачи
*6 - отмена диалогового окна пользователем
*7 - ошибка логина
*8 - ошибка авторизации
*9 - ошибка прав доступа

Если ошибка связана с запросами в Google Play Games, то к коду добавляется 1000, к примеру:
*1007 - ошибка логина в Google Play Games

Если ошибка связана с логином в Apple, то к коду добавляется 2000.

*2000 - ABS_SYSTEM_SIGNINWITHAPPLE_SUCCESS, // успех - не показываем
*2001 - ABS_SYSTEM_SIGNINWITHAPPLE_ERROR_CANCELED, // отмена пользователем - не показываеем
*2002 - ABS_SYSTEM_SIGNINWITHAPPLE_ERROR_FAILED, // ошибка логина
*2003 - ABS_SYSTEM_SIGNINWITHAPPLE_ERROR_INVALID_RESPONSE, // ошибка логина
*2004 - ABS_SYSTEM_SIGNINWITHAPPLE_ERROR_INVALID_NOT_HANDLED, // ошибка логина
*2005 - ABS_SYSTEM_SIGNINWITHAPPLE_ERROR_UNKNOWN // ошибка логина

Для обработки ошибок использовать [[Errormanager|ErrorManager]].

'''Пример запроса:'''
*подали запрос выполнить задачу (например ST_GET_FRIENDS)
*сначала проверяем есть ли права у приложения facebook (ST_AUTO_CHECK_APP_PERMISSIONS)
*потом проверяем есть ли права от пользователя (ST_AUTO_CHECK_USER_PERMISSIONS)
*если пользователь не давал прав, то просим (ST_AUTO_GET_READ_PERMISSIONS)
*потом снова проверяем дал ли нам пользователь права (ST_AUTO_CHECK_USER_PERMISSIONS)
*если весь цикл прошел успешно, то возвращаемся к поставленной задаче (ST_GET_FRIENDS)

'''ВАЖНО:'''
Если в любом месте произошел сбой, то ты НЕ увидишь конкретное состояние, ты увидишь только что "ST_GET_FRIENDS" отработал с ошибкой "9" или словами "ERR_PERMISSION". Других логик или кодов там нет.

==Слушатели заполнения таблиц==
Чтобы узнать когда окончательно заполниться таблица, нужно подвязать слушателя в нужном месте:
*Таблица лидеров:
**'''Cloud.table ''' - добавляемое свойство объекту 'Cloud' '''успешно загружены лидерборды''';
*Друзья и подарки:
**'''Cloud.table_fr ''' - добавляемое свойство объекту 'Cloud' '''успешно загружены друзья''';
*Неиграющие друзья:
** '''Esocial.friendsnotinst ''' - машинка-слушатель успеха объекта 'Esocial 'состояние '''5''' (изменить состояние объекта - успех задачи)
*Окно приёма подарка ( заполненность таблицы проверям у объекта "esocial" параметры "new_gifts" и "all_gifts"):
**'''Esocial.giftreceivetable ''' - машинка-слушатель объекта 'Esocial' (изменить состояние объекта - '''заполнена таблица с подарками''')

=Записи в логах=
==Отправка подарка==
21/3/2017 13:8:59.800: I/GESocial state() state 42
21/3/2017 13:8:59.800: I/GESocial state() New social system state = 42 gift = 11674 starting to search usid
21/3/2017 13:8:59.800: I/GESocial state() New social system state = 42 fb login = 1 gc login = 0
21/3/2017 13:8:59.800: I/GESocial state() state 13
21/3/2017 13:8:59.800: I/GESocial state() STATE_GIFT_CONFIRM gift = 11674
21/3/2017 13:8:59.800: I/GESocial state() STATE_GIFT_CONFIRM Got id from param, id = 258188181311449
21/3/2017 13:8:59.801: I/GESocial load() load curTime = 1492769339 saveTime = 1492769335 (curTime - saveTime) = 4
21/3/2017 13:8:59.801: I/GESocial state() STATE_GIFT_CONFIRM _giftsCur = 0, gift = 11674, id = 258188181311449, _giftsLimit = 50
21/3/2017 13:8:59.801: I/GESocial state() STATE_GIFT_CONFIRM soc_net == netFacebook id = 258188181311449, data = 3,241016273040597,11674
21/3/2017 13:8:59.805: I/GESocial state() Viber request gift urlId = -1, url = , text =
21/3/2017 13:8:59.808: I/GFacebook stPostRequest() stPostRequest -> title = Gift!, message = Иван Козаченко: Here is a gift for you!,
data = 3,241016273040597,11674, userId = 258188181311449,
excludeUserIds = , frictionless = 1, type = 2, forcedLogin=1

[[Category:Facebook]]

Esocial

2020-07-30T09:58:22Z

Vlegkun: /* Параметры */

[[Object|Объект]] '''Esocial''' обеспечивает связь между приложением и Facebook'ом.

=Параметры=

[[Файл:Esocial_full.jpg|right]]

==Общие==

*'''facebook''' - ссылка на объект [[facebook]], с которым будет работать объект
*'''esocialfriendsitem''' - ссылка на объект esocialfriendsitem, с которым будет работать объект
*'''таблица друзей''' - ссылка на таблицу, в которую будем клонировать esocialfriendsitem.
*'''индикатор активности''' - объект который видимый когда загружаются друзья. Видимость выключается, когда задача загрузки друзей выполнена (успех или провал не важно).
*'''опции для facebook''' - поле в опциях, куда мы будем записывать 32битное целое: Уровень + Коллекции.ESocial добавит к ним число друзей и засабмит при вызове соотв. состояние
*'''социальная сеть''' - выбор социальной сети с которой взаимодействовать. На данный момент можно выбрать facebook, google+ и обе.

==Подарки==

*'''специальные подарки'''
**'''подарок энергия id''' - id предметы из экономики;
**'''подарок энергия количество''' - количество;
**'''учитывать максимум энергии''' - если да, то не будет начисляться энергия выше максимума;

*'''Запрос подарка'''
**'''Текст''' - текстовый id, в котором будет хранится текст типа:"Мне нужны коллекционные предметы:". После ":" будут перечисляться предметы (названия будут браться из id коллекционных предметов), которые нужны игроку, через запятую.
**'''Таблица''' - таблица, в которую будут сложены желаемые предметы из окна коллекции для последующего поста их на стену.

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

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

*'''Окно дарения с двумя списками'''
**'''esocialfrienditem ''' - объект типа esocialfriendsitem (темплейт друга в таблице), который заполнит таблицу друзей.
**'''таблица друзей''' - ссылка на таблицу в которую мы клонируем объект esocialfriendsitem из поля выше.
**'''esocialgiftitem ''' - объект типа esocialgiftitem (темплейт подарка в таблице), который заполнит таблицу подарков.
**'''таблица подарков''' - ссылка на таблицу в которую мы клонируем объект esocialgiftitem из поля выше.

==Инвайты==

*'''Инвайт'''
**'''Заголовок''' - Заголовок сообщения, которое увидит пользователь в фейсбуке, перетаскивается из текстового редактора
**'''Сообщение''' - Сообщение, которое увидит пользователь в фейсбуке, перетаскивается из текстового редактора

*'''Успешный инвайт'''
**'''Окно''' - Машина, открывающая форму, которая содержит информацию об успешно приглашенном друге. Должна иметь состояние show. На закрытие должна вызывать состояние next_inv объекту esocial
**'''Портрет''' - Объект, в который будет сложена иконка друга, подтянутая с facebook
**'''Имя''' - Объект, в который будет сложено имя друга, подтянутое с facebook

В опции пишутся параметры инвайтов (вместо %d - айдишник объекта):

*'''esocial%d.max_invite_total''' - всего инвайтов отправлено
*'''esocial%d.max_invite_this''' - за последнюю отправку

Можно проверять в "nst_invite_sent"

==Обработчики==

*'''Изменить состояние объекта при принятии инвайта''' - при успешном принятии приглашения (друг установил приложение) переводит объект в состояние.
*'''Изменить состояние объекта при успешном выполнении задачи''' - при успешном выполнении задачи переводит объект в состояние
*'''Изменить состояние объекта при ошибке выполнения задачи''' - при ошибке выполнения задачи переводит объект в состояние
*'''изменить состояние объекта - дарим энергию выше max''' - обработчик применения энергии, когда дошли за максимум (сработает если '''учитывать максимум энергии''');

=Состояния=

*0. '''ready''' - состояние готовности
*1. '''friends'''
*2. '''friends_debug''' - добавляем фейковых друзей
*3. '''friends_inst''' - заполнить таблицу друзьями с установленной игрой
*4. '''friends_not_inst''' - заполнить таблицу друзьями с неустановленной игрой
*5. '''report''' - заслать полезную информацию (32бита)
*6. '''invite''' - показать окно инвайта
*7. '''cancel''' - отменить весь стек задач
*8. '''retry''' - повторить текущую задачу
*9. '''continue_fb''' - пропустить текущую задачу и перейти к следующей
*10. '''continue_google''' - пропустить текущую задачу и перейти к следующей
*11. '''next_inv''' - следующее окошко успешного инвайта
*12. '''gift''' - показать окно посылки подарка из окна коллекций
*13. '''gift_confirm''' - в окне посылки гифта из окна коллекций нажали кнопку ок
*14. '''wish''' - запостить на стену "попрошайку"
*15. '''check_requests''' - проверить реквесты от других пользователей
*16. '''next_gift''' - следующее окошко про полученный подарок17.
*17. '''refresh_gifts''' - актуализировать содержимое таблицы гифтов
*18. '''refresh_vip_gifts''' - актуализировать содержимое таблицы гифтов используя исключительно вип подарки
*19. '''gift_send''' - послать подарок из окна с двумя таблицами
*20. '''logout''' - разлогиниться из фейсбука удалив всю информацию о друзьях
*21. '''clear_gifts''' - сбросить ограничения на число подарков
*22. '''wish_table''' - добавить пожелание в таблицу пожеланий
*23. '''wish_all''' - пожелать все содержимое таблицы в фейсбук //Теперь только в фейсбук, а для гугла состояние ниже
*24. '''remove_gift''' - убрать подарок из таблицы
*25. '''gift_fb''' - подарить текущий подарок через фейбук используя нативный интерфейс фейсбука (т.е. так как сейчас работает гугл, без таблицы друзей)
*26. '''gift_info''' - Обновить информацию о текущих подарках в специальном окне
*27. '''gift_lb''' - Показать окно подарка из лидерборда
*28. '''gift_send_lb''' - Подтвердить отсылку подарка из лидерборда
*29. '''gift_receive''' - Получить подарок из окна получения подарков
*30. '''invite_lb''' - Послать приглашение другу из лидербордов
*31. '''get_me_google''' - запросить информацию о себе с гугла
*32. '''friends_inst_google''' - заполнить таблицу друзьями с установленной игрой
*33. '''friends_not_inst_google''' - заполнить таблицу друзьями с неустановленной игрой
*34. '''message_friend''' - послать другу уведомление
*35. '''friends_random''' - заполнить таблицу случайных друзей
*36. '''wish_all_google''' - пожелать все содержимое таблицы в гугл
*37. '''get_me_fb''' - запросить информацию о себе с фейсбука
*38. '''check_requests_fb''' - проверить реквесты от других пользователей для fb
*39. '''check_requests_google''' - проверить реквесты от других пользователей для гугл
*40. '''logout_google''' - разлогиниться из гугла, удалив всю информацию о друзьях
*41. '''gift_parse''' - Показать окно подарка из парсовой таблицы друзей
*42. '''gift_send_parse''' - Подтвердить отсылку подарка из парсовой таблицы друзей
*43. '''gift_parse_energy''' - Показать окно подарка энергии из парсовой таблицы друзей
*44. '''gift_parse_vip''' - Подарок вип-подарка из окна лидербордов
*45. '''gift_parse_res1''' - Подарок монет из окна лидербордов
*46. '''gift_receive_no_delete''' - Получить подарок из окна получения подарков без запроса
*47. '''gift_reply_energy''' - Послать в ответ энергию.
*48. '''gift_reply_more''' - Промотать таблицу подарков в клауде на нужного юзера
*49. '''gift_reply_res1''' - Послать в ответ ресурс1.
*50. '''gift_reply_universal''' - ответить тем же, что прислали
*51. '''gift_reply_vip''' - Послать в ответ vip.
*52. '''invite_parse''' - Послать приглашение другу из парса (но из общей таблицы, не из лидербордов)
*53. '''gift_parse_res1_multiple''' - отправить множественный подарок в виде монет
*54. '''gift_parse_item_multiple''' - отправить множественный подарок в виде предмета, взяв его из поля gift_param
*55. '''post_story''' - фоновое сообщение
*56. '''external_like''' - "внешнее" окошко лайка
*57. '''clear_timeouts''' - обнулить таймауты для некоторых тасков
*58. '''refresh_inv_gifts''' - актуализировать содержимое таблицы инвентарных гифтов
*59. '''wish_inv_add''' - добавить предмет из таблицы инвентарных в вишлист
*60. '''wish_inv_remove''' - убрать предмет из таблицы инвентарных в вишлист
*61. '''gift_parse_refresh''' - Обновить информацию о подарке в соотв. иконках и каунтерах
*62. '''check_requests_abs''' - проверить реквесты от других пользователей, но только parse
*63. '''switch_social_network''' - переключить активную социальную сеть, взяв ее айдишник из param
*64. '''invite_random''' - показать окно инвайта для случайных друзей

*66. '''join_community''' - пригласиться к группе, задать в параметр ''joincommunity'' id группы (для ВК).
*--. '''sign_in_with_apple''' - залогинится через Apple.

=Debug=
Для того, что бы отслеживать работу объекта Facebook в папке Documents создаются три файла, которые хранят в себе все знания относительно друзей данного пользователя, их коллекций и уровня:
 - '''facebook_debug_e.xml''' - создается во время отправки приглашения и при вызове состояния ''invite''
 - '''facebook_debug_s.xml''' - создается после фидбэка от Facebook'a.
 - '''facebook_debug.xml''' - создается исключительно в дебажной версии во время отправки объекту Facebook состояния ''friends'' или ''friends_inst''
Выглядит этот файл приблизительно вот так:
[[Файл:17-03-2014 11-09-06.png|right]]
Поля: '''request''' означает отправлен ли запрос. '''invite''' - принял ли запрос и поле '''inst'''(возможна ошибка в названии) - установлено ли приложение у данного друга.

=Задачи (команды) и ошибки=

В опции пишется номер успешной задачи, неуспешной и номер ошибки
*'''esocial%d.compl_task''' - поле в опциях, куда запишется номер успешно выполненной задачи. %d - id объекта esocial в проекте.
*'''esocial%d.err_task''' - поле в опциях, куда запишется номер неуспешной задачи. %d - id объекта esocial в проекте.
*'''esocial%d.err_code''' - поле в опциях, куда запишется номер ошибки. %d - id объекта esocial в проекте.

==Задачи==

При выполнении состояния Esocial пишет в лог следующее:

''onComplete state = %d task = %d,''

где номер таска берется из следующего списка (состояния Facebook):

*0 - провести авторизацию
*1 - закрыть текущую авторизованную сессию
*2 - создать диалог для отправки на стену
*3 - возвращает данные обо мне
*4 - возвращает данные о друзьях
*5 - возвращает данные о друзьях, которых можно пригласить в игру
*6 - получить список игровых сообщений
*7 - получить список групп пользователя
*8 - лайкал пользователь приложение или нет
*9 - обновить мои очки на facebook сервере
*10 - отправить игровое сообщение
*11 - удалить игровое сообщение на facebook сервере
*12 - отправить фоновое сообщение в ленту пользователя

След. сост. выполняются автоматически, если необходимо:
*13 - (ST_AUTO_CHECK_USER_PERMISSIONS) - получить список прав которые пользователь предоставил преложению
*14 - (ST_AUTO_CHECK_APP_PERMISSIONS) - получить список прав которые facebook предоставил преложению
*15 - (ST_AUTO_GET_WRITE_PERMISSIONS) - запросить у пользователя права на запись
*16 - (ST_AUTO_GET_READ_PERMISSIONS) - запросить у пользователя права на чтение
*17 - (ST_AUTO_POST_APP_REQUEST) - отправить application request пользователю
*18 - (ST_AUTO_CHECK_USER_ACHIEVEMENTS) - проверить текущие ачивки пользователя
*19 - (ST_CHANGE_SOCIAL_NETWORK) - изменить соц сеть

==Ошибки==

*0 - неизвестная ошибка
*1 - неизвестная задача
*2 - facebook не поддерживается
*3 - нет интернета
*4 - превышен лимит ожидания запроса
*5 - не указаны параметры для выполнения задачи
*6 - отмена диалогового окна пользователем
*7 - ошибка логина
*8 - ошибка авторизации
*9 - ошибка прав доступа

Если ошибка связана с запросами в Google Play Games, то к коду добавляется 1000, к примеру:
*1007 - ошибка логина в Google Play Games

Если ошибка связана с логином в Apple, то к коду добавляется 2000.

*2000 - ABS_SYSTEM_SIGNINWITHAPPLE_SUCCESS, // успех - не показываем
*2001 - ABS_SYSTEM_SIGNINWITHAPPLE_ERROR_CANCELED, // отмена пользователем - не показываеем
*2002 - ABS_SYSTEM_SIGNINWITHAPPLE_ERROR_FAILED, // ошибка логина
*2003 - ABS_SYSTEM_SIGNINWITHAPPLE_ERROR_INVALID_RESPONSE, // ошибка логина
*2004 - ABS_SYSTEM_SIGNINWITHAPPLE_ERROR_INVALID_NOT_HANDLED, // ошибка логина
*2005 - ABS_SYSTEM_SIGNINWITHAPPLE_ERROR_UNKNOWN // ошибка логина

Для обработки ошибок использовать [[Errormanager|ErrorManager]].

'''Пример запроса:'''
*подали запрос выполнить задачу (например ST_GET_FRIENDS)
*сначала проверяем есть ли права у приложения facebook (ST_AUTO_CHECK_APP_PERMISSIONS)
*потом проверяем есть ли права от пользователя (ST_AUTO_CHECK_USER_PERMISSIONS)
*если пользователь не давал прав, то просим (ST_AUTO_GET_READ_PERMISSIONS)
*потом снова проверяем дал ли нам пользователь права (ST_AUTO_CHECK_USER_PERMISSIONS)
*если весь цикл прошел успешно, то возвращаемся к поставленной задаче (ST_GET_FRIENDS)

'''ВАЖНО:'''
Если в любом месте произошел сбой, то ты НЕ увидишь конкретное состояние, ты увидишь только что "ST_GET_FRIENDS" отработал с ошибкой "9" или словами "ERR_PERMISSION". Других логик или кодов там нет.

==Слушатели заполнения таблиц==
Чтобы узнать когда окончательно заполниться таблица, нужно подвязать слушателя в нужном месте:
*Таблица лидеров:
**'''Cloud.table ''' - добавляемое свойство объекту 'Cloud' '''успешно загружены лидерборды''';
*Друзья и подарки:
**'''Cloud.table_fr ''' - добавляемое свойство объекту 'Cloud' '''успешно загружены друзья''';
*Неиграющие друзья:
** '''Esocial.friendsnotinst ''' - машинка-слушатель успеха объекта 'Esocial 'состояние '''5''' (изменить состояние объекта - успех задачи)
*Окно приёма подарка ( заполненность таблицы проверям у объекта "esocial" параметры "new_gifts" и "all_gifts"):
**'''Esocial.giftreceivetable ''' - машинка-слушатель объекта 'Esocial' (изменить состояние объекта - '''заполнена таблица с подарками''')

=Записи в логах=
==Отправка подарка==
21/3/2017 13:8:59.800: I/GESocial state() state 42
21/3/2017 13:8:59.800: I/GESocial state() New social system state = 42 gift = 11674 starting to search usid
21/3/2017 13:8:59.800: I/GESocial state() New social system state = 42 fb login = 1 gc login = 0
21/3/2017 13:8:59.800: I/GESocial state() state 13
21/3/2017 13:8:59.800: I/GESocial state() STATE_GIFT_CONFIRM gift = 11674
21/3/2017 13:8:59.800: I/GESocial state() STATE_GIFT_CONFIRM Got id from param, id = 258188181311449
21/3/2017 13:8:59.801: I/GESocial load() load curTime = 1492769339 saveTime = 1492769335 (curTime - saveTime) = 4
21/3/2017 13:8:59.801: I/GESocial state() STATE_GIFT_CONFIRM _giftsCur = 0, gift = 11674, id = 258188181311449, _giftsLimit = 50
21/3/2017 13:8:59.801: I/GESocial state() STATE_GIFT_CONFIRM soc_net == netFacebook id = 258188181311449, data = 3,241016273040597,11674
21/3/2017 13:8:59.805: I/GESocial state() Viber request gift urlId = -1, url = , text =
21/3/2017 13:8:59.808: I/GFacebook stPostRequest() stPostRequest -> title = Gift!, message = Иван Козаченко: Here is a gift for you!,
data = 3,241016273040597,11674, userId = 258188181311449,
excludeUserIds = , frictionless = 1, type = 2, forcedLogin=1

[[Category:Facebook]]

Esocial

2020-07-30T09:38:22Z

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

[[Object|Объект]] '''Esocial''' обеспечивает связь между приложением и Facebook'ом.

=Параметры=

[[Файл:Esocial_full.jpg|right]]
*'''facebook''' - ссылка на объект [[facebook]], с которым будет работать объект
*'''esocialfriendsitem''' - ссылка на объект esocialfriendsitem, с которым будет работать объект
*'''таблица друзей''' - ссылка на таблицу, в которую будем клонировать esocialfriendsitem.
*'''индикатор активности''' - объект который видимый когда загружаются друзья. Видимость выключается, когда задача загрузки друзей выполнена (успех или провал не важно).
*'''опции для facebook''' - поле в опциях, куда мы будем записывать 32битное целое: Уровень + Коллекции.ESocial добавит к ним число друзей и засабмит при вызове соотв. состояние
*'''социальная сеть''' - выбор социальной сети с которой взаимодействовать. На данный момент можно выбрать facebook, google+ и обе.

*'''специальные подарки'''
**'''подарок энергия id''' - id предметы из экономики;
**'''подарок энергия количество''' - количество;
**'''учитывать максимум энергии''' - если да, то не будет начисляться энергия выше максимума;

*'''Инвайт'''
**'''Заголовок''' - Заголовок сообщения, которое увидит пользователь в фейсбуке, перетаскивается из текстового редактора
**'''Сообщение''' - Сообщение, которое увидит пользователь в фейсбуке, перетаскивается из текстового редактора

*'''Успешный инвайт'''
**'''Окно''' - Машина, открывающая форму, которая содержит информацию об успешно приглашенном друге. Должна иметь состояние show. На закрытие должна вызывать состояние next_inv объекту esocial
**'''Портрет''' - Объект, в который будет сложена иконка друга, подтянутая с facebook
**'''Имя''' - Объект, в который будет сложено имя друга, подтянутое с facebook

*'''Запрос подарка'''
**'''Текст''' - текстовый id, в котором будет хранится текст типа:"Мне нужны коллекционные предметы:". После ":" будут перечисляться предметы (названия будут браться из id коллекционных предметов), которые нужны игроку, через запятую.
**'''Таблица''' - таблица, в которую будут сложены желаемые предметы из окна коллекции для последующего поста их на стену.

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

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

*'''Окно дарения с двумя списками'''
**'''esocialfrienditem ''' - объект типа esocialfriendsitem (темплейт друга в таблице), который заполнит таблицу друзей.
**'''таблица друзей''' - ссылка на таблицу в которую мы клонируем объект esocialfriendsitem из поля выше.
**'''esocialgiftitem ''' - объект типа esocialgiftitem (темплейт подарка в таблице), который заполнит таблицу подарков.
**'''таблица подарков''' - ссылка на таблицу в которую мы клонируем объект esocialgiftitem из поля выше.

*'''Изменить состояние объекта при принятии инвайта''' - при успешном принятии приглашения (друг установил приложение) переводит объект в состояние.
*'''Изменить состояние объекта при успешном выполнении задачи''' - при успешном выполнении задачи переводит объект в состояние
*'''Изменить состояние объекта при ошибке выполнения задачи''' - при ошибке выполнения задачи переводит объект в состояние
*'''изменить состояние объекта - дарим энергию выше max''' - обработчик применения энергии, когда дошли за максимум (сработает если '''учитывать максимум энергии''');

В опции пишутся параметры инвайтов:

*'''esocial%d.max_invite_total''' - всего инвайтов отправлено
*'''esocial%d.max_invite_this''' - за последнюю отправку

вместо %d - айдишник объекта

Можно проверять в "nst_invite_sent"

=Состояния=

*0. '''ready''' - состояние готовности
*1. '''friends'''
*2. '''friends_debug''' - добавляем фейковых друзей
*3. '''friends_inst''' - заполнить таблицу друзьями с установленной игрой
*4. '''friends_not_inst''' - заполнить таблицу друзьями с неустановленной игрой
*5. '''report''' - заслать полезную информацию (32бита)
*6. '''invite''' - показать окно инвайта
*7. '''cancel''' - отменить весь стек задач
*8. '''retry''' - повторить текущую задачу
*9. '''continue_fb''' - пропустить текущую задачу и перейти к следующей
*10. '''continue_google''' - пропустить текущую задачу и перейти к следующей
*11. '''next_inv''' - следующее окошко успешного инвайта
*12. '''gift''' - показать окно посылки подарка из окна коллекций
*13. '''gift_confirm''' - в окне посылки гифта из окна коллекций нажали кнопку ок
*14. '''wish''' - запостить на стену "попрошайку"
*15. '''check_requests''' - проверить реквесты от других пользователей
*16. '''next_gift''' - следующее окошко про полученный подарок17.
*17. '''refresh_gifts''' - актуализировать содержимое таблицы гифтов
*18. '''refresh_vip_gifts''' - актуализировать содержимое таблицы гифтов используя исключительно вип подарки
*19. '''gift_send''' - послать подарок из окна с двумя таблицами
*20. '''logout''' - разлогиниться из фейсбука удалив всю информацию о друзьях
*21. '''clear_gifts''' - сбросить ограничения на число подарков
*22. '''wish_table''' - добавить пожелание в таблицу пожеланий
*23. '''wish_all''' - пожелать все содержимое таблицы в фейсбук //Теперь только в фейсбук, а для гугла состояние ниже
*24. '''remove_gift''' - убрать подарок из таблицы
*25. '''gift_fb''' - подарить текущий подарок через фейбук используя нативный интерфейс фейсбука (т.е. так как сейчас работает гугл, без таблицы друзей)
*26. '''gift_info''' - Обновить информацию о текущих подарках в специальном окне
*27. '''gift_lb''' - Показать окно подарка из лидерборда
*28. '''gift_send_lb''' - Подтвердить отсылку подарка из лидерборда
*29. '''gift_receive''' - Получить подарок из окна получения подарков
*30. '''invite_lb''' - Послать приглашение другу из лидербордов
*31. '''get_me_google''' - запросить информацию о себе с гугла
*32. '''friends_inst_google''' - заполнить таблицу друзьями с установленной игрой
*33. '''friends_not_inst_google''' - заполнить таблицу друзьями с неустановленной игрой
*34. '''message_friend''' - послать другу уведомление
*35. '''friends_random''' - заполнить таблицу случайных друзей
*36. '''wish_all_google''' - пожелать все содержимое таблицы в гугл
*37. '''get_me_fb''' - запросить информацию о себе с фейсбука
*38. '''check_requests_fb''' - проверить реквесты от других пользователей для fb
*39. '''check_requests_google''' - проверить реквесты от других пользователей для гугл
*40. '''logout_google''' - разлогиниться из гугла, удалив всю информацию о друзьях
*41. '''gift_parse''' - Показать окно подарка из парсовой таблицы друзей
*42. '''gift_send_parse''' - Подтвердить отсылку подарка из парсовой таблицы друзей
*43. '''gift_parse_energy''' - Показать окно подарка энергии из парсовой таблицы друзей
*44. '''gift_parse_vip''' - Подарок вип-подарка из окна лидербордов
*45. '''gift_parse_res1''' - Подарок монет из окна лидербордов
*46. '''gift_receive_no_delete''' - Получить подарок из окна получения подарков без запроса
*47. '''gift_reply_energy''' - Послать в ответ энергию.
*48. '''gift_reply_more''' - Промотать таблицу подарков в клауде на нужного юзера
*49. '''gift_reply_res1''' - Послать в ответ ресурс1.
*50. '''gift_reply_universal''' - ответить тем же, что прислали
*51. '''gift_reply_vip''' - Послать в ответ vip.
*52. '''invite_parse''' - Послать приглашение другу из парса (но из общей таблицы, не из лидербордов)
*53. '''gift_parse_res1_multiple''' - отправить множественный подарок в виде монет
*54. '''gift_parse_item_multiple''' - отправить множественный подарок в виде предмета, взяв его из поля gift_param
*55. '''post_story''' - фоновое сообщение
*56. '''external_like''' - "внешнее" окошко лайка
*57. '''clear_timeouts''' - обнулить таймауты для некоторых тасков
*58. '''refresh_inv_gifts''' - актуализировать содержимое таблицы инвентарных гифтов
*59. '''wish_inv_add''' - добавить предмет из таблицы инвентарных в вишлист
*60. '''wish_inv_remove''' - убрать предмет из таблицы инвентарных в вишлист
*61. '''gift_parse_refresh''' - Обновить информацию о подарке в соотв. иконках и каунтерах
*62. '''check_requests_abs''' - проверить реквесты от других пользователей, но только parse
*63. '''switch_social_network''' - переключить активную социальную сеть, взяв ее айдишник из param
*64. '''invite_random''' - показать окно инвайта для случайных друзей

*66. '''join_community''' - пригласиться к группе, задать в параметр ''joincommunity'' id группы (для ВК).
*--. '''sign_in_with_apple''' - залогинится через Apple.

=Debug=
Для того, что бы отслеживать работу объекта Facebook в папке Documents создаются три файла, которые хранят в себе все знания относительно друзей данного пользователя, их коллекций и уровня:
 - '''facebook_debug_e.xml''' - создается во время отправки приглашения и при вызове состояния ''invite''
 - '''facebook_debug_s.xml''' - создается после фидбэка от Facebook'a.
 - '''facebook_debug.xml''' - создается исключительно в дебажной версии во время отправки объекту Facebook состояния ''friends'' или ''friends_inst''
Выглядит этот файл приблизительно вот так:
[[Файл:17-03-2014 11-09-06.png|right]]
Поля: '''request''' означает отправлен ли запрос. '''invite''' - принял ли запрос и поле '''inst'''(возможна ошибка в названии) - установлено ли приложение у данного друга.

=Задачи (команды) и ошибки=

В опции пишется номер успешной задачи, неуспешной и номер ошибки
*'''esocial%d.compl_task''' - поле в опциях, куда запишется номер успешно выполненной задачи. %d - id объекта esocial в проекте.
*'''esocial%d.err_task''' - поле в опциях, куда запишется номер неуспешной задачи. %d - id объекта esocial в проекте.
*'''esocial%d.err_code''' - поле в опциях, куда запишется номер ошибки. %d - id объекта esocial в проекте.

==Задачи==

При выполнении состояния Esocial пишет в лог следующее:

''onComplete state = %d task = %d,''

где номер таска берется из следующего списка (состояния Facebook):

*0 - провести авторизацию
*1 - закрыть текущую авторизованную сессию
*2 - создать диалог для отправки на стену
*3 - возвращает данные обо мне
*4 - возвращает данные о друзьях
*5 - возвращает данные о друзьях, которых можно пригласить в игру
*6 - получить список игровых сообщений
*7 - получить список групп пользователя
*8 - лайкал пользователь приложение или нет
*9 - обновить мои очки на facebook сервере
*10 - отправить игровое сообщение
*11 - удалить игровое сообщение на facebook сервере
*12 - отправить фоновое сообщение в ленту пользователя

След. сост. выполняются автоматически, если необходимо:
*13 - (ST_AUTO_CHECK_USER_PERMISSIONS) - получить список прав которые пользователь предоставил преложению
*14 - (ST_AUTO_CHECK_APP_PERMISSIONS) - получить список прав которые facebook предоставил преложению
*15 - (ST_AUTO_GET_WRITE_PERMISSIONS) - запросить у пользователя права на запись
*16 - (ST_AUTO_GET_READ_PERMISSIONS) - запросить у пользователя права на чтение
*17 - (ST_AUTO_POST_APP_REQUEST) - отправить application request пользователю
*18 - (ST_AUTO_CHECK_USER_ACHIEVEMENTS) - проверить текущие ачивки пользователя
*19 - (ST_CHANGE_SOCIAL_NETWORK) - изменить соц сеть

==Ошибки==

*0 - неизвестная ошибка
*1 - неизвестная задача
*2 - facebook не поддерживается
*3 - нет интернета
*4 - превышен лимит ожидания запроса
*5 - не указаны параметры для выполнения задачи
*6 - отмена диалогового окна пользователем
*7 - ошибка логина
*8 - ошибка авторизации
*9 - ошибка прав доступа

Если ошибка связана с запросами в Google Play Games, то к коду добавляется 1000, к примеру:
*1007 - ошибка логина в Google Play Games

Если ошибка связана с логином в Apple, то к коду добавляется 2000.

*2000 - ABS_SYSTEM_SIGNINWITHAPPLE_SUCCESS, // успех - не показываем
*2001 - ABS_SYSTEM_SIGNINWITHAPPLE_ERROR_CANCELED, // отмена пользователем - не показываеем
*2002 - ABS_SYSTEM_SIGNINWITHAPPLE_ERROR_FAILED, // ошибка логина
*2003 - ABS_SYSTEM_SIGNINWITHAPPLE_ERROR_INVALID_RESPONSE, // ошибка логина
*2004 - ABS_SYSTEM_SIGNINWITHAPPLE_ERROR_INVALID_NOT_HANDLED, // ошибка логина
*2005 - ABS_SYSTEM_SIGNINWITHAPPLE_ERROR_UNKNOWN // ошибка логина

Для обработки ошибок использовать [[Errormanager|ErrorManager]].

'''Пример запроса:'''
*подали запрос выполнить задачу (например ST_GET_FRIENDS)
*сначала проверяем есть ли права у приложения facebook (ST_AUTO_CHECK_APP_PERMISSIONS)
*потом проверяем есть ли права от пользователя (ST_AUTO_CHECK_USER_PERMISSIONS)
*если пользователь не давал прав, то просим (ST_AUTO_GET_READ_PERMISSIONS)
*потом снова проверяем дал ли нам пользователь права (ST_AUTO_CHECK_USER_PERMISSIONS)
*если весь цикл прошел успешно, то возвращаемся к поставленной задаче (ST_GET_FRIENDS)

'''ВАЖНО:'''
Если в любом месте произошел сбой, то ты НЕ увидишь конкретное состояние, ты увидишь только что "ST_GET_FRIENDS" отработал с ошибкой "9" или словами "ERR_PERMISSION". Других логик или кодов там нет.

==Слушатели заполнения таблиц==
Чтобы узнать когда окончательно заполниться таблица, нужно подвязать слушателя в нужном месте:
*Таблица лидеров:
**'''Cloud.table ''' - добавляемое свойство объекту 'Cloud' '''успешно загружены лидерборды''';
*Друзья и подарки:
**'''Cloud.table_fr ''' - добавляемое свойство объекту 'Cloud' '''успешно загружены друзья''';
*Неиграющие друзья:
** '''Esocial.friendsnotinst ''' - машинка-слушатель успеха объекта 'Esocial 'состояние '''5''' (изменить состояние объекта - успех задачи)
*Окно приёма подарка ( заполненность таблицы проверям у объекта "esocial" параметры "new_gifts" и "all_gifts"):
**'''Esocial.giftreceivetable ''' - машинка-слушатель объекта 'Esocial' (изменить состояние объекта - '''заполнена таблица с подарками''')

=Записи в логах=
==Отправка подарка==
21/3/2017 13:8:59.800: I/GESocial state() state 42
21/3/2017 13:8:59.800: I/GESocial state() New social system state = 42 gift = 11674 starting to search usid
21/3/2017 13:8:59.800: I/GESocial state() New social system state = 42 fb login = 1 gc login = 0
21/3/2017 13:8:59.800: I/GESocial state() state 13
21/3/2017 13:8:59.800: I/GESocial state() STATE_GIFT_CONFIRM gift = 11674
21/3/2017 13:8:59.800: I/GESocial state() STATE_GIFT_CONFIRM Got id from param, id = 258188181311449
21/3/2017 13:8:59.801: I/GESocial load() load curTime = 1492769339 saveTime = 1492769335 (curTime - saveTime) = 4
21/3/2017 13:8:59.801: I/GESocial state() STATE_GIFT_CONFIRM _giftsCur = 0, gift = 11674, id = 258188181311449, _giftsLimit = 50
21/3/2017 13:8:59.801: I/GESocial state() STATE_GIFT_CONFIRM soc_net == netFacebook id = 258188181311449, data = 3,241016273040597,11674
21/3/2017 13:8:59.805: I/GESocial state() Viber request gift urlId = -1, url = , text =
21/3/2017 13:8:59.808: I/GFacebook stPostRequest() stPostRequest -> title = Gift!, message = Иван Козаченко: Here is a gift for you!,
data = 3,241016273040597,11674, userId = 258188181311449,
excludeUserIds = , frictionless = 1, type = 2, forcedLogin=1

[[Category:Facebook]]

Esocial

2020-07-30T09:36:44Z

Vlegkun: /* Ошибки */

[[Object|Объект]] '''Esocial''' обеспечивает связь между приложением и Facebook'ом.

=Параметры=

[[Файл:Esocial_full.jpg|right]]
*'''facebook''' - ссылка на объект [[facebook]], с которым будет работать объект
*'''esocialfriendsitem''' - ссылка на объект esocialfriendsitem, с которым будет работать объект
*'''таблица друзей''' - ссылка на таблицу, в которую будем клонировать esocialfriendsitem.
*'''индикатор активности''' - объект который видимый когда загружаются друзья. Видимость выключается, когда задача загрузки друзей выполнена (успех или провал не важно).
*'''опции для facebook''' - поле в опциях, куда мы будем записывать 32битное целое: Уровень + Коллекции.ESocial добавит к ним число друзей и засабмит при вызове соотв. состояние
*'''социальная сеть''' - выбор социальной сети с которой взаимодействовать. На данный момент можно выбрать facebook, google+ и обе.

*'''специальные подарки'''
**'''подарок энергия id''' - id предметы из экономики;
**'''подарок энергия количество''' - количество;
**'''учитывать максимум энергии''' - если да, то не будет начисляться энергия выше максимума;

*'''Инвайт'''
**'''Заголовок''' - Заголовок сообщения, которое увидит пользователь в фейсбуке, перетаскивается из текстового редактора
**'''Сообщение''' - Сообщение, которое увидит пользователь в фейсбуке, перетаскивается из текстового редактора

*'''Успешный инвайт'''
**'''Окно''' - Машина, открывающая форму, которая содержит информацию об успешно приглашенном друге. Должна иметь состояние show. На закрытие должна вызывать состояние next_inv объекту esocial
**'''Портрет''' - Объект, в который будет сложена иконка друга, подтянутая с facebook
**'''Имя''' - Объект, в который будет сложено имя друга, подтянутое с facebook

*'''Запрос подарка'''
**'''Текст''' - текстовый id, в котором будет хранится текст типа:"Мне нужны коллекционные предметы:". После ":" будут перечисляться предметы (названия будут браться из id коллекционных предметов), которые нужны игроку, через запятую.
**'''Таблица''' - таблица, в которую будут сложены желаемые предметы из окна коллекции для последующего поста их на стену.

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

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

*'''Окно дарения с двумя списками'''
**'''esocialfrienditem ''' - объект типа esocialfriendsitem (темплейт друга в таблице), который заполнит таблицу друзей.
**'''таблица друзей''' - ссылка на таблицу в которую мы клонируем объект esocialfriendsitem из поля выше.
**'''esocialgiftitem ''' - объект типа esocialgiftitem (темплейт подарка в таблице), который заполнит таблицу подарков.
**'''таблица подарков''' - ссылка на таблицу в которую мы клонируем объект esocialgiftitem из поля выше.

*'''Изменить состояние объекта при принятии инвайта''' - при успешном принятии приглашения (друг установил приложение) переводит объект в состояние.
*'''Изменить состояние объекта при успешном выполнении задачи''' - при успешном выполнении задачи переводит объект в состояние
*'''Изменить состояние объекта при ошибке выполнения задачи''' - при ошибке выполнения задачи переводит объект в состояние
*'''изменить состояние объекта - дарим энергию выше max''' - обработчик применения энергии, когда дошли за максимум (сработает если '''учитывать максимум энергии''');

В опции пишутся параметры инвайтов:

*'''esocial%d.max_invite_total''' - всего инвайтов отправлено
*'''esocial%d.max_invite_this''' - за последнюю отправку

вместо %d - айдишник объекта

Можно проверять в "nst_invite_sent"

=Состояния=

*0. '''ready''' - состояние готовности
*1. '''friends'''
*2. '''friends_debug''' - добавляем фейковых друзей
*3. '''friends_inst''' - заполнить таблицу друзьями с установленной игрой
*4. '''friends_not_inst''' - заполнить таблицу друзьями с неустановленной игрой
*5. '''report''' - заслать полезную информацию (32бита)
*6. '''invite''' - показать окно инвайта
*7. '''cancel''' - отменить весь стек задач
*8. '''retry''' - повторить текущую задачу
*9. '''continue_fb''' - пропустить текущую задачу и перейти к следующей
*10. '''continue_google''' - пропустить текущую задачу и перейти к следующей
*11. '''next_inv''' - следующее окошко успешного инвайта
*12. '''gift''' - показать окно посылки подарка из окна коллекций
*13. '''gift_confirm''' - в окне посылки гифта из окна коллекций нажали кнопку ок
*14. '''wish''' - запостить на стену "попрошайку"
*15. '''check_requests''' - проверить реквесты от других пользователей
*16. '''next_gift''' - следующее окошко про полученный подарок17.
*17. '''refresh_gifts''' - актуализировать содержимое таблицы гифтов
*18. '''refresh_vip_gifts''' - актуализировать содержимое таблицы гифтов используя исключительно вип подарки
*19. '''gift_send''' - послать подарок из окна с двумя таблицами
*20. '''logout''' - разлогиниться из фейсбука удалив всю информацию о друзьях
*21. '''clear_gifts''' - сбросить ограничения на число подарков
*22. '''wish_table''' - добавить пожелание в таблицу пожеланий
*23. '''wish_all''' - пожелать все содержимое таблицы в фейсбук //Теперь только в фейсбук, а для гугла состояние ниже
*24. '''remove_gift''' - убрать подарок из таблицы
*25. '''gift_fb''' - подарить текущий подарок через фейбук используя нативный интерфейс фейсбука (т.е. так как сейчас работает гугл, без таблицы друзей)
*26. '''gift_info''' - Обновить информацию о текущих подарках в специальном окне
*27. '''gift_lb''' - Показать окно подарка из лидерборда
*28. '''gift_send_lb''' - Подтвердить отсылку подарка из лидерборда
*29. '''gift_receive''' - Получить подарок из окна получения подарков
*30. '''invite_lb''' - Послать приглашение другу из лидербордов
*31. '''get_me_google''' - запросить информацию о себе с гугла
*32. '''friends_inst_google''' - заполнить таблицу друзьями с установленной игрой
*33. '''friends_not_inst_google''' - заполнить таблицу друзьями с неустановленной игрой
*34. '''message_friend''' - послать другу уведомление
*35. '''friends_random''' - заполнить таблицу случайных друзей
*36. '''wish_all_google''' - пожелать все содержимое таблицы в гугл
*37. '''get_me_fb''' - запросить информацию о себе с фейсбука
*38. '''check_requests_fb''' - проверить реквесты от других пользователей для fb
*39. '''check_requests_google''' - проверить реквесты от других пользователей для гугл
*40. '''logout_google''' - разлогиниться из гугла, удалив всю информацию о друзьях
*41. '''gift_parse''' - Показать окно подарка из парсовой таблицы друзей
*42. '''gift_send_parse''' - Подтвердить отсылку подарка из парсовой таблицы друзей
*43. '''gift_parse_energy''' - Показать окно подарка энергии из парсовой таблицы друзей
*44. '''gift_parse_vip''' - Подарок вип-подарка из окна лидербордов
*45. '''gift_parse_res1''' - Подарок монет из окна лидербордов
*46. '''gift_receive_no_delete''' - Получить подарок из окна получения подарков без запроса
*47. '''gift_reply_energy''' - Послать в ответ энергию.
*48. '''gift_reply_more''' - Промотать таблицу подарков в клауде на нужного юзера
*49. '''gift_reply_res1''' - Послать в ответ ресурс1.
*50. '''gift_reply_universal''' - ответить тем же, что прислали
*51. '''gift_reply_vip''' - Послать в ответ vip.
*52. '''invite_parse''' - Послать приглашение другу из парса (но из общей таблицы, не из лидербордов)
*53. '''gift_parse_res1_multiple''' - отправить множественный подарок в виде монет
*54. '''gift_parse_item_multiple''' - отправить множественный подарок в виде предмета, взяв его из поля gift_param
*55. '''post_story''' - фоновое сообщение
*56. '''external_like''' - "внешнее" окошко лайка
*57. '''clear_timeouts''' - обнулить таймауты для некоторых тасков
*58. '''refresh_inv_gifts''' - актуализировать содержимое таблицы инвентарных гифтов
*59. '''wish_inv_add''' - добавить предмет из таблицы инвентарных в вишлист
*60. '''wish_inv_remove''' - убрать предмет из таблицы инвентарных в вишлист
*61. '''gift_parse_refresh''' - Обновить информацию о подарке в соотв. иконках и каунтерах
*62. '''check_requests_abs''' - проверить реквесты от других пользователей, но только parse
*63. '''switch_social_network''' - переключить активную социальную сеть, взяв ее айдишник из param
*64. '''invite_random''' - показать окно инвайта для случайных друзей

*66. '''join_community''' - пригласиться к группе, задать в параметр ''joincommunity'' id группы (для ВК).

=Debug=
Для того, что бы отслеживать работу объекта Facebook в папке Documents создаются три файла, которые хранят в себе все знания относительно друзей данного пользователя, их коллекций и уровня:
 - '''facebook_debug_e.xml''' - создается во время отправки приглашения и при вызове состояния ''invite''
 - '''facebook_debug_s.xml''' - создается после фидбэка от Facebook'a.
 - '''facebook_debug.xml''' - создается исключительно в дебажной версии во время отправки объекту Facebook состояния ''friends'' или ''friends_inst''
Выглядит этот файл приблизительно вот так:
[[Файл:17-03-2014 11-09-06.png|right]]
Поля: '''request''' означает отправлен ли запрос. '''invite''' - принял ли запрос и поле '''inst'''(возможна ошибка в названии) - установлено ли приложение у данного друга.

=Задачи (команды) и ошибки=

В опции пишется номер успешной задачи, неуспешной и номер ошибки
*'''esocial%d.compl_task''' - поле в опциях, куда запишется номер успешно выполненной задачи. %d - id объекта esocial в проекте.
*'''esocial%d.err_task''' - поле в опциях, куда запишется номер неуспешной задачи. %d - id объекта esocial в проекте.
*'''esocial%d.err_code''' - поле в опциях, куда запишется номер ошибки. %d - id объекта esocial в проекте.

==Задачи==

При выполнении состояния Esocial пишет в лог следующее:

''onComplete state = %d task = %d,''

где номер таска берется из следующего списка (состояния Facebook):

*0 - провести авторизацию
*1 - закрыть текущую авторизованную сессию
*2 - создать диалог для отправки на стену
*3 - возвращает данные обо мне
*4 - возвращает данные о друзьях
*5 - возвращает данные о друзьях, которых можно пригласить в игру
*6 - получить список игровых сообщений
*7 - получить список групп пользователя
*8 - лайкал пользователь приложение или нет
*9 - обновить мои очки на facebook сервере
*10 - отправить игровое сообщение
*11 - удалить игровое сообщение на facebook сервере
*12 - отправить фоновое сообщение в ленту пользователя

След. сост. выполняются автоматически, если необходимо:
*13 - (ST_AUTO_CHECK_USER_PERMISSIONS) - получить список прав которые пользователь предоставил преложению
*14 - (ST_AUTO_CHECK_APP_PERMISSIONS) - получить список прав которые facebook предоставил преложению
*15 - (ST_AUTO_GET_WRITE_PERMISSIONS) - запросить у пользователя права на запись
*16 - (ST_AUTO_GET_READ_PERMISSIONS) - запросить у пользователя права на чтение
*17 - (ST_AUTO_POST_APP_REQUEST) - отправить application request пользователю
*18 - (ST_AUTO_CHECK_USER_ACHIEVEMENTS) - проверить текущие ачивки пользователя
*19 - (ST_CHANGE_SOCIAL_NETWORK) - изменить соц сеть

==Ошибки==

*0 - неизвестная ошибка
*1 - неизвестная задача
*2 - facebook не поддерживается
*3 - нет интернета
*4 - превышен лимит ожидания запроса
*5 - не указаны параметры для выполнения задачи
*6 - отмена диалогового окна пользователем
*7 - ошибка логина
*8 - ошибка авторизации
*9 - ошибка прав доступа

Если ошибка связана с запросами в Google Play Games, то к коду добавляется 1000, к примеру:
*1007 - ошибка логина в Google Play Games

Если ошибка связана с логином в Apple, то к коду добавляется 2000.

*2000 - ABS_SYSTEM_SIGNINWITHAPPLE_SUCCESS, // успех - не показываем
*2001 - ABS_SYSTEM_SIGNINWITHAPPLE_ERROR_CANCELED, // отмена пользователем - не показываеем
*2002 - ABS_SYSTEM_SIGNINWITHAPPLE_ERROR_FAILED, // ошибка логина
*2003 - ABS_SYSTEM_SIGNINWITHAPPLE_ERROR_INVALID_RESPONSE, // ошибка логина
*2004 - ABS_SYSTEM_SIGNINWITHAPPLE_ERROR_INVALID_NOT_HANDLED, // ошибка логина
*2005 - ABS_SYSTEM_SIGNINWITHAPPLE_ERROR_UNKNOWN // ошибка логина

Для обработки ошибок использовать [[Errormanager|ErrorManager]].

'''Пример запроса:'''
*подали запрос выполнить задачу (например ST_GET_FRIENDS)
*сначала проверяем есть ли права у приложения facebook (ST_AUTO_CHECK_APP_PERMISSIONS)
*потом проверяем есть ли права от пользователя (ST_AUTO_CHECK_USER_PERMISSIONS)
*если пользователь не давал прав, то просим (ST_AUTO_GET_READ_PERMISSIONS)
*потом снова проверяем дал ли нам пользователь права (ST_AUTO_CHECK_USER_PERMISSIONS)
*если весь цикл прошел успешно, то возвращаемся к поставленной задаче (ST_GET_FRIENDS)

'''ВАЖНО:'''
Если в любом месте произошел сбой, то ты НЕ увидишь конкретное состояние, ты увидишь только что "ST_GET_FRIENDS" отработал с ошибкой "9" или словами "ERR_PERMISSION". Других логик или кодов там нет.

==Слушатели заполнения таблиц==
Чтобы узнать когда окончательно заполниться таблица, нужно подвязать слушателя в нужном месте:
*Таблица лидеров:
**'''Cloud.table ''' - добавляемое свойство объекту 'Cloud' '''успешно загружены лидерборды''';
*Друзья и подарки:
**'''Cloud.table_fr ''' - добавляемое свойство объекту 'Cloud' '''успешно загружены друзья''';
*Неиграющие друзья:
** '''Esocial.friendsnotinst ''' - машинка-слушатель успеха объекта 'Esocial 'состояние '''5''' (изменить состояние объекта - успех задачи)
*Окно приёма подарка ( заполненность таблицы проверям у объекта "esocial" параметры "new_gifts" и "all_gifts"):
**'''Esocial.giftreceivetable ''' - машинка-слушатель объекта 'Esocial' (изменить состояние объекта - '''заполнена таблица с подарками''')

=Записи в логах=
==Отправка подарка==
21/3/2017 13:8:59.800: I/GESocial state() state 42
21/3/2017 13:8:59.800: I/GESocial state() New social system state = 42 gift = 11674 starting to search usid
21/3/2017 13:8:59.800: I/GESocial state() New social system state = 42 fb login = 1 gc login = 0
21/3/2017 13:8:59.800: I/GESocial state() state 13
21/3/2017 13:8:59.800: I/GESocial state() STATE_GIFT_CONFIRM gift = 11674
21/3/2017 13:8:59.800: I/GESocial state() STATE_GIFT_CONFIRM Got id from param, id = 258188181311449
21/3/2017 13:8:59.801: I/GESocial load() load curTime = 1492769339 saveTime = 1492769335 (curTime - saveTime) = 4
21/3/2017 13:8:59.801: I/GESocial state() STATE_GIFT_CONFIRM _giftsCur = 0, gift = 11674, id = 258188181311449, _giftsLimit = 50
21/3/2017 13:8:59.801: I/GESocial state() STATE_GIFT_CONFIRM soc_net == netFacebook id = 258188181311449, data = 3,241016273040597,11674
21/3/2017 13:8:59.805: I/GESocial state() Viber request gift urlId = -1, url = , text =
21/3/2017 13:8:59.808: I/GFacebook stPostRequest() stPostRequest -> title = Gift!, message = Иван Козаченко: Here is a gift for you!,
data = 3,241016273040597,11674, userId = 258188181311449,
excludeUserIds = , frictionless = 1, type = 2, forcedLogin=1

[[Category:Facebook]]

Video

2020-06-25T11:41:56Z

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

{{TOC right}}
'''Video''' - [[Object|объект]], служащий для воспроизведения видео-файлов.

[[Файл:V1.jpg|300px|right]]
'''Общие параметры'''
(см. описание [[Object|Object]]):
*'''положение''' - координаты точки пивота объекта, т.к. объект не содержит графического изображения, положение объета определяется верхней левой точкой;
*'''размер''' - ширина и высота объекта (область отображения видео уменьшится (увеличится) согласно указанным размерам с сохранением пропорций).

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

*'''id видео''' - идентификатор видео-файла перетаскивается мышью из редактора ресурсов;
*'''id звука''' - идентификатор звукового файла перетаскивается мышью из редактора ресурсов;
*'''повторы''' - количество воспроизведений видео-файла (видео зациклено, если значение поля '''0''');
*'''состояние''' - начальное состояние video, в которое объект попадает при инициализации.
*'''[[прокликиваемая]]''' - Если 1, то объект прозрачный для клика мышкой (пропускает объектам под ней). Если 2, то картинка сама обрабатывает клик, но и пропускает его дальше.

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

Меню выбора ''Добавляемые параметры'' к объектам активируется по правой кнопки мыши.

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

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

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

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

!!ВАЖНО: Последние 2 добавляемых свойства используют время внутреннего таймера видео, поэтому удобно использовать эти свойства если по ходу видео нужно выполнять какие-то действия. Для устройств с разной производительностью хронометраж действий будет одинаковый.

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

Объекту video можно передавать следующие состояния:

*'''first''' - воспроизвести 1-й кадр видео;
*'''play''' - воспроизвести видео с начала;
*'''pause''' - приостановить воспроизведение видео;
*'''resume''' - продолжить воспроизведение видео с момента приостановки;
*'''stop''' - выключить видео.

== Примечания и дополнения ==

Оптимальными для воспроизведения видео являются следующие параметры:
[[Подготовка_и_форматы_видео|см. подготовка видео]]

При воспроизведении видео становится в наивысшее положение по координате z. Это означает, что все объекты расположенные над видео окажутся под ним, даже если лежат на сценах выше, чем сцена с видео.

Если при изменении размера объекта видео мы изменяем только одну координату, то размеры самого видео будут изменяться связанно. Например, если видео с разрешением 500x500 поместить в объект с размерами 200x300, то при воспроизведении видео будет иметь размеры 200x200.

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

== Пример ==

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

[[Category:Options]]

Absolutist Framework

2018-05-18T08:20:47Z

Vlegkun: /* Экономика */

{{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-скриптов]]
* [[Подготовка версии для Viber]]
* [[Проверка подгрузки текстур]]
* [[Экспорт проекта]]
* [[Шаблон|Экспорт/импорт шаблона проекта]]

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

== 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]] - машина состояний
** [[Файл:Mwindow.png]] - [[Mwindow]] - машина состояний - окно
* [[Файл: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]] - создание мини-карты для отображения прогресса прохождения игры.
* [[Файл:Statesmanager_ico.png]] - [[Statesmanager]] - очередь работы с объектами
* [[Файл:Slider icons.png]] - [[Slider]] - объект реализующий листание списка.
* [[Файл:Ribbon.png]] - [[Ribbon]] - объект отображения графики по сплайну
* [[Файл:Kub.png]] - [[Animation]] - объект различных анимаций
* [[Файл:Kub.png]] - [[Magicparticles]] - объект файлов Magic Particles
* [[Файл:Kub.png]] - [[puzzle3D]] - 3D паззл
* [[Файл:Kub.png]] - [[3D-object]] - 3D объект
* [[Файл:Kub.png]] - [[Scriptresources]] - scriptresources
* [[Файл:Kub.png]] - [[Partnersconsole]] - partnersconsole

== Game mechanic ==

===Игровые объекты===

* [[Файл:Kub.png]] - [[Avoider]] - эвойдер
* [[Файл:Kub.png]] - [[Battle]] - боевка
* [[Файл:Puzzle.png]] - [[Puzzle]] - игра пазл
* [[Файл:Memory.png]] - [[Memory]] - класс игр с memory-механикой
* [[Файл:Patchwork.png]] - [[Patchwork]] - класс игр с Patchwork-механикой
* [[Файл:Match3.png]] - [[Match]] - класс match-подобных игр
* [[Файл:Collaps.png]] - [[Collapse]] - класс match-подобных игр
* [[Файл:Bejewelled.png]] - [[Bejewelled]] - класс match-подобных игр
* [[Файл:Bs_old.png]] - [[Bubble Shooter]] - класс Bubble игр включая механику Снукер
* [[Файл:BubbleShooter.png]] - [[Bubble Shooter NEW]] - класс 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
* [[Файл:Kub.png]] - [[AtomicPuzzle]] - механика игры Atomic puzzle
* [[Файл:Matchbattle.png]] - [[Match Battle]] - настройка глобальных параметров для мини-игр
* [[Файл:Move box.png]] - [[DragBox]] - класс игр с dragbox-механикой
* [[Файл:Labyrinth.png]] - [[Labyrinth]] - класс игр лабиринт
* [[Файл:Pipes.png]] - [[Pipes]] - класс игр трубы
* [[Файл:Kub.png]] - [[Color Switch]] - механика игры Color Switch
* [[Файл:Slotmachine.png]] - [[Slotmachine]] - объект типа "slot"
* [[Файл:Kub.png]] - [[trivia]] - игровая механика - миллионер (trivia)
* [[Файл:Kub.png]] - [[CakeTower]] - объект шаблона ячейки с животным.
* [[Файл:Kub.png]] - [[Pentamino]] - механика игры в [https://ru.wikipedia.org/wiki/%D0%9F%D0%B5%D0%BD%D1%82%D0%B0%D0%BC%D0%B8%D0%BD%D0%BE пентамино]
* [[Файл:Kub.png]] - [[TapTheNew]]
* [[Файл:Kub.png]] - [[solitaire]] - солитер
* [[Файл:digitz.png]] - [[Digitz]] - механика игры Digitz.
* [[Файл:Kub.png]] - [[Wordsearch]] - механика поиска слов на поле
* [[Файл:Kub.png]] - [[Script Game]] - Script Game

===Поиск предметов===

* [[Файл: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]] - изометрическая карта

===Экономика===

* [[Файл:Economics.png]] - [[Economics]] - глобальная настройка игр типа ферма\билдер
** [[Файл:E_collection.png]] - [[Ecollection]] - шаблон для строки в таблице коллекции

* [[Файл:E_items.png]] - [[Eitems]] - объект, служащий для связи инвентаря/магазина и экономики
** [[Файл:E_store_item.png]] - [[Estoreitem]] - шаблон для ячейки магазина
** [[Файл:E_inventory_item.png]] - [[Einventoryitem]] - шаблон для ячейки инвентаря
** [[Файл:Kub.png]] - [[Ecraftitem]] - шаблон для ячейки создания предмета.

* [[Файл:Taskorganizer.png]] - [[Taskorganizer]] - органайзер заданий
** [[Файл:Kub.png]] - [[Etasktemplate]] - шаблон задачи для таблицы темплейтов.
** [[Файл:Kub.png]] - [[Elogbooktemplate]] - шаблон отображения ячейки логбука.
** [[Файл:E_task_item.png]] - [[Etaskitem]] - шаблон для ячейки задания

* [[Файл:Kub.png]] - [[Pseudochat]] - менеджер реплик.
** [[Файл:Kub.png]] - [[Pseudochattemplate]] - шаблон для менеджера реплик.

* [[Файл:Kub.png]] - [[Dressing]] - гардероб.
** [[Файл:Kub.png]] - [[Dressingtemplate]] - объект шаблона гардероба.

===Питомцы===

* [[Файл:Kub.png]] - [[Pet]] - объект питомца.
** [[Файл:Kub.png]] - [[PetCollectionTemplate]] - объект шаблона ячейки с коллекцией.
** [[Файл:Kub.png]] - [[PetTemplate]] - объект шаблона ячейки с животным.

===Физмир===

* [[Файл:Physicsworld.png]] - [[Physicsworld]] - физический мир Box2D
** [[Файл:Physicsobject.png]] - [[Physicsobject]] - физические объекты
** [[Файл:Physics links.png]] - [[Physicsjoint]] - физические соединения

===Другие объекты===

* [[Файл:Paint.png‎]] - [[Paint]] - объект для рисования
* [[Файл:Eraser.png]] - [[Eraser]] - стирачка
* [[Файл:Kub.png]] - [[Dailybonus]] - объект для управления механизмом ежедневного бонуса за вход в игру.
* [[Файл:Kub.png]] - [[Builder]] - механика типа фермы
** [[Файл:Kub.png]] - [[Builderitem]] - объект шаблона здания
** [[Файл:Kub.png]] - [[Buildercomponent]] - шаблон материала для апгрейда здания

== 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]] - настройки для отображения результатов прохождения игры
*[[Файл:Kub.png]] - [[Leaderboardsitem]] - Шаблон для помещения в таблицу лидербордов.

== 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]] - объект для отправки событий
* [[Файл:Kub.png]] - [[Errormanager]] - менеджер ошибок
* [[Файл:Kub.png]] - [[Multiplayer]] - объект мультиплеера

== 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
* [[Файл:Kub.png]] - [[ShareDialog]] - объект для вызова окна шаринга в другие приложения устройства

== Functions ==
* [[Файл:Forward.png]] - [[SendMail]] - отправка письма через почтовый клиент
* [[Файл:footer-icon-rate.png]] - [[Rate]] - вызов окна оценки приложения
* [[Файл:Kub.png]] - [[Config]] - конфиг для игровой механики

----
[[Файл:!.png]] - [[Правила оформления]] - Требование к описанию объектов.
----
<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]]

Pseudochattemplate

2018-05-18T08:19:19Z

Vlegkun:

[[Object|Объект]] Pseudochattemplate - шаблон для менеджер реплик [[Pseudochat|Pseudochat]].

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

*'''текст''' - текстовый объект, в который заполнится основной текст сообщения;
*'''время''' - текстовый объект, в который заполнится время сообщения;
*'''иконка персонажа''' - объект, в который заполнится иконка персонажа (icon 1)
*'''машина''' - vашина, которая подравняет фон под размер текста. Должна иметь состояние show.

[[Category:Game mechanic]]
[[Category:Economics|*]]

Pseudochattemplate

2018-05-18T08:13:44Z

Vlegkun: Новая страница: «Объект Pseudochattemplate - шаблон для менеджер реплик Pseudochat. =Основные параметры=…»

Absolutist Framework

2018-05-15T14:19:47Z

Vlegkun: /* 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-скриптов]]
* [[Подготовка версии для Viber]]
* [[Проверка подгрузки текстур]]
* [[Экспорт проекта]]
* [[Шаблон|Экспорт/импорт шаблона проекта]]

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

== 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]] - машина состояний
** [[Файл:Mwindow.png]] - [[Mwindow]] - машина состояний - окно
* [[Файл: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]] - создание мини-карты для отображения прогресса прохождения игры.
* [[Файл:Statesmanager_ico.png]] - [[Statesmanager]] - очередь работы с объектами
* [[Файл:Slider icons.png]] - [[Slider]] - объект реализующий листание списка.
* [[Файл:Ribbon.png]] - [[Ribbon]] - объект отображения графики по сплайну
* [[Файл:Kub.png]] - [[Animation]] - объект различных анимаций
* [[Файл:Kub.png]] - [[Magicparticles]] - объект файлов Magic Particles
* [[Файл:Kub.png]] - [[puzzle3D]] - 3D паззл
* [[Файл:Kub.png]] - [[3D-object]] - 3D объект
* [[Файл:Kub.png]] - [[Scriptresources]] - scriptresources
* [[Файл:Kub.png]] - [[Partnersconsole]] - partnersconsole

== Game mechanic ==

===Игровые объекты===

* [[Файл:Kub.png]] - [[Avoider]] - эвойдер
* [[Файл:Kub.png]] - [[Battle]] - боевка
* [[Файл:Puzzle.png]] - [[Puzzle]] - игра пазл
* [[Файл:Memory.png]] - [[Memory]] - класс игр с memory-механикой
* [[Файл:Patchwork.png]] - [[Patchwork]] - класс игр с Patchwork-механикой
* [[Файл:Match3.png]] - [[Match]] - класс match-подобных игр
* [[Файл:Collaps.png]] - [[Collapse]] - класс match-подобных игр
* [[Файл:Bejewelled.png]] - [[Bejewelled]] - класс match-подобных игр
* [[Файл:Bs_old.png]] - [[Bubble Shooter]] - класс Bubble игр включая механику Снукер
* [[Файл:BubbleShooter.png]] - [[Bubble Shooter NEW]] - класс 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
* [[Файл:Kub.png]] - [[AtomicPuzzle]] - механика игры Atomic puzzle
* [[Файл:Matchbattle.png]] - [[Match Battle]] - настройка глобальных параметров для мини-игр
* [[Файл:Move box.png]] - [[DragBox]] - класс игр с dragbox-механикой
* [[Файл:Labyrinth.png]] - [[Labyrinth]] - класс игр лабиринт
* [[Файл:Pipes.png]] - [[Pipes]] - класс игр трубы
* [[Файл:Kub.png]] - [[Color Switch]] - механика игры Color Switch
* [[Файл:Slotmachine.png]] - [[Slotmachine]] - объект типа "slot"
* [[Файл:Kub.png]] - [[trivia]] - игровая механика - миллионер (trivia)
* [[Файл:Kub.png]] - [[CakeTower]] - объект шаблона ячейки с животным.
* [[Файл:Kub.png]] - [[Pentamino]] - механика игры в [https://ru.wikipedia.org/wiki/%D0%9F%D0%B5%D0%BD%D1%82%D0%B0%D0%BC%D0%B8%D0%BD%D0%BE пентамино]
* [[Файл:Kub.png]] - [[TapTheNew]]
* [[Файл:Kub.png]] - [[solitaire]] - солитер
* [[Файл:digitz.png]] - [[Digitz]] - механика игры Digitz.
* [[Файл:Kub.png]] - [[Wordsearch]] - механика поиска слов на поле
* [[Файл:Kub.png]] - [[Script Game]] - Script Game

===Поиск предметов===

* [[Файл: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]] - изометрическая карта

===Экономика===

* [[Файл:Economics.png]] - [[Economics]] - глобальная настройка игр типа ферма\билдер
** [[Файл:E_collection.png]] - [[Ecollection]] - шаблон для строки в таблице коллекции

* [[Файл:E_items.png]] - [[Eitems]] - объект, служащий для связи инвентаря/магазина и экономики
** [[Файл:E_store_item.png]] - [[Estoreitem]] - шаблон для ячейки магазина
** [[Файл:E_inventory_item.png]] - [[Einventoryitem]] - шаблон для ячейки инвентаря
** [[Файл:Kub.png]] - [[Ecraftitem]] - шаблон для ячейки создания предмета.

* [[Файл:Taskorganizer.png]] - [[Taskorganizer]] - органайзер заданий
** [[Файл:Kub.png]] - [[Etasktemplate]] - шаблон задачи для таблицы темплейтов.
** [[Файл:Kub.png]] - [[Elogbooktemplate]] - шаблон отображения ячейки логбука.
** [[Файл:E_task_item.png]] - [[Etaskitem]] - шаблон для ячейки задания

* [[Файл:Kub.png]] - [[Pseudochat]] - менеджер реплик.

* [[Файл:Kub.png]] - [[Dressing]] - гардероб.
** [[Файл:Kub.png]] - [[Dressingtemplate]] - объект шаблона гардероба.

===Питомцы===

* [[Файл:Kub.png]] - [[Pet]] - объект питомца.
** [[Файл:Kub.png]] - [[PetCollectionTemplate]] - объект шаблона ячейки с коллекцией.
** [[Файл:Kub.png]] - [[PetTemplate]] - объект шаблона ячейки с животным.

===Физмир===

* [[Файл:Physicsworld.png]] - [[Physicsworld]] - физический мир Box2D
** [[Файл:Physicsobject.png]] - [[Physicsobject]] - физические объекты
** [[Файл:Physics links.png]] - [[Physicsjoint]] - физические соединения

===Другие объекты===

* [[Файл:Paint.png‎]] - [[Paint]] - объект для рисования
* [[Файл:Eraser.png]] - [[Eraser]] - стирачка
* [[Файл:Kub.png]] - [[Dailybonus]] - объект для управления механизмом ежедневного бонуса за вход в игру.
* [[Файл:Kub.png]] - [[Builder]] - механика типа фермы
** [[Файл:Kub.png]] - [[Builderitem]] - объект шаблона здания
** [[Файл:Kub.png]] - [[Buildercomponent]] - шаблон материала для апгрейда здания

== 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]] - настройки для отображения результатов прохождения игры
*[[Файл:Kub.png]] - [[Leaderboardsitem]] - Шаблон для помещения в таблицу лидербордов.

== 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]] - объект для отправки событий
* [[Файл:Kub.png]] - [[Errormanager]] - менеджер ошибок
* [[Файл:Kub.png]] - [[Multiplayer]] - объект мультиплеера

== 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
* [[Файл:Kub.png]] - [[ShareDialog]] - объект для вызова окна шаринга в другие приложения устройства

== Functions ==
* [[Файл:Forward.png]] - [[SendMail]] - отправка письма через почтовый клиент
* [[Файл:footer-icon-rate.png]] - [[Rate]] - вызов окна оценки приложения
* [[Файл:Kub.png]] - [[Config]] - конфиг для игровой механики

----
[[Файл:!.png]] - [[Правила оформления]] - Требование к описанию объектов.
----
<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]]

Absolutist Framework

2018-05-15T14:10:32Z

Vlegkun:

{{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-скриптов]]
* [[Подготовка версии для Viber]]
* [[Проверка подгрузки текстур]]
* [[Экспорт проекта]]
* [[Шаблон|Экспорт/импорт шаблона проекта]]

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

== 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]] - машина состояний
** [[Файл:Mwindow.png]] - [[Mwindow]] - машина состояний - окно
* [[Файл: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]] - создание мини-карты для отображения прогресса прохождения игры.
* [[Файл:Statesmanager_ico.png]] - [[Statesmanager]] - очередь работы с объектами
* [[Файл:Slider icons.png]] - [[Slider]] - объект реализующий листание списка.
* [[Файл:Ribbon.png]] - [[Ribbon]] - объект отображения графики по сплайну
* [[Файл:Kub.png]] - [[Animation]] - объект различных анимаций
* [[Файл:Kub.png]] - [[Magicparticles]] - объект файлов Magic Particles
* [[Файл:Kub.png]] - [[puzzle3D]] - 3D паззл
* [[Файл:Kub.png]] - [[3D-object]] - 3D объект
* [[Файл:Kub.png]] - [[Scriptresources]] - scriptresources
* [[Файл:Kub.png]] - [[Partnersconsole]] - partnersconsole

== Game mechanic ==

* [[Файл:Kub.png]] - [[Avoider]] - эвойдер
* [[Файл:Kub.png]] - [[Battle]] - боевка
* [[Файл:Puzzle.png]] - [[Puzzle]] - игра пазл
* [[Файл:Memory.png]] - [[Memory]] - класс игр с memory-механикой
* [[Файл:Patchwork.png]] - [[Patchwork]] - класс игр с Patchwork-механикой
* [[Файл:Match3.png]] - [[Match]] - класс match-подобных игр
* [[Файл:Collaps.png]] - [[Collapse]] - класс match-подобных игр
* [[Файл:Bejewelled.png]] - [[Bejewelled]] - класс match-подобных игр
* [[Файл:Bs_old.png]] - [[Bubble Shooter]] - класс Bubble игр включая механику Снукер
* [[Файл:BubbleShooter.png]] - [[Bubble Shooter NEW]] - класс 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
* [[Файл:Kub.png]] - [[AtomicPuzzle]] - механика игры Atomic puzzle
* [[Файл: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]] - "коллекция" поисковых объектов для хидден игр
* [[Файл:Kub.png]] - [[Color Switch]] - механика игры Color Switch
* [[Файл:Inventory.png]] - [[Inventory]] - "инвентарь" список применяемых объектов для игр
* [[Файл:Tool.png]] - [[Tool]] - "применение" - объект, который можно применить для игр
* [[Файл:Kub.png]] - [[Isomap]] - изометрическая карта
* [[Файл:Slotmachine.png]] - [[Slotmachine]] - объект типа "slot"

* [[Файл:Economics.png]] - [[Economics]] - глобальная настройка игр типа ферма\билдер
** [[Файл:E_collection.png]] - [[Ecollection]] - шаблон для строки в таблице коллекции

* [[Файл:E_items.png]] - [[Eitems]] - объект, служащий для связи инвентаря/магазина и экономики
** [[Файл:E_store_item.png]] - [[Estoreitem]] - шаблон для ячейки магазина
** [[Файл:E_inventory_item.png]] - [[Einventoryitem]] - шаблон для ячейки инвентаря
** [[Файл:Kub.png]] - [[Ecraftitem]] - шаблон для ячейки создания предмета.

* [[Файл:Taskorganizer.png]] - [[Taskorganizer]] - органайзер заданий
** [[Файл:Kub.png]] - [[Etasktemplate]] - шаблон задачи для таблицы темплейтов.
** [[Файл:Kub.png]] - [[Elogbooktemplate]] - шаблон отображения ячейки логбука.
** [[Файл:E_task_item.png]] - [[Etaskitem]] - шаблон для ячейки задания

* [[Файл:Kub.png]] - [[Pseudochat]] - менеджер реплик.

* [[Файл: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]] - объект шаблона ячейки с животным.
* [[Файл:Kub.png]] - [[CakeTower]] - объект шаблона ячейки с животным.
* [[Файл:Kub.png]] - [[Pentamino]] - механика игры в [https://ru.wikipedia.org/wiki/%D0%9F%D0%B5%D0%BD%D1%82%D0%B0%D0%BC%D0%B8%D0%BD%D0%BE пентамино]
* [[Файл:Kub.png]] - [[TapTheNew]]
* [[Файл:Kub.png]] - [[Dressing]] - гардероб.
** [[Файл:Kub.png]] - [[Dressingtemplate]] - объект шаблона гардероба.
* [[Файл:Kub.png]] - [[solitaire]] - солитер

* [[Файл:digitz.png]] - [[Digitz]] - механика игры Digitz.
* [[Файл:Kub.png]] - [[Wordsearch]] - механика поиска слов на поле
* [[Файл:Kub.png]] - [[Builder]] - механика типа фермы
** [[Файл:Kub.png]] - [[Builderitem]] - объект шаблона здания
** [[Файл:Kub.png]] - [[Buildercomponent]] - шаблон материала для апгрейда здания
* [[Файл:Kub.png]] - [[Script Game]] - Script Game

== 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]] - настройки для отображения результатов прохождения игры
*[[Файл:Kub.png]] - [[Leaderboardsitem]] - Шаблон для помещения в таблицу лидербордов.

== 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]] - объект для отправки событий
* [[Файл:Kub.png]] - [[Errormanager]] - менеджер ошибок
* [[Файл:Kub.png]] - [[Multiplayer]] - объект мультиплеера

== 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
* [[Файл:Kub.png]] - [[ShareDialog]] - объект для вызова окна шаринга в другие приложения устройства

== Functions ==
* [[Файл:Forward.png]] - [[SendMail]] - отправка письма через почтовый клиент
* [[Файл:footer-icon-rate.png]] - [[Rate]] - вызов окна оценки приложения
* [[Файл:Kub.png]] - [[Config]] - конфиг для игровой механики

----
[[Файл:!.png]] - [[Правила оформления]] - Требование к описанию объектов.
----
<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]]

Absolutist Framework

2018-05-15T14:07:02Z

Vlegkun: /* 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-скриптов]]
* [[Подготовка версии для Viber]]
* [[Проверка подгрузки текстур]]
* [[Экспорт проекта]]
* [[Шаблон|Экспорт/импорт шаблона проекта]]

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

=== 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]] - машина состояний
** [[Файл:Mwindow.png]] - [[Mwindow]] - машина состояний - окно
* [[Файл: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]] - создание мини-карты для отображения прогресса прохождения игры.
* [[Файл:Statesmanager_ico.png]] - [[Statesmanager]] - очередь работы с объектами
* [[Файл:Slider icons.png]] - [[Slider]] - объект реализующий листание списка.
* [[Файл:Ribbon.png]] - [[Ribbon]] - объект отображения графики по сплайну
* [[Файл:Kub.png]] - [[Animation]] - объект различных анимаций
* [[Файл:Kub.png]] - [[Magicparticles]] - объект файлов Magic Particles
* [[Файл:Kub.png]] - [[puzzle3D]] - 3D паззл
* [[Файл:Kub.png]] - [[3D-object]] - 3D объект
* [[Файл:Kub.png]] - [[Scriptresources]] - scriptresources
* [[Файл:Kub.png]] - [[Partnersconsole]] - partnersconsole

=== Game mechanic ===

* [[Файл:Kub.png]] - [[Avoider]] - эвойдер
* [[Файл:Kub.png]] - [[Battle]] - боевка
* [[Файл:Puzzle.png]] - [[Puzzle]] - игра пазл
* [[Файл:Memory.png]] - [[Memory]] - класс игр с memory-механикой
* [[Файл:Patchwork.png]] - [[Patchwork]] - класс игр с Patchwork-механикой
* [[Файл:Match3.png]] - [[Match]] - класс match-подобных игр
* [[Файл:Collaps.png]] - [[Collapse]] - класс match-подобных игр
* [[Файл:Bejewelled.png]] - [[Bejewelled]] - класс match-подобных игр
* [[Файл:Bs_old.png]] - [[Bubble Shooter]] - класс Bubble игр включая механику Снукер
* [[Файл:BubbleShooter.png]] - [[Bubble Shooter NEW]] - класс 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
* [[Файл:Kub.png]] - [[AtomicPuzzle]] - механика игры Atomic puzzle
* [[Файл: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]] - "коллекция" поисковых объектов для хидден игр
* [[Файл:Kub.png]] - [[Color Switch]] - механика игры Color Switch
* [[Файл:Inventory.png]] - [[Inventory]] - "инвентарь" список применяемых объектов для игр
* [[Файл:Tool.png]] - [[Tool]] - "применение" - объект, который можно применить для игр
* [[Файл:Kub.png]] - [[Isomap]] - изометрическая карта
* [[Файл:Slotmachine.png]] - [[Slotmachine]] - объект типа "slot"

* [[Файл:Economics.png]] - [[Economics]] - глобальная настройка игр типа ферма\билдер
** [[Файл:E_collection.png]] - [[Ecollection]] - шаблон для строки в таблице коллекции

* [[Файл:E_items.png]] - [[Eitems]] - объект, служащий для связи инвентаря/магазина и экономики
** [[Файл:E_store_item.png]] - [[Estoreitem]] - шаблон для ячейки магазина
** [[Файл:E_inventory_item.png]] - [[Einventoryitem]] - шаблон для ячейки инвентаря
** [[Файл:Kub.png]] - [[Ecraftitem]] - шаблон для ячейки создания предмета.

* [[Файл:Taskorganizer.png]] - [[Taskorganizer]] - органайзер заданий
** [[Файл:Kub.png]] - [[Etasktemplate]] - шаблон задачи для таблицы темплейтов.
** [[Файл:Kub.png]] - [[Elogbooktemplate]] - шаблон отображения ячейки логбука.
** [[Файл:E_task_item.png]] - [[Etaskitem]] - шаблон для ячейки задания

* [[Файл:Kub.png]] - [[Pseudochat]] - менеджер реплик.

* [[Файл: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]] - объект шаблона ячейки с животным.
* [[Файл:Kub.png]] - [[CakeTower]] - объект шаблона ячейки с животным.
* [[Файл:Kub.png]] - [[Pentamino]] - механика игры в [https://ru.wikipedia.org/wiki/%D0%9F%D0%B5%D0%BD%D1%82%D0%B0%D0%BC%D0%B8%D0%BD%D0%BE пентамино]
* [[Файл:Kub.png]] - [[TapTheNew]]
* [[Файл:Kub.png]] - [[Dressing]] - гардероб.
** [[Файл:Kub.png]] - [[Dressingtemplate]] - объект шаблона гардероба.
* [[Файл:Kub.png]] - [[solitaire]] - солитер

* [[Файл:digitz.png]] - [[Digitz]] - механика игры Digitz.
* [[Файл:Kub.png]] - [[Wordsearch]] - механика поиска слов на поле
* [[Файл:Kub.png]] - [[Builder]] - механика типа фермы
** [[Файл:Kub.png]] - [[Builderitem]] - объект шаблона здания
** [[Файл:Kub.png]] - [[Buildercomponent]] - шаблон материала для апгрейда здания
* [[Файл:Kub.png]] - [[Script Game]] - Script Game

=== 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]] - настройки для отображения результатов прохождения игры
*[[Файл:Kub.png]] - [[Leaderboardsitem]] - Шаблон для помещения в таблицу лидербордов.

=== 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]] - объект для отправки событий
* [[Файл:Kub.png]] - [[Errormanager]] - менеджер ошибок
* [[Файл:Kub.png]] - [[Multiplayer]] - объект мультиплеера

=== 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
* [[Файл:Kub.png]] - [[ShareDialog]] - объект для вызова окна шаринга в другие приложения устройства

=== Functions ===
* [[Файл:Forward.png]] - [[SendMail]] - отправка письма через почтовый клиент
* [[Файл:footer-icon-rate.png]] - [[Rate]] - вызов окна оценки приложения
* [[Файл:Kub.png]] - [[Config]] - конфиг для игровой механики

----
[[Файл:!.png]] - [[Правила оформления]] - Требование к описанию объектов.
----
<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]]

Ecollection

2018-05-15T14:01:51Z

Vlegkun: /* Сопутствующие объекты */

[[Object|Объект]] '''Ecollection''' позволяет отображать коллекции предметов в игре с объектом [[economics]].

=Параметры=

[[Файл:Ecollection1.jpg|right|260px]]
*'''alpha''' - прозрачность: от 0 (объект полностью прозрачный) до 1 (объект не прозрачный).
*'''economics''' - ссылка на объект [[economics]].
*'''таблица''' - ссылка на таблицу, куда помещаются коллекционные предметы (обязательно должна быть подобъектом).
*'''зарядник 1''' - иконка первого зарядника (инвентарного предмета, необходимого для сдачи коллекции); если не указать, значение запишется в счётчик '''зарядник 1 к-во''' в параметр "val2".
*'''зарядник 2''' - иконка второго зарядника.
*'''зарядник 3''' - иконка третьего зарядника.
*'''зарядник 4''' - иконка четвертого зарядника.
*'''зарядник 1 к-во''' - счетчик, сколько нужно первого зарядника для сдачи коллекции.
*'''зарядник 2 к-во''' - счетчик, сколько нужно второго зарядника для сдачи коллекции.
*'''зарядник 3 к-во''' - счетчик, сколько нужно третего зарядника для сдачи коллекции.
*'''зарядник 4 к-во''' - счетчик, сколько нужно четвертого зарядника для сдачи коллекции.
*'''зарядник 1 есть''' - счетчик, сколько есть первого зарядника в инвентаре.
*'''зарядник 2 есть''' - счетчик, сколько есть второго зарядника в инвентаре.
*'''зарядник 3 есть''' - счетчик, сколько есть третего зарядника в инвентаре.
*'''зарядник 4 есть''' - счетчик, сколько есть четвертого зарядника в инвентаре.
*'''кнопка сдачи 1''' - кнопка, по нажатию на которую, происходит сдача коллекции. Передает состояние collection объекту ecollection (обязательно должна быть подобъектом).
*'''кнопка сдачи 2''' - передает состояние collection объекту ecollection. Эта кнопка видна в том случае, когда не хватает чарджеров для сдачи коллекции (обязательно должна быть подобъектом). Будет открываться окно с предложением докупить зарядников (чарджеров).
*'''название коллекции''' - текстовый объект, в котором будет отображаться название коллекции.
*'''фонарь''' - машина состояний, которая сигнализирует о том, что коллекция готова к сдаче. Должна иметь состояния on и off.
*'''награда''' - объект, которому будет присвоена иконка наградного предмета (на рисунке справа у объекта тип [[button]], т.к. по нажатию на иконку награды вызывается окошко, но обычно это тип [[image]]).
*'''проверять количество награды''' - принимает значение 1 и 0. По умолчанию '''1''' - если кол-во награды 0, то иконка награды полупрозрачная, если кол-во награды >0, то иконка награды с альфой 1. При '''0''' - иконка награды будет полупрозрачной только до первой сдачи, если после первой сдачи мы используем награду, иконка все равно останется с альфой 1.
*'''награда текст''' - текстовый объект, в который помещается название наградного предмета.
*'''награда ресурс 1''' - счетчик, который будет отображать количество призового ресурса 1.
*'''награда ресурс 2''' - счетчик, который будет отображать количество призового ресурса 2.
*'''награда опыт''' - счетчик, который будет отображать количество призового опыта.
*'''число наград''' - счетчик, который будет отображать, сколько раз была сдана коллекция.
*'''метка сдано''' - объект, который становится видимым, если коллекция сдана хотя бы раз (например, это может быть поздравительная картинка, в которую помещен текст и счетчик из поля ''число наград'').
*'''esocial''' - ссылка на объект типа [[esocial]].
*'''Кнопка подарить''' - добавляемый параметр, кнопка, которая позволяет подарить коллекционный предмет другу. Кнопка должна передавать объекту ecollection в параметр param порядковый номер предмета в коллекции (начиная с 0) и вызывать состояние ''gift''. После этого открывается окно дарения подарка прописанное в объекте [[esocial]]. Если в коллекции 5 предметов, то и кнопок должно быть 5.
*'''Кнопка попросить''' - добавляемый параметр, кнопка, которая позволяет попросить у друга необходимый коллекционный предмет. Записывает объекту ecollection в параметр param порядковый номер предмета в коллекции (начиная с 0) и вызывает состояние ''wish''. Если в коллекции 5 предметов, то и кнопок должно быть 5.

=Состояния=
[[Файл:Ecollection3.jpg|right|350px]]
*'''collection''' - Попытаться сдать коллекцию.
*'''chargers''' - Показать окно покупки чарджеров.
*'''wish''' - добавляет коллекционный предмет в wishlist. Обязательно передавать порядковый номер предмета перед вызовом состояния.
*'''gift''' - Дарит предмет другу (открывает окно дарения подарка). Обязательно передавать порядковый номер предмета перед вызовом состояния.

*'''wish_touched''' - добавляет коллекционный предмет в wishlist.Если мы вынесли кнопки из шаблона в окно которое открывается при ''item_collections'', то есть получаем одну кнопку в окне для любого предмета.
*'''gift_touched''' - Дарит предмет другу (открывает окно дарения подарка). Если мы вынесли кнопки из шаблона в окно которое открывается при ''item_collections'', то есть получаем одну кнопку в окне для любого предмета.

Пример окошка с коллекциями на рисунке справа.

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

Объекты, которые используются вместе с объектом 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]] - глобальная настройка игр типа ферма\билдер

[[Category:Game mechanic]]
[[Category:Economics|*]]

Etaskitem

2018-05-15T14:01:13Z

Vlegkun: /* Сопутствующие объекты */

[[Object|Объект]] '''Etaskitem''' - Шаблон/форма отдельной подзадачи в общем задании. Шаблон/форма представляет собой скомпонованную группу объектов (картинки, счетчики, кнопки, рамочки и т.п.), которая должна быть вложена в Etaskitem. Объект Etaskitem заполняет шаблон по очереди для каждой подзадачи текущего задания и помещает заполненный шаблон в ячейку таблицы (таблицу, в которую помещать шаблон, указывают в Taskorganaizer setup для конкретной задачи).

=Свойства=

[[Файл:Etaskitem1.jpg|right|250px]]
*'''alpha''' - прозрачность: от 0 (объект полностью прозрачен) до 1(объект не прозрачен).
*'''taskorganizer''' - Объект типа [[taskorganizer]].
*'''иконка''' - Иконка предмета подзадачи.
*'''описание''' - Текстовый объект, куда будет занесено описание объекта.
*'''цена res2''' - Цена предмета в ресурсе 2. Игрок может купить предмет для выполнения подзадачи.
*'''цена res1''' - Цена предмета в ресурсе 1. Игрок может купить предмет для выполнения подзадачи.
*'''кнопка искать''' - Кнопка поиска указывает, в какой локации можно найти предмет. Видна, если объект коллекционный. Должна вызывать объекту [[Economics]] состояние ''search_task''.
*'''кнопка коллекции''' - Кнопка ведущая в коллекции. Видна, если задание состоит в сдаче коллекции. Должна вызывать объекту [[Economics]] состояние ''search_task''.
*'''кнопка купить''' - Кнопка покупки. Видна, если объект инвентарный. Должна вызывать объекту Etaskitem состояние buy.
*'''кнопка инвентарь''' - Кнопка, по нажатию на которую происходит переход на инвентарь. Кнопка видна, если подзадача требует применить предмет и он есть в наличии.
*'''кнопка магазин''' - Кнопка, по нажатию на которую происходит переход в магазин. Кнопки видна, если подзадача требует применить предмет, но его нет в наличии.
*'''надпись успеха''' - Объект, например, картинка галочки или текст. Виден, если данная часть задания выполнена.
*'''счетчик (текущий)''' - Счетчик, отображающий имеющееся кол-во предмета (или текущее значение параметра для подзадачи типа опции).
*'''счетчик (желаемый)''' - Счетчик, отображающий требуемое кол-во предмета (или требуемое значение параметра для подзадачи типа опции).

[[Файл:Etaskitem2.jpg|right|300px]]
Справа показан пример, как будет выглядеть шаблон в окне задачи. Если у задачи несколько подзадач, например, нужно найти несколько разных предметов, то Etaskitem заполняет шаблон для каждой подзадачи и помещает в ячейку таблицы, на рисунке видно две ячейки таблицы для двух подзадач.

Объект Etaskinem полезен тем, что с его помощью можно отображать огромное количество подзадач (заполненных шаблонов) в таблице. Так же этот объект может скрывать/показывать отдельные элементы шаблона, для отдельной подзадачи (ячейки таблицы), а не для всей таблицы.

Недостаток: Шаблон/форма всегда одна для одного таскорганайзера. Может возникать потребность в разных шаблонах для разных задач таскорганайзера. Например, в задаче 1 шаблон подзадач помещается в таблицу 1 и должен отображать иконку предмета, а в задаче 2 шаблон помещается в таблицу 2 и должен отображать описание подзадачи. Тогда при открытии окна придется "вручную" (в машине состояний) прятать/показывать элементы шаблона/формы, в данном примере иконку и текст. Таких ситуаций лучше избегать!!!

=Состояния=
*'''set_filter''' - при переходе, например в инвентарь или в магазин, сразу открывает тот раздел, в котором находится нужный предмет.
*'''buy''' - Купить нужный предмет.

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

Объекты, которые используются вместе с объектом 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]] - глобальная настройка игр типа ферма\билдер

[[Category:Game mechanic]]
[[Category:Economics|*]]

Elogbooktemplate

2018-05-15T14:00:46Z

Vlegkun:

Объект предназначен для помещение в таблицу логбука. Если у объекта '''Taskorganazer''' в поля (шаблон 1, шаблон 2 ) указать два объекта Elogbooktemplate, то они будут заполнять таблицу логбука поочерёдно.

===Параметры===
[[Файл:ElogbookTemplate.jpg|right]]
Общие параметры - аналогичны другим объектам.

*'''название''' - текстовый объект, в который будет складываться имя записи логбука (word).
*'''описание''' - по настройкам логбука, складывается описание (sense1;sense2;sense1 и sense2).
*'''иконка''' - сюда сложится иконка.

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

[[Category:Game mechanic]]
[[Category:Economics|*]]

Etasktemplate

2018-05-15T14:00:27Z

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

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

=Параметры=

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

===Связь с объектом типа eanalysis===

Кнопка [[Eanalysis|экспертизы]] может быть в трех состояниях:
*'''не начата''' - в этом случае игроку только предлагается пройти экспертизу. Например, в таком случае ребенком кнопки можно сделать текстовый объект с соответствующей надписью. Например "Анализ".
*'''в процессе''' - экспертиза уже запущена и идет процесс. Тут, например, можно показать таймер с отсчетом времени до конца экспертизы. Его как раз и помещают в Etasktemplate, в поле "таймер экспертизы".
*'''выполнена''' - экспертиза выполнена, отображается соответствующая кнопка. Например, "Читать".

===Отметка выполненной задачи===

Графический ресурс (например галочка), который отображается, когда задача выполнена. Реализуется в виде [[Machine|машины состояний]].

'''Правила для отметки задачи и эффектов выполнения'''
*Каждый эффект начинается с состояния beg и обязан перейти в finish
*В состоянии beg эффект запускается в координатах ячейки таблицы. В этом же состоянии перебивать координаты нельзя. Поэтому все остальные действия отображения эффекта лучше делать в состоянии beg_.
*Эффект исчезания таска начнется только после перехода в finish эффекта отметки (например, анимация галочки выполненных тасков)

===Дополнительные кнопки===

Нажатием правой кнопки мыши на поле объекта Etasktemplate можно добавлять дополнительные [[Button|кнопки]], которые отображаются на специфических задачах. Например "Играть", "Искать", "Получить" (таск [[Taskorganizer#Задача cross promo|cross-promo]]), "Нравится" (таск оценить приложение).

Номер кнопки соответствует порядковому номеру этой кнопки в объекте Etasktemplate. Нумерация начинается с нуля. Например, в Taskorganizer указана кнопка 1 для автоматически [[Taskorganizer#Группа генерируемые|генерируемых задач]]. Это значит, что эта кнопка должна быть указана в поле "дополнительные кнопки" второй.

Все кнопки, для отдельных задач, указываются в [[Taskorganizer#Taskorganizer setup|Taskorganizer setup]].

=Состояния=

*'''take''' - должно вызываться кнопкой или кнопкой2, при вызове состояния в объект записываются параметры:
**'''clicked_task_id''' - id таска, на темплейте которого была нажата кнопка или кнопка2;
**'''clicked_task_x''' - координата x центра ячейки, относительно пивота таблицы, в которой была нажата кнопка или кнопка2;
**'''clicked_task_y''' - координата y центра ячейки, относительно пивота таблицы, в которой была нажата кнопка или кнопка2;
*'''complete''' - запускается анимация удаления таска из таблицы. При вызове complete в сам темплейт автоматически записывается параметр "need_effect". В need_effect хранится информация о том, есть ли еще таски, которые выполнены и требуют завершения и воспроизведения должных эффектов.
**Если need_effect = 1, то такие эффекты еще есть, значит вызываем снова complete.
**Если need_effect = 0, то тасок больше нет, все завершенные таски последовательно воспроизвели все свои эффекты. Вызываем состояние refresh_templates для таскорганайзера. При вызове refresh_templates таскорганайзеру запускается анимация добавления новых тасков в таблицу, если такие есть.

===Реализация таймерных тасков===
Таймерные таски - таски, в которых указано время на выполнение.

*для таймерных тасков указываем '''время на их выполнения''' в поле для таймера в Etasktemplate. Таймер будет виден только если время в задаче > 0.
*в поле '''"штраф репутации"''' указываем репутацию, которая отнимется у игрока в случае невыполнения задания. Счетчик будет виден, если поле заполнено в [[Taskorganizer#Taskorganizer setup|Taskorganizer setup]].
*если в таймтаске требуется подзадача опции (например, выполнить действие три раза), то используем '''счетчики "всего" и "выполнено"''' в Etasktemplate.
*'''эффект выполнения fail''' используется в случае невыполнения таймерного таска. Работает так же как "эффект выполнения отметка" полностью. Начинается с состояния beg и обязан перейти в finish. После себя инициирует исчезание, если переведен в finish. Дополнительно этот эффект следует указать в [[Taskorganizer#Taskorganizer setup|Taskorganizer setup]] <property name="изменить состояние объекта - таймаут" label="изменить состояние объекта если какая-то задача кончилась таймаутом.">

[[Category:Game mechanic]]
[[Category:Economics|*]]

Taskorganizer

2018-05-15T14:00:10Z

Vlegkun: /* Равномерная экономика (Preset) */

{{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 ( "нет" ), то вне зависимости от количества заходов, будет браться вероятность.
*'''etasktemplate''' - объект типа [[Etasktemplate|etasktemplate]]
*'''только одна подкрутка за раз''' - 0 - нет, 1 - да. Ставим = 1 ( "да" ), если хотим чтобы за один проход хиддена выполнялся один таск.
*'''таблица для шаблонов''' - таблица, в которую сложим шаблоны из предыдущего поля
*'''помещать генерируемые в шаблоны''' - помещать в шаблоны генерируемые таски
*'''уменьшать предметы при сдаче коллекции''' - 0 - нет, 1 - да. Ставим = 1 ( "да" ), то при сдаче коллекции будет выполнен декремент количества предметов необходимых чтобы задание выполнилось ( параметр таски s0 в опциях).

<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.
*'''награда опыт''' - Счетчик, которому будет присвоено количество призового опыта.
*'''текст для etasktemplate''' - будет в поле name etasktemplate. Это название задачи на прохождение локации, которая генерируется автоматически и использует шаблон etasktemplate. Текст используется из Текстовой Базы Ресурсов. Например, "Исследовать локацию".
*'''номер кнопки для etasktemplate''' - номер кнопки для etasktemplate. [[Button|Кнопка]], которая используется для данной задачи. Например, "Исследовать".

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

<pre>
Если перед генерацией случайного таска от персонажа указать параметру gen_face значение от 0 до n, то ближайшая генерируемая задача будет от персонажа под указанным номером. После генерации параметр gen_face становится -1.
Если указать gen_face="-2", то таскорганайзер попытается с генерировать задачу с персонажем так, чтобы номер локации совпадал с персонажем, при условии что номер локации будет меньше максимальному числу персонажей ( char_num).
</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 за выполнение задания.
*'''награда (опыт)''' - Счетчик отображающий награду в опыте за выполнение задания.
*'''таблица хинта''' - Таблица, в которую будем складывать хинты.
*'''reusable''' - 0 - задача появится 1 раз, 1 - будет появляться каждый раз при выполнении ее условий.
*'''приоритетная''' - чем больше число, тем выше в таблице тасков.
*'''умножать цену пропуска''' - нужно в случае, если мы хотим давать юзеру возможность моментально выполнить задачу за цену, которая зависит от количества нехватающих коллекционных предметов (цена пропуска*количество отсутствующих предметов).
*'''отображать выполненным в шаблонах''' - "да" - таск будет оставаться в таблице шаблонов после выполнения/
*'''видимые кнопки''' - номера видимых кнопок в [[Etasktemplate#Дополнительные кнопки|Etasktemplate]] через запятую. Отображает кнопки, используемые для данной задачи.

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

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

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

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

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

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

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

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

==Подзадача предмет==
В опции суммарно будет записываться значение два параметра:

:'''iN''' - "item need" - необходимое количество предметов, по всем "подзадачам предмет";
:'''iH''' - "item have" - имеющееся количество предметов, по всем "подзадачам предмет";
:'''i0..i666''' - требующийся предмет, пишется для задач из коллекций;

*'''сгенерировать предмет''' - определить необходимый предмет из коллекции;
::'''нет''' - просто требовать предмет;
::'''да''' - сгенерировать предмет из доступных локаций (календарь);
::'''сегодня''' - с генерировать предмет из коллекции, для локации текущего дня (календарь);
::'''неделя''' - с генерировать предмет из коллекции, для локаций текущей недели (календарь);
*'''из коллекции''' - указать txtID коллекции из которой будут браться id предметов;

==Подзадача экспертиза==

*'''предмет''' - в поле предмет записываем id объекта, который нужен для проведения экспертизы. Предмет берем из текстовой базы ресурсов. Иконка предмета до начала и во время проведения экспертизы в icon1, иконка предмета после проведения экспертизы в icon2.
*'''время''' - изначальная длительность экспертизы в секундах.
*'''стоимость''' - стоимость экспертизы, используется res3.
*'''стоимость ускорения''' - стоимость ускорения экспертизы, используется res2.
*'''описание''' - описание подзадачи
*'''владелец''' - здесь используем число для указания типа экспертизы. Например, 1 - это экспертизы одного типа, 2 - это второй тип экспертиз
*'''уведомление''' - текстовый id для уведомления. Генерируется при старте. Имя уведомления записать в поле word, текст уведомления в sentence1, картинку уведомления в sentence2.

<pre>
Картинку для уведомления положить в конфиги, рядом с файлом platform.icf для каждой платформы.
К примеру, путь может выглядеть так: C:\Editor\Projects\Crime_City\conf\base\project\platforms\google
</pre>

[[Файл:Taskorganizer_eanalysis.png|600px|thumb|right]]

==Задача cross promo==

У таска можно включить флаг:
*'''cross promo''' - идентификатор задачи типа ''cross promo'' (1 - да, 0 - нет)

в этом случае он
а) сгенерится, если есть кросс промо И выполнены остальные условия его появления;
б) выполнится, если установлено приложение И выполнине остальные условия его выполнения;
в) вызвав состояние '''cross_promo''' -открыть урл связанный с crosspromo задачей - таскорганайзеру можно открыть урл, которые приехал из конфига.
У задачи должно быть уникакльное окно, в котором в объект указанный в ''портрет'' будет помещен баннер.

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

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

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

Позволяет изменить состояние объекта если какая-то задача кончилась таймаутом, находится в taskorganizer setup. Создан для таймерных заданий, которые работают через [[Etasktemplate|Etasktemplate]]. Указываем '''эффект выполнения fail''' из [[Etasktemplate#Реализация таймерных тасков|Etasktemplate]]. Эффект используется, когда задание завершилось провалом по истечению времени.

=Состояния=

*'''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_complete_id''' - показать окно после задачи, взяв ее id из param (делалось для одноразовых задач, повторяемые могут не работать);
*'''show_last_plot''' - Открыть последнюю сгенерированную сюжетную задачу.
*'''guess''' - Ответить на текущую угадайку, взяв ответ из параметра (param). Taskorganizer также хранит правильный ответ на текущую угадайку в параметре ''guess_answer'', его можно использовать, если нужно оставить игроку меньше вариантов для угадывания.
*'''add_hint_last''' - Добавить подсказку последней добавленной задаче.
*'''add_hint_top''' - Добавить подсказку верхней задаче в таблице.
*'''guess_who_reward''' - начислить награду за последнюю угадайку.
*'''roulette_complete''' -состояние, вызываемое при выполнении текущей задачи "рулетка".
*'''cheat_complete''' - если его вызвать, то при следующем check выполнится задача, для которой последней показывали превью.
*'''skip''' - При вызове этого состояния выполнится последний открытый таск. Цена скипа указывается внутри самого таска.
*'''skip_id_no_effect''' - изменить состояние задачи с id из param на completed безо всяких доп. эффектов - награды, окон и т.п.
*'''check_multiple''' - Проверить выполнение задач не выходя из проверки после первой найденной.
*'''add_hint_hidden''' - Вызов подсказки для 1 (первой по списку в таскорганайзере) скрытой задачи.
*'''add_hint_hidden_all''' - Вызов подсказки для всех активных скрытых задач (по списку в таскорганайзере).
*'''calc_active_preset''' - Посчитать количество активных задач по конкретному "preset" (перед вызовом в поле "param" указать номер интересующей категории preset). После вызова, таскорганайзер заполнит параметр "preset_tasks".

Состояния для работы с тасками-угадайками по типу викторины ( в 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''' - задач в таблице + скрытых задач

Изменение состояния объекта в логе выводится как:
I/GTaskOrganizer GTaskOrganizer::state() state from 0 to 5 through object eco_checker (2543);

<pre>
Состояния из кода:
0 "idle", // Состояние по умолчанию
1 "refresh", // Обновить таблицу с иконками задач
2 "refresh_templates", // Обновить "ленту" задач
3 "generate", // Сгенерировать новую задачу (выбрать одну из доступных по условиям) И обновить таблицу с иконками задач
4 "show", // Показать окно задачи в зависимости от выделенной ячейки в таблице
5 "check", // Проверить задачи на выполнение. После этого автоматически вызовется рефреш
6 "log_check", // Проверить, не стали ли доступны новые записи в логе
7 "log_show", // Заполнить таблицу логбука записями с текущим фильтром
8 "task_next", // Следующий таск в таблице
9 "task_prev", // Предыдущий таск в таблице
10 "add_hint", // Добавить подсказку
11 "task_reward", // Вручить награду за задание - нужно, чтобы разделить выполнение задания и окно получения уровня
12 "show_id", // Показать окно задачи, взяв ее id из параметра
13 "guess", // Ответить на текущую угадайку, взяв ответ из параметра
14 "add_hint_last", // Добавить подсказку последней добавленной задаче
15 "add_hint_top", // Добавить подсказку верхней задаче в таблице
16 "guess_who_reward", // Начислить награду за последнюю угадайку
17 "roulette_complete", // состояние, вызываемое при выполнении текущей задачи "рулетка"
18 "cheat_complete", // читерское завершение задачи
19 "generate_plot", // сгенерировать новых "сюжетных задач"
20 "eraser_start", // принудительно стартовать стирачку
21 "eraser_complete", // вручить награду за нее
22 "cancel", // отменить задание из param
23 "guess_year", // попытаться угадать год (param)
24 "guess_year_reward", // Дать награду за угадывание года
25 "show_last_plot", // Открыть последнюю сгенерированную сюжетную задачу
26 "skip", // Пропустить задачу для которой открыто окно за кристаллы
27 "add_hint_id", // Добавить хинт задаче по id, если она активна
28 "add_hint_hidden", // Добавить хинт первой скрытой задаче
29 "add_hint_hidden_all", // Добавить хинт всем скрытым задачам
30 "time_to_activate", // Пришло событие об активации задачи
31 "time_to_timeout", // Пришло событие о таймауте задачи
32 "check_multiple", // Проверить выполнение задач не выходя из проверки после первой найденной
33 "answer", // Ответить на новую (январь 2015) угадайку. Номер кнопки в param
34 "generate_guess", // Сгенерировать новую угадайку
35 "show_random", // Показать окно случайной активной задачи
36 "show_eraser", // Показать окно стирачки
37 "calc_active_preset", // Посчитать активные задачи по заданному пресету
38 "show_case", // Найти активный кейс и заполнить его поля
39 "scroll_to_task", // Промотать на таск из param таблицу
40 "reactivate", // Повторно активировать таск из param
41 "generate_loc", // Сгенерировать генерируемых (извиняюсь) тасков, количество в param
42 "copy", // Скопировать общие данные в другой таскорганайзер
43 "cross_promo", // Открыть урл связанный с crosspromo задачей
44 "show_complete_id", // Показать окно после задачи независимо от ее состояния, взяв ее id из параметра
45 "skip_id_no_effect", // Изменить состояние задачи с id из param на completed безо всяких доп. эффектов - награды, окон и т.п.
46 "clear_shown_templates" // Убрать выполненные таски для которых показан эффект из таблицы шаблонов
</pre>

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

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

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

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

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

Объекты, которые используются вместе с объектом 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

=Равномерная экономика (Preset)=
[[Файл:1499422858929.jpg|300px|thumb|right]]
Работает, при включении в объекте Economic равномерной экономики (задание не нулевых значений).
Настройка позволяет давать диапазонную награду конкретной группе задач("preset").
Настройка награды для всех задач, у которых не указан параметр "preset" (т.е. =="-1"), осуществляется, группой параметров объекта Taskorganizer:

Настройки конкретного preset вынесены в отдельную вкладку "Taskorganizer_setup":
[[Файл:Photo hidden 365 Scene Editor build Wed Jul 5 151607 2017 -(single-user) DProjectsEDITOR Game Hidden 365Photo hidden 365Photo hidden 365.seproj.jpg|600px|right]]

[[Category:Game mechanic]]
[[Category:Economics|*]]

Ecraftitem

2018-05-15T13:59:53Z

Vlegkun: /* Сопутствующие объекты */

[[Object|Объект]] представляет собой шаблон создания предмета (крафта) в игре с объектом [[economics]].

Ингридиенты для крафта добавляются в объекте economics в разделе "Предмет".

=Параметры=

[[Файл:Ecraftitem.jpg|right]]

*'''alpha''' - прозрачность: от 0 (прозраче), до 1 (непрозрачен)
*'''eitems''' - ссылка на объект eitems

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

*'''описание''' - ссылка на текстовый объект, которому передается описание предмета

*'''иконка''' - иконка самого предмета.

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

=Состояния=

*'''craft''' - Вызов окна крафта предмета.

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

Объекты, которые используются вместе с объектом 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]] - глобальная настройка игр типа ферма\билдер

[[Category:Game mechanic]]
[[Category:Economics|*]]

Einventoryitem

2018-05-15T13:59:41Z

Vlegkun: /* Сопутствующие объекты */

[[Object|Объект]] представляет собой шаблон ячейки для инвентаря в игре с объектом [[economics]].

=Параметры=

[[Файл:Einventoryitem1.jpg|right]]
*'''alpha''' - прозрачность: от 0(объект полностью прозрачен)до 1(объект непрозрачен)
*'''eitems''' - ссылка на объект eitems

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

*'''описание''' - ссылка на текстовый объект, которому передается описание предмета

*'''иконка''' - иконка самого предмета, передается экономикой самостоятельно

*'''кнопка использования''' - кнопка, по нажатию на которую осуществляется использование предмета. Передает объекту Einventoryitem состояние '''use'''
*'''счетчик''' - счетчик, отображает количество предметов.
*'''иконка цены''' - картинка, отображающая иконку предмета.
*'''цена''' - счетчик, который отображает непосредственно цену предмета.
*'''кнопка продать''' - кнопка по нажатию на которую, происходит продажа предмета. Передает объекту Einventoryitem состояние '''sell'''

=Состояния=

*'''use''' - Попытаться использовать предмет. В параметр '''last_used_item''' запишется id примененного предмета.
*'''sell''' - Попытаться продать предмет.

Пример шаблона инвентарного предмета:

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

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

Объекты, которые используются вместе с объектом 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]] - глобальная настройка игр типа ферма\билдер

[[Category:Game mechanic]]
[[Category:Economics|*]]

Estoreitem

2018-05-15T13:59:04Z

Vlegkun: /* Сопутствующие объекты */

[[Object|Объект]] представляет собой шаблон ячейки для магазина в игре с объектом [[economics]].

=Параметры=

[[Файл:Estoreitem.jpg|right]]

*'''alpha''' ''(al)'' - Прозрачность: от 0 (прозраче), до 1 (непрозрачен).
*'''eitems''' ''(eitems)'' - Ссылка на объект eitems.

*'''название''' ''(name)'' - Cсылка на текстовый объект, которому передается название предмета.

*'''описание''' ''(desc)'' - Ссылка на текстовый объект, которому передается описание предмета.

*'''иконка цены''' ''(icoPrice)'' - Ссылка на картинку, которая показывает каким ресурсом будем платить за предмет.

*'''цена''' ''(price)'' - Ссылка на объект типа counter, который отображает стоимость предмета.

*'''иконка''' ''(ico)'' - Иконка самого предмета, передается экономикой самостоятельно.

*'''кнопка купить''' ''(btnSell)'' - Кнопка, по нажатию на которую осуществляется покупка предмета. Передает объекту Estoreitem состояние '''buy'''
*'''кнопка продать''' ''(btnSell1)'' - Кнопка, по нажатию на которую осуществляется продажа предмета. Передает объекту Estoreitem состояние '''sell'''.
*'''счетчик''' ''(cnt)''- Счетчик, в котором отображается, сколько штук данного предмета будет продаваться за одну покупку.
*'''количество''' ''(cntHave)'' - Счетчик, в котором отображается, сколько штук данного предмета у нас уже есть.
*'''акция 1+1''' ''(discount)'' - Лейбла акции. Будет видима, когда соотвествующий коэффициент больше 0.
*'''номер иконки''' ''(iconind)'' - Номер иконки в текстовой базе. Будет отображаться, когда предмет доступен для покупки.
*'''номер иконки недоступный''' ''(iconinddis)'' - Номер иконки в текстовой базе. Будет отображаться, когда предмет не доступен для покупки.

=Состояния=

*'''buy''' - Попытаться купить предмет.
*'''sell''' - Попытаться продать предмет.

Пример шаблонов в таблице:

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

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

Объекты, которые используются вместе с объектом 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]] - глобальная настройка игр типа ферма\билдер

[[Category:Game mechanic]]
[[Category:Economics|*]]

Eitems

2018-05-15T13:58:51Z

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

[[Object|Объект]] '''Eitems''', служит для связи инвентаря(магазина) и экономики

=Свойства=

*'''иконка ресурса 1''' - Графический ресурс иконки монет.
*'''иконка ресурса 2''' - Графический ресурс иконки кристаллов

==Ссылки на объекты==

[[Файл:Eitems.jpg|right]]
*'''economics''' - Ссылка на объект economics.

*'''таблица''' - Ссылка на таблицу, где будут размещаться шаблоны.

*'''шаблон магазина''' - Ссылка на шаблон магазина.

*'''шаблон инвентаря''' - Ссылка на шаблон инвентаря.

*'''шаблон создания''' - Ссылка на шаблон создания конкретного объекта в инвентаре.

*'''инвентарь''' - Для связи объектов economics, например, с tools.

 

==Окно подтверждения покупки==

[[Файл:Eitems2.jpg|right]]
*'''окно''' - Некая машина, олицетворяющая собой само окно предмета. Должна иметь состояние open.
*'''иконка''' - Иконка предмета.
*'''текст (объект)''' - Текстовый объект в окошке.
*'''описание (объект)''' - Текстовый объект в окошке, в который сложим описание предмета.
*'''иконка цены''' - Объект отображающий иконку цены (кристаллы, золото и т.п.).
*'''цена''' - Счетчик отображающий непосредственно цену.
*'''купить''' - Кнопка купить. Вызывает объекту eitems состояние ''buy''.
*'''использовать''' - Кнопка использовать. Вызывает объекту eitems состояние ''use''. Состояние ''use'' вызвать больше одного раза подряд нельзя, лучше после вызова состояния прописать закрытие окна.
*'''количество''' - Счетчик отображающий количество предметов на данный момент. Если не установлена кнопка ''использовать'' - счетчик работать не будет, он будет виден, но отобразит не корректные данные.

Пример:

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

==Окно подтверждения продажи==
[[Файл:Eitems sell.jpg|250px|right]]

*'''окно''' - некая машина, содержащая в себе всю необходимую информацию,олицетворяет собой само окно подтверждения продажи. Должно содержать состояние open.
*'''иконка''' - картинка, отображающая иконку предмета.
*'''текст(объект)''' - текстовый объект, отображающий название предмета.
*'''описание (объект)''' - текстовый объект, отображающий описание предмета, который продается.
*'''иконка цены''' - объект типа картинка, отображающий иконку цены, это может быть золото, кристаллы и т.п.
*'''цена''' - счетчик, отображающий цену продаваемого предмета.
*'''продать''' - кнопка, по нажатию на которую, происходит продажа предмета. Вызывает объекту eitems состояние ''sell''.
*'''использовать''' - кнопка, по нажатию на которую, предмет используется.
*'''количество''' - счетчик, отображающий количество предметов, которые есть в наличии на данный момент.
*'''иконка ресурса 1''' - графический ресурс, отображающий иконку монет.
*'''иконка ресурса 2''' - графический ресурс, отображающий иконку кристаллов.

==Окно создания предмета==
[[Файл:Craft1.png‎|250px|right]]

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

Ингридиенты для крафта добавляются в объекте economics в разделе "Предмет".

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

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

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

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

[[Файл:Eitems1.jpg|right]]
Есть возможность применять фильтры к предметам, чтобы отображать только предметы нужной нам категории. Можно этот делать двумя способами.

1) Категория указывается в настройках предметов в объекте economics. Для этого есть параметр '''filter'''. Этот параметр является текстовым и перетаскивается из текстовой базы. После определения параметра фильтрации переводим объект eitems в состояние '''filter'''.

2) Сформировать свой фильтр с помощью добавляемого свойста. Записать в параметр '''filter''' номер фильтра по порядку. Перевести объект eitems в состояние '''custom_filter'''.

'''param_num''' - кол-во предметов, можно задать перед вызовом состояний ''add_param'', ''buy_param''

==Cостояния==

*'''Store''' - Отобразить шаблон магазина.
*'''Inventory''' - Отобразить шаблон инвентаря.
*'''craft''' - Отобразить шаблон крафта предметов.
*'''filter''' - Задать категорию предметов, исходя из настроек предметов в объекте ''economics''.
*'''custom_filter''' - Задать категорию предметов, исходя из ''своего фильтра''.

Перед тем, как переводить объект eitems в следующие состояния, нужно его параметру param присвоить текстовый id соответствующего предмета.

*'''hide_param''' - Спрятать объект (итемс пропадает и из магазина, и из инвентаря).
*'''use_param''' - Использовать объект из поля param или просто вычесть его, если предмет не используемый.
*'''add_param''' - Добавляет объект из магазина в инвентарь, но не вычитает ресурс (пассивное добавление итемса)
*'''buy_param''' - Добавляет объект из магазина в инвентарь и вычитает ресурс (осуществляет покупку итемса).
*'''check_price''' - узнать значение предмета из поля param (записывает цену в параметры - checked_res1 и checked_res2 )
*'''craft_item''' - Создает предмет из других предметов (предметы необходимые для создания при этом отнимаются).
*'''buy''' - Купить предмет для которого показано окошко покупки.
*'''use''' - Использовать предмет для которого показано окошко покупки. (В параметр '''last_used_item''' запишется id примененного предмета).
*'''cancel_param''' - Отменить действие амулета из поля param.
*'''sell''' - Продать предмет для которого показано окошко продажи.
*'''wnd_param''' - Показывает окно подтверждения покупки для предмета, id которого мы предварительно запишем в параметр param объекта eitems.
*'''show_craft_param''' - Показывает окно крафта предмета, id которого мы предварительно запишем в параметр param объекта eitems.
*'''ingridient_click''' - Вызывается при клике на таблицу ингридиентов в окне крафта, показывает окно покупки ингридиента.

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

Объекты, которые используются вместе с объектом 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]] - глобальная настройка игр типа ферма\билдер

=Пример=

[[Category:Game mechanic]]
[[Category:Economics|*]]

Pseudochat

2018-05-15T13:57:12Z

Vlegkun:

{{TOC right}}
[[Object|Объект]] Pseudochat - Менеджер реплик для задач из [[Taskorganizer|Taskorganizer]]. Он используется для имитации чата с заданным количеством собеседников.

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

*'''файл уровня''' - Имя файла с уровнями в фомате *.json
*'''номер уровня''' - Номер уровня в файле начиная с 0
*'''etasktemplate''' - объект типа [[Etasktemplate|Etasktemplate]], использующийся для названия, описания, прогресса и т.п.
*'''taskorganizer''' - taskorganizer
*'''таблица тасков''' - Таблица темплейтов тасков
*'''таблица реплик''' - Таблица в которую будем помещать темплейты реплик
*'''реплик в таблице''' - хранить в таблице историю диалога или только одну реплику
*'''плашка НОВЫЕ СООБЩЕНИЯ''' - Плашка с надписью НОВЫЕ СООБЩЕНИЯ. Будет добавлена в таблицу
*'''плашка СОБЕСЕДНИК ПЕЧАТАЕТ (не 0 темплейт)''' - Плашка с надписью СОБЕСЕДНИК ПЕЧАТАЕТ (не 0 темплейт). Будет добавлена в таблицу
*'''плашка СОБЕСЕДНИК ПЕЧАТАЕТ (0 темплейт)''' - Плашка с надписью СОБЕСЕДНИК ПЕЧАТАЕТ (0 темплейт). Будет добавлена в таблицу

'''времена между репликами'''
*'''ms на символ''' - Число милисекунд на один символ следующей реплики
*'''max ms''' - Максимальное время на сообщение не може превышать это значение

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

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

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

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

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

=Состояния=

*'''idle''' - Состояние по умолчанию (не вызывается)
*'''show_dialog''' - Показать диалог для последнего кликнутого таска в таблице
*'''add_one''' - Добавить одну реплику в текущий диалог
*'''add_all''' - Добавить все реплики в текущий диалог
*'''pause''' - Чат на паузе
*'''show_dialog_by_owner''' - Показать диалог, взяв owner из param

=Структура файла уровней=

Файл уровней должен быть в формате *.json и иметь следующую структуру:

<pre>
{
"dialogs": [
{
"id": 511,
"owner": 3,
"task": 511,
"messages": [
{
"text": 568,
"template": 0
},
{
"text": 569,
"template": 1
}]
},
{
"id": 517,
"owner": 4,
"task": 517,
"messages": [
{
"text": 646,
"template": 1
},
{
"text": 648,
"template": 0
}]
}]
}
</pre>

'''Расшифровка параметров:'''

*'''"id": 511''' - это id таска, по которому мы тапнули в таблице, он же id самого диалога,
*'''"owner": 3''' - владелец таска должен соответствовать владельцу таска в таскорганайзере,
*'''"task": 511''' - таск, активность которого проверяем для показа диалога (необязательный параметр),
*'''"text": 568''' - текстовый id самой реплики,
*'''"template": 0''' - номер темплейта реплики (по порядку начиная с нуля) из добавленных в объект Pseudochat.

[[Category:Game mechanic]]
[[Category:Economics|*]]

Absolutist Framework

2018-05-15T13:54:11Z

Vlegkun: /* 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-скриптов]]
* [[Подготовка версии для Viber]]
* [[Проверка подгрузки текстур]]
* [[Экспорт проекта]]
* [[Шаблон|Экспорт/импорт шаблона проекта]]

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

=== 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]] - машина состояний
** [[Файл:Mwindow.png]] - [[Mwindow]] - машина состояний - окно
* [[Файл: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]] - создание мини-карты для отображения прогресса прохождения игры.
* [[Файл:Statesmanager_ico.png]] - [[Statesmanager]] - очередь работы с объектами
* [[Файл:Slider icons.png]] - [[Slider]] - объект реализующий листание списка.
* [[Файл:Ribbon.png]] - [[Ribbon]] - объект отображения графики по сплайну
* [[Файл:Kub.png]] - [[Animation]] - объект различных анимаций
* [[Файл:Kub.png]] - [[Magicparticles]] - объект файлов Magic Particles
* [[Файл:Kub.png]] - [[puzzle3D]] - 3D паззл
* [[Файл:Kub.png]] - [[3D-object]] - 3D объект
* [[Файл:Kub.png]] - [[Scriptresources]] - scriptresources
* [[Файл:Kub.png]] - [[Partnersconsole]] - partnersconsole

=== Game mechanic ===

* [[Файл:Kub.png]] - [[Avoider]] - эвойдер
* [[Файл:Kub.png]] - [[Battle]] - боевка
* [[Файл:Puzzle.png]] - [[Puzzle]] - игра пазл
* [[Файл:Memory.png]] - [[Memory]] - класс игр с memory-механикой
* [[Файл:Patchwork.png]] - [[Patchwork]] - класс игр с Patchwork-механикой
* [[Файл:Match3.png]] - [[Match]] - класс match-подобных игр
* [[Файл:Collaps.png]] - [[Collapse]] - класс match-подобных игр
* [[Файл:Bejewelled.png]] - [[Bejewelled]] - класс match-подобных игр
* [[Файл:Bs_old.png]] - [[Bubble Shooter]] - класс Bubble игр включая механику Снукер
* [[Файл:BubbleShooter.png]] - [[Bubble Shooter NEW]] - класс 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
* [[Файл:Kub.png]] - [[AtomicPuzzle]] - механика игры Atomic puzzle
* [[Файл: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]] - "коллекция" поисковых объектов для хидден игр
* [[Файл:Kub.png]] - [[Color Switch]] - механика игры Color Switch
* [[Файл: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]] - шаблон задачи для таблицы темплейтов.
*** [[Файл:Kub.png]] - [[Elogbooktemplate]] - шаблон отображения ячейки логбука.
** [[Файл:E_task_item.png]] - [[Etaskitem]] - шаблон для ячейки задания
** [[Файл:E_collection.png]] - [[Ecollection]] - шаблон для строки в таблице коллекции
** [[Файл:Kub.png]] - [[Pseudochat]] - менеджер реплик.
* [[Файл: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]] - объект шаблона ячейки с животным.
* [[Файл:Kub.png]] - [[CakeTower]] - объект шаблона ячейки с животным.
* [[Файл:Kub.png]] - [[Pentamino]] - механика игры в [https://ru.wikipedia.org/wiki/%D0%9F%D0%B5%D0%BD%D1%82%D0%B0%D0%BC%D0%B8%D0%BD%D0%BE пентамино]
* [[Файл:Kub.png]] - [[TapTheNew]]
* [[Файл:Kub.png]] - [[Dressing]] - гардероб.
** [[Файл:Kub.png]] - [[Dressingtemplate]] - объект шаблона гардероба.
* [[Файл:Kub.png]] - [[solitaire]] - солитер

* [[Файл:digitz.png]] - [[Digitz]] - механика игры Digitz.
* [[Файл:Kub.png]] - [[Wordsearch]] - механика поиска слов на поле
* [[Файл:Kub.png]] - [[Builder]] - механика типа фермы
** [[Файл:Kub.png]] - [[Builderitem]] - объект шаблона здания
** [[Файл:Kub.png]] - [[Buildercomponent]] - шаблон материала для апгрейда здания
* [[Файл:Kub.png]] - [[Script Game]] - Script Game

=== 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]] - настройки для отображения результатов прохождения игры
*[[Файл:Kub.png]] - [[Leaderboardsitem]] - Шаблон для помещения в таблицу лидербордов.

=== 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]] - объект для отправки событий
* [[Файл:Kub.png]] - [[Errormanager]] - менеджер ошибок
* [[Файл:Kub.png]] - [[Multiplayer]] - объект мультиплеера

=== 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
* [[Файл:Kub.png]] - [[ShareDialog]] - объект для вызова окна шаринга в другие приложения устройства

=== Functions ===
* [[Файл:Forward.png]] - [[SendMail]] - отправка письма через почтовый клиент
* [[Файл:footer-icon-rate.png]] - [[Rate]] - вызов окна оценки приложения
* [[Файл:Kub.png]] - [[Config]] - конфиг для игровой механики

----
[[Файл:!.png]] - [[Правила оформления]] - Требование к описанию объектов.
----
<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]]

Pseudochat

2018-05-15T13:51:17Z

Vlegkun:

Pseudochat

2018-05-15T11:09:56Z

Vlegkun: Новая страница: «{{TOC right}} Объект Pseudochat - Менеджер реплик для задач из Taskorganizer. =Основные па…»

{{TOC right}}
[[Object|Объект]] Pseudochat - Менеджер реплик для задач из [[Taskorganizer|Taskorganizer]].

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

*'''файл уровня''' - Имя файла с уровнями в фомате *.json
*'''номер уровня''' - Номер уровня в файле начиная с 0
*'''etasktemplate''' - объект типа [[Etasktemplate|Etasktemplate]] использующийся для названия, описания, прогресса и т.п.
*'''taskorganizer''' - taskorganizer
*'''таблица тасков''' - Таблица темплейтов тасков
*'''таблица реплик''' - Таблица в которую будем помещать темплейты реплик
*'''реплик в таблице''' - хранить в таблице историю диалога или только одну реплику
*'''плашка НОВЫЕ СООБЩЕНИЯ''' - Плашка с надписью НОВЫЕ СООБЩЕНИЯ. Будет добавлена в таблицу
*'''плашка СОБЕСЕДНИК ПЕЧАТАЕТ (не 0 темплейт)''' - Плашка с надписью СОБЕСЕДНИК ПЕЧАТАЕТ (не 0 темплейт). Будет добавлена в таблицу
*'''плашка СОБЕСЕДНИК ПЕЧАТАЕТ (0 темплейт)''' - Плашка с надписью СОБЕСЕДНИК ПЕЧАТАЕТ (0 темплейт). Будет добавлена в таблицу

'''времена между репликами'''
*'''ms на символ''' - Число милисекунд на один символ следующей реплики
*'''max ms''' - Максимальное время на сообщение не може превышать это значение

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

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

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

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

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

=Состояния=

*'''idle''' - Состояние по умолчанию (не вызывается)
*'''show_dialog''' - Показать диалог для последнего кликнутого таска в таблице
*'''add_one''' - Добавить одну реплику в текущий диалог
*'''add_all''' - Добавить все реплики в текущий диалог
*'''pause''' - Чат на паузе
*'''show_dialog_by_owner''' - Показать диалог, взяв owner из param

Store

2018-02-13T15:08:58Z

Vlegkun:

{{TOC right}}

[[Object|Объект]] '''Store''' необходим для описания InApp покупок(позволяют продавать отдельные бонусы, паки и т.п.) в игре.

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

*'''service id''' - Идентификатор сервиса для Fortumo
*'''app secret''' - Секретный ключ для Fortumo
*'''group id''' - ID группы для Samsung
*'''wallet''' - Объект типа [[Wallet|Wallet]]

'''Группа adjust'''
*'''включить adjust''' - нет=0, да=1;
*'''событие первой покупки для iOS'''
*'''событие первой покупки для Ansroid'''
*'''событие покупки для iOS'''
*'''событие покупки для Android'''

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

[[Файл:+.png]] '''Покупка''' - Описание одной внутриигровой покупки.

*'''id покупки''' - внутренний id покупки
*'''числовой id покупки''' - Числовой id покупки для сохранения истории покупок в опции
*'''цена''' - Цена покупки по умолчанию
*'''объект (успех)''' - Этому объекту будет сообщено об успехе покупки
*'''состояние (успех)''' - Это состояние будет установлено объекту при успешной покупке
*'''объект (провал)''' - Этому объекту будет сообщено о неудаче покупки
*'''состояние (провал)''' - Это состояние будет установлено объекту при ошибке/отмене покупки
*'''iOS id покупки''' - id покупки в магазине Apple для iOS версии приложения
*'''Amazon id покупки''' - id покупки для Amazon версии приложения
*'''Fortumo id покупки''' - id Fortumo покупки для Android версии приложения
*'''Описание покупки Fortumo''' - отбражаемое описание покупки для Frotumo под Android
*'''Fortumo service Id''' - берутся с сайта фортумо (их видно в свойствах покупки)
*'''Fortumo appSecret''' - берутся с сайта фортумо (их видно в свойствах покупки)
*'''Samsung Item ID''' - id покупки в самсунговском маркете
*'''Wild Tangent Product Name''' - имя продукта в маркете Wild Tangent(берётся из сайта Wild Tangent)
*'''Wild Tangent Partner Name''' - имя партнера в маркете Wild Tangent(берётся из сайта Wild Tangent)
*'''Wild Tangent Site Name''' - имя сайта в маркете Wild Tangent(берётся из сайта Wild Tangent)
*'''Wild Tangent Game Name''' - имя игры в маркете Wild Tangent(берётся из сайта Wild Tangent)
*'''Google Product ID''' - ID покупки на Google Play [[http://ge.absolutist.com/index.php/Store#.D0.94.D0.BE.D0.BF.D0.BE.D0.BB.D0.BD.D0.B8.D1.82.D0.B5.D0.BB.D1.8C.D0.BD.D1.8B.D0.B5_.D1.81.D0.B2.D0.B5.D0.B4.D0.B5.D0.BD.D0.B8.D1.8F]]
*'''BlackBerry id покупки''' - BlackBerry ID
*'''WP8 ID''' - id покупки для Windows Phone 8 приложений
*'''Windows 81 id покупки''' - Windows 81 ID
*'''Netmarble transaction id''' - Netmarble transaction id
*'''Netmarble item id''' - Netmarble item id
*'''Tizen id покупки''' - id покупки в магазине Tizen
*'''Yandex id покупки''' - id покупки в магазине Yandex
*'''Nokia id покупки''' - id покупки в магазине Nokia
*'''Mobiroo id покупки''' - id покупки в магазине Mobiroo
*'''Web facebook id''' - Web facebook id
*'''Web odnoklassniki id''' - Web odnoklassniki id
*'''Web vkontakte id''' - Web vkontakte id
*'''Web yahoo id''' - Web yahoo id
*'''Web mailru id''' - Web mailru id
*'''Web wizq id''' - Web wizq id
*'''Steam id покупки''' - id покупки в Steam версии приложения
*'''Consumable''' - 1 - покупка расходуемая, 0 - покупка раз и навсегда. '''! Важно, если параметр не указан, по-умолчанию покупка - навсегда !'''
*'''объект (restore)''' - объект - Слушатель восстановления покупки. Этому объекту будет сообщено об успехе восстановления этой покупки покупки.
*'''состояние (restore)''' - Это состояние будет установлено объекту при успешном восстановлении этой покуки

[[Файл:+.png]] '''успех restore''' - Выполняется когда хотя бы одна покупка успешно восстановлена.

*'''объект''' - Объект - состояние которого меняем. Этому объекту будет сообщено о завершении восстановления покупок.
*'''состояние''' - Это состояние будет установлено объекту при завершении восстановления покупок.

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

*'''объект''' - Объект - состояние которого меняем. Этому объекту будет сообщено об ошибке восстановления покупок.
*'''состояние''' - Это состояние будет установлено объекту при ошибке восстановления покупок.

[[Файл:+.png]] '''пусто restore''' - выполняется когда нет покупок для восстановления

*'''объект''' - Объект - состояние которого меняем. Этому объекту будет сообщено об отсутствии покупок для восстановления.
*'''состояние''' - Это состояние будет установлено объекту при отсутствии покупок для восстановления.

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

*'''purchase''' - совершить покупку, взяв ее идентификатор (внутренний id) из параметра ''productBundle''
*'''restore''' - вызвать восстановление покупок

==Создание, совершение и восстановление покупок==

===Создание===

'''Шаг 1.''' Создание обюъекта Store.
На глобальном экране (например, там, где находятся [[options]]) создать объект [[store]]. Для этого на сцене ПКМ (правой кнопкой мыши), из выпадающего меня выбрать "создать объект сцены в текущем объекте". У созданного объекта изменить тип объекта на [[store]]. В поле ''имя'' вводим уникальное имя (приучаем себя к порядку в проекте).
<center>
[[Файл:store_new.png]]
</center>

'''Шаг 2.''' Создание покупки.
* В свойствах этого объекта нажимаем ПКМ и добавляем раздел '''in-app покупка'''. По умолчанию создаются параметры: объект (успех), состояние (успех), объект (провал), состояние (провал), объект (restore), состояние (restore).
* Для выбора остальных параметров нужно нажать на кнопку с троеточием, откроется окно с параметрами, в котором проставим галочки на нужных параметрах:
<center>
[[Файл:store_params.png]].
</center>
'''!!! Обязательным параметром является ''внутренний id покупки'' - это уникальный идентификатор покупки в проекте.!!!'''
Можно выбирать сразу несколько систем in-app покупок - при сборке в зависимости от платформы и целевого маркета на устройстве будут использованы соответствующие покупки.
* В первом поле "'''id покупки'''" записываем строковый идентификатор инапа. Это может быть любая строка, уникальная для каждого инапа. Если в строке встречаются точки, то информация о покупках будет сохранятся в поддиректориях опций. Эта строка будет использоваться в игре объектами для выяснения того, была ли уже проведена покупка или нет и для совершения покупки. '''!!!Недопустимо начинать внутренний id покупки с числа!!!'''
* Во втором поле, в примере "'''iOS id покупки'''", записывается идентификатор этого инапа, в нашем случае на Apple Store. Аналогично для других систем.
* Далее, таким же образом, добавляется следующий инап. '''!!!Недопустимо использовать одинаковый идентификатор инапа из стора в разных внутренних покупках!!!'''
В результате, окно настроек объекта будет выглядеть примерно таким образом:
<center>
[[Файл:store_buy.png]]
</center>

===Совершение покупки===

Для инициации процесса покупки существует несколько способов.

'''Способ 1.''' По нажатию на кнопку.
В кнопке добавляется свойство "'''совершить in-app покупку'''" (как обычно, ПКМ). В нем отмечается галкой поле ''внутренний id покупки'' - тот же, что и "id покупки" в объекте [[store]]. По нажатию на эту кнопку произойдет обращение к магазину.

'''Способ 2.''' Из машины состояний.
В машине состояний выбрать команду '''in-app совершить in-app покупку''', в ней отметить галкой поле ''внутренний id покупки'' по аналогии с кнопкой. При вызове нужного состояния машине будет произведено обращение к магазину.

===Обработчики покупки===

'''Обработка успеха'''
Если игрок произвел покупку, то объект, заданный в поле этой покупки объекта Store ''объект (успех)'' будет переведен в состояние ''состояние (успех)''. В этом объекте (обычно [[Machine|машина состояний]]) может быть активированы некоторые действия (например, спрятаны замочки, блокирующие продаваемый бонус). Одновременно с этим, в раздел опций который соответствует полю "внутренний id покупки" будет записано значение "1" (покупка совершена). Это поле может в дальнейшем вычитываться различными игровыми объектами.
Если в объекте Store указан объект Wallet, и начисление ресурсов покупки происходит через него, то начисление произойдет автоматически при успехе покупки.

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

===Типы ошибок при совершении покупки===

0 - Unknown error

1 - Client is not allowed to make the payment

2 - Client canceled purchase

3 - Invalid parameter/purchase ID

4 - Device is not allowed to make the payment

5 - No internet connection ( нет сети )

6 - No internet connection ( нет интернета )

7 - The service is not available for some reason (Услуга временно не доступна)

8 - Purchase restore failed (Восстановить покупку не возможно)

код ошибки находится в объекте типа options в параметре store.lastError

В данный момент для IOS работает возврат всех ошибок, для других платформ "неизвестная ошибка" и "отсутствие интернета".

===Восстановление покупок===

В некоторых магазинах используется восстановление покупок автоматически. В Apple Store для восстановления нерасходуемых покупок нужно вызвать состояние ''restore''.

В полях "объект (restore)" и "состояние (restore)" in-app покупки указывается машина и состояние в которое её надо перевести, если придёт сообщение, о том, что данная покупка должна быть восстановлена.

Обработчики "успех restore", "ошибка restore" и "пусто restore" используются в общем по приходу сообщений о восстановлении. Т.е. если пришло сообщение в восстановлении 2-х покупок, то переведутся в указанные состояние 2 машины в покупках, которые необходимо восстановить, и переведётся машина в "успех restore" в указанное состояние. Если придёт сообщение о ошибке восстановления или о том что нет покупок для восстановления , то машины в "ошибка restore" и "пусто restore" переведутся в указанные состояние соответственно.

===Восстановление покупки через патч опций===

Если возникла необходимость восстановить покупку методом патча опций, то процедура следующая:
* патчем записываем в опции в некий параметр строку ''внутренний id покупки'';
* машиной состояний вычитываем эту строку и записываем в параметр ''productBundle'' и вызываем состояние ''purchase''.

В итоге получаем успех совершенной покупки.

== Пример InApp-a==

Предположим, что в игре [[puzzle]] есть бонус, ставящий ячейку на своё место.
Игроку дается возможность использовать этот бонус 3 раза за игровую сессию, после чего появляется окно на подобное этому:
<center>
[[Файл:store2.png]]
</center>
При нажатии на крестик окно закрывается, а при нажатии на замок активируется процесс покупки.

Голубая кнопка с белым ноликом является кнопкой запуска хинта. В ней есть раздел
* '''изменить состояние объекта'''
** объект = puzzle (идентификатор миниигры [[puzzle]])
** состояние = swap (состояние котором одна из ячеек становится на свое место).

Белая цифра поверх кнопки - это счетчик [[counter]]. Его идентификатор cnt_hnt сообщается пазле (она уменьшает его значение при выполнении этого хинта). Диапазон изменения счетчика задан в пределах min=0, max=3. Начальное значение val=3. Кроме этого в счетчик правой кнопкой мыши добавлены разделы:
* '''min: изменить объект'''
** объект = win_buy_hint
** состояние = open
* '''minIf: условие изменения min'''
** куплено = buy.hint
** not = 1
Эти разделы означают, что при достижении счетчиком минимальной границы будет открыто окно win_buy_hint если в опциях '''не''' (поле not) отмечена покупка "buy.hint".

Заметим, что пазла [[puzzle]] выполняет этот хинт (получив состояние от кнопки), если счетчика этих хинтов нет, или он не достиг минимума, или достиг, но в нем нет выполнившегося раздела "min: изменить объект".

Само окно win_buy_hint (желтый прямоугольник) является [[Machine|машиной состояний]] в которой может быть выключен счётчик, открывается окно, закрывается окно.

У машины состояний есть 2 подобъекта - кнопки с замочком и крестиком.
Крестик имеет добавленный раздел, который закрывает окно.
Замок запускает процесс покупки и также закрывает окно:
* '''изменить состояние объекта'''
** объект = win_buy_hint
** состояние = close
* '''совершить in-app покупку'''
** id покупки = buy.hint
** объект (успех) = win_buy_hint
** состояние (успех) = hide
** объект (провал) = win_error
** состояние (провал) = open
В случае успешной покупки счетчик становится невидимым (состояние hide окна). При неудаче открывается окно win_error, аналогичное win_buy_hint сообщающее об ошибке покупки хинта.

Обратим внимание, что выполнение состояний "успех" и "провал" является отложенными во времени.
Они вызываются магазином, когда соответствующие события (покупка или отказ от неё) возникнут.

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

===Покупки Google Play===

* Для работы покупок на Google Play необходимо добавить разрешения:
<pre>

<uses-permission android:name="com.android.vending.BILLING" />

</pre>

* Для получения ID покупки на Google Play необходимо сначала загрузить apk с разрешением покупок

* Разрешения записываются в AndroidManifest.xml, который находится обычно в каталоге %s3e_dir%\deploy\plugins\android. Также можно вместо AndroidManifest.xml вносить соответствующие настройки в android-extra-manifest.xml, который находится в каталоге %каталог_редактора%\system\marmalade\conf\%марект%(к примеру android)

* Для приложения с покупками на google play надо добавить лицензионный ключ приложения в app.icf в группу [AndroidLVL] и разбить его на 4 части длинной не более 100 знаков. Также добавить для бесплатного приложения параметр ''free_app=1''
<pre>
[AndroidLVL]
base64_public_key_1=""
base64_public_key_2=""
base64_public_key_3=""
base64_public_key_4=""
free_app=1
</pre>

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

===Настройка маркета действующих покупок===

* Для работы соостветствующего маркета на устройстве недобходимо в [[app.icf]] в секцию [Game] добавить параметр Market с значением для маркета.

магазин - значение в [[app.icf]] 
Fortumo - fortumo 
Samsung - samsung 
Amazon market - amazon 
Apple store - ios 
Wildtangent - wildtangent 
Windows Store - wp8 
Blackberry - blackberry 
Google Play - android 

Пример:
<pre>
[Game]
Market="ios"
</pre>

===Trial период в Windows Phone 8===
* Для windows phone 8 есть возможность работы в пробном режиме. То есть пользователь может пользоваться платным приложением или некоторое время или с ограниченными возможностями.

"The trial/full state of a user’s execution rights for an app are maintained in a license. When a user tries your app, it is installed on their phone along with a license that grants them the right to try the app. Trial licenses do not expire but when a user purchases an app they have been trying a full license is downloaded. The full license replaces the trial license and grants full rights to the app."

[http://msdn.microsoft.com/library/windowsphone/develop/ff967558%28v=vs.105%29.aspx Creating trial apps for Windows Phone]

Данный функционал связан с объектом типа store - недоступный функционал находится за внутриигровой покупкой. Когда пользователь покупает полную версию все покупки помечаются автоматически как "купленные".

Для работы данного функционала в [[app.icf]] или [[platform.icf]] необходимо в группу <nowiki>[Game]</nowiki> поместить параметр '''''trial'''''

'''trial=0''' - без триала

'''trial=1''' - с триалом

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

===Тестирование покупок для Blackberry===
Для тестирования покупок на Blackberry устройствах в app.icf сборки необходимо добавить следующие строки:
<pre>
[Game]
inappTest=1
</pre>
inappTest=1 - all in-app in test mode, 0 - default

===Тестирование покупок из редактора на Viewer===
Для тестирования покупок на Viewer-е в app.icf необходимо добавить следующие строки:
<pre>
[Game]
purchaseEverything=1
</pre>

[[Category:Options]]

Файл:Store params.png

2018-02-13T15:05:46Z

Vlegkun:

Файл:Store new.png

2018-02-13T15:05:34Z

Vlegkun:

Файл:Store buy.png

2018-02-13T15:04:52Z

Vlegkun:

Store

2018-02-13T14:30:24Z

Vlegkun: /* Добавляемые параметры */

{{TOC right}}

[[Object|Объект]] '''Store''' необходим для описания InApp покупок(позволяют продавать отдельные бонусы, паки и т.п.) в игре.

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

*'''service id''' - Идентификатор сервиса для Fortumo
*'''app secret''' - Секретный ключ для Fortumo
*'''group id''' - ID группы для Samsung
*'''wallet''' - Объект типа [[Wallet|Wallet]]

'''Группа adjust'''
*'''включить adjust''' - нет=0, да=1;
*'''событие первой покупки для iOS'''
*'''событие первой покупки для Ansroid'''
*'''событие покупки для iOS'''
*'''событие покупки для Android'''

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

[[Файл:+.png]] '''Покупка''' - Описание одной внутриигровой покупки.

*'''id покупки''' - внутренний id покупки
*'''числовой id покупки''' - Числовой id покупки для сохранения истории покупок в опции
*'''цена''' - Цена покупки по умолчанию
*'''объект (успех)''' - Этому объекту будет сообщено об успехе покупки
*'''состояние (успех)''' - Это состояние будет установлено объекту при успешной покупке
*'''объект (провал)''' - Этому объекту будет сообщено о неудаче покупки
*'''состояние (провал)''' - Это состояние будет установлено объекту при ошибке/отмене покупки
*'''iOS id покупки''' - id покупки в магазине Apple для iOS версии приложения
*'''Amazon id покупки''' - id покупки для Amazon версии приложения
*'''Fortumo id покупки''' - id Fortumo покупки для Android версии приложения
*'''Описание покупки Fortumo''' - отбражаемое описание покупки для Frotumo под Android
*'''Fortumo service Id''' - берутся с сайта фортумо (их видно в свойствах покупки)
*'''Fortumo appSecret''' - берутся с сайта фортумо (их видно в свойствах покупки)
*'''Samsung Item ID''' - id покупки в самсунговском маркете
*'''Wild Tangent Product Name''' - имя продукта в маркете Wild Tangent(берётся из сайта Wild Tangent)
*'''Wild Tangent Partner Name''' - имя партнера в маркете Wild Tangent(берётся из сайта Wild Tangent)
*'''Wild Tangent Site Name''' - имя сайта в маркете Wild Tangent(берётся из сайта Wild Tangent)
*'''Wild Tangent Game Name''' - имя игры в маркете Wild Tangent(берётся из сайта Wild Tangent)
*'''Google Product ID''' - ID покупки на Google Play [[http://ge.absolutist.com/index.php/Store#.D0.94.D0.BE.D0.BF.D0.BE.D0.BB.D0.BD.D0.B8.D1.82.D0.B5.D0.BB.D1.8C.D0.BD.D1.8B.D0.B5_.D1.81.D0.B2.D0.B5.D0.B4.D0.B5.D0.BD.D0.B8.D1.8F]]
*'''BlackBerry id покупки''' - BlackBerry ID
*'''WP8 ID''' - id покупки для Windows Phone 8 приложений
*'''Windows 81 id покупки''' - Windows 81 ID
*'''Netmarble transaction id''' - Netmarble transaction id
*'''Netmarble item id''' - Netmarble item id
*'''Tizen id покупки''' - id покупки в магазине Tizen
*'''Yandex id покупки''' - id покупки в магазине Yandex
*'''Nokia id покупки''' - id покупки в магазине Nokia
*'''Mobiroo id покупки''' - id покупки в магазине Mobiroo
*'''Web facebook id''' - Web facebook id
*'''Web odnoklassniki id''' - Web odnoklassniki id
*'''Web vkontakte id''' - Web vkontakte id
*'''Web yahoo id''' - Web yahoo id
*'''Web mailru id''' - Web mailru id
*'''Web wizq id''' - Web wizq id
*'''Steam id покупки''' - id покупки в Steam версии приложения
*'''Consumable''' - 1 - покупка расходуемая, 0 - покупка раз и навсегда. '''! Важно, если параметр не указан, по-умолчанию покупка - навсегда !'''
*'''объект (restore)''' - объект - Слушатель восстановления покупки. Этому объекту будет сообщено об успехе восстановления этой покупки покупки.
*'''состояние (restore)''' - Это состояние будет установлено объекту при успешном восстановлении этой покуки

[[Файл:+.png]] '''успех restore''' - Выполняется когда хотя бы одна покупка успешно восстановлена.

*'''объект''' - Объект - состояние которого меняем. Этому объекту будет сообщено о завершении восстановления покупок.
*'''состояние''' - Это состояние будет установлено объекту при завершении восстановления покупок.

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

*'''объект''' - Объект - состояние которого меняем. Этому объекту будет сообщено об ошибке восстановления покупок.
*'''состояние''' - Это состояние будет установлено объекту при ошибке восстановления покупок.

[[Файл:+.png]] '''пусто restore''' - выполняется когда нет покупок для восстановления

*'''объект''' - Объект - состояние которого меняем. Этому объекту будет сообщено об отсутствии покупок для восстановления.
*'''состояние''' - Это состояние будет установлено объекту при отсутствии покупок для восстановления.

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

*'''purchase''' - совершить покупку, взяв ее идентификатор (внутренний id) из параметра ''productBundle''
*'''restore''' - вызвать восстановление покупок

== Задание in-app идентификаторов ==

Прежде всего необходимо определить in-app идентификаторы.
Для этого необходимо:
* поместить на глобальное окно (например, там, где находятся [[options]]) объект [[store]]. Для этого, на сцену этого окна перетаскивается любая картинка или создаётся новый объект в сцене и у него меняется тип объекта на [[store]].
* в настройках свойств этого объекта нажимаем правую кнопку мыши и добавляем раздел "'''in-app покупка'''", кликая на который, в окне помечаем галочку у "внутренний id покупки" и необходимых полей(для ios - ios id покупки, для amazon - amazon id покупки и другие). Можно выбирать сразу несколько систем in-app покупок - при сборке в зависимости от платформы и целевого маркета на устройстве будут использованы соответствующие покупки.
* В первом поле "'''id покупки'''" записываем текстовый идентификатор инапа. Это может быть любая строка, уникальная для каждого инапа. Если в строке встречаются точки, то информация о покупках будет сохранятся в поддиректориях опций. Эта строка будет использоваться в игре объектами для выяснения того, была ли уже проведена покупка или нет и для совершения покупки.
* Во втором поле, в примере "'''iOS id покупки'''", записывается идентификатор этого инапа, в нашем случае на Apple Store. Аналогично для других систем.
* Далее, таким же образом, добавляется следующий инап.
В результате, окно настроек объекта будет выглядеть примерно таким образом:
<center>
[[Файл:store1.png]]
</center>

Для IOS также используется восстановление покупок. В полях "объект (restore)" и "состояние (restore)" in-app покупки указывается машина и состояние в которое её надо перевести, если придёт сообщение, о том, что данная покупка должна быть восстановлена.

Параметры "успех restore", "ошибка restore" и "пусто restore" используются в общем по приходу сообщений о восстановлении. Тесть если пришло сообщение в восстановлении 2-х покупок, то переведутся в указанные состояние 2 машины в покупках, которые необходимо восстановить, и переведётся машина в "успех restore" в указанное состояние. Если придёт сообщение о ошибке восстановления или о том что нет покупок для восстановления , то машины в "ошибка restore" и "пусто restore" переведутся в указанные состояние соответственно.

== Использование InApp идентификаторов ==

Если из игры необходимо инициировать процесс покупки, в результате нажатия на кнопку,
этой кнопки добавляется раздел "'''совершить in-app покупку'''" (как обычно, правой кнопкой мыши).
В нем отмечаются галочками поля:
* внутренний id покупки - тот же, что и "id покупки" в объекте [[store]]
* объект - слушатель успеха
* состояние успеха
* объект - слушатель неудачи
* состояние неудачи
После нажатия на эту кнопку произойдет обращение к магазину. В этот момент поверх экрана игры будет рисоваться клип прогресса, определяемый в [[options]] (такой же, как и при переходах между экранами).

Если игрок произвел покупку, объект, заданный в поле "'''объект (успех)'''" будет переведен в состояние "'''состояние (успех)'''" (третье поле). В этом объекте (обычно [[Machine|машина состояний]]) может быть активированы некоторые действия (например, спрятаны замочки, блокирующие продаваемый бонус). Одновременно с этим, в раздел опций который соответствует полю "внутренний id покупки" будет записана 1 (покупка совершена). Это поле может в дальнейшем вычитываться различными игровыми объектами.

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

== Пример InApp-a==

Предположим, что в игре [[puzzle]] есть бонус, ставящий ячейку на своё место.
Игроку дается возможность использовать этот бонус 3 раза за игровую сессию, после чего появляется окно на подобное этому:
<center>
[[Файл:store2.png]]
</center>
При нажатии на крестик окно закрывается, а при нажатии на замок активируется процесс покупки.

Голубая кнопка с белым ноликом является кнопкой запуска хинта. В ней есть раздел
* '''изменить состояние объекта'''
** объект = puzzle (идентификатор миниигры [[puzzle]])
** состояние = swap (состояние котором одна из ячеек становится на свое место).

Белая цифра поверх кнопки - это счетчик [[counter]]. Его идентификатор cnt_hnt сообщается пазле (она уменьшает его значение при выполнении этого хинта). Диапазон изменения счетчика задан в пределах min=0, max=3. Начальное значение val=3. Кроме этого в счетчик правой кнопкой мыши добавлены разделы:
* '''min: изменить объект'''
** объект = win_buy_hint
** состояние = open
* '''minIf: условие изменения min'''
** куплено = buy.hint
** not = 1
Эти разделы означают, что при достижении счетчиком минимальной границы будет открыто окно win_buy_hint если в опциях '''не''' (поле not) отмечена покупка "buy.hint".

Заметим, что пазла [[puzzle]] выполняет этот хинт (получив состояние от кнопки), если счетчика этих хинтов нет, или он не достиг минимума, или достиг, но в нем нет выполнившегося раздела "min: изменить объект".

Само окно win_buy_hint (желтый прямоугольник) является [[Machine|машиной состояний]] в которой может быть выключен счётчик, открывается окно, закрывается окно.

У машины состояний есть 2 подобъекта - кнопки с замочком и крестиком.
Крестик имеет добавленный раздел, который закрывает окно.
Замок запускает процесс покупки и также закрывает окно:
* '''изменить состояние объекта'''
** объект = win_buy_hint
** состояние = close
* '''совершить in-app покупку'''
** id покупки = buy.hint
** объект (успех) = win_buy_hint
** состояние (успех) = hide
** объект (провал) = win_error
** состояние (провал) = open
В случае успешной покупки счетчик становится невидимым (состояние hide окна). При неудаче открывается окно win_error, аналогичное win_buy_hint сообщающее об ошибке покупки хинта.

Обратим внимание, что выполнение состояний "успех" и "провал" является отложенными во времени.
Они вызываются магазином, когда соответствующие события (покупка или отказ от неё) возникнут.

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

===Покупки Google Play===

* Для работы покупок на Google Play необходимо добавить разрешения:
<pre>

<uses-permission android:name="com.android.vending.BILLING" />

</pre>

* Для получения ID покупки на Google Play необходимо сначала загрузить apk с разрешением покупок

* Разрешения записываются в AndroidManifest.xml, который находится обычно в каталоге %s3e_dir%\deploy\plugins\android. Также можно вместо AndroidManifest.xml вносить соответствующие настройки в android-extra-manifest.xml, который находится в каталоге %каталог_редактора%\system\marmalade\conf\%марект%(к примеру android)

* Для приложения с покупками на google play надо добавить лицензионный ключ приложения в app.icf в группу [AndroidLVL] и разбить его на 4 части длинной не более 100 знаков. Также добавить для бесплатного приложения параметр ''free_app=1''
<pre>
[AndroidLVL]
base64_public_key_1=""
base64_public_key_2=""
base64_public_key_3=""
base64_public_key_4=""
free_app=1
</pre>

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

===Настройка маркета действующих покупок===

* Для работы соостветствующего маркета на устройстве недобходимо в [[app.icf]] в секцию [Game] добавить параметр Market с значением для маркета.

магазин - значение в [[app.icf]] 
Fortumo - fortumo 
Samsung - samsung 
Amazon market - amazon 
Apple store - ios 
Wildtangent - wildtangent 
Windows Store - wp8 
Blackberry - blackberry 
Google Play - android 

Пример:
<pre>
[Game]
Market="ios"
</pre>

===Типы ошибок при совершении покупоки===

* Типы ошибок при совершении покупоки

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

0 - Unknown error

1 - Client is not allowed to make the payment

2 - Client canceled purchase

3 - Invalid parameter/purchase ID

4 - Device is not allowed to make the payment

5 - No internet connection ( нет сети )

6 - No internet connection ( нет интернета )

7 - The service is not available for some reason (Услуга временно не доступна)

8 - Purchase restore failed (Восстановить покупку не возможно)

код ошибки находится в объекте типа options в параметре store.lastError

В данный момент для IOS работает возврат всех ошибок, для других платформ "неизвестная ошибка" и "отсутствие интернета"

Для обработки ошибок использовать [[Errormanager|ErrorManager]].

===Trial период в Windows Phone 8===
* Для windows phone 8 есть возможность работы в пробном режиме. То есть пользователь может пользоваться платным приложением или некоторое время или с ограниченными возможностями.

"The trial/full state of a user’s execution rights for an app are maintained in a license. When a user tries your app, it is installed on their phone along with a license that grants them the right to try the app. Trial licenses do not expire but when a user purchases an app they have been trying a full license is downloaded. The full license replaces the trial license and grants full rights to the app."

[http://msdn.microsoft.com/library/windowsphone/develop/ff967558%28v=vs.105%29.aspx Creating trial apps for Windows Phone]

Данный функционал связан с объектом типа store - недоступный функционал находится за внутриигровой покупкой. Когда пользователь покупает полную версию все покупки помечаются автоматически как "купленные".

Для работы данного функционала в [[app.icf]] или [[platform.icf]] необходимо в группу <nowiki>[Game]</nowiki> поместить параметр '''''trial'''''

'''trial=0''' - без триала

'''trial=1''' - с триалом

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

===Тестирование покупок для Blackberry===
Для тестирования покупок на Blackberry устройствах в app.icf сборки необходимо добавить следующие строки:
<pre>
[Game]
inappTest=1
</pre>
inappTest=1 - all in-app in test mode, 0 - default

===Тестирование покупок из редактора на Viewer===
Для тестирования покупок на Viewer-е в app.icf необходимо добавить следующие строки:
<pre>
[Game]
purchaseEverything=1
</pre>

[[Category:Options]]

Store

2018-02-13T13:23:40Z

Vlegkun:

{{TOC right}}

[[Object|Объект]] '''Store''' необходим для описания InApp покупок(позволяют продавать отдельные бонусы, паки и т.п.) в игре.

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

*'''service id''' - Идентификатор сервиса для Fortumo
*'''app secret''' - Секретный ключ для Fortumo
*'''group id''' - ID группы для Samsung
*'''wallet''' - Объект типа [[Wallet|Wallet]]

'''Группа adjust'''
*'''включить adjust''' - нет=0, да=1;
*'''событие первой покупки для iOS'''
*'''событие первой покупки для Ansroid'''
*'''событие покупки для iOS'''
*'''событие покупки для Android'''

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

'''Покупка''' - Описание одной внутриигровой покупки.

*'''id покупки''' - внутренний id покупки
*'''числовой id покупки''' - Числовой id покупки для сохранения истории покупок в опции
*'''цена''' - Цена покупки по умолчанию
*'''объект (успех)''' - Этому объекту будет сообщено об успехе покупки
*'''состояние (успех)''' - Это состояние будет установлено объекту при успешной покупке
*'''объект (провал)''' - Этому объекту будет сообщено о неудаче покупки
*'''состояние (провал)''' - Это состояние будет установлено объекту при ошибке/отмене покупки
*'''iOS id покупки''' - id покупки в магазине Apple для iOS версии приложения
*'''Amazon id покупки''' - id покупки для Amazon версии приложения
*'''Fortumo id покупки''' - id Fortumo покупки для Android версии приложения
*'''Описание покупки Fortumo''' - отбражаемое описание покупки для Frotumo под Android
*'''Fortumo service Id''' - берутся с сайта фортумо (их видно в свойствах покупки)
*'''Fortumo appSecret''' - берутся с сайта фортумо (их видно в свойствах покупки)
*'''Samsung Item ID''' - id покупки в самсунговском маркете
*'''Wild Tangent Product Name''' - имя продукта в маркете Wild Tangent(берётся из сайта Wild Tangent)
*'''Wild Tangent Partner Name''' - имя партнера в маркете Wild Tangent(берётся из сайта Wild Tangent)
*'''Wild Tangent Site Name''' - имя сайта в маркете Wild Tangent(берётся из сайта Wild Tangent)
*'''Wild Tangent Game Name''' - имя игры в маркете Wild Tangent(берётся из сайта Wild Tangent)
*'''Google Product ID''' - ID покупки на Google Play [[http://ge.absolutist.com/index.php/Store#.D0.94.D0.BE.D0.BF.D0.BE.D0.BB.D0.BD.D0.B8.D1.82.D0.B5.D0.BB.D1.8C.D0.BD.D1.8B.D0.B5_.D1.81.D0.B2.D0.B5.D0.B4.D0.B5.D0.BD.D0.B8.D1.8F]]
*'''BlackBerry id покупки''' - BlackBerry ID
*'''WP8 ID''' - id покупки для Windows Phone 8 приложений
*'''Windows 81 id покупки''' - Windows 81 ID
*'''Netmarble transaction id''' - Netmarble transaction id
*'''Netmarble item id''' - Netmarble item id
*'''Tizen id покупки''' - id покупки в магазине Tizen
*'''Yandex id покупки''' - id покупки в магазине Yandex
*'''Nokia id покупки''' - id покупки в магазине Nokia
*'''Mobiroo id покупки''' - id покупки в магазине Mobiroo
*'''Web facebook id''' - Web facebook id
*'''Web odnoklassniki id''' - Web odnoklassniki id
*'''Web vkontakte id''' - Web vkontakte id
*'''Web yahoo id''' - Web yahoo id
*'''Web mailru id''' - Web mailru id
*'''Web wizq id''' - Web wizq id
*'''Steam id покупки''' - id покупки в Steam версии приложения
*'''Consumable''' - 1 - покупка расходуемая, 0 - покупка раз и навсегда. '''! Важно, если параметр не указан, по-умолчанию покупка - навсегда !'''
*'''объект (restore)''' - объект - Слушатель восстановления покупки. Этому объекту будет сообщено об успехе восстановления этой покупки покупки.
*'''состояние (restore)''' - Это состояние будет установлено объекту при успешном восстановлении этой покуки

'''успех restore''' - Выполняется когда хотя бы одна покупка успешно восстановлена.

*'''объект''' - Объект - состояние которого меняем. Этому объекту будет сообщено о завершении восстановления покупок.
*'''состояние''' - Это состояние будет установлено объекту при завершении восстановления покупок.

'''ошибка restore''' - выполняется, когда произошла ошибка при восстановлении покупок

*'''объект''' - Объект - состояние которого меняем. Этому объекту будет сообщено об ошибке восстановления покупок.
*'''состояние''' - Это состояние будет установлено объекту при ошибке восстановления покупок.

'''пусто restore''' - выполняется когда нет покупок для восстановления

*'''объект''' - Объект - состояние которого меняем. Этому объекту будет сообщено об отсутствии покупок для восстановления.
*'''состояние''' - Это состояние будет установлено объекту при отсутствии покупок для восстановления.

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

*'''purchase''' - совершить покупку, взяв ее идентификатор (внутренний id) из параметра ''productBundle''
*'''restore''' - вызвать восстановление покупок

== Задание in-app идентификаторов ==

Прежде всего необходимо определить in-app идентификаторы.
Для этого необходимо:
* поместить на глобальное окно (например, там, где находятся [[options]]) объект [[store]]. Для этого, на сцену этого окна перетаскивается любая картинка или создаётся новый объект в сцене и у него меняется тип объекта на [[store]].
* в настройках свойств этого объекта нажимаем правую кнопку мыши и добавляем раздел "'''in-app покупка'''", кликая на который, в окне помечаем галочку у "внутренний id покупки" и необходимых полей(для ios - ios id покупки, для amazon - amazon id покупки и другие). Можно выбирать сразу несколько систем in-app покупок - при сборке в зависимости от платформы и целевого маркета на устройстве будут использованы соответствующие покупки.
* В первом поле "'''id покупки'''" записываем текстовый идентификатор инапа. Это может быть любая строка, уникальная для каждого инапа. Если в строке встречаются точки, то информация о покупках будет сохранятся в поддиректориях опций. Эта строка будет использоваться в игре объектами для выяснения того, была ли уже проведена покупка или нет и для совершения покупки.
* Во втором поле, в примере "'''iOS id покупки'''", записывается идентификатор этого инапа, в нашем случае на Apple Store. Аналогично для других систем.
* Далее, таким же образом, добавляется следующий инап.
В результате, окно настроек объекта будет выглядеть примерно таким образом:
<center>
[[Файл:store1.png]]
</center>

Для IOS также используется восстановление покупок. В полях "объект (restore)" и "состояние (restore)" in-app покупки указывается машина и состояние в которое её надо перевести, если придёт сообщение, о том, что данная покупка должна быть восстановлена.

Параметры "успех restore", "ошибка restore" и "пусто restore" используются в общем по приходу сообщений о восстановлении. Тесть если пришло сообщение в восстановлении 2-х покупок, то переведутся в указанные состояние 2 машины в покупках, которые необходимо восстановить, и переведётся машина в "успех restore" в указанное состояние. Если придёт сообщение о ошибке восстановления или о том что нет покупок для восстановления , то машины в "ошибка restore" и "пусто restore" переведутся в указанные состояние соответственно.

== Использование InApp идентификаторов ==

Если из игры необходимо инициировать процесс покупки, в результате нажатия на кнопку,
этой кнопки добавляется раздел "'''совершить in-app покупку'''" (как обычно, правой кнопкой мыши).
В нем отмечаются галочками поля:
* внутренний id покупки - тот же, что и "id покупки" в объекте [[store]]
* объект - слушатель успеха
* состояние успеха
* объект - слушатель неудачи
* состояние неудачи
После нажатия на эту кнопку произойдет обращение к магазину. В этот момент поверх экрана игры будет рисоваться клип прогресса, определяемый в [[options]] (такой же, как и при переходах между экранами).

Если игрок произвел покупку, объект, заданный в поле "'''объект (успех)'''" будет переведен в состояние "'''состояние (успех)'''" (третье поле). В этом объекте (обычно [[Machine|машина состояний]]) может быть активированы некоторые действия (например, спрятаны замочки, блокирующие продаваемый бонус). Одновременно с этим, в раздел опций который соответствует полю "внутренний id покупки" будет записана 1 (покупка совершена). Это поле может в дальнейшем вычитываться различными игровыми объектами.

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

== Пример InApp-a==

Предположим, что в игре [[puzzle]] есть бонус, ставящий ячейку на своё место.
Игроку дается возможность использовать этот бонус 3 раза за игровую сессию, после чего появляется окно на подобное этому:
<center>
[[Файл:store2.png]]
</center>
При нажатии на крестик окно закрывается, а при нажатии на замок активируется процесс покупки.

Голубая кнопка с белым ноликом является кнопкой запуска хинта. В ней есть раздел
* '''изменить состояние объекта'''
** объект = puzzle (идентификатор миниигры [[puzzle]])
** состояние = swap (состояние котором одна из ячеек становится на свое место).

Белая цифра поверх кнопки - это счетчик [[counter]]. Его идентификатор cnt_hnt сообщается пазле (она уменьшает его значение при выполнении этого хинта). Диапазон изменения счетчика задан в пределах min=0, max=3. Начальное значение val=3. Кроме этого в счетчик правой кнопкой мыши добавлены разделы:
* '''min: изменить объект'''
** объект = win_buy_hint
** состояние = open
* '''minIf: условие изменения min'''
** куплено = buy.hint
** not = 1
Эти разделы означают, что при достижении счетчиком минимальной границы будет открыто окно win_buy_hint если в опциях '''не''' (поле not) отмечена покупка "buy.hint".

Заметим, что пазла [[puzzle]] выполняет этот хинт (получив состояние от кнопки), если счетчика этих хинтов нет, или он не достиг минимума, или достиг, но в нем нет выполнившегося раздела "min: изменить объект".

Само окно win_buy_hint (желтый прямоугольник) является [[Machine|машиной состояний]] в которой может быть выключен счётчик, открывается окно, закрывается окно.

У машины состояний есть 2 подобъекта - кнопки с замочком и крестиком.
Крестик имеет добавленный раздел, который закрывает окно.
Замок запускает процесс покупки и также закрывает окно:
* '''изменить состояние объекта'''
** объект = win_buy_hint
** состояние = close
* '''совершить in-app покупку'''
** id покупки = buy.hint
** объект (успех) = win_buy_hint
** состояние (успех) = hide
** объект (провал) = win_error
** состояние (провал) = open
В случае успешной покупки счетчик становится невидимым (состояние hide окна). При неудаче открывается окно win_error, аналогичное win_buy_hint сообщающее об ошибке покупки хинта.

Обратим внимание, что выполнение состояний "успех" и "провал" является отложенными во времени.
Они вызываются магазином, когда соответствующие события (покупка или отказ от неё) возникнут.

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

===Покупки Google Play===

* Для работы покупок на Google Play необходимо добавить разрешения:
<pre>

<uses-permission android:name="com.android.vending.BILLING" />

</pre>

* Для получения ID покупки на Google Play необходимо сначала загрузить apk с разрешением покупок

* Разрешения записываются в AndroidManifest.xml, который находится обычно в каталоге %s3e_dir%\deploy\plugins\android. Также можно вместо AndroidManifest.xml вносить соответствующие настройки в android-extra-manifest.xml, который находится в каталоге %каталог_редактора%\system\marmalade\conf\%марект%(к примеру android)

* Для приложения с покупками на google play надо добавить лицензионный ключ приложения в app.icf в группу [AndroidLVL] и разбить его на 4 части длинной не более 100 знаков. Также добавить для бесплатного приложения параметр ''free_app=1''
<pre>
[AndroidLVL]
base64_public_key_1=""
base64_public_key_2=""
base64_public_key_3=""
base64_public_key_4=""
free_app=1
</pre>

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

===Настройка маркета действующих покупок===

* Для работы соостветствующего маркета на устройстве недобходимо в [[app.icf]] в секцию [Game] добавить параметр Market с значением для маркета.

магазин - значение в [[app.icf]] 
Fortumo - fortumo 
Samsung - samsung 
Amazon market - amazon 
Apple store - ios 
Wildtangent - wildtangent 
Windows Store - wp8 
Blackberry - blackberry 
Google Play - android 

Пример:
<pre>
[Game]
Market="ios"
</pre>

===Типы ошибок при совершении покупоки===

* Типы ошибок при совершении покупоки

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

0 - Unknown error

1 - Client is not allowed to make the payment

2 - Client canceled purchase

3 - Invalid parameter/purchase ID

4 - Device is not allowed to make the payment

5 - No internet connection ( нет сети )

6 - No internet connection ( нет интернета )

7 - The service is not available for some reason (Услуга временно не доступна)

8 - Purchase restore failed (Восстановить покупку не возможно)

код ошибки находится в объекте типа options в параметре store.lastError

В данный момент для IOS работает возврат всех ошибок, для других платформ "неизвестная ошибка" и "отсутствие интернета"

Для обработки ошибок использовать [[Errormanager|ErrorManager]].

===Trial период в Windows Phone 8===
* Для windows phone 8 есть возможность работы в пробном режиме. То есть пользователь может пользоваться платным приложением или некоторое время или с ограниченными возможностями.

"The trial/full state of a user’s execution rights for an app are maintained in a license. When a user tries your app, it is installed on their phone along with a license that grants them the right to try the app. Trial licenses do not expire but when a user purchases an app they have been trying a full license is downloaded. The full license replaces the trial license and grants full rights to the app."

[http://msdn.microsoft.com/library/windowsphone/develop/ff967558%28v=vs.105%29.aspx Creating trial apps for Windows Phone]

Данный функционал связан с объектом типа store - недоступный функционал находится за внутриигровой покупкой. Когда пользователь покупает полную версию все покупки помечаются автоматически как "купленные".

Для работы данного функционала в [[app.icf]] или [[platform.icf]] необходимо в группу <nowiki>[Game]</nowiki> поместить параметр '''''trial'''''

'''trial=0''' - без триала

'''trial=1''' - с триалом

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

===Тестирование покупок для Blackberry===
Для тестирования покупок на Blackberry устройствах в app.icf сборки необходимо добавить следующие строки:
<pre>
[Game]
inappTest=1
</pre>
inappTest=1 - all in-app in test mode, 0 - default

===Тестирование покупок из редактора на Viewer===
Для тестирования покупок на Viewer-е в app.icf необходимо добавить следующие строки:
<pre>
[Game]
purchaseEverything=1
</pre>

[[Category:Options]]

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

2017-12-08T10:20:28Z

Vlegkun: /* Steam */

{{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.

=Submit Facebook=
После каждого добавления новых постов ( лвл-апы, пост аччивок) нужно пройти проверку от Facebook. Для этого все посты настраиваются в админке, собирается версия на webfb релиз(если посты содержат новую графику) и отдаются две версии приложения на проверку. Два приложения - ios и google, должны соблюдать требования:
:должны состоять из одного файла (apk,ipa - без obb файла);
:посты должны отсылаться без проверки разрешений (пермишенов); Для этого в app.icf указываем в теге [s3eFacebook] параметр с значением: "DonotCheckAppPermision=1"

=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.

=Одноклассники=
*Значение переменной market = "webok".
*В проекте весь интерфейс, тексты должны быть на Русском. В app.icf указываем lang="ru".
*В проекте должна быть отключена возможность смены языка ( всегда должен быть Русский).
*На иконках постов, игровых картинках не должно быть надписей на иностранном языке ( в проекте если market="webok" меняем некот. графику) .
*Иконки пользователей в социальных окнах должны вписываться ( в объекте image указываем параметр тайлинг="вписать"), т.к. одноклассники отдают нам не квадратные иконки.
*Тексты постов, уведомлений - д.б. на Русском.
*В проекте не д.б. внешних ссылок, кроме как отправить письмо и ссылки на группы в Одноклассниках.
*В проекте не д.б. иконок других соцсетей.
*Для корректной работы курсора нужно указать его для каждого экрана в проекте, а также поместить на расшаренной сцене с альфой = 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.

=Steam=
*Значение переменной market = "steam".
*Экспортируется как обычная виндовая версия win_abs.
*Для отображения сплеш скрина компании рядом с .exe файлом должен лежать файл default.dat. Создается он следующим образом:
- 1. В папке ..\project\icons\splash выбирается иконка размера 1024*768.
- 2. Через paint эта картинка сохраняется как .bmp.
- 3. И переименовывается на default.dat.
Либо вариант видео: в кофиги платформы добавить файл splash.ogv.
Еще в app.icf в группе Game указать fullScreenOnStart=1.
*Для запуска приложения также рядом с .exe файлом должен лежать файл steam_appid.txt, содержащий только id приложения (просто число, без "id=" и т.д.). Этот id дают маркетологи. А вообще его нужно положить в конфигурациях .....\project\platforms\win_abs. При сборке он подтянется.
*Объект Facebook не функционален. Сделать картинкой для улучшения производительности.
*Объект Advertisement тоже сделать картинкой.
*Вся графика проекта должна находится в нулевом паке.
*Удалить из проекта все ссылки на absolutist.com и другие ресурсы, куда может перейти пользователь и купить игры вне Steam.

[[Category:Projects]]

Script Game

2017-11-21T08:10:05Z

Vlegkun:

[[Object|Объект]] '''JSGame''' служит для встраивания иигр, написанных на языке Java Script, в редактор

=Свойства=

*'''иконка ресурса 1''' - Графический ресурс иконки монет.
*'''иконка ресурса 2''' - Графический ресурс иконки кристаллов

==Ссылки на объекты==

[[Файл:Eitems.jpg|right]]
*'''economics''' - Ссылка на объект economics.

*'''таблица''' - Ссылка на таблицу, где будут размещаться шаблоны.

==Ссылки на объекты 1==

[[Файл:Eitems.jpg|right]]
*'''economics''' - Ссылка на объект economics.

*'''таблица''' - Ссылка на таблицу, где будут размещаться шаблоны.
=Взаимодействие объекта с вьювером=
В данном разделе описан протокол обмена сообщениями между вьювером и объектом

Script Game

2017-11-21T08:09:21Z

Vlegkun:

[[Object|Объект]] '''JSGame''' служит для встраивания миниигр, написанных на языке Java Script, в редактор

=Свойства=

*'''иконка ресурса 1''' - Графический ресурс иконки монет.
*'''иконка ресурса 2''' - Графический ресурс иконки кристаллов

==Ссылки на объекты==

[[Файл:Eitems.jpg|right]]
*'''economics''' - Ссылка на объект economics.

*'''таблица''' - Ссылка на таблицу, где будут размещаться шаблоны.

==Ссылки на объекты 1==

[[Файл:Eitems.jpg|right]]
*'''economics''' - Ссылка на объект economics.

*'''таблица''' - Ссылка на таблицу, где будут размещаться шаблоны.
=Взаимодействие объекта с вьювером=
В данном разделе описан протокол обмена сообщениями между вьювером и объектом

Script Game

2017-11-21T08:08:47Z

Vlegkun:

Script Game

2017-11-21T08:07:56Z

Vlegkun:

Script Game

2017-11-21T08:05:48Z

Vlegkun:

Script Game

2017-11-21T08:05:30Z

Vlegkun:

[[Object|Объект]] '''JSGame''' служит для встраивания миниигр, написанных на языке Java Script в редактор

=Свойства=

*'''иконка ресурса 1''' - Графический ресурс иконки монет.
*'''иконка ресурса 2''' - Графический ресурс иконки кристаллов

==Ссылки на объекты==

[[Файл:Eitems.jpg|right]]
*'''economics''' - Ссылка на объект economics.

*'''таблица''' - Ссылка на таблицу, где будут размещаться шаблоны.

==Ссылки на объекты 1==

[[Файл:Eitems.jpg|right]]
*'''economics''' - Ссылка на объект economics.

*'''таблица''' - Ссылка на таблицу, где будут размещаться шаблоны.
=Свойства=

Absolutist Framework

2017-11-21T08:02:23Z

Vlegkun: /* 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-скриптов]]
* [[Подготовка версии для Viber]]
* [[Проверка подгрузки текстур]]
* [[Экспорт проекта]]

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

=== 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]] - машина состояний
** [[Файл:Mwindow.png]] - [[Mwindow]] - машина состояний - окно
* [[Файл: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]] - создание мини-карты для отображения прогресса прохождения игры.
* [[Файл:Statesmanager_ico.png]] - [[Statesmanager]] - очередь работы с объектами
* [[Файл:Slider icons.png]] - [[Slider]] - объект реализующий листание списка.
* [[Файл:Ribbon.png]] - [[Ribbon]] - объект отображения графики по сплайну
* [[Файл:Kub.png]] - [[Animation]] - объект различных анимаций
* [[Файл:Kub.png]] - [[Magicparticles]] - объект файлов Magic Particles
* [[Файл:Kub.png]] - [[puzzle3D]] - 3D паззл
* [[Файл:Kub.png]] - [[3D-object]] - 3D объект

=== Game mechanic ===

* [[Файл:Kub.png]] - [[Avoider]] - эвойдер
* [[Файл:Kub.png]] - [[Battle]] - боевка
* [[Файл: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]] - "коллекция" поисковых объектов для хидден игр
* [[Файл:Kub.png]] - [[Color Switch]] - механика игры Color Switch
* [[Файл: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]] - шаблон задачи для таблицы темплейтов.
*** [[Файл:Kub.png]] - [[Elogbooktemplate]] - шаблон отображения ячейки логбука.
** [[Файл: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]] - объект шаблона ячейки с животным.
* [[Файл:Kub.png]] - [[CakeTower]] - объект шаблона ячейки с животным.
* [[Файл:Kub.png]] - [[Pentamino]] - механика игры в [https://ru.wikipedia.org/wiki/%D0%9F%D0%B5%D0%BD%D1%82%D0%B0%D0%BC%D0%B8%D0%BD%D0%BE пентамино]
* [[Файл:Kub.png]] - [[TapTheNew]]
* [[Файл:Kub.png]] - [[Dressing]] - гардероб.
** [[Файл:Kub.png]] - [[Dressingtemplate]] - объект шаблона гардероба.
* [[Файл:Kub.png]] - [[solitaire]] - солитер

* [[Файл:digitz.png]] - [[Digitz]] - механика игры Digitz.
* [[Файл:Kub.png]] - [[Wordsearch]] - механика поиска слов на поле
* [[Файл:Kub.png]] - [[Builder]] - механика типа фермы
** [[Файл:Kub.png]] - [[Builderitem]] - объект шаблона здания
** [[Файл:Kub.png]] - [[Buildercomponent]] - шаблон материала для апгрейда здания
* [[Файл:Kub.png]] - [[Java Script Game]] - Java Script Game

=== 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]] - объект для отправки событий
* [[Файл:Kub.png]] - [[Errormanager]] - менеджер ошибок
* [[Файл:Kub.png]] - [[Multiplayer]] - объект мультиплеера

=== 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
* [[Файл:Kub.png]] - [[ShareDialog]] - объект для вызова окна шаринга в другие приложения устройства

=== Functions ===
* [[Файл:Forward.png]] - [[SendMail]] - отправка письма через почтовый клиент
* [[Файл:footer-icon-rate.png]] - [[Rate]] - вызов окна оценки приложения

----
[[Файл:!.png]] - [[Правила оформления]] - Требование к описанию объектов.
----
<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]]

Script Game

2017-11-21T07:59:55Z

Vlegkun:

[[Object|Объект]] '''JSGame''', служит для связи инвентаря(магазина) и экономики

=Свойства=

*'''иконка ресурса 1''' - Графический ресурс иконки монет.
*'''иконка ресурса 2''' - Графический ресурс иконки кристаллов

==Ссылки на объекты==

[[Файл:Eitems.jpg|right]]
*'''economics''' - Ссылка на объект economics.

*'''таблица''' - Ссылка на таблицу, где будут размещаться шаблоны.

==Ссылки на объекты 1==

[[Файл:Eitems.jpg|right]]
*'''economics''' - Ссылка на объект economics.

*'''таблица''' - Ссылка на таблицу, где будут размещаться шаблоны.

Script Game

2017-11-21T07:51:04Z

Vlegkun: