小程序震动接口怎么用

时间:2025-01-28 08:47:04 单机游戏

微信小程序提供了两个用于振动的API接口:`wx.vibrateLong()` 和 `wx.vibrateShort()`。

wx.vibrateLong()

功能:使手机震动一段时间,适用于需要较长时间的震动反馈场景。

参数

`success`:接口调用成功的回调函数(可选)。

`fail`:接口调用失败的回调函数(可选)。

`complete`:接口调用结束的回调函数(可选,无论成功或失败都会执行)。

版本要求:基础库版本不低于 1.2.0。

wx.vibrateShort()

功能:使手机短暂震动,适用于需要短暂震动反馈场景。

参数

`success`:接口调用成功的回调函数(可选)。

`fail`:接口调用失败的回调函数(可选)。

`complete`:接口调用结束的回调函数(可选,无论成功或失败都会执行)。

版本要求:基础库版本不低于 1.9.6,并且仅在 iPhone 7/iPhone 7 Plus 及 Android 机型生效。

使用建议

选择合适的接口:根据你的需求选择合适的震动接口。如果需要长时间震动,使用 `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` 回调函数。