Добавьте тактильную обратную связь к событиям

Одним из основных вариантов использования тактильных ощущений является обеспечение обратной связи при взаимодействии с пользователем. Выбор времени, нажатие клавиш на виртуальной клавиатуре и выбор текста — типичные примеры хорошего использования тактильной обратной связи. Для получения дополнительной информации о том, когда и как применять тактильные ощущения, прочтите «Принципы проектирования тактильных ощущений» .

На этой странице описаны три способа обеспечения тактильной обратной связи.

• Используйте View (рекомендуется) . Этот подход ориентирован на действия, имеет самую широкую поддержку и не требует разрешения VIBRATE .
• Используйте предопределенный VibrationEffect . Этот подход более гибок, но имеет некоторые компромиссы.
• Используйте продвинутые композиции с примитивами . Этот метод более новый и еще более гибкий, но требует поддержки специального устройства.

Эти методы используют примитивы, определенные на уровне устройства, чтобы обеспечить высококачественную обратную связь, адаптированную к конкретному устройству.

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

Используйте компоненты View для создания тактильной обратной связи.

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

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

Предварительные требования: включить тактильную обратную связь.

Пока View отображается, для его событий можно использовать тактильную обратную связь. Некоторые события, такие как длительное нажатие, имеют тактильные ощущения по умолчанию, которые срабатывают, если прослушиватель в представлении обрабатывает событие (возвращает true ).

Android View может отключить тактильную обратную связь, установив для свойства View.hapticFeedbackEnabled значение false . Отключение этого свойства приводит к обратной связи по умолчанию.

Метод performHapticFeedback также учитывает системный параметр HAPTIC_FEEDBACK_ENABLED , который позволяет пользователю потенциально отключить их для всей системы.

В отличие от других тактильных API, использование HapticFeedbackConstants с View не требует разрешения VIBRATE .

Выберите HapticFeedbackConstant

При использовании компонентов View с HapticFeedbackConstants нет необходимости оценивать поддержку конкретного устройства, поскольку эти константы при необходимости будут иметь резервное поведение. Единственное, что следует учитывать, — это уровень SDK желаемой константы.

Пример 1: нажатие клавиши

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

class HapticTouchListener : View.OnTouchListener {
  override fun onTouch(View view, MotionEvent event) : Boolean {
    when (event.actionMasked) {
      MotionEvent.ACTION_DOWN ->
        view.performHapticFeedback(HapticFeedbackConstants.VIRTUAL_KEY)
      MotionEvent.ACTION_UP ->
        view.performHapticFeedback(HapticFeedbackConstants.VIRTUAL_KEY_RELEASE)
    }
    return true
  }
}

class HapticTouchListener implements View.OnTouchListener {
  @Override
  public boolean onTouch(View view, MotionEvent event) {
    switch (event.getAction()) {
      case MotionEvent.ACTION_DOWN:
        view.performHapticFeedback(HapticFeedbackConstants.VIRTUAL_KEY);
        break;
      case MotionEvent.ACTION_UP:
        view.performHapticFeedback(HapticFeedbackConstants.VIRTUAL_KEY_RELEASE);
        break;
    }
    return true;
  }
}

Пример 2: кнопка «Отправить»

Варианты использования тактильной обратной связи выходят за рамки моделирования физического взаимодействия с устройством. Они также могут использоваться для передачи абстрактного значения. Например, обычно ожидается, что эффект CONFIRM — это короткая и легкая вибрация, тогда как REJECT может быть более сильной обратной связью, сигнализирующей о сбое. Это проиллюстрировано в следующем примере для обратной связи по кнопке отправки.

submitButton.setOnClickListener { view ->
  val successful = performSubmit()
  if (successful) {
    view.performHapticFeedback(HapticFeedbackConstants.CONFIRM)
  } else {
    view.performHapticFeedback(HapticFeedbackConstants.REJECT)
  }
}

submitButton.setOnClickListener(view -> {
  boolean successful = performSubmit();
  if (successful) {
    view.performHapticFeedback(HapticFeedbackConstants.CONFIRM);
  } else {
    view.performHapticFeedback(HapticFeedbackConstants.REJECT);
  }
});

Используйте предопределенный VibrationEffect для создания тактильной обратной связи.

Использование подхода на основе View фокусируется на взаимодействии с пользователем. Это предпочтительно для обеспечения единообразия во всей системе. Однако определенные предопределенные API-интерфейсы VibrationEffect также можно вызывать для настройки эффектов тактильной обратной связи.

Предопределенные эффекты доступны в виде констант VibrationEffect , их можно проверить на наличие поддержки и воспроизвести с помощью службы Vibrator , как показано в следующих примерах.

Понимать поддержку устройствами API VibrationEffect .

При базовом использовании не должно быть необходимости проверять поддержку отдельных API VibrationEffect . Такие API, как Vibrator.areEffectsSupported и Vibrator.areAllEffectsSupported , используются для определения того, имеет ли устройство настроенную реализацию константы. Если настроенный эффект отсутствует, ваше приложение все равно может воспроизводить эффекты и использовать резервную реализацию, определенную платформой.

Дополнительные сведения см. в разделе Предопределенный VibrationEffect .

Предварительные требования: загрузите вибратор и разрешение VIBRATE

Большинство вибраций можно воспроизвести с помощью сервиса Vibrator , который можно загрузить следующим образом:

import android.os.Vibrator

val vibrator = context.getSystemService(Vibrator::class.java)

import android.os.Vibrator;

Vibrator vibrator = context.getSystemService(Vibrator.class);

Приложению необходимо иметь разрешение VIBRATE , чтобы вибрировать на устройстве с помощью этой службы. Разрешение можно добавить в файл манифеста приложения:

<uses-permission android:name="android.permission.VIBRATE"/>

Воспроизведение предопределенного VibrationEffect

Предопределенные эффекты можно подготовить с помощью VibrationEffect.createPredefined , а затем воспроизвести с помощью одного из методов vibrate в Vibrator .

В этом примере воспроизводится эффект щелчка.

val vibrator = context.getSystemService(Vibrator::class.java)
...
// Requires VIBRATE permission
vibrator.vibrate(VibrationEffect.createPredefined(VibrationEffect.EFFECT_CLICK))

Vibrator vibrator = context.getSystemService(Vibrator.class);
...
// Requires VIBRATE permission
vibrator.vibrate(VibrationEffect.createPredefined(VibrationEffect.EFFECT_CLICK));

Используйте сложные композиции с примитивами.

API VibrationEffect.Composition предлагает дополнительные возможности для тактильной обратной связи. Однако, в отличие от эффектов, эти примитивы не имеют резервов на системном уровне, а это означает, что необходимо уделять пристальное внимание примитивам и другим возможностям, поддерживаемым устройством.

Использование этих API более подробно обсуждается в разделе «Создание пользовательских тактильных эффектов» .