VKWebAppShare

Важно! Событие станет доступно пользователям после того, как ваше приложение пройдёт модерацию.

VKWebAppShare показывает окно с предложением поделиться записью с указанной ссылкой в личном сообщении или истории (только в приложении для Android).

Поделиться записью в личном сообщенииПоделиться записью в личном сообщении

Пример

JavaScript
bridge.send('VKWebAppShare', { link: 'https://vk.com/vkappsdev' }) .then((data) => { if (data.result) { // История опубликована, сообщение отправлено } }) .catch((error) => { // Ошибка console.log(error); });

Платформы

Android, iOS, Mobile Web, Web

Параметры

Android, iOS

Поле
Тип
Описание
link необязательное
string
Ссылка, которой необходимо поделиться в записи. Если параметр не указан, передаётся ссылка на текущее мини-приложение или игру вида https://vk.com/app6909581#hash.
text необязательное
string
Текст сообщения. Максимальная длина — 4000 символов. Текст отображается только в личных сообщениях.
user_id необязательное
integer
Идентификатор пользователя, который отобразится первым в списке «Поделиться». На iOS этот пользователь будет сразу выбран для отправки.

Mobile Web, Web

Поле
Тип
Описание
link необязательное
string
Ссылка, которой необходимо поделиться. Если параметр не указан, передаётся ссылка на текущее мини-приложение или игру вида https://vk.com/app6909581#hash. Можно поделиться только в личных сообщениях.

Результат

Проверить результат можно:

  • •

    Используя объект Promise, который возвращается вызовом bridge.send(...).

  • •

    С помощью событий VKWebAppShareResult и VKWebAppShareFailed.

Подробнее о проверке результатов при вызовах VK Bridge — в разделе Обработка результата.

Объект Promise

Если обращение к платформе прошло успешно, управление будет передано в then-обработчик объекта Promise. В качестве ответа платформа возвращает:

  • •

    Массив объектов, если запись была отправлена в личных сообщениях:

    Поле
    Тип
    Описание
    type
    string
    Тип записи, значение message.
    users
    object
    Объект с данными пользователей, которым было отправлено сообщение.
  • •

    Объект, если запись была отправлена в историю:

    Поле
    Тип
    Описание
    type
    string
    Тип записи, значение story.
    story_id
    string
    Идентификатор истории.

Если при обращении к платформе произошла ошибка, управление передаётся в метод catch. В качестве ответа платформа возвращает объект с информацией об ошибке, общий для всех событий VK Bridge.

События

VKWebAppShareResult

Сигнализирует, что запись размещена. В обработчик события на стороне пользователя передаются следующие данные:

JavaScript
{ detail: { type: "VKWebAppShareResult", data: { type: "message", users: [ { id: 743784474, first_name: "Персик", last_name: "Рыжий", photo: "https://sun9-9.userapi.com/s/v1/ig2/-8CtSNxFfHdfDKwnEN_8nLAPtuIei6idu8zmkERN9va58RZ3EFc_TYEml6UNNKamZUa2fUoCEwE88xMw29L6Dpdr.jpg?quality=95&crop=20,0,446,446&as=32x32,48x48,72x72,108x108,160x160,240x240,360x360&ava=1&cs=50x50", sex: 2 } ] } } }

Передаваемый объект подобен объекту, возвращаемому при успешном выполнении промиса.

VKWebAppShareFailed

Информирует об ошибке, которая произошла при взаимодействии с платформой.

В обработчик события на стороне пользователя передаётся объект с информацией об ошибке, общий для всех методов VK Bridge.

Пример обработки событий

Подробнее — в разделе Обработка результата.

Песочница

VKWebAppShare

Материалы по теме