Flutter震动功能插件vibration的使用

Vibration

这是一个用于处理iOS、Android和Web上的震动API的插件。API 文档。

Getting Started

添加依赖

在pubspec.yaml文件的dependencies部分添加vibration：

dependencies:
  vibration: ^1.8.4

导入包

在您的Dart代码中导入此包：

import 'package:vibration/vibration.dart';

Methods

hasVibrator

检查目标设备是否具有震动功能。

if (await Vibration.hasVibrator()) {
    Vibration.vibrate();
}

hasAmplitudeControl

检查目标设备是否有控制震动幅度的能力，该功能在Android 8.0 Oreo引入，在更早的API级别中返回false。

if (await Vibration.hasAmplitudeControl()) {
    Vibration.vibrate(amplitude: 128);
}

hasCustomVibrationsSupport

检查设备是否能够以自定义时长、模式或强度震动。即使设备没有震动器也可能返回true（如果您想检查设备是否有震动器，请参阅hasVibrator）。

if (await Vibration.hasCustomVibrationsSupport()) {
    Vibration.vibrate(duration: 1000);
} else {
    Vibration.vibrate();
    await Future.delayed(Duration(milliseconds: 500));
    Vibration.vibrate();
}

vibrate

• 特定时长：例如1秒

Vibration.vibrate(duration: 1000);

默认时长为500ms。

• 特定时长和特定幅度（如果支持）

Vibration.vibrate(duration: 1000, amplitude: 128);

• 模式（等待500ms，震动1s，等待500ms，震动2s）

Vibration.vibrate(pattern: [500, 1000, 500, 2000]);

• 模式（等待500ms，震动1s，等待500ms，震动2s），不同强度（1 - 最小，255 - 最大）

Vibration.vibrate(pattern: [500, 1000, 500, 2000], intensities: [1, 255]);

cancel

停止正在进行的震动。

Vibration.cancel();

Android

在AndroidManifest.xml中需要VIBRATE权限。

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

支持带有持续时间和模式的震动。在Android 8（Oreo）及以上版本中，使用VibrationEffect类。对于其余的使用说明，请参阅Vibrator类文档。

iOS

支持CoreHaptics设备上的震动持续时间和模式。在较旧的设备上，模式通过500ms长的震动进行模拟。您可以使用hasCustomVibrationsSupport来检查当前设备是否支持CoreHaptics。

OpenHarmony

在OpenHarmony平台上的vibration实现。 在你的项目的module.json5文件中增加以下权限设置。

"requestPermissions": [
     {"name" :  "ohos.permission.VIBRATE"},                
]

vibrateEffect 和 vibrateAttribute 只存在于VibrationOhos中。

(VibrationPlatform.instance as VibrationOhos).vibrate(
   vibrateEffect: const VibratePreset(count: 100),
   vibrateAttribute: const VibrateAttribute(
     usage: 'alarm',
   ),
 );

示例Demo

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

void main() => runApp(VibratingApp());

class VibratingApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Vibration Plugin example app'),
        ),
        body: Builder(
          builder: (BuildContext context) {
            return Center(
              child: Column(
                children: <Widget>[
                  ElevatedButton(
                    child: Text('Vibrate for default 500ms'),
                    onPressed: () {
                      Vibration.vibrate();
                    },
                  ),
                  ElevatedButton(
                    child: Text('Vibrate for 1000ms'),
                    onPressed: () {
                      Vibration.vibrate(duration: 1000);
                    },
                  ),
                  ElevatedButton(
                    child: Text('Vibrate with pattern'),
                    onPressed: () {
                      final snackBar = SnackBar(
                        content: Text(
                          'Pattern: wait 0.5s, vibrate 1s, wait 0.5s, vibrate 2s, wait 0.5s, vibrate 3s, wait 0.5s, vibrate 0.5s',
                        ),
                      );
                      ScaffoldMessenger.of(context).showSnackBar(snackBar);
                      Vibration.vibrate(
                        pattern: [500, 1000, 500, 2000, 500, 3000, 500, 500],
                      );
                    },
                  ),
                  ElevatedButton(
                    child: Text('Vibrate with pattern and amplitude'),
                    onPressed: () {
                      final snackBar = SnackBar(
                        content: Text(
                          'Pattern: wait 0.5s, vibrate 1s, wait 0.5s, vibrate 2s, wait 0.5s, vibrate 3s, wait 0.5s, vibrate 0.5s',
                        ),
                      );

                      ScaffoldMessenger.of(context).showSnackBar(snackBar);
                      Vibration.vibrate(
                        pattern: [500, 1000, 500, 2000, 500, 3000, 500, 500],
                        intensities: [0, 128, 0, 255, 0, 64, 0, 255],
                      );
                    },
                  )
                ],
              ),
            );
          },
        ),
      ),
    );
  }
}