Flutter无障碍服务插件a11y_service的使用

Flutter无障碍服务插件a11y_service的使用

使用

在使用 a11y_service 插件之前，你需要在 Android 平台上进行一些配置。

AndroidManifest.xml

首先，在你的 AndroidManifest.xml 文件中添加以下内容：

<service
    android:name="com.liasica.a11y_service.A11yService"
    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/accessibilityservice" />
</service>

res/xml/accessibilityservice.xml

然后，在 res/xml/accessibilityservice.xml 文件中定义你的无障碍服务属性：

<?xml version="1.0" encoding="utf-8"?>
<accessibility-service xmlns:android="http://schemas.android.com/apk/res/android"
    android:accessibilityEventTypes="typeWindowsChanged|typeWindowStateChanged|typeWindowContentChanged"
    android:accessibilityFeedbackType="feedbackVisual"
    android:canPerformGestures="true"
    android:notificationTimeout="300"
    android:accessibilityFlags="flagDefault|flagIncludeNotImportantViews|flagRequestTouchExplorationMode|flagRequestEnhancedWebAccessibility|flagReportViewIds|flagRetrieveInteractiveWindows"
    android:canRetrieveWindowContent="true">
</accessibility-service>

示例代码

以下是一个完整的示例代码，展示了如何使用 a11y_service 插件：

import 'package:flutter/material.dart';
import 'package:a11y_service/a11y_service.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> {
  final _plugin = A11yService();

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

    // 监听无障碍事件
    _plugin.onAccessibilityEvent.listen((event) {
      // print('$event');
    });

    // 监听权限变更事件
    _plugin.onPermissionChanged.listen((isGranted) {
      print('权限已授予: $isGranted');
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Flutter A11y Service 示例'),
        ),
        body: SafeArea(
          child: Center(
            child: Column(
              mainAxisAlignment: MainAxisAlignment.center,
              mainAxisSize: MainAxisSize.min,
              children: [
                ElevatedButton(
                  onPressed: () async {
                    // 请求权限
                    final isGranted = await _plugin.requestPermission();
                    print('权限已授予: $isGranted');
                  },
                  child: const Text('请求权限'),
                ),
                ElevatedButton(
                  onPressed: () async {
                    // 强制停止应用
                    final forceStopApp = await _plugin.forceStopApp(
                      'com.android.chrome',
                      determine: '确定',
                      alertDialogName: 'androidx.appcompat.app.AlertDialog',
                      appDetailsName: 'com.android.settings.applications.InstalledAppDetailsTop',
                    );
                    print('强制停止应用: $forceStopApp');
                  },
                  child: const Text('强制停止应用'),
                ),
                ElevatedButton(
                  onPressed: () async {
                    // 分析
                    final result = await _plugin.analyze();
                    print('分析结果: $result');
                  },
                  child: const Text('分析'),
                ),
              ],
            ),
          ),
        ),
      ),
    );
  }
}