Haptics

Haptics API 通过触觉或振动为用户提供物理反馈。

• impact(...)
• notification(...)
• vibrate()
• selectionStart()
• selectionChanged()
• selectionEnd()
• 接口
• 枚举

Android 注意事项

要使用振动功能，你必须在 AndroidManifest.xml 文件中添加以下权限：

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

示例

import { Plugins, HapticsImpactStyle } from '@capacitor/core';

const { Haptics } = Plugins;

export class HapticsExample {
  hapticsImpact(style = HapticsImpactStyle.Heavy) {
    Haptics.impact({
      style: style,
    });
  }

  hapticsImpactMedium(style) {
    this.hapticsImpact(HapticsImpactStyle.Medium);
  }

  hapticsImpactLight(style) {
    this.hapticsImpact(HapticsImpactStyle.Light);
  }

  hapticsVibrate() {
    Haptics.vibrate();
  }

  hapticsSelectionStart() {
    Haptics.selectionStart();
  }

  hapticsSelectionChanged() {
    Haptics.selectionChanged();
  }

  hapticsSelectionEnd() {
    Haptics.selectionEnd();
  }
}

API

impact(...)

impact(options: HapticsImpactOptions) => void

触发触觉“冲击”反馈

参数	类型
options	HapticsImpactOptions

---

notification(...)

notification(options: HapticsNotificationOptions) => void

触发触觉“通知”反馈

参数	类型
options	HapticsNotificationOptions

---

vibrate()

vibrate() => void

振动设备

---

selectionStart()

selectionStart() => void

触发选择开始的触觉提示

---

selectionChanged()

selectionChanged() => void

触发选择变化的触觉提示。如果选择已经开始，这将使设备提供触觉反馈

---

selectionEnd()

selectionEnd() => void

如果之前调用了 selectionStart()，selectionEnd() 将结束选择。例如，当用户从控件上抬起手指时调用此方法

---

接口

HapticsImpactOptions

属性	类型
style	HapticsImpactStyle

HapticsNotificationOptions

属性	类型
type	HapticsNotificationType

枚举

HapticsImpactStyle

成员	值
Heavy	"HEAVY"
Medium	"MEDIUM"
Light	"LIGHT"

HapticsNotificationType

成员	值
SUCCESS	"SUCCESS"
WARNING	"WARNING"
ERROR	"ERROR"