Options — различия между версиями

Материал из wiki.appsalutecreator.com
Перейти к: навигация, поиск
м
м
Строка 18: Строка 18:
 
:'''0''' - отключен,
 
:'''0''' - отключен,
 
:'''не 0''' - включен.
 
:'''не 0''' - включен.
*'''курсор''' ''(curs)'' - Графический ресурс курсора по умолчанию для всего проэкта.
+
*'''курсор''' ''(curs)'' - Графический ресурс курсора по умолчанию для всего проекта.
 
*'''page''' ''(page)'' - Номер страницы для книги.
 
*'''page''' ''(page)'' - Номер страницы для книги.
 
*'''fullScreen''' ''(fullScreen)'' - Полноэкранный режим, используется в приложениях для PC:  
 
*'''fullScreen''' ''(fullScreen)'' - Полноэкранный режим, используется в приложениях для PC:  
Строка 30: Строка 30:
 
*'''loading bg''' ''(res_bg)'' - Графический ресурс для индикатора загрузки. Перетаскивается мышкой из редактора ресурсов (поле должно находиться в состоянии редактирования).
 
*'''loading bg''' ''(res_bg)'' - Графический ресурс для индикатора загрузки. Перетаскивается мышкой из редактора ресурсов (поле должно находиться в состоянии редактирования).
 
*'''loading bar''' ''(res_bar)'' - Графический ресурс для индикатора загрузки. Перетаскивается мышкой из редактора ресурсов (поле должно находится в состоянии редактирования).
 
*'''loading bar''' ''(res_bar)'' - Графический ресурс для индикатора загрузки. Перетаскивается мышкой из редактора ресурсов (поле должно находится в состоянии редактирования).
*'''поле ввода''' ''(edit)'' - Объек типа edit, из которого будет браться имя при добавлении/редактировании профилей (состояние add у опций).
+
*'''поле ввода''' ''(edit)'' - Объект типа edit, из которого будет браться имя при добавлении/редактировании профилей (состояние add у опций).
 
*'''таблица''' ''(table)'' - Объект типа table, в который мы будем складывать все профиля (состояние update у опций).
 
*'''таблица''' ''(table)'' - Объект типа table, в который мы будем складывать все профиля (состояние update у опций).
 
*'''разрешить рекламу''' ''(ad)'' - Разрешить или нет показ рекламы объектом [[Advertisement]]:
 
*'''разрешить рекламу''' ''(ad)'' - Разрешить или нет показ рекламы объектом [[Advertisement]]:
Строка 145: Строка 145:
 
[[Файл:Opt 5.jpg]]
 
[[Файл:Opt 5.jpg]]
  
2. Cменить язык <br>
+
2. Сменить язык <br>
 
Организовывается с помощью объектов типа ''"groupbox"'' и ''"checkbox"'':<br>
 
Организовывается с помощью объектов типа ''"groupbox"'' и ''"checkbox"'':<br>
  
 
[[Файл:Opt 6.jpg]]
 
[[Файл:Opt 6.jpg]]
  
Благодаря такой коснтрукции при выборе одного (в данном случае) языка снимается галочка со второго. В самом чекбоксе следует прописать следующее:<br>
+
Благодаря такой конструкции при выборе одного (в данном случае) языка снимается галочка со второго. В самом чекбоксе следует прописать следующее:<br>
  
 
[[Файл:Opt 7.jpg]]
 
[[Файл:Opt 7.jpg]]
  
Изначально следует проверить язык устройства и установить соответсвующий чекбокс:<br>
+
Изначально следует проверить язык устройства и установить соответствующий чекбокс:<br>
  
 
[[Файл:Opt 8.jpg]]
 
[[Файл:Opt 8.jpg]]

Версия 11:25, 23 сентября 2014

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.

Примеры

Рассмотрим маленькие примеры, которые часто встречаются в окнах с настройками игры.

Opt 4.jpg

1. Отправить письмо

Для объекта типа "button" следует прописать следующее:

Opt 5.jpg

2. Сменить язык
Организовывается с помощью объектов типа "groupbox" и "checkbox":

Opt 6.jpg

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

Opt 7.jpg

Изначально следует проверить язык устройства и установить соответствующий чекбокс:

Opt 8.jpg

Пример