Flutter触觉反馈插件haptic_feedback的使用

haptic_feedback简介

haptic_feedback是一个为iOS和Android提供的触觉反馈插件。它利用了标准的iOS触觉反馈，并在Android上模拟相同的触觉模式，以确保跨平台的一致性体验。

对于如何在Flutter应用中使用该包，可以阅读Kamran的文章 Using haptic feedback to make your Flutter app more interactive ，他提供了关于触觉反馈及其应用场景的详细解释。

快速开始

1. 添加依赖项

通过以下命令将haptic_feedback添加到您的Flutter项目中：

flutter pub add haptic_feedback

2. 使用插件

使用插件前，请先检查设备是否支持触觉反馈功能：

final canVibrate = await Haptics.canVibrate();

然后，根据需要调用不同类型的触觉反馈：

await Haptics.vibrate(HapticsType.success);
await Haptics.vibrate(HapticsType.warning);
await Haptics.vibrate(HapticsType.error);

await Haptics.vibrate(HapticsType.light);
await Haptics.vibrate(HapticsType.medium);
await Haptics.vibrate(HapticsType.heavy);

await Haptics.vibrate(HapticsType.rigid);
await Haptics.vibrate(HapticsType.soft);

await Haptics.vibrate(HapticsType.selection);

Android VIBRATE权限自动包含

当您将haptic_feedback插件集成到Flutter项目中时，它会自动在应用程序最终合并的AndroidManifest.xml文件中包含必要的VIBRATE权限。这是因为权限已经在插件的清单中声明。

这意味着：

• 无需手动操作：不需要手动向应用程序的AndroidManifest.xml添加<uses-permission android:name="android.permission.VIBRATE"/>权限。
• 透明度：使用haptic_feedback插件后，您的应用程序将请求VIBRATE权限。请确保了解应用程序所需的所有权限，尤其是在发布到应用商店时。一些用户可能对应用程序权限敏感，即使它们不需要明确同意。
• 权限概览：要查看由于插件和您自己的声明而请求的所有权限，请检查构建后的最终合并AndroidManifest.xml。这将提供所有权限和其他清单条目的全面视图。

示例代码

下面是一个完整的示例demo，演示如何在Flutter应用中使用haptic_feedback插件：

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

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

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      debugShowCheckedModeBanner: false,
      darkTheme: ThemeData.dark(),
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Haptic feedback playground'),
        ),
        body: const _HapticsList(),
      ),
    );
  }
}

class _HapticsList extends StatefulWidget {
  const _HapticsList();

  @override
  State<_HapticsList> createState() => _HapticsListState();
}

class _HapticsListState extends State<_HapticsList> {
  @override
  Widget build(BuildContext context) {
    return ListView(
      children: [
        for (final type in HapticsType.values)
          ListTile(
            title: Text(type.name),
            subtitle: Text(describeEnum(type)),
            onTap: () async {
              // Check if device is capable of haptic feedback
              final can = await Haptics.canVibrate();

              // Show snackbar
              if (!context.mounted) return;
              final snackbarMessage = can
                  ? '$type'
                  : 'This device is not capable of haptic feedback.';
              ScaffoldMessenger.of(context).hideCurrentSnackBar();
              ScaffoldMessenger.of(context).showSnackBar(
                SnackBar(
                  content: Text(snackbarMessage, textAlign: TextAlign.center),
                  duration: const Duration(seconds: 1),
                ),
              );

              // Vibrate only if device is capable of haptic feedback
              if (!can) return;
              await Haptics.vibrate(type);
            },
          ),
      ],
    );
  }
}

这个示例创建了一个简单的Flutter应用，其中包含一个列表，每个列表项代表一种触觉反馈类型。点击列表项时，如果设备支持触觉反馈，则会触发相应的触觉反馈，并显示一条消息提示用户。