ВСети
IFrame-приложения
Вы можете создать любое интегрированное приложение, загружаемое с Вашего сервера с помощью встроенного на страницу ВСети элемента IFrame. Такие приложения могут отображать информацию с помощью любых технологий, поддерживаемых браузером пользователя: HTML, Javasсript, AJAX, Flash и др.

Аналогично переменным flashVars, передаваемым во Flash-приложение, в IFrame-приложение эти переменные передаются посредством GET-параметров запроса.

Использование Javascript API в IFrame-приложении
Для более тесной интеграции IFrame-приложения c пользовательским интерфейсом ВСети, предусмотрена возможность использования Javasсript API, который позволяет выполнять следующие функции:
  • Открытие окон установки приложения, настроек, приглашения друзей и ввода зайчиков для оплаты услуг.
  • Получение событий об успешной установке приложения пользователем, изменении настроек и баланса пользователя внутри приложения.
  • Динамическое изменение размера окна приложения.

Инициализация Javascript API
1. Добавьте следующую ссылку в код Вашей страницы:
<script src="http://vseti.by/js/api/xd_connection.js?2" type="text/javascript"></script>

2. После загрузки страницы для инициализации приложения можно использовать следующий код:
<script type="text/javascript">
	  VS.init(function() {
	     // API успешно инициировано
	     // Ваш код пишем здесь
	  });
	</script>


Обращаем Ваше внимание на то, что инициализация приложения может закончится ещё до полной загрузки Вашего приложения и выполнения события window.onload.

Методы Javascript API
Все нижеперечисленные методы доступны в контексте глобального объекта VS, создаваемого в результате подключения файла xd_connection.js к странице приложения.

Название метода
Параметры
Описание
init[Function success]Инициализирует соединение с родительским окном для запуска внешних вызовов. При успешной инициализации соединения вызывается функция success.
callMethodString name, Object param1, Object param2, ...Осуществляет внешний вызов метода javascript API
addCallbackString name, Function callbackДобавляет функцию callback в качестве обработчика события name.
removeCallbackString name, Function callbackУдаляет обработчик события name.
apiString method, Object params, Function callbackВыполняет запрос к ВСети API и передаёт полученные данные в функцию callback.


Вызов методов Javascript API
Для осуществления внешних вызовов необходимо использовать функцию VS.callMethod(String methodName, Object param1, Object param2, ...). В таблице ниже приведен список доступных методов.

Список методов Javascript API »

Пример вызова внешнего метода:
VS.callMethod("resizeWindow", 510, 600);


Обращение к ВСети API
Для осуществления вызовов к API необходимо использовать функцию VS.api - VS.api(methodName, {params}, callback).
  • При завершении запроса будет вызвана функция callback, с объектом, содержащим либо поле response, либо поле error.

VS.api принимает 3 параметра:
1) Название метода api.
2) Объект с параметрами запроса.
3) Функция для обработки результата.

Пример обращения к ВСети API:
VS.api('video.get',{videos: '-4363_136089719,13245770_137352259'},function(data) {
  if (data.response) {
  // data.response is object
  }
});


Обработка событий
В результате совершения пользователем каких-либо действий на странице с приложением, родительское окно создает события, которые можно отслеживать с помощью функции VS.addCallback(String name, Function value). В таблице ниже приведен список таких событий.

Название события
Параметры
Описание
onSettingsChangedint settingsСобытие происходит, когда пользователь изменяет настройки приложений. Параметр settings передаваемого объекта в функцию обратного вызова содержит в себе битовую маску выставленных значений настроек. Подробнее о значении параметра настроек в описании метода getUserSettings.
onBalanceChangedint balanceСобытие происходит, когда пользователь положил или снял зайчика с баланса приложения. Параметр balance содержит текущий баланс пользователя в зайчиках. Этот параметр можно использовать только для вывода пользователю. Достоверность баланса всегда нужно проверять с помощью метода secure.getBalance.
onMerchantPaymentCancel
Событие происходит, когда пользователь отменяет покупку.
onMerchantPaymentSuccessString merchantOrderIdСобытие происходит, когда пользователь оплатил товар.
onMerchantPaymentFail
Событие происходит, когда покупка закончилась неуспешно.


Пример кода обработки события:
VS.addCallback("onSettingsChanged", onSettingsChanged);
...
function onSettingsChanged(settings) {
    // Делаем что-нибудь полезное
}


Пример выполнения запроса к API:
VS.api("getProfiles", {uids:"1,2,3,4"}, function(data) {
    // Действия с полученными данными
});

Новости

10 марта 2013 - теперь можно загружать скриншот приложения

17 февраля 2013 - запущена платёжная система аналогичная ВКонтакте

5 дек 2012 - добавлены методы загрузки фото в альбом пользователя

Ссылки

Правила размещения
Партнёрская модель
Жанровый эксклюзив


Все понятно
Подробнее
Ответить
Нет друзей ВСети
. . .
Нет открытых диалогов
Показать предыдущие сообщения ↑
. .
angel bad biggrin blum blush cray crazy
dance diablo dirol good in_love kiss_mini laugh
music nea pardon rolleyes scratch shok shout
smile unknw wacko2 wall wink yahoo