微信小程序提供了两个用于振动的API接口:`wx.vibrateLong()` 和 `wx.vibrateShort()`。
wx.vibrateLong() 功能
:使手机震动一段时间,适用于需要较长时间的震动反馈场景。
参数 `success`:接口调用成功的回调函数(可选)。 `fail`:接口调用失败的回调函数(可选)。 `complete`:接口调用结束的回调函数(可选,无论成功或失败都会执行)。 版本要求
wx.vibrateShort() 功能
:使手机短暂震动,适用于需要短暂震动反馈场景。
参数 `success`:接口调用成功的回调函数(可选)。 `fail`:接口调用失败的回调函数(可选)。 `complete`:接口调用结束的回调函数(可选,无论成功或失败都会执行)。 版本要求
使用建议
选择合适的接口:根据你的需求选择合适的震动接口。如果需要长时间震动,使用 `wx.vibrateLong()`;如果只是短暂震动,使用 `wx.vibrateShort()`。
版本检查:在调用这些接口之前,确保你的小程序基础库版本满足要求。
平台兼容性:`wx.vibrateShort()` 接口在 iPhone 7/7 Plus 及 Android 机型上有效,如果安卓系统设置中开启了自动调节亮度功能,可能会影响震动效果。
示例代码
```javascript
wx.vibrateShort({
success: function() {
console.log('振动成功');
},
fail: function() {
console.log('振动失败');
},
complete: function() {
console.log('振动结束');
}
});
```
这个示例代码会在成功调用 `wx.vibrateShort()` 后输出“振动成功”,在失败时输出“振动失败”,无论成功或失败都会执行 `complete` 回调函数。