Интерфейс вибрации

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

Вибрация описывается как последовательность импульсов включения/выключения различной длительности. Шаблон может состоять либо из одного целого числа, описывающего количество миллисекунд вибрации, либо из массива целых чисел, описывающих последовательность вибраций и пауз. Управление вибрацией осуществляется с помощью единственного метода: Navigator.vibrate().

Вы можете вызвать вибрацию один раз, указав либо одно значение, либо массив, содержащий только одно значение:

navigator.vibrate(200);
navigator.vibrate([200]);

Оба этих примера вибрируют устройство на 200 мс.

Массив значений описывает чередующиеся периоды вибрации и пауз устройства. Каждое значение в массиве преобразуется в целое число и затем интерпретируется как количество миллисекунд вибрации и количество миллисекунд паузы. Например:

navigator.vibrate([200, 100, 200]);

Это вибрирует устройство в течение 200 мс, затем делает паузу в 100 мс, прежде чем вибрировать снова на 200 мс.

Вы можете указать любое количество пар вибрация/пауза, и вы можете предоставить четное или нечетное количество элементов. Важно отметить, что вам не обязательно предоставлять паузу в качестве последнего элемента, так как вибрация автоматически останавливается в конце каждого периода вибрации.

Вызов Navigator.vibrate() со значением 0, пустым массивом или массивом, содержащим только нули, отменит любой текущий шаблон вибрации.

Некоторые базовые setInterval и clearInterval действия позволят вам создавать постоянную вибрацию:

let vibrateInterval;

// Starts vibration at passed in level
function startVibrate(duration) {
  navigator.vibrate(duration);
}

// Stops vibration
function stopVibrate() {
  // Clear interval and stop persistent vibrating
  if (vibrateInterval) clearInterval(vibrateInterval);
  navigator.vibrate(0);
}

// Start persistent vibration at given duration and interval
// Assumes a number value is given
function startPersistentVibrate(duration, interval) {
  vibrateInterval = setInterval(() => {
    startVibrate(duration);
  }, interval);
}

Конечно, приведенный выше фрагмент кода не учитывает массивный метод вибрации; для создания постоянной вибрации, основанной на массиве, необходимо рассчитать сумму элементов массива и создать интервал на основе этого значения (вероятно, с дополнительной задержкой).

Navigator.vibrate()

Вызывает вибрацию на устройствах, поддерживающих ее. Если вибрация не поддерживается, ничего не делает.

• Navigator.vibrate()