Библиотека MAX Bridge даёт мини-приложению доступ к системным возможностям телефона — от открытия ссылок до NFC-модуля. Раздел «Сканирование QR-кодов» — самый короткий во всей документации: один метод вместо двух-трёх у соседних разделов. И в этом одном методе подпись расходится с тем, что метод делает по умолчанию.
Один метод на весь раздел
В документации MAX Bridge (dev.max.ru) у раздела «Сканирование QR-кодов» нет соседних методов — только один, с описанием режимов работы в самом начале:
Библиотекой предусмотрено два режима работы:
dev.max.ru, раздел «Сканирование QR-кодов»Дальше режимы перечислены списком — сканирование камерой и выбор файла для сканирования из файловой системы. Ни второго метода, ни отдельного параметра для переключения формата ответа в разделе нет: всё управление — один булев аргумент у единственного метода.
Два режима — и какой из них включён по умолчанию
Перед описанием самого метода документация сразу называет режим по умолчанию:
По умолчанию установлен режим выбора файла из системы.
dev.max.ru, раздел «Сканирование QR-кодов»То есть без явного указания параметра приложение не включает камеру сразу, а показывает системный выбор файла — тот же диалог, что при прикреплении картинки к сообщению.
Подпись метода говорит «камера» — по умолчанию доступна и галерея
Сам метод в документации оформлен как заголовок с уже подставленным значением по умолчанию прямо в сигнатуре:
window.WebApp.openCodeReader(fileSelect = true)
Сразу под этой сигнатурой стоит короткое описание действия:
Открывает камеру для считывания QR-кода.
window.WebApp.openCodeReader(fileSelect = true), dev.max.ruА чуть ниже, в описании самого параметра, выясняется, что при этом же значении по умолчанию (fileSelect = true) пользователю доступен ещё и выбор из галереи:
fileSelect = true — доступен также выбор из галереи.
dev.max.ru, раздел «Сканирование QR-кодов»Строго камерой, без файлового диалога, сканер работает только при явном fileSelect = false:
fileSelect = false — доступно сканирование только через камеру.
dev.max.ru, раздел «Сканирование QR-кодов»Получается разрыв между заголовком метода и его же описанием чуть ниже: строка сигнатуры и подпись под ней читаются как «открывает камеру», а фактическое поведение по умолчанию — это камера плюс выбор из галереи одновременно, и явно только-камерный режим включается отдельным значением параметра.
Что возвращает метод, и о чём документация молчит
Про результат работы метода в разделе сказано одной фразой, с явной оговоркой про условие:
Вернётся результат в виде строки, если QR-код был найден и распознан.
window.WebApp.openCodeReader(fileSelect = true), dev.max.ruФормулировка описывает только успешный исход. Что произойдёт, если пользователь закроет камеру или файловый диалог без выбора, если снимок не распознан как QR-код или если доступ к камере не выдан, — в разделе не сказано. Про параметр документация уточняет только поведение по умолчанию:
Если fileSelect не передан, то по умолчанию считается fileSelect = true.
dev.max.ru, раздел «Сканирование QR-кодов»То есть у единственного метода раздела зафиксировано ровно одно значение параметра, одно значение по умолчанию и один описанный сценарий возврата — успешное распознавание. Остальные исходы остаются на усмотрение разработчика мини-приложения.
Частые вопросы
Какой режим сканирования QR-кода в MAX Bridge включён по умолчанию?
Выбор файла из системы — при значении параметра fileSelect по умолчанию (true) пользователю доступен и этот диалог, и камера.
Как включить в openCodeReader сканирование строго камерой, без файлового диалога?
Передать методу значение fileSelect = false — только тогда, по формулировке документации, доступно исключительно сканирование через камеру.
Что возвращает openCodeReader, если QR-код не распознан?
В документации это не описано — названо только поведение при успешном распознавании: результат в виде строки.
Сколько методов у раздела «Сканирование QR-кодов» библиотеки MAX Bridge?
Один — openCodeReader с единственным параметром fileSelect, в отличие от соседних разделов библиотеки с двумя-тремя методами.
Развиваете канал или бота в MAX?
Добавьте его в каталог MaxOfficial — читатели находят каналы через поиск и подборки, а статистика копится автоматически.
Добавить канал в каталог
