Flutter如何检测设备辅助功能的启用状态及触发时机？

一、原生API直接监听文本缩放变化 #

Flutter自带的MediaQuery可以获取系统辅助功能中的文本缩放系数，通过MediaQuery.textScaleFactorOf(context)就能拿到当前值。如果要实时监听缩放变化，结合WidgetsBindingObserver监听系统配置变更即可：

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

  @override
  State<ScaleDetector> createState() => _ScaleDetectorState();
}

class _ScaleDetectorState extends State<ScaleDetector> with WidgetsBindingObserver {
  double _currentScale = 1.0;

  @override
  void initState() {
    super.initState();
    WidgetsBinding.instance.addObserver(this);
    _currentScale = MediaQuery.textScaleFactorOf(context);
  }

  @override
  void dispose() {
    WidgetsBinding.instance.removeObserver(this);
    super.dispose();
  }

  @override
  void didChangeMetrics() {
    super.didChangeMetrics();
    final newScale = MediaQuery.textScaleFactorOf(context);
    if (newScale != _currentScale) {
      setState(() => _currentScale = newScale);
      // 此处添加缩放变化后的业务逻辑
      print("辅助功能缩放系数更新：$_currentScale");
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Center(child: Text("当前缩放系数：$_currentScale")),
    );
  }
}

用户在设备辅助功能中调整文本缩放时，didChangeMetrics方法会被触发，即可捕获到缩放变化。

二、第三方插件覆盖更多辅助功能场景 #

如果需要检测其他辅助功能（如屏幕阅读器、放大手势等），可以使用flutter_accessibility_service插件：

操作步骤： #

1. 在pubspec.yaml中添加依赖：

dependencies:
  flutter_accessibility_service: ^最新版本号

2. 初始化并监听辅助功能状态：

import 'package:flutter_accessibility_service/flutter_accessibility_service.dart';

void setupAccessibilityListener() async {
  // 部分Android设备需申请权限
  await FlutterAccessibilityService.requestAccessibilityPermission();
  
  // 监听所有辅助功能状态变更
  FlutterAccessibilityService.accessibilityStream.listen((event) {
    if (event.textScaleFactor != null) {
      print("文本缩放系数变化：${event.textScaleFactor}");
    }
    // 还可监听屏幕阅读器状态：event.isScreenReaderEnabled
  });
}

注意：iOS平台部分系统级辅助功能的检测需要额外配置权限，具体请参考插件的平台适配说明。

三、注意事项 #

• MediaQuery的文本缩放系数仅对应系统的文本缩放设置；若要检测系统级屏幕缩放（如iOS的“显示缩放”、Android的“显示大小”），这类变化通常会导致应用重启，可通过对比MediaQuery.sizeOf(context)与原始屏幕尺寸判断，但实用性有限。
• 部分辅助功能的检测需要引导用户前往系统设置开启权限（如Android的辅助功能权限），需提前做好用户提示。

内容的提问来源于stack exchange，提问作者Thorvald