MAX Bridge

Библиотека MAX Bridge позволяет мини-приложениям корректно взаимодействовать с API MAX и API операционной системы на устройстве пользователя

Подключение библиотеки

Через CDN добавьте библиотеку max-web-app.js

HTML

Скопировать

<script src="https://st.max.ru/js/max-web-app.js"></script>

После подключения библиотеки мини-приложение получит доступ к объекту WebApp через глобальный объект window

JAVASCRIPT

Скопировать

window.WebApp

window.WebApp — это глобальный объект, который связывает мини-приложение с клиентом и позволяет взаимодействовать с МAX, управлять интерфейсом приложения и получать информацию о пользователях. Объект создаётся с каждым запуском сервиса, предзагружает данные и не требует отдельной инициализации: его методы и параметры доступны напрямую

Функциональность библиотеки

Работа с данными инициализации

Чтобы получить инициализационные данные, в объекте WebApp предусмотрены следующие методы:

initData
initDataUnsafe
platform
version
deviceName

window.WebApp.initData

Строка со стартовыми параметрами в URL-кодировке. Содержит данные о пользователе и другие инициализационные данные в виде закодированной в UTF-8 строки для валидации на стороне сервера

Тип возвращаемых данных

JAVASCRIPT

Скопировать

string

window.WebApp.initDataUnsafe

Объект, который содержит данные из initData в виде JSON-объекта

Обратите внимание, что объект нельзя использовать для валидации данных

Пример

JAVASCRIPT

Скопировать


interface InitData {
    query_id: string;
    ip?: string;
    auth_date: number;
    hash: string;
    user: {
        id: number;
        first_name: string;
        last_name: string;
        username: string;
        language_code: string;
        photo_url: string;
    };
    chat: {
        id: number;
        type: 'DIALOG' | 'CHAT' | 'CHANNEL';
    };
    start_param: string;
}

Описание свойств объекта

Поле	Тип данных	Описание
`query_id`	`string`	Уникальный идентификатор текущей сессии
`ip?`	`string`	IP-адрес пользователя
`auth_date`	`number`	Время выдачи данных. Позволяет определить момент инвалидации данных. Рекомендуемый интервал составляет 1 час
`hash`	`string`	Хеш переданных параметров, который можно использовать для проверки их достоверности
`user`	`object`	Объект содержит данные о пользователе, который открывает мини-приложение
`user.id`	`number`	Идентификатор пользователя
`user.first_name`	`string`	Имя пользователя
`user.last_name`	`string`	Фамилия пользователя
`user.username`	`string`	Никнейм пользователя
`user.language_code`	`string`	Язык интерфейса приложения MAX
`user.photo_url`	`string`	Ссылка на фото профиля пользователя
`chat`	`object`	Объект содержит данные о чате, в котором открыто мини-приложение
`chat.id`	`number`	Идентификатор чата
`chat.type`	`string`	Тип чата (`DIALOG` / `CHAT` / `CHANNEL`)
`start_param`	`string`	Значение, переданное в мини-приложение через query-параметр Пример: `https://max.ru/<your_awesome_bot>?startapp=someData`, где поле `start_param` будет содержать значение `someData`

window.WebApp.platform

Платформа, с которой запущено мини-приложение. Возможные значения:

ios
android
desktop
web

Тип возвращаемых данных

Пример

JAVASCRIPT

Скопировать

string

window.WebApp.version

Версия приложения MAX, с которого запущено мини-приложение

Имеет формат <year>.<build_number — возрастающий счётчик>.<patch_version — для патчей>, например 25.9.16

Этот параметр не участвует в формировании хеша для валидации — в хеше учитываются только данные из WebAppData

Тип возвращаемых данных

Пример

JAVASCRIPT

Скопировать

string

window.WebApp.deviceName

Возвращает устройство, с которого запущено мини-приложение. Например, может возвращать:

