Тактильная отдача в MAX Bridge: методы HapticFeedback

HapticFeedback: почему его нет на десктопе

Документация MAX Bridge вводит объект одной фразой:

Сразу под ней — предупреждение вынесено в отдельную врезку, а не растворено в тексте:

Что именно произойдёт при вызове любого из трёх методов на десктопе или в веб-версии — страница не уточняет: не сказано, вернёт ли вызов ошибку или просто ничего не случится. Единственный факт, зафиксированный документацией, — поддержки там нет. Для мини-приложения, открытого не на телефоне, тактильный отклик как канал связи с пользователем просто отсутствует.

Три метода — три сигнала

У объекта HapticFeedback ровно три метода, и у каждого своё назначение: impactOccurred — отклик на нажатие интерактивного элемента, notificationOccurred — отклик на результат действия, selectionChanged — отклик на смену выбора без результата как такового. Про первый документация пишет так:

Формулировка про второй метод устроена иначе — сначала описан не сам вызов, а смысл параметра, который в него передают:

Слово «возвращает» тут не про Promise и не про значение, которое метод отдаёт вызвавшему коду — ни у одного из трёх методов раздел не показывает пример возвращаемого значения, только форму передаваемых параметров. Возвращает статус в этом предложении сам факт вибрации: телефон отвечает пользователю on-device, а не приложению.

Пять стилей одного нажатия

У impactOccurred самый широкий выбор из трёх методов — стиль вибрации задаётся одним из пяти значений:

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

В типах TypeScript это перечисление выглядит так:

У notificationOccurred выбор втрое уже — только error, success и warning. У selectionChanged выбора нет вовсе: метод принимает единственный необязательный параметр и не различает, что именно изменилось в выборе пользователя.

В примере кода — чужое имя параметра

Сигнатура второго метода называет параметр notificationType — так написано в заголовке раздела и в тексте описания. Но в блоке «Типы данных и пример» под тем же методом строка выглядит иначе:

Имя параметра в примере — impactStyle, то есть буквально то же имя, что и в примере кода соседнего метода impactOccurred, только со значениями error / success / warning вместо стилей вибрации. По всему разделу словосочетание notificationType встречается один раз — в заголовке метода, и ни разу больше в его собственном примере кода. Похоже на копию блока от impactOccurred, в которой заменили набор значений, но не имя переменной.

Когда вибрацию просят не использовать

У третьего метода, selectionChanged, в документации есть отдельная оговорка о том, когда его вызывать не следует:

Разница на первый взгляд едва заметна: и пролистывание списка вариантов, и финальный тап по одному из них — это действия с одним и тем же переключателем. Но документация разводит их по разным откликам: смена варианта во время выбора — это selectionChanged, а подтверждение или отмена самого выбора — задача уже impactOccurred или notificationOccurred, а не этого метода.

Один запасной вариант на все три метода

У каждого из трёх методов есть общий необязательный параметр — disableVibrationFallback. Формулировка повторяется у всех троих дословно:

Частые вопросы