Flutter Apple Pencil双击功能插件 apple_pencil_double_tap 的使用

apple_pencil_double_tap 是一个简单易用的插件，用于在任何Flutter应用中检测Apple Pencil的交互。该插件支持iOS 12.1+和iPadOS 12.1+。

安装

在你的 pubspec.yaml 文件中的 dependencies: 部分添加以下行：

apple_pencil_double_tap: <latest_version>

请确保将 <latest_version> 替换为最新的版本号。

使用方法

你可以非常容易地使用这个插件。下面是一个简单的示例代码：

import 'package:apple_pencil_double_tap/apple_pencil_double_tap.dart';

ApplePencilDoubleTap().listen(
    // 对于iPadOS < 17.5
    v1Callback: (PreferredAction preferedAction) {
        print('Double tap detected. Prefered user action: $preferedAction');
    },
    // 对于iPadOS >= 17.5
    onTapAction: (TapAction action) {
        print('TapAction: $action');
    },
    // 对于iPadOS >= 17.5
    onSqueeze: (SqueezeAction action) {
        print('SqueezeAction: $action');
    },
    onError: (e) {
        print('Error: $e');
    },
);

示例Demo

下面是一个完整的示例项目，展示了如何集成和使用 apple_pencil_double_tap 插件。

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

void main() {
  runApp(const MyApp());
}

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

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  final _applePencilDoubleTapPlugin = ApplePencilDoubleTap();

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

  void initApplePencilListener() {
    _applePencilDoubleTapPlugin.listen(
      v1Callback: (PreferredAction preferedAction) {
        print('Double tap detected. Prefered user action: $preferedAction');
      },
      onTapAction: (TapAction action) {
        print('TapAction: $action');
      },
      onSqueeze: (SqueezeAction action) {
        print('SqueezeAction: $action');
      },
      onError: (e) {
        print('Error: $e');
      },
    );
  }

  @override
  void dispose() {
    _applePencilDoubleTapPlugin.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Apple pencil double tap plugin example app'),
        ),
        body: const Center(
          child: TextField(
            decoration: InputDecoration(hintText: "Use apple pencil to write something. Double tap and check logs"),
          ),
        ),
      ),
    );
  }
}

注意事项

• 确保你的设备运行的是iPadOS 12.1或更高版本。
• 在实际项目中，请替换 <latest_version> 为最新的插件版本号。
• 如果你在调试过程中遇到问题，请检查控制台输出的日志信息，特别是在 onError 回调中打印的信息。

通过上述步骤，你应该能够成功集成并使用 apple_pencil_double_tap 插件来处理Apple Pencil的双击事件和其他交互。