Facebook — различия между версиями
Igood (обсуждение | вклад) |
(→Добавляемые параметры) |
||
(не показано 26 промежуточных версий 8 участников) | |||
Строка 1: | Строка 1: | ||
− | Объект | + | {{TOC right}} |
+ | [[Object|Объект]] '''Facebook''' помогает нам запостить на страничку информацию о приложении. | ||
− | + | == Общие параметры == | |
+ | |||
+ | *'''имя''' - Имя объекта Facebook в дереве проекта. Может быт произвольным. | ||
+ | *'''id-объекта''' - Уникальный номер объекта Facebook, который можно увидеть при наведении курсора на строку "имя". | ||
+ | *'''синхронизация''' - Применяется для синхронизации между лейаутами. Если указан параметр "нет", то объект будет активен только на текущем лейауте. По умолчанию указан параметр "да". | ||
+ | *'''сохранение параметров''' - Настройка этого параметра актуальна, если приложение в дальнейшем будет сворачиваться в системную панель («трей»). Выбирается значение этого параметра из выпадающего списка. Возможны следующие варианты: "нет", "только объект", "объект с подобъектами", "только подобъекты". При выходе из трэя будут восстановлены ранее измененные/установленные (при переходе с одного экрана на другой)параметры объектов или подобъектов в зависимости от выбранного варианта для этого параметра. По умолчанию указан параметр "нет". Следует помнить, что если выбирается для объекта некоторой сцены значения этого параметра отличное от "нет", то должно и предусматриваться соответствующее значение этого параметра и для этой сцены, и для экрана, содержащего эту сцену. | ||
+ | |||
+ | |||
+ | == Основные параметры == | ||
+ | |||
+ | *'''ID приложения''' - ID приложения на фейсбуке. | ||
+ | *'''Пароль к приложению''' - Пароль к приложению на фейсбуке. | ||
+ | |||
+ | |||
+ | '''Группа - вложения''' | ||
+ | |||
+ | *'''заголовок''' - Заголовок вложения. | ||
+ | *'''ссылка заголовка''' - URL по которому перейдем при нажатии на заголовок (ссылка по которой мы перейдём если нажмём на заголовок в окне запроса). | ||
+ | *'''подзаголовок''' - Подзаголовок вложения. | ||
+ | *'''описание''' - Описание. | ||
+ | *'''текст перед ссылками''' - Текст перед остальными ссылками. | ||
+ | *'''имя ссылки''' - Имя ссылки. | ||
+ | *'''ссылка''' - URL ссылки. | ||
+ | *'''картинка кнопки''' - URL картинки для рисования кнопки ( иконку которую запостим на стену). | ||
+ | *'''ссылка кнопки''' - URL по которому перейдем при нажатии на кнопку (ссылка по которой мы перейдём если нажмём на картинку в окне запроса). | ||
+ | |||
+ | |||
+ | '''Состояние''' | ||
+ | |||
+ | *'''send_to_wall''' - Состояние, в которое нужно перевести объект Facebook, чтобы запостить на стене информацию. | ||
+ | *'''login''' - залогиниться | ||
+ | *'''logout''' - разлогиниться | ||
+ | |||
+ | == Добавляемые параметры == | ||
+ | |||
+ | Меню выбора ''Добавляемые параметры'' к объектам активируется по правой кнопки мыши. | ||
+ | |||
+ | [[Файл:+.png]] '''изменить состояние объекта при ошибке''' | ||
+ | *'''объект''' - При ошибке шаринга в фейсбук перевести объект в состояние из следующего поля. | ||
+ | *'''состояние''' - Новое состояние для объекта из предыдущего поля. | ||
+ | |||
+ | [[Файл:+.png]] '''изменить состояние объекта при доступности промо акции''' (payer promotion) | ||
+ | *'''объект''' - машинка. | ||
+ | *'''состояние''' - состояние. | ||
+ | |||
+ | Payer promotion существует для того, чтобы игрок подвязал свою карту на facebook. Игроку предлагается существующая покупка за $0.00. | ||
+ | Для этого, если платформа фейсбук, объекту facebook отправляется запрос get_is_eligible_promo. Если игрок еще не привязал карту, срабатывает обработчик '''изменить состояние объекта при доступности промо акции''' и переводит машину в указанное состояние, к примеру, для того, чтобы показать акцию, стоимость покупки которой будет = 0. | ||
+ | Кнопке инаппа в окне промо акции, добавить запрос eligible_promo объекту facebook. | ||
+ | По нажатию на кнопку, появится системное окно со сторовским описанием акции и ценой $0.00. | ||
+ | |||
+ | == Пример использования== | ||
+ | |||
+ | Для использования объекта Facebook нам понадобится "App ID" и "App Secret" приложения, о котором будем постить информацию. Подгружаются они из текстовой базы. Поля '''ID приложения''' и '''Пароль к приложению''' должны быть в состоянии редактирования. | ||
+ | |||
+ | [[Файл:fb2.jpg]] | ||
+ | |||
+ | Далее создается кнопка, которая сообщает объекту "facebook", что ему нужно запостить наше приложение. Для этого кнопка должна изменить состояние "facebook" на "send_to_wall". | ||
[[Файл:facebook.jpg]] | [[Файл:facebook.jpg]] | ||
− | При | + | '''Обзор проекта''' |
+ | |||
+ | Рассмотрим фрагмент проекта, где применяется объект '''Facebook'''. | ||
+ | |||
+ | В экране '''screen_1''' расположен объект '''Facebook''', кнопка, которая задает ему состояние, чтобы запостить информацию на стене, и окно, в котором будет появляться текстовое сообщение в случае ошибки шаринга. | ||
+ | |||
+ | [[Файл:Obzor.JPG]] | ||
+ | |||
+ | Объект '''Facebook''' создается путем создания объекта внутри сцены и выбора для него соответствующего типа. Заполняются следующие поля: | ||
+ | |||
+ | [[Файл:Facebook property.JPG]] | ||
+ | |||
+ | '''Заголовок''', '''Ссылка заголовка''' и '''Описание''' также подгружаются из текстовой базы. Соответствующие поля должны быть в состоянии редактирования. | ||
+ | |||
+ | При ошибке шаринга объект '''Facebook''' задает объекту '''err_social''' состояние '''open'''. Это состояние, в котором становится видимым окно с соответствующим сообщением. Причем бъект Facebook может задавать состояния сразу нескольким объектам путем активации меню выбора "Добавляемые параметры". | ||
+ | |||
+ | Кнопка '''fb_btn''' задает объекту '''facebook''' состояние '''send_to_wall''', которое сообщает ему, что нужно запостить информацию о приложении. | ||
+ | |||
+ | == Примечания == | ||
+ | |||
+ | ;'''ОБЯЗАТЕЛЬНЫМИ''' для заполнения являются: | ||
+ | *''' ID приложения''' - ID приложения на фейсбуке | ||
+ | *''' Пароль к приложению''' - Пароль к приложению на фейсбуке | ||
+ | |||
+ | :Во вложениях значениями соответствующих полей являются текстовые id, заранее прописанные в текстовой базе. | ||
+ | :При сборке проекта с facebook`ом в файле proj_config.csv, 10 пунктом должен быть соответствующий ID приложения. | ||
+ | |||
+ | для корректной работы на ios платформе необходимо в info.plist приложения добавить | ||
+ | <pre> | ||
+ | <key>FacebookAppID</key> | ||
+ | <string>11111111111</string> (11111111111) - id приложения | ||
+ | </pre> | ||
+ | |||
+ | для корректной работы на android устройствах надо добавить в | ||
+ | в ids.xml: | ||
+ | <pre> | ||
+ | <string name="facebook_app_id">11111111111</string> | ||
+ | </pre> | ||
+ | |||
+ | |||
+ | в android-extra-application-manifest.xml: | ||
+ | <pre> | ||
+ | <meta-data android:name="com.facebook.sdk.ApplicationId" android:value="@string/facebook_app_id"/> | ||
+ | </pre> | ||
+ | |||
+ | == Пример == | ||
+ | |||
+ | [http://fs5.absolutist.com/files/wikisample/facebook.rar Download] | ||
+ | |||
+ | [[Category:Social]] | ||
+ | [[Category:Facebook|*]] |
Текущая версия на 14:03, 31 июля 2018
Объект Facebook помогает нам запостить на страничку информацию о приложении.
Общие параметры
- имя - Имя объекта Facebook в дереве проекта. Может быт произвольным.
- id-объекта - Уникальный номер объекта Facebook, который можно увидеть при наведении курсора на строку "имя".
- синхронизация - Применяется для синхронизации между лейаутами. Если указан параметр "нет", то объект будет активен только на текущем лейауте. По умолчанию указан параметр "да".
- сохранение параметров - Настройка этого параметра актуальна, если приложение в дальнейшем будет сворачиваться в системную панель («трей»). Выбирается значение этого параметра из выпадающего списка. Возможны следующие варианты: "нет", "только объект", "объект с подобъектами", "только подобъекты". При выходе из трэя будут восстановлены ранее измененные/установленные (при переходе с одного экрана на другой)параметры объектов или подобъектов в зависимости от выбранного варианта для этого параметра. По умолчанию указан параметр "нет". Следует помнить, что если выбирается для объекта некоторой сцены значения этого параметра отличное от "нет", то должно и предусматриваться соответствующее значение этого параметра и для этой сцены, и для экрана, содержащего эту сцену.
Основные параметры
- ID приложения - ID приложения на фейсбуке.
- Пароль к приложению - Пароль к приложению на фейсбуке.
Группа - вложения
- заголовок - Заголовок вложения.
- ссылка заголовка - URL по которому перейдем при нажатии на заголовок (ссылка по которой мы перейдём если нажмём на заголовок в окне запроса).
- подзаголовок - Подзаголовок вложения.
- описание - Описание.
- текст перед ссылками - Текст перед остальными ссылками.
- имя ссылки - Имя ссылки.
- ссылка - URL ссылки.
- картинка кнопки - URL картинки для рисования кнопки ( иконку которую запостим на стену).
- ссылка кнопки - URL по которому перейдем при нажатии на кнопку (ссылка по которой мы перейдём если нажмём на картинку в окне запроса).
Состояние
- send_to_wall - Состояние, в которое нужно перевести объект Facebook, чтобы запостить на стене информацию.
- login - залогиниться
- logout - разлогиниться
Добавляемые параметры
Меню выбора Добавляемые параметры к объектам активируется по правой кнопки мыши.
изменить состояние объекта при ошибке
- объект - При ошибке шаринга в фейсбук перевести объект в состояние из следующего поля.
- состояние - Новое состояние для объекта из предыдущего поля.
изменить состояние объекта при доступности промо акции (payer promotion)
- объект - машинка.
- состояние - состояние.
Payer promotion существует для того, чтобы игрок подвязал свою карту на facebook. Игроку предлагается существующая покупка за $0.00. Для этого, если платформа фейсбук, объекту facebook отправляется запрос get_is_eligible_promo. Если игрок еще не привязал карту, срабатывает обработчик изменить состояние объекта при доступности промо акции и переводит машину в указанное состояние, к примеру, для того, чтобы показать акцию, стоимость покупки которой будет = 0. Кнопке инаппа в окне промо акции, добавить запрос eligible_promo объекту facebook. По нажатию на кнопку, появится системное окно со сторовским описанием акции и ценой $0.00.
Пример использования
Для использования объекта Facebook нам понадобится "App ID" и "App Secret" приложения, о котором будем постить информацию. Подгружаются они из текстовой базы. Поля ID приложения и Пароль к приложению должны быть в состоянии редактирования.
Далее создается кнопка, которая сообщает объекту "facebook", что ему нужно запостить наше приложение. Для этого кнопка должна изменить состояние "facebook" на "send_to_wall".
Обзор проекта
Рассмотрим фрагмент проекта, где применяется объект Facebook.
В экране screen_1 расположен объект Facebook, кнопка, которая задает ему состояние, чтобы запостить информацию на стене, и окно, в котором будет появляться текстовое сообщение в случае ошибки шаринга.
Объект Facebook создается путем создания объекта внутри сцены и выбора для него соответствующего типа. Заполняются следующие поля:
Заголовок, Ссылка заголовка и Описание также подгружаются из текстовой базы. Соответствующие поля должны быть в состоянии редактирования.
При ошибке шаринга объект Facebook задает объекту err_social состояние open. Это состояние, в котором становится видимым окно с соответствующим сообщением. Причем бъект Facebook может задавать состояния сразу нескольким объектам путем активации меню выбора "Добавляемые параметры".
Кнопка fb_btn задает объекту facebook состояние send_to_wall, которое сообщает ему, что нужно запостить информацию о приложении.
Примечания
- ОБЯЗАТЕЛЬНЫМИ для заполнения являются
- ID приложения - ID приложения на фейсбуке
- Пароль к приложению - Пароль к приложению на фейсбуке
- Во вложениях значениями соответствующих полей являются текстовые id, заранее прописанные в текстовой базе.
- При сборке проекта с facebook`ом в файле proj_config.csv, 10 пунктом должен быть соответствующий ID приложения.
для корректной работы на ios платформе необходимо в info.plist приложения добавить
<key>FacebookAppID</key> <string>11111111111</string> (11111111111) - id приложения
для корректной работы на android устройствах надо добавить в в ids.xml:
<string name="facebook_app_id">11111111111</string>
в android-extra-application-manifest.xml:
<meta-data android:name="com.facebook.sdk.ApplicationId" android:value="@string/facebook_app_id"/>