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

Менеджеры 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 }.

ts
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.

ts
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().

ts
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.

ts
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.

ts
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