Options

Материал из wiki.appsalutecreator.com
Версия от 12:19, 15 сентября 2014; Lkunica (обсуждение | вклад) (Добавляемые параметры)
Перейти к: навигация, поиск

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

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

Смотреть описание Object.

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

Opt2.jpg
  • язык (lang) - Язык, принудительно используемый приложением.
  • url обновлений (surl) - url, по которому ищем обновления опций.
  • sound (sound) - Громкость звука:
1 - максимальный,
0 - отключен.
  • music (music)- Громкость музыки:
1 - максимальная,
0 - отключена.
  • voice (voice) - Голос рассказчика:
0 - отключен,
не 0 - включен.
  • курсор (curs) - Графический ресурс курсора по умолчанию для всего проэкта.
  • page (page) - Номер страницы для книги.
  • fullScreen (fullScreen) - Полноэкранный режим, используется в приложениях для PC:
1 - на весь экран,
0 - в окне.
  • immersive mode (immersive) -
  • activity (activity) - Графический ресурс для индикатора загрузки. Перетаскивается мышкой из редактора ресурсов (поле должно находиться в состоянии редактирования).
  • first loading bg (fl_bg) - Графический ресурс для индикатора загрузки. Перетаскивается мышкой из редактора ресурсов (поле должно находиться в состоянии редактирования).
  • first loading bar (fl_bar) - Графический ресурс для индикатора загрузки. Перетаскивается мышкой из редактора ресурсов (поле должно находится в состоянии редактирования).
  • show progress (progr) - 1 - Отображать не только крутилку activity, но и прогрессбар (кастомный или беленький программный).
  • loading bg (res_bg) - Графический ресурс для индикатора загрузки. Перетаскивается мышкой из редактора ресурсов (поле должно находиться в состоянии редактирования).
  • loading bar (res_bar) - Графический ресурс для индикатора загрузки. Перетаскивается мышкой из редактора ресурсов (поле должно находится в состоянии редактирования).
  • поле ввода (edit) - Объек типа edit, из которого будет браться имя при добавлении/редактировании профилей (состояние add у опций).
  • таблица (table) - Объект типа table, в который мы будем складывать все профиля (состояние update у опций).
  • разрешить рекламу (ad) - Разрешить или нет показ рекламы объектом Advertisement:
1 - разрешить,
0 - запретить

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

Opt.jpg

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


+.png ввод пустого имени - При попытке добавить пустое имя состоянием add будет изменено состояние заданного объекта.

  • объект - При попытке добавить пустое имя перевести объект в состояние из следующего поля.
  • состояние - Новое состояние для объекта из предыдущего поля.


+.png ввод существующего имени - Когда будет введено существующее имя, изменить состояние заданного объекта.

  • объект - Когда будет введено существующее имя, перевести объект в состояние из следующего поля.
  • состояние - Новое состояние для объекта из предыдущего поля.


+.png Android - кнопка Back - При нажатии на кнопку перевести объект в новое состояние.

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


+.png Android - кнопка Menu - При нажатии на кнопку перевести объект в новое состояние.

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


+.png Windows - кнопка ESC - При нажатии на кнопку перевести объект в новое состояние.

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


+.png Обновление с сервера - успех - При успешном обновлении опций с сервера перевести объект в новое состояние.

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


+.png Обновление с сервера - ошибка - При ошибочном обновлении опций с сервера перевести объект в новое состояние.

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


+.png Возврат из паузы - При возврате из паузы перевести объект в новое состояние.

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


+.png Переход в полноэкранный режим - При переходе в полноэкранный режим перевести объект в новое состояние.

  • объект - При переходе в полноэкранный режим перевести объект в состояние из следующего поля.
  • состояние - Новое состояние для объекта из предыдущего поля.


+.png Возврат из полноэкранного режима - При выходе из полноэкранного режима перевести объект в новое состояние.

  • объект - При выходе из полноэкранного режима перевести объект в состояние из следующего поля.
  • состояние - Новое состояние для объекта из предыдущего поля


!!! Если в машине, которая вызывается по нажатию на Android-кнопку, есть обращение к опциям, то это обращение нужно писать в другом
состоянии, через команду '''wait'''
!!! Машину, которая вызывается по нажатию на Android-кнопку, нужно размещать на расшариной сцене, если в ней есть команда '''wait'''
потому, что эта команда работает, если прописана на текущем экране, а не на фоновом (глобальном, не текущем).

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

  • rlang - Текущий язык устройства, если не указан принудительно какой-либо язык (параметр lang).
  • r_install - Дата и время установки в секундах.
  • r_hours - Время прошедшее с момента установки в часах.
  • r_playtime - Время нахождения в игре в минутах.
  • r_launches - Количество запусков игры.
  • r_days - Сколько дней подряд запускалась игра, если пропускается хотя бы день, то сбрасывается.
  • r_lastlaunch - Дата и время последнего запуска в секундах.
  • downloadErrCode - Код ошибки возвращаемый при неудачной загрузке:
1 - неизвестная ошибка (возможно нет интернета),
2 - отключён wi-fi,
3 - недоступна карта памяти,
4 - недостаточно места на карте памяти для загрузки,
5 - ошибка при распаковке архива (чаще всего, не хватает места для распаковки архива).
  • reloadScrID - id экрана, на который мы перейдем после перегрузки лейаута. Перегрузка вызывается в команде init в машине состояний.
  • curScrID - id текущего экрана.
  • prevScrID - id предыдущего экрана.

Состояния

Объект Options обладает рядом состояний:

  • init - Инициализация опций.
  • add - Добавить новый профиль из заданного поля ввода и сделать его текущим.
  • update - Заполнить заданную таблицу списком профилей.
  • change - Сменить профиль на выбранный на данный момент в таблице.
  • delete - Удалить выбранный профиль.
  • generate - Генерирует имя профиля по умолчанию при создании нового профиля.
  • save - Сохранение всех параметров в опции. Это состояние вызывается автоматически при переходе между экранами, выгрузки и закрытии приложения. При его вызове приложение физически открывает файл options.xml и записывает туда данные. Частое обращение к этому файлу снизит быстродействие нашего приложения.
  • edit - С текущего поля ввода считывает имя и устанавливает его для текущего профиля.
  • reset - Заменяет файл Options файлом Options_default, то есть сбрасываются все параметры и устанавливаются все параметры по умолчанию
  • clear_cur_player (такого состояния нет, требует правки) - Удаляет весь текущий прогресс по выбранному профилю, таким образом можно организовать прохождение игры заново для одного и того же профиля.
  • delete_node - Удаляет ноду в опциях, вычитав ее название из поля param.

Пример