Options — различия между версиями
Lkunica (обсуждение | вклад) (→Основные параметры) |
Lkunica (обсуждение | вклад) (→Дополнительные стандартные параметры) |
||
Строка 74: | Строка 74: | ||
== Дополнительные стандартные параметры == | == Дополнительные стандартные параметры == | ||
− | * '''rlang''' - Текущий язык устройства, если не указан принудительно какой либо язык(параметр ''lang'') | + | * '''rlang''' - Текущий язык устройства, если не указан принудительно какой-либо язык (параметр ''lang''). |
* '''r_install''' - Дата и время установки в секундах. | * '''r_install''' - Дата и время установки в секундах. | ||
* '''r_hours''' - Время прошедшее с момента установки в часах. | * '''r_hours''' - Время прошедшее с момента установки в часах. | ||
Строка 81: | Строка 81: | ||
* '''r_days''' - Сколько дней подряд запускалась игра, если пропускается хотя бы день, то сбрасывается. | * '''r_days''' - Сколько дней подряд запускалась игра, если пропускается хотя бы день, то сбрасывается. | ||
* '''r_lastlaunch''' - Дата и время последнего запуска в секундах. | * '''r_lastlaunch''' - Дата и время последнего запуска в секундах. | ||
− | * '''downloadErrCode''' - Код ошибки возвращаемый при неудачной загрузке | + | * '''downloadErrCode''' - Код ошибки возвращаемый при неудачной загрузке: |
− | * '''reloadScrID''' - id экрана на который мы перейдем после перегрузки лейаута. Перегрузка вызывается в команде init в машине состояний. | + | :'''1''' - неизвестная ошибка (возможно нет интернета), |
− | * '''curScrID''' - id текущего экрана | + | :'''2''' - отключён wi-fi, |
− | * '''prevScrID''' -id предыдущего экрана | + | :'''3''' - недоступна карта памяти, |
+ | :'''4''' - недостаточно места на карте памяти для загрузки, | ||
+ | :'''5''' - ошибка при распаковке архива (чаще всего, не хватает места для распаковки архива). | ||
+ | * '''reloadScrID''' - id экрана, на который мы перейдем после перегрузки лейаута. Перегрузка вызывается в команде init в машине состояний. | ||
+ | * '''curScrID''' - id текущего экрана. | ||
+ | * '''prevScrID''' - id предыдущего экрана. | ||
== Состояния == | == Состояния == |
Версия 12:07, 15 сентября 2014
Options - тип объекта, который используется для хранения и управления глобальными параметрами приложения. Так же Options позволяет хранить и использовать параметры записанные в него другими объектами.
Содержание
Общие параметры
Смотреть описание Object.
Основные параметры
- язык (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 - запретить
Добавляемые параметры
Меню выбора Добавляемые параметры к объектам активируется по нажатию правой кнопки мыши.
ввод пустого имени - При попытке добавить пустое имя состоянием add будет изменено состояние заданного объекта.
- объект - При попытке добавить пустое имя перевести объект в состояние из следующего поля.
- состояние - Новое состояние для объекта из предыдущего поля.
Android - кнопка Back - При нажатии на кнопку перевести объект в новое состояние.
- объект - При клике на кнопку перевести объект в состояние из следующего поля.
- состояние - Новое состояние для объекта из предыдущего поля.
Android - кнопка Menu - При нажатии на кнопку перевести объект в новое состояние.
- объект - При клике на кнопку перевести объект в состояние из следующего поля.
- состояние - Новое состояние для объекта из предыдущего поля.
Windows - кнопка ESC - При нажатии на кнопку перевести объект в новое состояние.
- объект - При клике на кнопку перевести объект в состояние из следующего поля.
- состояние - Новое состояние для объекта из предыдущего поля.
Обновление с сервера - успех - При успешном обновлении опций с сервера перевести объект в новое состояние.
- объект - объект - состояние которого меняем.
- состояние - Новое состояние для объекта из предыдущего поля.
Обновление с сервера - ошибка - При ошибочном обновлении опций с сервера перевести объект в новое состояние.
- объект - объект - состояние которого меняем.
- состояние - Новое состояние для объекта из предыдущего поля.
!!! Если в машине, которая вызывается по нажатию на 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.