Чтобы использовать Mobile SDK, добавьте подключение скрипта в <head> страницы:
<script src="https://vk.com/js/api/mobile_sdk.js" type="text/javascript"></script>
А затем инициализируйте объект VK:
<script type="text/javascript">
VK.init(function() {
// API initialization succeeded
// Your code here
}, function() {
// API initialization failed
// Can reload page here
}, '5.60');
</script>
Эти методы используются для взаимодействия с нативным интерфейсом мобильного приложения. Обратите внимание, список методов Mobile Client API отличается от списка методов Client API для Javascript и Flash SDK. Чтобы вызвать метод Mobile Client API, используйте
VK.callMethod().
Параметры: —
Открывает окно для приглашения друзей пользователя в приложение. После закрытия окна вызывается событие
onInviteBoxDone, в которое передаются значения:
- status (string) — статус действия: cancel — отмена пользователем, success — успешно, fail — с ошибками;
- [data (array) — массив идентификатор пользователей, для которых приглашение не было отправлено (status = fail).]
Параметры:
user_id (integer),
message (string),
request_key (string)
Открывает окно для отправки запроса пользователю
user_id с текстом
message.
request_key — произвольная строка для отслеживания конверсии (request_key передается в параметрах запуска приложения, если оно запущено из запроса). После закрытия окна вызывается событие
onRequestBoxDone, в которое передаются значения:
- status (string) — статус действия: cancel — отмена пользователем, success — успешно, fail — с ошибками;
Перед вызовом
showRequestBox необходимо получить список пользователей, которым можно отправлять запросы, с помощью API метода
friends.getAppUsers.
Параметры:
message (string),
attachments (array),
target (string)
Открывает окно для шаринга с текстом
message и вложениями
attachments.
target =
wall — шаринг на стену,
target =
im — шаринг в личные сообщения. У записи может быть максимум 2 вложения — фотография и ссылка (при
target =
im ссылку следует указать в тексте сообщения
message). После закрытия окна вызывается событие
onShareBoxDone, в которое передаются значения:
- status (string) — статус действия: cancel — отмена пользователем, success — успешно, fail — с ошибками;
Параметры:
settings (integer)
Открывает окно с запросом прав доступа для приложения. Параметр
settings — это битовая маска запрашиваемых прав доступа. Если
settings =
0, то пользователю будет предложено разрешить все возможные права доступа. После закрытия окна вызывается событие
onSettingsBoxDone, в которое передаются значения:
- status (string) — статус действия: cancel — отмена пользователем, success — успешно, fail — с ошибками;
- [data (string) — новый access_token].
Параметры:
order (object)
Объект
order содержит поля:
- type (string) — содержит строку item.
- item (string) — содержит наименование товара, которое будет отправлено в платежном уведомлении.
Открывает окно для покупки товара в приложении. После закрытия окна вызывается событие
onOrderBoxDone, в которое передаются значения:
- status (string) — статус действия: cancel — отмена пользователем, success — успешно, fail — с ошибками;
Добавьте тестировщиков платежей в настройках приложения в разделе «Платежи». На счету тестеров должен быть как минимум 1 голос. При оплате голоса не списываются со счета тестеров в пользу приложения.
Пример:
VK.callMethod("showOrderBox", {"type":"item","item":"MyOrderTitle"});
Параметры:
user_result (integer)
Отображает окно с турнирной таблицей приложения. Турнирная таблица может отображать прогресс пользователей по очкам или уровням (тип турнирной таблицы выбирается в Управлении приложением).
user_result — результат текущего пользователя. Для добавления уровня или очков пользователям используйте метод
secure.addAppEvent.
Параметры: string
eventName, function
callback.
Добавляет функцию
callback в качестве обработчика события
eventName.
Параметры: string
eventName, function
callback.
Удаляет функцию
callback из обработчика события
eventName.
Методы API ВКонтакте позволяют работать с данными пользователей и сообществ ВКонтакте. Для обращения к методам API в Mobile SDK используется функция VK.api. Она принимает следующие параметры:
- methodName (string) — название метода API;
- params (object) — объект, содержащий параметры метода;
- callback (function) — функция, в которую будет передан полученный результат после выполнения метода.
Параметры метода API передаются в виде пар «ключ»: «значение».