VKWebAppUpdateConfig

VKWebAppUpdateConfig отправляется платформой, когда изменяется конфигурация мини-приложения.

Клиент отправляет мини-приложению событие VKWebAppUpdateConfig с информацией об используемой конфигурации в следующих случаях:

•
Сразу после выполнения события VKWebAppInit.
•
При показе модального вью-контроллера.
•
При появлении, исчезновении или изменении размеров клавиатуры.
•
При изменении фрейма экрана, в том числе ориентации.
•
При изменении цветовой схемы.

Пример

JavaScript

bridge.subscribe((e) => {
  if (e.detail.type === 'VKWebAppUpdateConfig') {
    // Логика мини-приложения
  }
});

Параметры

—

Результат

VKWebAppUpdateConfig сигнализирует, что информация получена. В качестве ответа платформа возвращает объект со следующими полями:

Поле	Тип	Платформа	Значение
`api_host`	`string`	Mobile Web, Web	API-хост для вызовов, не использующих VK Bridge. Возможные значения: • `api.vk.com` • `api.vk.ru`
`app`	`string`	Android, iOS	Тип клиента. Возможные значения: • `vkclient` — приложение ВКонтакте. • `vkme` — мессенджер ВКонтакте.
`app_id`	`string`	Android, iOS, Mobile Web, Web	Идентификатор приложения, которому соответствует нативное мобильное приложение ВКонтакте.
`appearance`	`string`	Android, iOS, Mobile Web, Web	Тема мини-приложения или игры. Возможные значения: • `light`— светлая тема. • `dark` — тёмная тема.
`insets`	`string`	iOS	Текущие отступы, которые необходимо выдержать от края экрана до контента (если показана клавиатура, её высота будет в bottom-инсете).
`gaid`	`string`	Android, iOS	Google Advertising ID.
`sak_version`	`string`	Android, iOS	Версия SuperAppKit.
`scheme`	`string`	Android, iOS, Mobile Web, Web	Цветовая схема мини-приложения или игры. Возможные значения: • `space_gray` — тёмная схема мобильного приложения и мобильной версии сайта. • `bright_light` — светлая схема мобильного приложения и мобильной версии сайта. • `vkcom_light` — светлая схема десктопной версии сайта. • `vkcom_dark` — тёмная схема десктопной версии сайта.
`start_time`	`integer`	Android, iOS	Время и дата открытия модального экрана (Unix Timestamp). Передаётся только при открытии модального экрана.
`viewport_height`	`integer`	Mobile Web, Web	Высота родительского окна мини-приложения или игры.
`viewport_width`	`integer`	Mobile Web, Web	Ширина родительского окна мини-приложения или игры.
`is_layer`	`boolean`	Web	Поле приходит, если мини-приложение или игра открыты в слое.

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

JavaScript

{
  detail: {
    type: "VKWebAppUpdateConfig",
    data: {
      api_host: "api.vk.com",
      app_id: "8142709",
      appearance: "light",
      scheme: "vkcom_light",
      viewport_height: 558,
      viewport_width: 1258
    }
  }
}

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

Смотрите раздел Обработка событий-результатов.