Skip to main content

Haptics

Home Assistant Companion features haptics, which provide physical feedback when interacting with the UI. Areas you will feel haptic feedback include toggles (lights, switches, input_booleans) and input_selects. Certain scenarios such as invalid service call errors will also generate haptic feedback.

iOS

iPhone models that support haptic feedback include the iPhone 7 and 7 Plus, iPhone 8 and 8 Plus, the iPhone X, XR, XS, XS Max, iPhone 11 and 11 Pro.

Android

Android devices that have haptic feedback support and/or a vibration motor can expect to feel some type of feedback.

Disabling Haptics#

Home Assistant Companion respects the OS-level setting for disabling haptics. In iOS Settings, navigate to "Sounds & Haptics" and then toggle off "System Haptics" at the bottom of the screen. See the Apple Support document for more information. On Android you can disable Vibration from the Home Assistant user profile page to disable this feature.

Developers: Integrating Haptics into Custom Cards#

WIP: Instructions on integrating haptics supports into custom cards will go here. You can fire an event when your custom card is interacted with that the iOS app will listen for and re-interpret into haptic feedback.

Home Assistant Companion supports all seven haptic strength levels as defined by Apple's Human Interface Guidelines. Android will try to make a best effort to match these with existing Haptic Feedback Constants and/or Vibration Effects.

HapticDescription
successIndicates that a task or action has completed.
warningIndicates that a task or action has produced a warning of some kind.
failureIndicates that a task or action has failed.
lightProvides a physical metaphor that complements the visual experience.
mediumProvides a physical metaphor that complements the visual experience.
heavyProvides a physical metaphor that complements the visual experience.
selectionIndicates that the selection is actively changing.

Custom Cards that use haptics: