flutter-手机振动马达插件vibration使用详细指南

在移动应用开发中，手机振动反馈是提升用户体验的重要手段。无论是按钮点击、消息提醒还是游戏交互，恰当的振动反馈都能让操作更具沉浸感。Flutter 生态中的 vibration 插件为跨平台振动功能提供了简单易用的接口，本文将详细介绍其用法、特性及实战场景。

1. 插件概述

vibration 是一个支持 iOS 和 Android 平台的 Flutter 插件，它封装了原生振动 API，提供了统一的调用方式。其核心优势包括：

• 跨平台兼容：同时支持 iOS 和 Android，无需分别处理平台差异
• 功能丰富：支持简单振动、自定义时长振动、模式振动等多种类型
• 权限管理：自动处理振动权限请求（Android 平台）
• 设备检测：可判断设备是否支持振动功能

插件地址：传送门

2. 基础使用流程

下面是基础的使用流程：

2.1. 安装插件

在 pubspec.yaml 中添加依赖：

dependencies:
  flutter:
    sdk: flutter
  vibration: ^1.8.4  # 请使用最新版本

执行安装命令：

flutter pub get

2.2. 权限配置

Android 需在 AndroidManifest.xml 中添加振动权限：

<!-- android/app/src/main/AndroidManifest.xml -->
<uses-permission android:name="android.permission.VIBRATE" />

iOS 平台无需额外权限配置。

2.3. 导入并初始化

在需要使用振动功能的 Dart 文件中导入插件：

import 'package:vibration/vibration.dart';

3. 核心 API 详解

vibration 插件提供了多个静态方法，覆盖不同振动场景：

3.1. 检查设备振动支持

在使用振动功能前，建议先检查设备是否支持：

// 检查设备是否支持振动
bool hasVibrator = await Vibration.hasVibrator();
print('设备支持振动: $hasVibrator');

// 检查设备是否支持自定义振动模式（iOS 10+ 和部分 Android 设备）
bool hasAmplitudeControl = await Vibration.hasAmplitudeControl();
print('设备支持振幅控制: $hasAmplitudeControl');

// 检查设备是否支持自定义振动强度（仅部分 Android 设备）
bool hasCustomVibrationSupport = await Vibration.hasCustomVibrationSupport();
print('设备支持自定义振动: $hasCustomVibrationSupport');

3.2. 基础振动方法

• 简单振动

触发一次默认时长的振动：

// 触发振动（使用系统默认时长）
Vibration.vibrate();

// 带参数的振动（milliseconds 为振动时长，单位毫秒）
Vibration.vibrate(milliseconds: 500);  // 振动 500ms

• 取消振动

立即停止当前振动：

// 取消正在进行的振动
Vibration.cancel();

• 重复振动

按固定间隔重复振动：

// 重复振动：振动 500ms，暂停 1000ms，重复 3 次
Vibration.vibrate(
  milliseconds: 500,
  interval: 1000,  // 两次振动间隔
  repeat: 3,       // 重复次数
);

3.3. 高级振动模式

• 模式振动（Pattern Vibration）

自定义振动与暂停的交替模式，适用于复杂反馈场景：

// 振动模式：[振动时长, 暂停时长, 振动时长, 暂停时长, ...]
// 示例：振动 100ms → 暂停 100ms → 振动 200ms → 暂停 100ms → 振动 300ms
Vibration.vibrate(pattern: [100, 100, 200, 100, 300]);

• 带振幅的振动（Amplitude Vibration）

部分设备支持调节振动强度（振幅），值范围为 1-255：

// 检查设备是否支持振幅控制
if (await Vibration.hasAmplitudeControl()) {
  // 振动 500ms，振幅 100（中等强度）
  Vibration.vibrate(
    milliseconds: 500,
    amplitude: 100,  // 1-255，值越大振动越强
  );
}

• 预定义系统振动（仅 iOS）

iOS 支持触发系统预定义的振动模式（如通知、警告等）：

// 仅 iOS 有效
Vibration.vibrate(
  pattern: [0, 200, 100, 300],  // 自定义模式
  intensities: [0, 128, 0, 255], // 对应模式的强度（0-1）
);

4. 实战场景示例

下面是实战场景示例：

4.1. 按钮点击振动反馈

为按钮添加轻量级振动反馈，提升交互体验：

ElevatedButton(
  onPressed: () async {
    // 检查设备支持后振动
    if (await Vibration.hasVibrator()) {
      Vibration.vibrate(milliseconds: 30);  // 短振动
    }
    // 执行按钮逻辑
    handleButtonClick();
  },
  child: Text('点击我'),
)

