Транспорт 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. При скрытом происхождении родителя задайте его явно.
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
Проверяемый пример
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' });
}