Методы и совместимость
Вызовы выполняются на объекте MaxWebApp. Для вложенных методов передавайте в supports путь вида 'HapticFeedback.selectionChanged'. Функция проверяет наличие метода и применяет известные ограничения платформы и версии. В клиентском SDK supports по умолчанию использует объект активной сессии. Инициализация SDK
Ограничения SDK
| Метод или группа | Где SDK считает их доступными при наличии метода |
|---|---|
getLaunchContext | Android ≥ 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');
}
}