Менеджеры MAX Bridge
Менеджеры — свойства MaxWebApp. Проверяйте доступность каждого вызова. MAX может отклонить запрос по состоянию устройства, разрешениям или выбору пользователя. Совместимость и ошибки
Кнопка и хранилища
BackButton предоставляет show(), hide(), isVisible, onClick(callback) и offClick(callback). При прямом использовании передавайте ту же функцию в offClick. У DeviceStorage и SecureStorage есть getItem, setItem, removeItem и clear. Примеры и типы результатов приведены в руководствах кнопки «Назад» и хранилищ.
Яркость и захват экрана
requestScreenMaxBrightness() и restoreScreenBrightness() возвращают { maxBrightness }. Менеджер ScreenCapture предоставляет enableScreenCapture() и disableScreenCapture() с результатом { isScreenCaptureEnabled }.
import { getWebApp, supports } from '@mwa.js/bridge';
export async function preventScreenCapture() {
const app = getWebApp();
if (app && supports('ScreenCapture.disableScreenCapture', app)) {
return app.ScreenCapture?.disableScreenCapture?.();
}
}Биометрия
Сначала вызовите BiometricManager.init(). Результат содержит доступность, типы биометрии, состояние разрешения, наличие сохранённого токена и идентификатор устройства.
| Метод | Назначение |
|---|---|
requestAccess(reason?) | Запросить доступ и получить BiometryInfo |
authenticate(reason?) | Выполнить аутентификацию и получить результат со статусом authorized и токеном |
updateBiometricToken(token?, reason?) | Обновить или удалить биометрический токен |
openSettings() | Открыть настройки биометрии, результат со статусом opened |
Состояние доступно через isInited, isBiometricAvailable, isAccessRequested, isAccessGranted, isBiometricTokenSaved, biometricType и deviceId.
import { getWebApp, supports } from '@mwa.js/bridge';
export async function requestBiometry() {
const app = getWebApp();
if (!app || !supports('BiometricManager.init', app)) return;
const manager = app.BiometricManager;
const info = await manager?.init?.();
if (info?.available && supports('BiometricManager.requestAccess', app)) {
return manager?.requestAccess?.('Подтверждение входа');
}
}Камера и микрофон
PermissionsManager.init() и requestAccess(permissions, reason?) возвращают PermissionsInfo с отдельным состоянием для camera и mic. После инициализации доступны признаки наличия устройства, запроса прав и выдачи прав на уровне системы и приложения. Для перехода к настройкам есть openMaxSettings() и openSystemSettings().
import { getWebApp, supports } from '@mwa.js/bridge';
export async function requestCamera() {
const app = getWebApp();
if (!app || !supports('PermissionsManager.init', app) || !supports('PermissionsManager.requestAccess', app)) return;
const manager = app.PermissionsManager;
await manager?.init?.();
const access = await manager?.requestAccess?.('camera', 'Сканирование документа');
return access?.camera;
}Тактильный отклик
В HapticFeedback доступны impactOccurred(style, disableVibrationFallback?), notificationOccurred(type, disableVibrationFallback?) и selectionChanged(disableVibrationFallback?). Стили воздействия — light, medium, heavy, rigid и soft. Типы уведомления — error, success и warning.
import { getWebApp, supports } from '@mwa.js/bridge';
export function confirmSelection() {
const app = getWebApp();
if (app && supports('HapticFeedback.impactOccurred', app)) {
return app.HapticFeedback?.impactOccurred?.('light');
}
}NFC
NfcManager.init() сообщает, доступен ли и включён ли NFC. Используйте openSystemSettings() для перехода в настройки. emulateNfcTag(nfctag?) запускает передачу данных метки со статусом scanned. Вызов без параметра останавливает передачу со статусом stopped.
import { getWebApp, supports } from '@mwa.js/bridge';
export async function emulateTag(tag: string) {
const app = getWebApp();
if (!app || !supports('NfcManager.init', app) || !supports('NfcManager.emulateNfcTag', app)) return;
const manager = app.NfcManager;
const info = await manager?.init?.();
if (info?.available && info.enabled && !info.accessRevoked) {
return manager?.emulateNfcTag?.(tag);
}
}Условия выдачи прав, результаты методов и доступность клиента описаны в официальном справочнике. MAX Bridge