network name, macOS Tahoe (26.6) — десктоп-приложение на macOS
network name, Windows 11 Version 25H2 — десктоп-приложение на Windows
Google Pixel 6, Android 17 — мобильное приложение Android
iPhone 16, iOS 26.5 — мобильное приложение iOS
Chrome, macOS — веб-приложение на macOS
Chrome, Windows — веб-приложение на Windows

Тип возвращаемых данных

Пример

JAVASCRIPT

Скопировать

string

Контекст запущенного приложения

window.WebApp.getLaunchContext()

Позволяет мини-приложению адаптировать поведение и интерфейс в зависимости от источника запуска — это может быть таббар (нижняя панель вкладок приложения MAX) или список чатов, экран чата, экран настроек

Метод доступен для версий:

Android — 26.19.2 и выше

iOS — 26.20.0 и выше

Тип возвращаемых данных

Пример

JAVASCRIPT

Скопировать

Promise<{
  entryPoint: 'tabbar' | 'default'
}>

entryPoint = tabbar — мини приложение запущено из таббара
entryPoint = default — мини приложение запущено из списка чатов / экрана чата / экрана настроек

Работа с экраном

window.WebApp.requestScreenMaxBrightness()

Устанавливает яркость экрана пользователя на максимум

Приложение поддержит максимальную яркость 30 секунд, затем восстановит исходное значение

Типы данных и пример

Тип возвращаемых данных

Пример

JAVASCRIPT

Скопировать

Promise<{maxBrightness: boolean}>

window.WebApp.restoreScreenBrightness()

Восстанавливает яркость экрана пользователя до исходного значения

Типы данных и пример

Тип возвращаемых данных

Пример

JAVASCRIPT

Скопировать

Promise<{maxBrightness: boolean}>

window.WebApp.ScreenCapture.enableScreenCapture()

Включает возможность делать скриншоты или записывать экран

Типы данных и пример

Тип возвращаемых данных

Пример

JAVASCRIPT

Скопировать

Promise<{isScreenCaptureEnabled: boolean}>

window.WebApp.ScreenCapture.disableScreenCapture()

Отключает возможность делать скриншоты или записывать экран

Типы данных и пример

Тип возвращаемых данных

Пример

JAVASCRIPT

Скопировать

Promise<{isScreenCaptureEnabled: boolean}>

window.WebApp.getViewportSize()

Возвращает текущий размер доступной области просмотра мини-приложения (viewport). Эти данные необходимо учитывать для корректного отображения мини-приложения

Тип возвращаемых данных

Пример

JAVASCRIPT

Скопировать

Promise<{
    height: string,          
    width: string           
    }>

Запрос номера телефона

Обратите внимание: отправка номера телефона в чат-бот описана на странице API

window.WebApp.requestContact()

Запрашивает номер телефона пользователя в модальном окне нативного клиента MAX

Данные пользователя (включая номер телефона), полученные с помощью метода requestContact(), могут использоваться только для взаимодействия с текущим мини-приложением. Например, их можно применять для регистрации в программе лояльности, проверки статуса заказа, идентификации пользователя

Типы данных и пример

Тип возвращаемых данных

Пример

JAVASCRIPT

Скопировать

Promise<{
    phone: string;
    authDate: string; // timestamp создания hash
    hash: string;
}>

Проверка номера телефона

Для проверки, что полученный на запрос номер телефона совпадает с номером, привязанным к аккаунту пользователя в MAX, сравните:

Значение поля hash, полученное от клиента
Значение функции HMAC_SHA256(authDate + phone + userId, botToken), где:
- HMAC_SHA256 — стандартная для большинства языков программирования криптографическая функция
- authDate + phone + userId — параметры в алфавитном порядке, используемые для вычисления хеша: сформируйте строку, объединив пары key=value с разделителем \n
- botToken — токен бота, чьё мини-приложение запрашивает номер телефона пользователя

Если значения совпадают, это подтверждает, что пользователь поделился номером телефона, привязанным к его аккаунту в MAX

При вычислении хеша значение phone не должно содержать +: вместо +7********** используется 7**********

Возможные ошибки

