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

Материал из wiki.appsalutecreator.com
Перейти к: навигация, поиск
(Добавляемые параметры)
 
(не показаны 23 промежуточные версии 8 участников)
Строка 1: Строка 1:
Объект с типом "facebook" помогает нам зайти на страничку приложения например [http://itunes.apple.com/us/app/bon-voyage-hidden-object/id524620002?mt=8 Bon Voyage]
+
{{TOC right}}
 +
[[Object|Объект]] '''Facebook''' помогает нам запостить на страничку информацию о приложении.
  
Для этого нам нужно в редакторе сцен создать объект с типом "facebook" он не имеет графического ресурса, и кнопку которая изменяет состояние объекту "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".
+
'''Обзор проекта'''
 +
 
 +
Рассмотрим фрагмент проекта, где применяется объект '''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>
  
ОБЯЗАТЕЛЬНЫМИ для заполнения:
 
  
ID приложения - ID приложения на фейсбуке<br>
+
в android-extra-application-manifest.xml:
пароль к приложению - Пароль к приложению на фейсбуке<br>
+
<pre>
 +
<meta-data android:name="com.facebook.sdk.ApplicationId" android:value="@string/facebook_app_id"/>
 +
</pre>
  
Вложения:
+
== Пример ==
  
заголовок - Заголовок вложения<br>
+
[http://fs5.absolutist.com/files/wikisample/facebook.rar Download]
ссылка заголовка - URL по которому перейдем при нажатии на заголовок<br>
 
  
подзаголовок - Подзаголовок вложения<br>
+
[[Category:Social]]
описание - Описание
+
[[Category:Facebook|*]]
текст перед ссылками - Текст перед остальными ссылками<br>
 
имя ссылки - Имя ссылки<br>
 
ссылка - URL ссылки<br>
 
картинка кнопки - URL картинки для рисования кнопки<br>
 
ссылка кнопки - URL по которому перейдем при нажатии на кнопку.<br>
 

Текущая версия на 14:03, 31 июля 2018

Объект 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.

В экране 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 приложения добавить

<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"/>

Пример

Download