更新记录

1.0.0（2026-06-17）

开箱即用，添加安卓，ios端震动功能

平台兼容性

uni-app x(5.0)

lin-vibrator

UniAppX的设备震动模块，封装了 Android 和 IOS 原生 Vibrator API，提供简单易用的震动功能。 【无需将HBuilder升级到alpha版本。】

功能概述

该模块提供跨平台的设备震动能力，支持三种震动时长模式：短震动、中震动和长震动。内部自动处理设备兼容性检查，确保在不支持震动的设备上不会报错。

平台支持

目前只支持Android和iOS两个平台

使用示例

基础用法

import { vibrate } from "@/uni_modules/lin-vibrator"
// 短震动
vibrate({
  type: 'short'
})

// 长震动
vibrate({
  type: 'long'
})

// 中等震动
vibrate({
  type: 'medium'
})

带回调的用法

vibrate({
  type: 'short',
  success: () => {
    console.log('震动成功')
  },
  fail: () => {
    console.error('设备不支持震动')
  },
  complete: () => {
    console.log('震动操作完成')
  }
})

VibrateType 类型

震动类型枚举，定义了三种震动时长：

VibrateOptions 接口

震动配置参数对象：

export type VibrateOptions = {
  type: VibrateType
  success?: () => void
  fail?: () => void
  complete?: () => void
}

vibrate(options: VibrateOptions)

触发设备震动。

参数：

返回值： void

依赖说明

• Android API: 需要 Android 系统支持 Vibrator 服务
• 系统权限: 无需额外权限（Android 6.0+ 震动功能默认可用）

注意事项

1. 该模块仅适用于 Android 和 iOS 平台
2. 在不支持震动的设备上，会调用 fail 回调并输出错误日志
3. complete 回调在成功和失败两种情况下都会执行，适合用于清理操作
4. 震动时长单位为毫秒（ms）