Если пользователь отказывается поделиться номером телефона или запрос завершился ошибкой, возвращает:

JSON

Скопировать

{
    "error": {
        "code": "client.request_phone.<reason>"
    }
}

Номер ошибки	Возможное значение `reason`	Описание ошибки
01	`user_refused_provide_phone_number`	Пользователь отказался предоставить номер телефона
02	`request_error`	Ошибка при выполнении запроса (нет сети / не ответил backend)

Подтверждение закрытия мини-приложения

Обратите внимание, что возможности из этой категории отправляют запрос приложению MAX в одностороннем порядке

window.WebApp.enableClosingConfirmation()

Включает предупреждение о риске потерять заполненные данные, если закрыть мини-приложение

Пример

JAVASCRIPT

Скопировать

window.WebApp.enableClosingConfirmation()

window.WebApp.disableClosingConfirmation()

Выключает предупреждение о риске потерять заполненные данные, если закрыть мини-приложение

Пример

JAVASCRIPT

Скопировать

window.WebApp.disableClosingConfirmation()

Открытие ссылок

Библиотека поддерживает два формата открытия ссылок:

во внешнем браузере
в виде диплинка, связанного с max.ru

window.WebApp.openLink(url)

Открывает ссылку во внешнем браузере

Чтобы обезопасить процесс, перед вызовом метода MAX Bridge проверяет клик пользователя в мини-приложении. Если клика не было, перехода по ссылке не будет

Типы данных и пример

Тип передаваемых данных

Пример

JAVASCRIPT

Скопировать

// URL веб-страницы, которую нужно открыть
url: string

window.WebApp.openMaxLink(url)

Открывает диплинк вида https://max.ru/<some-url> из мини-приложения внутри MAX. Если передать ссылку другого вида, метод откроет её во внешнем браузере

Типы данных и пример

Тип передаваемых данных

Пример

JAVASCRIPT

Скопировать

// Диплинк для клиента MAX
url: string

Скачивание файла

Условие для скачивания файла — наличие защищённого https-соединения

Чтобы обезопасить процесс, перед вызовом метода MAX Bridge проверяет клик пользователя в мини-приложении. Если клика не было, файл не будет скачан

window.WebApp.downloadFile(url, file_name)

Скачивает файл по переданной https-ссылке под нужным названием

Типы данных и пример

Тип передаваемых данных

Тип возвращаемых данных

Пример

JAVASCRIPT

Скопировать

url: string // URL для доступа к нужному ресурсу
file_name: string // Название файла

Шеринг контента

В библиотеке есть два способа для шеринга контента:

во внешние приложения
внутри MAX

window.WebApp.shareContent(params)

Вызывает нативный экран шеринга из мини-приложения на iOS, Android. Передаются параметры text и/или link: один из параметров всегда должен быть передан. Разделение является условным и сделано для удобства восприятия: если передать и текст, и ссылку в одном поле text, то результат не изменится

Этот метод не поддерживается веб-приложением

Типы данных и пример

Тип передаваемых данных

Тип возвращаемых данных

Пример

JAVASCRIPT

Скопировать

params: {
    text?: string;
    link?: string
}

window.WebApp.shareMaxContent(params)

Открывает экран шеринга внутри MAX

Чтобы обезопасить процесс, перед вызовом метода MAX Bridge проверяет клик пользователя в мини-приложении. Если клика не было, экран шеринга не откроется

Метод предоставляет возможность шеринга контента из мини-приложения в диалоги или групповые чаты MAX. Метод работает в двух режимах:

шеринг текста, который аналогичен WebApp.shareContent(params)
шеринг текста с контентом: файл, медиа

Для шеринга файла или медиа бот, на котором работает мини-приложение, предварительно отправляет контент пользователю через POST/messages. Шеринг медиа работает как пересылка сообщения, поэтому поддерживается любой тип контента:

