VKWebAppCallJoin

VKWebAppCallJoin используется при интеграции звонков в мини-приложение. Событие подключает пользователя к звонку по ссылке. Перед подключением пользователь видит окно с возможностью присоединиться к звонку.

Окно подключения к звонку Окно подключения к звонку

Пример

JavaScript

bridge.send('VKWebAppCallJoin', {
  join_link: 'hg0IXLVD7txQyFKMTLt2Zy4P6HmuXxcKGcfF0A8GznU' 
  })
  .then((data) => { 
    if (data.result) {
      // Пользователь присоединился к звонку
    }
  })
  .catch((error) => {
    // Ошибка
    console.log(error);
  });

Платформы

Android, iOS, Web

Параметры

Поле	Тип	Описание
`join_link` обязательное	`string`	Ссылка для подключения к звонку. Ссылку на звонок возвращает событие `VKWebAppCallStart`.

Результат

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

•

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

С помощью событий VKWebAppCallJoinResult и VKWebAppCallJoinFailed.

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

Объект `Promise`

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

Поле	Тип	Описание
`result`	`boolean`	`true`, если пользователь присоединился к звонку.

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

События

`VKWebAppCallJoinResult`

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

JavaScript

{
  detail: {
    type: "VKWebAppCallJoinResult",
    data: {
      result: true
    }
  }
}

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

`VKWebAppCallJoinFailed`

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

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

•
Если пользователь уже находится в звонке, возвращается ошибка c кодом 13:Сustom error.
•
Если пользователь не предоставил необходимые доступы ВКонтакте, возвращается код ошибки 11 Access denied.

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

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

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

•
Интеграция звонков
•
VKWebAppCallStart