uni.vibrate 无法调节震动强度,ios 需用 plus.ios + uiimpactfeedbackgenerator 实现三档触感,android 仅能控制时长与节奏,且受系统限制严格。

uni.vibrate 不能调节震动强度,它根本没这个参数
uni-app 的 uni.vibrateShort 和 uni.vibrateLong 是纯系统级封装,不接受强度、波形或毫秒级自定义。传 { type: 'light' } 或 { duration: 30 } 在绝大多数版本中会被直接忽略——尤其是 iOS,连日志都不会打。所谓“强度调节”在跨平台 API 层面并不存在。
iOS 真正可控的触感反馈得用 plus.ios + UIImpactFeedbackGenerator
想在 iOS App 端实现按钮按下(轻量)、确认(中等)、错误(沉重)三档反馈,必须绕过 uni.vibrateShort,改用原生桥接:
-
plus.ios.importClass('UIImpactFeedbackGenerator')导入生成器类 - 通过
plus.ios.invoke('UIImpactFeedbackStyle', 'Light')指定风格(Light/Medium/Heavy) - 必须先调
impact.prepare(),再调impact.impactOccurred(),否则静默失败 - 仅限
#ifdef APP-PLUS下使用,H5 / 小程序环境不可用
Android 端无法真正“调节强度”,只能控制时长和节奏
Android 底层 Vibrator 不暴露马达电压或振幅接口,所谓“强度”实际是时长+频率组合的主观感受:
-
plus.device.vibrate(15)是最短可用值,低于 10ms 系统会截断 - 连续震动需手动节流:两次调用间隔 ≥ 50ms,否则被系统合并或丢弃
- 厂商 ROM(如华为 EMUI、小米 HyperOS)可能强制屏蔽非前台应用震动,即使权限已开
- Android 8.0+ 要求运行时申请
android.permission.VIBRATE,且 manifest.json 中必须显式声明
别指望 uni.vibrate({ type: 'light' }) 在老项目里生效
该写法仅在 uni-app 3.99+ 版本中被识别,低版本(比如常见于 Vue2 项目中的 2.x 或 3.7.x)会直接忽略整个对象参数,退化为无参调用,结果不可控:
- iOS 上退化为静默或等效
uni.vibrateLong - Android 上可能按默认 15ms 执行,也可能因参数非法而 fail 不触发
- 检查当前 uni-app CLI 版本:
uni-app -v,不是 HBuilderX 版本号 - 升级前务必验证
uni.getSystemInfoSync().uniCompileVersion是否 ≥ "3.99"
最易被忽略的一点:iOS 触感反馈是否开启,无法通过代码检测,也不能触发系统弹窗请求——你只能在设置页引导用户手动打开「辅助功能 → 触感反馈」,否则所有原生触感调用都白写。