Бот отправляет контент пользователю, например медиафайл или открытку
Мини-приложение получает идентификатор этого сообщения mid. Его возвращает MAX Bot API, когда сообщение отправляется пользователю
В мини-приложении вызывается shareMaxContent({ mid, chatType }), где mid — идентификатор сообщения от бота, а chatType — тип чата, сообщением из которого нужно поделиться:
- DIALOG — для диалога, личного чата между двумя пользователями
- CHAT — для группового чата. Пользователь должен быть участником чата
Пользователь выбирает, куда отправить контент — сообщение пересылается в выбранный чат

В метод передаются либо text и/или link, либо mid и chatType. Если при шеринге медиа или файла передать text или link, они будут проигнорированы

Типы данных и пример

Тип передаваемых данных

Тип возвращаемых данных

Пример

JAVASCRIPT

Скопировать

params: {
    text?: string;
    link?: string
} | {
    mid: string;
    chatType: 'DIALOG' | 'CHAT'
}

Сканирование QR-кодов

Библиотекой предусмотрено два режима работы:

сканирование QR-кода камерой
выбор файла для сканирования из файловой системы

По умолчанию установлен режим выбора файла из системы

window.WebApp.openCodeReader(fileSelect = true)

Открывает камеру для считывания QR-кода

Типы данных и пример

Тип передаваемых данных

Тип возвращаемых данных

Пример

JAVASCRIPT

Скопировать

// Использовать файл из системы или сканировать камерой
fileSelect: boolean

Вернётся результат в виде строки, если QR-код был найден и распознан

fileSelect = true — доступен также выбор из галереи
fileSelect = false — доступно сканирование только через камеру

Если fileSelect не передан, то по умолчанию считается fileSelect = true

Управление кнопкой «Назад» в шапке приложения

Управление кнопкой Назад происходит через объект BackButton

window.WebApp.BackButton.show()

Делает кнопку Назад активной и видимой

Пример

JAVASCRIPT

Скопировать

window.WebApp.BackButton.show()

window.WebApp.BackButton.hide()

Скрывает кнопку Назад

Пример

JAVASCRIPT

Скопировать

window.WebApp.BackButton.hide()

window.WebApp.BackButton.isVisible

Управляет отображением кнопки Назад в заголовке мини-приложения в интерфейсе MAX

Типы данных и пример

Тип возвращаемых данных

Пример

JAVASCRIPT

Скопировать

boolean

Значение false задано по умолчанию

window.WebApp.BackButton.onClick(callback)

Устанавливает обработчик событий нажатия на кнопку Назад

Чтобы оставить возможность отписки от события нажатия на кнопку, сохраните ссылку на функцию, которая будет передана в качестве callbcak

Типы данных и пример

Тип передаваемых данных

Пример

JAVASCRIPT

Скопировать

callback: () => void

window.WebApp.BackButton.offClick(callback)

Отключает обработчик событий нажатия кнопки Назад

Типы данных и пример

Тип передаваемых данных

Пример

JAVASCRIPT

Скопировать

callback: () => void

Хранилище устройства

С помощью DeviceStorage можно сохранять данные на устройстве пользователя. Объект предоставляет мини-приложению доступ к хранилищу данных, ассоциированному с конкретным пользователем MАХ

Методы этого объекта не поддерживаются веб-приложением

window.WebApp.DeviceStorage.setItem(key, value)

Сохраняет переданную пару «ключ-значение» в локальном хранилище устройства для этого мини-приложения

Типы данных и пример

Тип передаваемых данных

Тип возвращаемых данных

Пример

JAVASCRIPT

Скопировать

key: string
value: string

window.WebApp.DeviceStorage.getItem(key)

Получает значение из локального хранилища устройства по указанному ключу

Типы данных и пример

Тип передаваемых данных

Тип возвращаемых данных

Пример

JAVASCRIPT

Скопировать

key: string

window.WebApp.DeviceStorage.removeItem(key)

Удаляет значение из локального хранилища устройства по указанному ключу

Типы данных и пример

Тип передаваемых данных

Тип возвращаемых данных

Пример

JAVASCRIPT

