Перейти к содержимому

Транспорт MAX ​

SDK самостоятельно отправляет команды клиенту MAX. Приложение импортирует пакет и вызывает init().

WebView ​

Нативный клиент предоставляет window.WebViewHandler.postEvent(name, json). Bridge сохраняет контекст этого метода. Ответы клиент передаёт через window.WebApp.sendEvent(name, json).

Обработчик устанавливается при первом запросе или подписке. После завершения последнего запроса и снятия последней подписки прежнее глобальное свойство восстанавливается.

Iframe и targetOrigin ​

В iframe используется строка JSON с полем type. Ответ принимается от непосредственного родителя с выбранным HTTPS-origin клиента.

Origin определяется из ancestorOrigins или document.referrer. При скрытом происхождении родителя задайте его явно.

ts
import { init } from '@mwa.js/sdk';

const dispose = init({ targetOrigin: 'https://web.max.ru' });

Допустимы HTTPS-поддомены max.ru и oneme.ru. Настройка относится к родительскому клиенту MAX.

Запросы и очистка ​

Каждый асинхронный запрос получает собственный requestId. Клиент возвращает его в ответе. Ошибки MAX передаются как объект с error.code.

Обычный таймаут составляет 10 секунд. NFC использует 30 секунд, контакт, шеринг, загрузка файла и интерактивные разрешения — 60 секунд, сканер — 600 секунд.

Cleanup SDK снимает его подписки и сбрасывает состояние. Уже отправленный запрос завершает собственный Promise ответом или таймаутом. Результат старой сессии сохраняет изоляцию от состояния новой.

Источник сведений ​

Форматы транспорта сверены 18 ноября 2026 года по публичной реализации MAX. Проверки в эмуляторе описывают синтетический обмен. Для проверки настоящего клиента нужны бот и HTTPS-адрес. MAX Bridge

Проверяемый пример ​

ts
import { getWebApp, init, isMMA } from '@mwa.js/sdk';

export function connect() {
  if (isMMA()) return init();
  return undefined;
}

export function connectIframe() {
  return init({ targetOrigin: 'https://web.max.ru' });
}

export function bridge() {
  return getWebApp({ targetOrigin: 'https://web.max.ru' });
}