4.2. 表单验证反馈

用不同振动模式区分验证结果：

Future<void> validateForm() async {
  if (_formKey.currentState!.validate()) {
    // 验证成功：短振动
    if (await Vibration.hasVibrator()) {
      Vibration.vibrate(milliseconds: 50);
    }
    submitForm();
  } else {
    // 验证失败：警告振动模式
    if (await Vibration.hasVibrator()) {
      Vibration.vibrate(pattern: [100, 50, 100]);  // 短-停-短
    }
    showErrorToast();
  }
}

4.3. 游戏振动反馈

在游戏场景中使用复杂振动模式增强沉浸感：

// 游戏成功振动模式
void vibrateSuccess() async {
  if (await Vibration.hasVibrator()) {
    Vibration.vibrate(pattern: [50, 30, 50, 30, 100]);
  }
}

// 游戏失败振动模式
void vibrateFailure() async {
  if (await Vibration.hasVibrator()) {
    Vibration.vibrate(pattern: [200, 100, 200]);
  }
}

// 碰撞反馈
void vibrateCollision() async {
  if (await Vibration.hasVibrator()) {
    Vibration.vibrate(milliseconds: 40);
  }
}

4.4. 通知振动

模拟消息通知的振动模式：

// 标准通知振动模式
void vibrateNotification() async {
  if (await Vibration.hasVibrator()) {
    // 振动 100ms → 暂停 200ms → 振动 100ms → 暂停 200ms → 振动 100ms
    Vibration.vibrate(pattern: [100, 200, 100, 200, 100]);
  }
}

4.5. 振动权限管理

在 Android 平台处理振动权限请求：

import 'package:permission_handler/permission_handler.dart';

// 检查并请求振动权限
Future<bool> requestVibrationPermission() async {
  if (Platform.isAndroid) {
    var status = await Permission.vibrate.status;
    if (!status.isGranted) {
      status = await Permission.vibrate.request();
      return status.isGranted;
    }
    return true;
  }
  // iOS 无需权限
  return true;
}

// 使用示例
void initVibration() async {
  bool hasPermission = await requestVibrationPermission();
  if (hasPermission) {
    print('振动权限已获取');
  } else {
    print('未获取振动权限，部分功能受限');
  }
}

5. 平台差异与兼容性

6. 最佳实践与注意事项

1. 适度使用振动：过度振动会影响用户体验，建议仅在关键交互点使用

2. 尊重用户设置：检查系统振动开关状态，避免在用户关闭振动时强制振动

3. 处理设备差异：不同设备的振动强度和效果差异较大，测试时需覆盖多种机型

4. 短振动优先：交互反馈建议使用 30-100ms 的短振动，避免干扰用户

5. 权限检查：Android 平台必须检查并请求振动权限，iOS 无需处理

6. 及时取消：在页面销毁或任务完成时取消振动，避免无效振动

7. 模式设计原则：复杂振动模式应遵循"短震为主、间隔清晰"的原则，如 [振动, 暂停, 振动]

vibration 插件为 Flutter 开发者提供了便捷的跨平台振动解决方案，通过简单的 API 即可实现从基础到高级的振动反馈功能。无论是日常交互的轻量反馈，还是游戏场景的复杂振动模式，该插件都能满足需求。

在实际开发中，建议结合具体场景设计合理的振动策略，注重振动时长、强度与交互场景的匹配，同时尊重用户设置和设备差异。通过恰当的振动反馈，能显著提升应用的交互质感和用户满意度。

本次分享就到这儿啦，我是鹏多多，如果您看了觉得有帮助，欢迎评论，关注，点赞，转发，我们下次见~

往期文章

• vue中ref的详解以及react的ref对比
• css使用aspect-ratio制作4:3和9:16和1:1等等比例布局
• Web前端页面开发阿拉伯语种适配指南
• flutter-使用extended_image操作图片的加载和状态处理以及缓存和下载
• flutter-制作可缩放底部弹出抽屉评论区效果
• flutter-实现Tabs吸顶的PageView效果
• Vue2全家桶+Element搭建的PC端在线音乐网站
• 助你上手Vue3全家桶之Vue3教程
• 超详细！vue组件通信的10种方式
• 超详细！Vuex手把手教程
• 使用nvm管理node.js版本以及更换npm淘宝镜像源
• vue中利用.env文件存储全局环境变量，以及配置vue启动和打包命令

个人主页

• CSDN
• GitHub
• 掘金
• 简书
• 博客园