Скопировать

key: string

window.WebApp.DeviceStorage.clear()

Очищает все ключи, ранее сохранённые ботом в локальном хранилище устройства

Пример

JAVASCRIPT

Скопировать

// Хранилище очищено
window.WebApp.DeviceStorage.clear();

Защищённое хранилище устройства

С помощью объекта SecureStorage можно получить доступ к безопасному хранилищу конфиденциальных данных на устройстве пользователя. Это гарантирует, что все сохраненные значения зашифрованы и недоступны для неавторизованных приложений

Защищённое хранилище подходит для хранения токенов, секретов, состояния аутентификации и другой конфиденциальной пользовательской информации. Каждый бот может хранить до 10 ключей на пользователя

Методы этого объекта не поддерживаются веб-приложением

window.WebApp.SecureStorage.setItem(key, value)

Сохраняет переданную пару «ключ-значение» в защищённом хранилище устройства

Типы данных и пример

Тип передаваемых данных

Тип возвращаемых данных

Пример

JAVASCRIPT

Скопировать

key: string
value: string

window.WebApp.SecureStorage.getItem(key)

Получает значение из защищённого хранилища устройства по указанному ключу

Типы данных и пример

Тип передаваемых данных

Тип возвращаемых данных

Пример

JAVASCRIPT

Скопировать

key: string

window.WebApp.SecureStorage.removeItem(key)

Удаляет значение из защищённого хранилища устройства по указанному ключу

Типы данных и пример

Тип передаваемых данных

Тип возвращаемых данных

Пример

JAVASCRIPT

Скопировать

key: string

window.WebApp.SecureStorage.clear()

Очищает все ключи, ранее сохранённые в защищённом хранилище устройства

Пример

JAVASCRIPT

Скопировать

// Хранилище очищено
window.WebApp.SecureStorage.clear();

Использование биометрии

Работа с биометрией доступна через объект BiometricManager. Он нужен для аутентификации, когда доступ к данным в keychain получается через биометрические идентификаторы

Методы этого объекта не поддерживаются десктоп- и веб-клиентом

window.WebApp.BiometricManager.init()

Перед использованием методов объекта BiometricManager нужно однократно вызвать метод первичной инициализации биометрии — init:

Проверяет наличие функции биометрии на устройстве
Проверяет, предоставлен ли доступ к биометрии на устройстве

Типы данных и пример

Тип возвращаемых данных

Пример

JAVASCRIPT

Скопировать

type BiometryType = 'finger' | 'face' | 'unknown';

interface BiometryInfo {
    available: boolean;
    type: BiometryType[];
    accessRequested: boolean;
    accessGranted: boolean;
    tokenSaved: boolean;
    deviceId: string | null;
}

Promise<BiometryInfo>

Поле	Тип данных	Описание
`available`	`boolean`	Проверка доступности биометрии на устройстве пользователя, который запустил мини-приложение
`type`	`array`	Типы биометрии: `fingerprint`, `faceid`, `unknown` Если пользователь отказался предоставить доступ к биометрии, то `biometricType= array<unknown>`. Для Android всегда `unknown`
`accessRequested`	`boolean`	Проверка отправки запроса на предоставление доступа к биометрии устройства Если пользователь отказался предоставить доступ к биометрии, то `accessRequested = false`
`accessGranted`	`boolean`	Проверка предоставления доступа к биометрии
`tokenSaved`	`boolean`	Проверка наличия токена авторизации через биометрию в безопасном хранилище устройства
`deviceId`	`string`	Идентификатор устройства — можно использовать для сопоставления токена с устройством

window.WebApp.BiometricManager.isInited

Получает состояние инициализации BiometricManager — была ли ранее первичная инициализация

Типы данных и пример

Тип возвращаемых данных

Пример

JAVASCRIPT

Скопировать

boolean

window.WebApp.BiometricManager.isBiometricAvailable

Проверяет доступность биометрии на устройстве пользователя, который запустил мини-приложение

Типы данных и пример

