Flutter触控交互控制插件flutter_touch_interaction_controller的使用

简介

• 描述：一个用于检测和处理屏幕触摸事件的Flutter插件。
• 技术栈：Flutter插件。
• 状态：CHANGELOG。

主要功能

1. 单点触控事件识别和流提供。
2. 请求无障碍服务权限。
3. 验证无障碍服务权限。
4. 执行单点触控操作。
5. 执行滑动操作。

示例截图

安装

添加依赖

在你的pubspec.yaml文件中添加以下依赖：

dependencies:
  flutter_touch_interaction_controller: ^1.1.0

修改Android设置

1. 在android/app/src/main/AndroidManifest.xml文件中添加以下代码：

<service
    android:name="com.rabbitson87.flutter_touch_interaction_controller.AccessibilityServicePlugin"
    android:exported="true"
    android:permission="android.permission.BIND_ACCESSIBILITY_SERVICE">
    <intent-filter>
        <action android:name="android.accessibilityservice.AccessibilityService" />
    </intent-filter>
    <meta-data
        android:name="android.accessibilityservice"
        android:resource="@xml/accessibility_service_config" />
</service>

2. 创建android/app/src/main/res/xml/accessibility_service_config.xml文件并添加以下代码：

<accessibility-service xmlns:android="http://schemas.android.com/apk/res/android"
    android:accessibilityEventTypes="typeAllMask"
    android:accessibilityFeedbackType="feedbackSpoken"
    android:accessibilityFlags="flagDefault"
    android:canPerformGestures="true"
    android:canRequestTouchExplorationMode="true"
    android:notificationTimeout="100" />

使用

检查无障碍权限是否启用

bool isAccessibilityPermissionEnabled = await FlutterTouchInteractionController.isAccessibilityPermissionEnabled;

请求无障碍权限

await FlutterTouchInteractionController.requestAccessibilityPermission;

监听触摸事件

final accessStream = FlutterTouchInteractionController.accessStream.listen((event) {
  print(event);
});

移除监听器

accessStream.cancel();

执行触摸操作

await FlutterTouchInteractionController.touch(Point(x: 350, y: 400));

执行滑动操作

await FlutterTouchInteractionController.swipe(Point(x: 350, y: 1400), Point(x: 350, y: 1000));

获取帮助

如果你有任何问题、疑虑或错误报告，请在这个仓库的Issue Tracker中提交问题。

参与贡献

如何贡献的具体说明可以查看 CONTRIBUTING.md。

开源许可信息

1. TERMS
2. LICENSE

致谢

1. flutter_accessibility_service
2. do-touch

示例代码

import 'dart:async';

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:flutter_touch_interaction_controller/flutter_touch_interaction_controller.dart';

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

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

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  bool _isAccessibilityPermissionEnabled = false;
  StreamSubscription<MotionEvent>? _subscription;
  List<MotionEvent?> events = [];

  [@override](/user/override)
  void initState() {
    super.initState();
  }

  Future<void> _isAccessibilityPermissionEnabledState() async {
    bool isAccessibilityPermissionEnabled;
    try {
      isAccessibilityPermissionEnabled = await FlutterTouchInteractionController
          .isAccessibilityPermissionEnabled;
    } on PlatformException {
      isAccessibilityPermissionEnabled = false;
    }

    if (!mounted) return;

    setState(() {
      _isAccessibilityPermissionEnabled = isAccessibilityPermissionEnabled;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('FlutterTouchInteractionController example'),
        ),
        body: Center(
          child: Column(children: [
            ElevatedButton(
              onPressed: () async {
                final result = await FlutterTouchInteractionController
                    .requestAccessibilityPermission();
                print("requestAccessibilityPermission: $result");
              },
              child: const Text('请求无障碍权限'),
            ),
            ElevatedButton(
              onPressed: _isAccessibilityPermissionEnabledState,
              child: const Text('检查无障碍权限是否启用'),
            ),
            Text(
                '无障碍权限已启用: $_isAccessibilityPermissionEnabled'),
            ElevatedButton(
              onPressed: () {
                if (_subscription == null) {
                  setState(() {
                    _subscription = FlutterTouchInteractionController
                        .accessStream
                        .listen((event) {
                      print("$event");
                      setState(() {
                        events.add(event);
                      });
                    });
                  });
                } else {
                  _subscription?.cancel();
                  _subscription = null;
                  setState(() {
                    events = [];
                  });
                }
              },
              child: Text(
                  _subscription == null ? '开始监听' : '停止监听'),
            ),
            ElevatedButton(
              onPressed: () async {
                final touchResult = await FlutterTouchInteractionController.touch(
                    Point(x: 350, y: 400));
                print("touchResult: $touchResult");
              },
              child: const Text('点击'),
            ),
            ElevatedButton(
              onPressed: () async {
                final touchResult = await FlutterTouchInteractionController.swipe(
                    Point(x: 350, y: 1400), Point(x: 350, y: 1000));
                print("SwipeResult: $touchResult");
              },
              child: const Text('滑动'),
            ),
            Expanded(
              child: ListView.builder(
                shrinkWrap: true,
                itemCount: events.length,
                itemBuilder: (_, index) => ListTile(
                  title: Text(events[index]?.toString() ?? ''),
                ),
              ),
            ),
          ]),
        ),
      ),
    );
  }
}