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

Методы и совместимость ​

Вызовы выполняются на объекте MaxWebApp. Для вложенных методов передавайте в supports путь вида 'HapticFeedback.selectionChanged'. Функция проверяет наличие метода и применяет известные ограничения платформы и версии. В клиентском SDK supports по умолчанию использует объект активной сессии. Инициализация SDK

Ограничения SDK ​

Метод или группаГде SDK считает их доступными при наличии метода
getLaunchContextAndroid ≥ 26.19.2, iOS ≥ 26.20.0
downloadFile, DeviceStorage.*, SecureStorage.*Android, iOS, desktop
shareContent, BiometricManager.*, HapticFeedback.*Android, iOS
NfcManager.*Android
Остальные методыПроверяется наличие соответствующей функции

Особенности действия зависят от клиента и разрешений пользователя. Документация MAX Bridge

Методы верхнего уровня ​

МетодВход и результатПодробнее
getLaunchContext()Promise с entryPoint: 'tabbar' | 'default'Чтение контекста
requestScreenMaxBrightness(), restoreScreenBrightness()Promise с maxBrightness: booleanЯркость и захват экрана
getViewportSize()Promise с width и height в виде строкРазмеры
requestContact()Promise с phone, authDate и hashКонтакт
enableClosingConfirmation(), disableClosingConfirmation()Команды без результатаПодтверждение закрытия
openLink(url), openMaxLink(url)Команды открытия URLСсылки
downloadFile(url, fileName)Promise со статусом загрузки или отменыЗагрузка
shareContent(params), shareMaxContent(params)Promise со статусом шеринга или отменыШеринг
openCodeReader(fileSelect?)Promise со считанным значениемQR

Обработка ошибок ​

Методы MAX могут отклонить Promise с объектом вида { error: { code, message? } }. При обращении к менеджеру вызовите метод на самом менеджере, чтобы сохранить контекст this.

ts
import { getWebApp, supports } from '@mwa.js/bridge';

export async function vibrate() {
  const webApp = getWebApp();
  if (!webApp || !supports('HapticFeedback.selectionChanged', webApp)) return;
  try {
    return await webApp.HapticFeedback?.selectionChanged?.();
  } catch (error) {
    const native = error as { error?: { code?: string } };
    console.error(native?.error?.code ?? 'Ошибка MAX Bridge');
  }
}