Тип возвращаемых данных

Пример

JAVASCRIPT

Скопировать

boolean

Если пользователь отказался предоставить доступ к биометрии, значение будет false

window.WebApp.BiometricManager.isAccessRequested

Проверяет, был ли ранее отправлен запрос на предоставление доступа к биометрии устройства

Типы данных и пример

Тип возвращаемых данных

Пример

JAVASCRIPT

Скопировать

boolean

Если пользователь отказался предоставить доступ к биометрии, значение будет false

window.WebApp.BiometricManager.isAccessGranted

Проверяет, предоставлен ли доступ к биометрии

Типы данных и пример

Тип возвращаемых данных

Пример

JAVASCRIPT

Скопировать

boolean

Если пользователь отказался предоставить доступ к биометрии, значение будет false

window.WebApp.BiometricManager.isBiometricTokenSaved

Проверяет наличие токена в безопасном хранилище устройства

Типы данных и пример

Тип возвращаемых данных

Пример

JAVASCRIPT

Скопировать

boolean

window.WebApp.BiometricManager.biometricType

Позволяет посмотреть доступные типы биометрии:

fingerprint
faceid
unknown

Типы данных и пример

Тип возвращаемых данных

Пример

JAVASCRIPT

Скопировать

Array<'finger' | 'face' | 'unknown'>

Если пользователь отказался предоставить доступ к биометрии, то biometricType=["unknown"]

Для Android всегда ["unknown"]

window.WebApp.BiometricManager.deviceId

Возвращает идентификатор устройства — можно использовать для сопоставления токена с устройством

Типы данных и пример

Тип возвращаемых данных

Пример

JAVASCRIPT

Скопировать

string | null

Возвращает null, если пользователь отказался предоставить доступ к биометрии

window.WebApp.BiometricManager.requestAccess(reason)

Отправляет запрос на доступ к использованию биометрии на устройстве

Возвращает тип данных BiometryInfo, подробнее — в подразделе про использование биометрии

Типы данных и пример

Тип передаваемых данных

Тип возвращаемых данных

Пример

JAVASCRIPT

Скопировать

// Причина запроса мини-приложения на использование доступа
// Размер: 1-128 символов, остальное будет отрезаться
// Необязательное поле
reason?: string

window.WebApp.BiometricManager.authenticate(reason)

Запускает процесс аутентификации при помощи биометрических данных

Типы данных и пример

Тип передаваемых данных

Тип возвращаемых данных

Пример

JAVASCRIPT

Скопировать

// Причина запроса мини-приложения на использование доступа
// Размер: 1-128 символов, остальное будет отрезаться
// Необязательное поле
reason?: string

window.WebApp.BiometricManager.updateBiometricToken(token, reason)

Обновляет биометрический токен в безопасном хранилище устройства

Для удаления токена вызовите метод без передачи параметра токена

Типы данных и пример

Тип передаваемых данных

Тип возвращаемых данных

Пример

JAVASCRIPT

Скопировать

token?: string
// Причина запроса мини-приложения на использование доступа
// Размер: 1-128 символов, остальное будет отрезаться
// Необязательное поле
reason?: string

window.WebApp.BiometricManager.openSettings()

Отображает нативное диалоговое окно с предложением перейти в настройки MAХ на экран приватности, чтобы дать доступ к биометрии устройства для мини-приложения

Вызывает закрытие мини-приложения

Типы данных и пример

Тип возвращаемых данных

Пример

JAVASCRIPT

Скопировать

Promise<{
    status: 'opened'
}>

Тактильные отклики

Чтобы активировать и настроить тактильную обратную связь при взаимодействии пользователя с веб-приложением, используйте объект HapticFeedback

Методы этого объекта не поддерживаются десктоп- и веб-клиентом

window.WebApp.HapticFeedback.impactOccurred(impactStyle, disableVibrationFallback)

С помощью этого метода приложение MAX может воспроизвести соответствующие тактильные эффекты на основе переданного значения стиля

