Библиотека MAX Bridge — тот самый window.WebApp, через который мини-приложение достаёт до системных возможностей телефона: экрана, буфера обмена, NFC-модуля — и, среди прочего, до открытия ссылок. В документации (dev.max.ru) этому посвящены два соседних раздела на три метода: два — про переход по ссылке, один — про скачивание файла. Внутри — метод, который на одних ссылках ведёт себя как диплинк, а на других тихо превращается в обычную ссылку.
Три метода в двух соседних разделах
Документация MAX Bridge отводит ссылкам два раздела подряд: «Открытие ссылок» — про переход по адресу — и «Скачивание файла» — про сохранение файла на устройство. Раздел про открытие ссылок начинается с общей формулы:
Библиотека поддерживает два формата открытия ссылок.
dev.max.ru, раздел «Открытие ссылок»Дальше в исходном тексте эти два формата перечислены как список — «во внешнем браузере» и «в виде диплинка, связанного с max.ru» — и каждому формату отвечает отдельный метод.
Ссылка во внешнем браузере — и условие для неё
Первый метод открывает произвольный адрес в системном браузере телефона, за пределами MAX:
Открывает ссылку во внешнем браузере.
window.WebApp.openLink(url), dev.max.ruПеред этим MAX Bridge сам проверяет, что открытие ссылки — реакция на настоящее действие пользователя, а не программный вызов без повода:
Чтобы обезопасить процесс, перед вызовом метода MAX Bridge проверяет клик пользователя в мини-приложении.
dev.max.ruИ если условие не выполнено, ничего не произойдёт:
Если клика не было, перехода по ссылке не будет.
window.WebApp.openLink(url), dev.max.ruДиплинк, который сам становится обычной ссылкой
Второй метод раздела — не для произвольного адреса, а для диплинка на сам MAX:
Открывает диплинк вида https://max.ru/<some-url> из мини-приложения внутри MAX. Если передать ссылку другого вида, метод откроет её во внешнем браузере.
То есть openMaxLink не отклоняет «неправильный» адрес и не возвращает ошибку — он просто ведёт себя как openLink, если переданная ссылка не совпала с шаблоном https://max.ru/<путь>. Разработчику не нужно заранее проверять домен: один и тот же вызов обслуживает оба сценария, разница только в том, где в итоге откроется адрес — внутри MAX или в браузере.
Клик пользователя обязателен не всегда
Фраза про проверку клика из раздела 2 в документации — не разовая оговорка. Дословно она повторена ещё раз, слово в слово, у третьего метода — скачивания файла. А вот у диплинка, openMaxLink, этой фразы в тексте нет вовсе: единственное условие, которое для него зафиксировано, — совпадение ссылки с шаблоном max.ru.
Скачивание файла: два параметра без единого ограничения
Третий метод раздела не про переход, а про сохранение файла на устройство. У него своё условие — не про клик, а про протокол ссылки:
Условие для скачивания файла — наличие защищённого https-соединения.
И та же проверка клика, что и у openLink:
Если клика не было, файл не будет скачан.
window.WebApp.downloadFile(url, file_name), dev.max.ruСам метод принимает два параметра вместо одного — адрес и имя файла:
Скачивает файл по переданной https-ссылке под нужным названием.
Про тип или размер скачиваемого файла в разделе не сказано ничего — названы только два условия: защищённое соединение и реальный клик пользователя.
Частые вопросы
Что будет, если передать в openMaxLink ссылку, которая не начинается с https://max.ru/?
Метод откроет её во внешнем браузере — так же, как openLink. Ошибки при этом не возникает.
Нужно ли мини-приложению MAX самому проверять клик пользователя перед вызовом openLink?
Нет, это делает сам MAX Bridge: если реального клика не было, переход по ссылке не произойдёт.
Какое условие документация называет для скачивания файла в мини-приложении MAX?
Защищённое https-соединение — это единственное явно названное требование к ссылке, плюс тот же клик пользователя, что и у openLink.
Проверяет ли downloadFile тип или размер скачиваемого файла?
В документации об этом не сказано ничего — названы только протокол ссылки и обязательный клик пользователя.
Развиваете канал или бота в MAX?
Добавьте его в каталог MaxOfficial — читатели находят каналы через поиск и подборки, а статистика копится автоматически.
Добавить канал в каталог
