Cloud
Объект необходим для синхронизации приложения с облаком.
Содержание
Параметры объекта Cloud
parse general
- app - Код приложения из parse
- key - Ключ приложения из parse
- имя игры - Наше внутреннее имя игры в parse
- имя игрока - Имя игрока. Заполнить до любых вызовов состояний
- cloud major field - Главное поле в опциях, по которому будет выбираться версия опций в cloud при кофликте (наибольшее из значений будет приоритетнее)
- автоприменение - Применять лучшие опции автоматически. Если "нет" то нужно подтверждение пользователя.
- esocial - объект типа esocial для получения списка друзей.
- повторять лоад раз - количество повторов parse_load при неуспехе, если не отсутствие интернета.
- автолоад - автоматически вызывать parse_load при логине в социальной сети.
parse leaderboards
- лидерборд - id таблицы на сервере, в которую будет засылать очки. Начинается с латинской буквы! Не содержит левых символов!
- очки - Очки для отправки. Валидное целое число!
- таблица - объект-таблица, в который сложим очки. Должна иметь три колонки (место-имя-очки), заполнение по строкам - в случае если не указан "шаблон".
- шаблон - объект типа leaderboardsitem для помещения в таблицу
- свое место - каунтер в котором будет место игрока
- свои очки - каунтер в котором будут очки игрока
- запрашивать записей - сколько записей запросить из таблицы
- специальная сортировка ( special_sort ) - специальная сортировка, по лвлу ( задаём "1" когда открываем лидерборды глобальные/ друзей; ставим "0" в лидерах монстров/локаций)
Настройка <property name="анимация смены мест" type="enum" value="0" min="0" max="1" id="lb_anim" hint="Анимация смены мест игроком" regexp="нет=0, да=1"/> Работает только с друзьями.
Добавляемые параметры
ошибка загрузки данных из cloud: изменить состояние объекта - сейчас не применяется, т.к. используем ErrorManager.
- объект - объект у которого мы меняем состояние.
- состояние - Значение нового состояния.
нечего загружать из cloud: изменить состояние объекта - обработчик неуспеха parse_load в случае отсутствия данных на сервере.
- объект - объект у которого мы меняем состояние.
- состояние - Значение нового состояния.
подтверждение применения данных из cloud: изменить состояние объекта - обработчик успеха parse_load в случае наличия данных на сервере с таким же device_id
- объект - объект у которого мы меняем состояние.
- состояние - Значение нового состояния.
применены данные из cloud: изменить состояние объекта - обработчик успеха parse_apply, желательно перегрузить лайаут.
- объект - объект у которого мы меняем состояние.
- состояние - Значение нового состояния.
подтверждение применения данных из cloud при наличии двух комплектов данных в сети: изменить состояние объекта - обработчик успеха parse_load в случае наличия двух комплектов данных на сервере (например, по facebook_id)
- объект - объект, состояние которого меняем.
- состояние - новое состояние для объекта из предыдущего поля.
в cloud опции хуже, не применям их: изменить состояние объекта - обработчик неуспеха parse_load в случае, когда данные на сервере хуже, чем на текущем устройстве.
- объект - объект, состояние которого меняем.
- состояние - новое состояние для объекта из предыдущего поля.
голосование загружено: изменить состояние объекта
- объект - объект, состояние которого меняем.
- состояние - новое состояние для объекта из предыдущего поля.
успешно проголосовали: изменить состояние объекта
- объект - объект, состояние которого меняем.
- состояние - новое состояние для объекта из предыдущего поля.
запрос в парсе успешно выполнен (любой) - обработчик успеха любого запроса.
- объект - объект, состояние которого меняем.
- состояние - новое состояние для объекта из предыдущего поля.
ошибка, нужно обновить приложение - обработчик неуспеха parse_load, когда версия текущего приложения ниже, чем версия опциях на сервере.
- объект - объект, состояние которого меняем.
- состояние - новое состояние для объекта из предыдущего поля.
успешно проведен серверный resolve - обработчик успеха parse_apply_server, желательно перезагрузить лэйаут.
- объект - объект, состояние которого меняем.
- состояние - новое состояние для объекта из предыдущего поля.
успешно проведена изоляция - обработчик успеха parse_isolate.
- объект - объект, состояние которого меняем.
- состояние- новое состояние для объекта из предыдущего поля.
успешно проведена разизоляция - обработчик успеха parse_un_isolate.
- объект - объект, состояние которого меняем.
- состояние - новое состояние для объекта из предыдущего поля.
синхронизируемый параметр между приложениями устройства - позволяет синхронизировать конкретный параметр между разными приложениями через parse.
- группа - имя группы, общее для различных приложений, которые синхронизируют данный параметр
- параметр - имя параметра в группе, общее для различных приложений
- объект - объект у которого синхронизируем параметр.
- параметр объекта - параметр который синхронизируем.
невозможно загрузить лидерборды из-за objectId - обработчик ошибки загрузки лидербордов, которая происходит при неуспехе parse_load (в этом случае parse_load желательно повторить)
- объект - объект, состояние которого меняем,
- состояние - состояние - значение нового состояния.
Особенности использования
Есть несколько платформ, которые не поддерживают работу с фейсбуком. Это blackberry, win 8.1, windows phone 8. При этом эти устройства могут взаимодействовать с клаудом. При этом есть ряд проблем с этими платформами: каждый пользователь будет отправлять свои результаты в лидерборды под ником new_user (или другим дефолтным); не до конца прозрачна ситуация с включением/отключением изоляции игроков. Для того, что бы отключить сохранение в клауд для этих платформ нужно установить в опциях флаг disable_cloud_save = 1. Опросник при этом работает нормально.
Состояния
- parse_load - загружает из облака опции
- parse_save - сохраняет опции в клауд. Автоматически сохраняется при переходе с экрана на экран и при выходе из приложения.
- parse_apply - применяет загруженные опции при условии совпадения по device_id.
- parse_apply_server - выбирает лучшие и применяет опции при условии наличии на сервере двух наборов.
- parse_isolate - проводит изоляцию опций (сохраняет 2 набора).
- parse_un_isolate - проводит объединение опций.
- parse_leaderboards - заполняет таблицу глобальных лидербордов.
- parse_leaderboards_friends - заполняет таблицу лидербордов-друзей.
- parse_friends - заполняет таблицу парсовых друзей для отправки подарков.
- parse_submit - отправляет очки в клауд. Предварительно нужно записать кол-во очков в параметр score.
- parse_get_public_lb - показывает информацию о друге из таблицы лидербордов.
- parse_poll - загружает опросник.
- parse_vote - отправляет голос в опроснике.
- parse_poll_prev - загружает результаты предыдущего опросника.
Сообщения в лог
Объект пишет в опции строки: I/GCloud GCloud::state() state val = 2 state = 3
Где val = 2 - это состояние в которое хотим перейти в дальнейшем ( в зависимости от текущего состояния, или сстанет в очередь или выполниться следующим тиком).
- state = 3 - это состояние в котором сейчас находиться объект;
Номера состояний:
- 0 - ST_LOCAL_DEVICE_SYNCHRONIZATION //!< синхронизация параметров между приложениями одного устройства;
- 1 - ST_PARSE_RESOLVE //!< ресолвим конфликт и ждем подтверждения;
- 2 - ST_PARSE_IDLE //!< состояние простоя, означает, что мы не ждем ответа ни на один запрос;
- 3 - ST_PARSE_LOAD //!< загрузить опции из парса (вызываться должно снаружи, после ввода имени) ;
- 4 - ST_PARSE_SAVE //!< сохранить опции в парс c учетом предохранительной задержки SAVE_DELAY_SEC (на 2014-09-17 вызывается из единственного места - GOptions::save);
- 5 - ST_PARSE_LEADERBOARDS //!< загрузить лидерборды из парса и сложить в соответствующую таблицу;
- 6 - ST_PARSE_LEADERBOARDS_FRIENDS //!< загрузить лидерборды из парса и сложить в соответствующую таблицу;
- 7 - ST_PARSE_SUBMIT //!< заслать очки в парс взяв очки из поля score и уровень из поля level;
- 8 - ST_PARSE_APPLY //!< применить скачанные опции;
- 9 - ST_GET_PUBLIC_LB //!< скопировать паблик данные кликнутого юзера из лидербордов в доступную область;
- 10 - ST_PARSE_POLL //!< получить данные о текущем опроснике от клауда. Заполнить таблицу ответов;
- 11 - ST_PARSE_POLL_PREV //!< получить данные о предыдущем опроснике от клауда. Заполнить таблицу ответов №2;
- 12 - ST_PARSE_VOTE //!< проголосовать в текущем опроснике (номер ответа возьмем из таблицы) TODO - не нужно ли состояний против и за?;
- 13 - ST_PARSE_SHARE_POLL //!< зашарить результаты текущего опроса;
- 14 - ST_PARSE_FORCED_SAVE //!< сохранить опции в парс незамедлительно (на 2014-09-17 вызывается из единственного места - GOptions::save);
- 15 - ST_PARSE_APPLY_SERVER //!< применить опции и отправить ресолв;
- 16 - ST_PARSE_CLEAR_NOTIFICATIONS //!< отписаться от уведомлений;
- 17 - ST_PARSE_ADD_NOTIFICATION //!< добавить уведомление (не требует действий с сетью, реальная отправка - по потере фокуса);
- 18 - ST_PARSE_TIME //!< запросить время;
- 19 - ST_PARSE_FRIENDS //!< заполнить таблицу всех друзей (новые подарки);
- 20 - ST_PARSE_ISOLATE //!< отказаться от слияния аккаунтов;
- 21 - ST_PARSE_UN_ISOLATE //!< отменить изоляцию
Коды ошибок:
- 6 - опрос закончился;
- 7 - ошибка версионности;
- 1000 - отсутсвие интернета.
В прочих случаях код ошибки будет 2000 + номер состояния, т.е. для лоада, например ошибка будет 2000 + 3 = 2003
Дополнительно клауд будет отправлять коды ошибок по таймауту ( превышению времени ответа - сейчас равен 60 сек): 4000 + номер состояния, т.е. для запроса лидербордов, например ошибка будет 4000 + 5 = 4005 ( глобальные) или 4000 + 6 = 4006 (друзья)