更新记录

1.0.0（2026-03-14）

• 按钮点击
• 保存成功
• 警告提醒
• 错误提醒
• 轻触 / 中等 / 强反馈
• Android 自定义时长震动
• Android 节奏震动
• 停止震动
• 当前设备能力展示

平台兼容性

uni-app(4.75)

uni-app x(4.75)

austin-haptics

austin-haptics 是一个统一的 Android / iOS 震动触感插件。

当前目录下的 index.vue 是完整模板页，演示的是一套新人拿来就能试的触感反馈页面，包含：

• 按钮点击
• 保存成功
• 警告提醒
• 错误提醒
• 轻触 / 中等 / 强反馈
• Android 自定义时长震动
• Android 节奏震动
• 停止震动
• 当前设备能力展示

试用说明

• 可以直接点击“试用插件”
• 试用内容就是完整模板页，已经把常见场景按钮和示例调用都摆好了
• 页面层不需要区分 Android 和 iOS，直接调用同一个 vibrate() 方法即可
• Android 支持更强的自定义时长和节奏震动
• iOS 不支持完全一致的时长/节奏时，会自动降级成最接近的触感反馈

功能特性

• 支持统一调用 vibrate(options)
• 支持 short / long
• 支持 light / medium / heavy
• 支持 success / warning / error
• 支持 cancelVibration()
• 支持 isVibrationSupported()
• 支持查询当前设备能力
• Android 支持自定义时长、节奏震动和重复震动
• iOS 会自动做能力降级

安装

将 uni_modules/austin-haptics 目录复制到项目的 uni_modules 目录下。

模板页示例：

• index.vue

项目里另外提供了一个实际路由页面：

• pages/haptics/index

API

vibrate(options?)

统一触发震动或触感反馈。

参数：

• type: 场景类型，支持 short long light medium heavy success warning error
• duration: 自定义时长，Android 生效，iOS 会自动降级
• pattern: 节奏数组，Android 生效，iOS 会自动降级
• repeatIndex: 重复索引，Android 生效，iOS 会自动降级

cancelVibration()

停止当前震动。Android 支持，iOS 通常不支持。

isVibrationSupported()

判断当前设备是否支持震动或触感反馈。

getHapticsCapabilities()

返回当前设备能力：

• supported
• platform
• supportsPreset
• supportsDuration
• supportsPattern
• supportsRepeat
• supportsCancel
• notes

最小调用

import { vibrate, cancelVibration } from '@/uni_modules/austin-haptics'

vibrate({ type: 'light' })
vibrate({ type: 'success' })
vibrate({ type: 'warning', pattern: [0, 120, 80, 120] })

cancelVibration()

模板页试用方法

1. 点击“试用插件”
2. 先点“按钮点击”“保存成功”“错误提醒”感受常见场景
3. 再点 Android 增强场景里的“持续 0.8 秒”“连续两下”“告警节奏”
4. 如果测试了循环提醒，可再点“停止震动”
5. 页面里会直接显示当前设备能力和最近一次体验结果

注意事项

• 页面层不需要自己判断平台
• Android 和 iOS 会走同一套调用
• Android 支持更强的震动能力
• iOS 会自动降级成最接近的触感反馈
• 如果 iPhone 点击按钮没有任何触感，先检查系统开关：
  • 设置 > 声音与触感 > 系统触感 需要开启
  • 设置 > 辅助功能 > 触控 > 振动 需要开启
• 真机效果会因设备马达和系统版本不同而有所差异