Flutter震动功能插件flutter_vibrate的使用

插件介绍

flutter_vibrate 是一个Flutter插件，用于触发设备的震动。它利用了苹果和安卓平台上的所有当前触觉反馈API，为开发者提供了丰富的震动模式选择。

开始使用

Android配置

确保在您的AndroidManifest.xml文件中添加以下权限：

<uses-permission android:name="android.permission.VIBRATE"/>

导入包

在Dart代码中导入插件：

import 'package:flutter_vibrate/flutter_vibrate.dart';

使用方法

普通震动

检查设备是否支持震动

bool canVibrate = await Vibrate.canVibrate;
if (canVibrate) {
  print('This device can vibrate');
} else {
  print('This device cannot vibrate');
}

触发震动

Vibrate.vibrate();

注意：在iOS上，震动持续时间是一个固定的500ms，因为无法设置特定的持续时间。

带有暂停的连续震动

final Iterable<Duration> pauses = [
  const Duration(milliseconds: 500),
  const Duration(milliseconds: 1000),
  const Duration(milliseconds: 500),
];
Vibrate.vibrateWithPauses(pauses);

这段代码将执行如下的震动序列：震动 - 等待0.5秒 - 再次震动 - 等待1秒 - 再次震动 - 等待0.5秒 - 最后一次震动。

触觉反馈

根据不同的场景选择合适的反馈类型：

enum FeedbackType {
  success,
  error,
  warning,
  selection,
  impact,
  heavy,
  medium,
  light
}

// 例如，触发一次轻度的触觉反馈
Vibrate.feedback(FeedbackType.light);

完整示例Demo

下面是一个完整的Flutter应用例子，展示了如何使用flutter_vibrate插件来实现不同的震动效果。

import 'package:flutter/material.dart';
import 'package:flutter_vibrate/flutter_vibrate.dart';

void main() => runApp(const MyApp());

class MyApp extends StatefulWidget {
  const MyApp({Key? key}) : super(key: key);

  @override
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  bool _canVibrate = true;
  final Iterable<Duration> pauses = [
    const Duration(milliseconds: 500),
    const Duration(milliseconds: 1000),
    const Duration(milliseconds: 500),
  ];

  @override
  void initState() {
    super.initState();
    _init();
  }

  Future<void> _init() async {
    bool canVibrate = await Vibrate.canVibrate;
    setState(() {
      _canVibrate = canVibrate;
      _canVibrate
          ? debugPrint('This device can vibrate')
          : debugPrint('This device cannot vibrate');
    });
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: const Text('Haptic Feedback Example')),
        body: Center(
          child: ListView(children: [
            ListTile(
              title: const Text('Vibrate'),
              leading: const Icon(Icons.vibration, color: Colors.teal),
              onTap: () {
                if (_canVibrate) Vibrate.vibrate();
              },
            ),
            ListTile(
              title: const Text('Vibrate with Pauses'),
              leading: const Icon(Icons.vibration, color: Colors.brown),
              onTap: () {
                if (_canVibrate) {
                  Vibrate.vibrateWithPauses(pauses);
                }
              },
            ),
            const Divider(height: 1),
            ListTile(
              title: const Text('Impact'),
              leading: const Icon(Icons.tap_and_play, color: Colors.orange),
              onTap: () {
                if (_canVibrate) {
                  Vibrate.feedback(FeedbackType.impact);
                }
              },
            ),
            ListTile(
              title: const Text('Selection'),
              leading: const Icon(Icons.select_all, color: Colors.blue),
              onTap: () {
                if (_canVibrate) {
                  Vibrate.feedback(FeedbackType.selection);
                }
              },
            ),
            ListTile(
              title: const Text('Success'),
              leading: const Icon(Icons.check, color: Colors.green),
              onTap: () {
                if (_canVibrate) {
                  Vibrate.feedback(FeedbackType.success);
                }
              },
            ),
            ListTile(
              title: const Text('Warning'),
              leading: const Icon(Icons.warning, color: Colors.red),
              onTap: () {
                if (_canVibrate) {
                  Vibrate.feedback(FeedbackType.warning);
                }
              },
            ),
            ListTile(
              title: const Text('Error'),
              leading: const Icon(Icons.error, color: Colors.red),
              onTap: () {
                if (_canVibrate) {
                  Vibrate.feedback(FeedbackType.error);
                }
              },
            ),
            const Divider(height: 1),
            ListTile(
              title: const Text('Heavy'),
              leading:
                  const Icon(Icons.notification_important, color: Colors.red),
              onTap: () {
                if (_canVibrate) {
                  Vibrate.feedback(FeedbackType.heavy);
                }
              },
            ),
            ListTile(
              title: const Text('Medium'),
              leading:
                  const Icon(Icons.notification_important, color: Colors.green),
              onTap: () {
                if (_canVibrate) {
                  Vibrate.feedback(FeedbackType.medium);
                }
              },
            ),
            ListTile(
              title: const Text('Light'),
              leading:
                  Icon(Icons.notification_important, color: Colors.yellow[700]),
              onTap: () {
                if (_canVibrate) {
                  Vibrate.feedback(FeedbackType.light);
                }
              },
            ),
          ]),
        ),
      ),
    );
  }
}

这个例子创建了一个简单的Flutter应用程序，用户可以通过点击列表项来触发不同类型的震动效果或触觉反馈。这有助于理解并测试flutter_vibrate插件的各种功能。

文档参考

• Android官方文档
• iOS官方文档