VKWebAppGetClientVersion
VKWebAppGetClientVersion возвращает информацию о платформе, на которой запущено мини-приложение.
Пример
bridge.send('VKWebAppGetClientVersion')
.then((data) => {
if (data.platform) {
// Данные пользователя получены
}
})
.catch((error) => {
// Ошибка
console.log(error);
});
Платформы
Android, iOS, Mobile Web, Web
Параметры
—
Результат
Проверить результат можно:
- •
Используя объект
Promise, который возвращается вызовомbridge.send(...). - •
С помощью событий
VKWebAppGetClientVersionResultиVKWebAppGetClientVersionFailed.
Подробнее о проверке результатов при вызовах VK Bridge.
Объект Promise
Если обращение к платформе прошло успешно, управление будет передано в then-обработчик объекта Promise. В качестве ответа платформа возвращает объект со следующими полями:
| Поле | Тип | Описание |
|---|---|---|
platform | string | Платформа, на которой запущено мини-приложение. Возможные значения:
• ios — мобильное приложение для iOS.
• android — мобильное приложение для Android.
• web — десктопная версия сайта.
• mobile-web — мобильная версия сайта. |
app | string | Имя хоста приложения на мобильном устройстве, внутри которого запускается мини-приложение. |
is_google_services_available | boolean | Информация о том, есть ли на мобильном устройстве сервисы Google. |
client_user_agent | string | User-Agent приложения на мобильном устройстве. |
build | string | Версия сборки приложения хоста на мобильном устройстве. |
is_new_navigation | boolean | Информация о том, включена ли новая навигация в мини-приложении. |
is_voice_assistant_available | boolean | Информация о том, доступен ли голосовой помощник Маруся. |
install_referrer | string | Идентификатор отслеживания рекламы для Android. |
vk_client_exists | boolean | Информация о том, установлено ли приложение ВКонтакте на мобильном устройстве. |
Если при обращении к платформе произошла ошибка, управление передаётся в метод catch. В качестве ответа платформа возвращает объект с информацией об ошибке, общий для всех событий VK Bridge.
События
VKWebAppGetClientVersionResult
Сигнализирует, что данные пользователя получены. В обработчик события на стороне пользователя передаются следующие данные:
{
detail: {
type: "VKWebAppGetClientVersionResult",
data: {
"platform": "android",
"version": "5.3.2",
"app": "vkclient",
"is_google_services_available": true,
"client_user_agent": "SAK_1.93(com.vkontakte.android)/7.42-13967 (Android 12; SDK 31; arm64-v8a; samsung SM-A525F; ru; 2186x1080)",
"build": "13967",
"is_new_navigation": false,
"is_voice_assistant_available": true,
"install_referrer": "com.android.vending",
"vk_client_exists": true
}
}
}
Передаваемый объект подобен объекту, возвращаемому при успешном выполнении промиса.
VKWebAppGetClientVersionFailed
Информирует об ошибке, которая произошла при взаимодействии с платформой.
В обработчик события на стороне пользователя передаётся объект с информацией об ошибке, общий для всех методов VK Bridge.
Пример обработки событий
Смотрите раздел Обработка событий-результатов.