VKWebAppGetGrantedPermissions
VKWebAppGetGrantedPermissions позволяет получить список разрешений, выданных мобильному приложению ВКонтакте.
Чтобы пользователь мог выдать нужные разрешения на iOS, откройте системные настройки устройства. Для этого добавьте в нужное место своего мини-приложения ссылку:
<a href="app-settings:" target="_blank">Пример
bridge.send('VKWebAppGetGrantedPermissions')
.then((data) => {
if (data.permissions) {
// Список разрешений получен
}
})
.catch((error) => {
// Ошибка
console.log(error);
});
Платформы
Android, iOS
Параметры
—
Результат
Проверить результат можно:
- •
Используя объект
Promise, который возвращается вызовомbridge.send(...). - •
С помощью событий
VKWebAppGetGrantedPermissionsResultиVKWebAppGetGrantedPermissionsFailed.
Подробнее о проверке результатов при вызовах VK Bridge.
Объект Promise
Если обращение к платформе прошло успешно, управление будет передано в then-обработчик объекта Promise. В качестве ответа платформа возвращает объект со следующим полем:
| Поле | Тип | Описание |
|---|---|---|
permissions | array[string] | Список разрешений, выданных мобильному приложению ВКонтакте. Возможные значения:
• camera — разрешено использовать камеру, чтобы делать фотографии и записывать видео.
• location — разрешено запрашивать местоположение устройства.
• photo — доступ к фотографиям и видео на мобильном устройстве с iOS.
Пустой результат означает, что никакие разрешения не выданы. Есть ли доступ к фотографиям, можно проверить только на iPhone. |
Если при обращении к платформе произошла ошибка, управление передаётся в метод catch. В качестве ответа платформа возвращает объект с информацией об ошибке, общий для всех событий VK Bridge.
События
VKWebAppGetGrantedPermissionsResult
сигнализирует, что список разрешений получен. В обработчик события на стороне пользователя передаются следующие данные:
{
detail: {
type: "VKWebAppGetGrantedPermissionsResult",
data: {
"permissions": [
"camera",
"location",
"photo"
]
}
}
}
Передаваемый объект подобен объекту, возвращаемому при успешном выполнении промиса.
VKWebAppGetGrantedPermissionsFailed
Информирует об ошибке, которая произошла при взаимодействии с платформой.
В обработчик события на стороне пользователя передаётся объект с информацией об ошибке, общий для всех методов VK Bridge.
Пример обработки событий
Смотрите раздел Обработка событий-результатов.