Подходит для тактильного отклика на интерактивные элементы, например при нажатии на кнопку

Стиль может иметь одно из следующих значений:

soft — мягкая вибрация
light — лёгкая вибрация
medium — средняя вибрация
heavy — сильная вибрация
rigid — жёсткая вибрация

disableVibrationFallback — разрешение использовать вибрацию с постоянной амплитудой на устройствах, которые не поддерживают вибрацию с переменной амплитудой. Значение по умолчанию: false

Типы данных и пример

Тип передаваемых данных

Тип возвращаемых данных

Пример

JAVASCRIPT

Скопировать

impactStyle: 'light' | 'medium' | 'heavy' | 'rigid' | 'soft'
disableVibrationFallback?: boolean // По умолчанию false

window.WebApp.HapticFeedback.notificationOccurred(notificationType, disableVibrationFallback)

Возвращает статус событий или действий: выполнены успешно, не удалось выполнить или выдано предупреждение

Приложение MAХ может воспроизводить соответствующие тактильные сигналы на основе переданного значения типа. Тип может быть одним из следующих значений:

error — не удалось выполнить
success — выполнены успешно
warning — выдано предупреждение

Типы данных и пример

Тип передаваемых данных

Тип возвращаемых данных

Пример

JAVASCRIPT

Скопировать

impactStyle: 'error' | 'success' | 'warning'
disableVibrationFallback?: boolean // По умолчанию false

window.WebApp.HapticFeedback.selectionChanged(disableVibrationFallback)

Сообщает, что пользователь изменил выбор

Приложение MAX может воспроизвести соответствующие тактильные сигналы

Не используйте эту обратную связь, когда пользователь делает или подтверждает выбор. Используйте её только при изменении выбора

Типы данных и пример

Тип передаваемых данных

Тип возвращаемых данных

Пример

JAVASCRIPT

Скопировать

// По умолчанию false
disableVibrationFallback?: boolean

NFC-модуль

Работа с NFC-модулем доступна через объект NfcManager

Методы этого объекта поддерживаются только для Android

Чтобы начать использовать методы объекта NfcManager, необходимо сначала вызвать его метод инициализации init

window.WebApp.NfcManager.init()

Инициализирует NfcManager

Типы данных и пример

Тип возвращаемых данных

Пример

JAVASCRIPT

Скопировать

interface NfcInfo {
  available: boolean;
  enabled: boolean;
  accessRevoked?: boolean;
}

Описание свойств объекта

Поле	Тип данных	Описание
`available`	`boolean`	Проверка наличия NFC-модуля на устройстве пользователя
`enabled`	`boolean`	Проверка включения NFC-модуля в настройках системы
`accessRevoked?`	`boolean`	Отозвал ли пользователь разрешение использовать NFC-модуль для текущего мини-приложения в настройках приватности MAX

window.WebApp.NfcManager.isInited

Возвращает состояние инициализации NfcManager

Типы данных и пример

Тип возвращаемых данных

Пример

JAVASCRIPT

Скопировать

boolean

window.WebApp.NfcManager.openSystemSettings()

Открывает страницу системных настроек доступа к NFC-модулю и вызывает закрытие мини-приложения

Если пользователь не отключал NFC-модуль, то переход не будет выполнен

Типы данных и пример

Тип возвращаемых данных

Пример

JAVASCRIPT

Скопировать

Promise<{
    status: 'opened'
}>

window.WebApp.NfcManager.emulateNfcTag(nfctag)

Запускает через NFC-модуль передачу данных, полученных из мини-приложения

Если не передать данные NFC-метки, то вещание будет остановлено

Типы данных и пример

Тип передаваемых данных

Тип возвращаемых данных

Пример

JAVASCRIPT

Скопировать

nfctag?: 'string'

Ошибки и обработка исключений

Большинство методов возвращают Promise-объекты, и в случае ошибки вызывается reject

Типы данных и пример

Структура объекта ошибки

Пример

JAVASCRIPT

Скопировать

{
    error: {
        code: string
    }
}