Flutter中如何在应用后台监听键盘按键事件

你的现有代码依赖RawKeyboard，它仅能在Flutter应用处于前台活跃状态时捕获按键事件——因为当应用退到后台，Flutter引擎会暂停视图相关的事件监听，无法再接收系统键盘事件。要实现后台监听，必须通过**原生平台通道（MethodChannel）**调用系统级API，结合平台特定的权限和监听机制来实现。

核心思路 #

• 在Flutter层创建MethodChannel，用于接收原生层传递的按键事件。
• 针对不同平台（Android/iOS/桌面）编写原生代码，注册系统级键盘监听。
• 处理平台权限申请（后台监听通常需要特殊权限，比如辅助功能权限）。

Flutter端实现代码 #

替换你原有的RawKeyboard监听逻辑，改用MethodChannel接收原生事件：

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

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

  @override
  State<BackgroundKeyListener> createState() => _BackgroundKeyListenerState();
}

class _BackgroundKeyListenerState extends State<BackgroundKeyListener> {
  var pressedKey = '';
  final MethodChannel _keyChannel = const MethodChannel('com.example/key_listener');

  @override
  void initState() {
    super.initState();
    // 监听原生发送的按键事件
    _keyChannel.setMethodCallHandler((call) async {
      if (call.method == 'onKeyPressed') {
        final keyData = call.arguments as Map;
        setState(() {
          if (keyData['isCtrlPressed'] == true && keyData['character'] != null) {
            pressedKey = 'Ctrl + ${keyData['character']}';
          }
        });
      }
    });
    // 通知原生启动监听
    _keyChannel.invokeMethod('startListening');
  }

  @override
  void dispose() {
    // 通知原生停止监听
    _keyChannel.invokeMethod('stopListening');
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Center(child: Text('Pressed: $pressedKey')),
    );
  }
}

Android端实现（Kotlin） #

Android后台监听键盘需要使用AccessibilityService（普通广播自Android 7.0起无法捕获后台按键事件）：

1. 创建AccessibilityService类：

package com.example.your_app_name

import android.accessibilityservice.AccessibilityService
import android.view.KeyEvent
import android.view.accessibility.AccessibilityEvent
import io.flutter.plugin.common.MethodChannel

class KeyAccessibilityService : AccessibilityService() {
    private var channel: MethodChannel? = null

    fun setMethodChannel(channel: MethodChannel) {
        this.channel = channel
    }

    override fun onAccessibilityEvent(event: AccessibilityEvent?) {}

    override fun onInterrupt() {}

    override fun onKeyEvent(event: KeyEvent): Boolean {
        if (event.action == KeyEvent.ACTION_DOWN) {
            val isCtrlPressed = event.isCtrlPressed
            val character = event.displayLabel?.toString()
            channel?.invokeMethod("onKeyPressed", mapOf(
                "isCtrlPressed" to isCtrlPressed,
                "character" to character
            ))
        }
        return super.onKeyEvent(event)
    }
}

2. 在AndroidManifest.xml中注册Service并声明权限：

<uses-permission android:name="android.permission.BIND_ACCESSIBILITY_SERVICE" />

<application ...>
    <service
        android:name=".KeyAccessibilityService"
        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>
</application>

3. 创建res/xml/accessibility_service_config.xml配置文件：

<?xml version="1.0" encoding="utf-8"?>
<accessibility-service xmlns:android="http://schemas.android.com/apk/res/android"
    android:accessibilityEventTypes="typeAllMask"
    android:accessibilityFeedbackType="feedbackGeneric"
    android:accessibilityFlags="flagDefault"
    android:canRetrieveWindowContent="true"
    android:description="@string/accessibility_service_description" />

4. 在MainActivity中关联MethodChannel和AccessibilityService：

package com.example.your_app_name

import android.content.Intent
import android.os.Bundle
import io.flutter.embedding.android.FlutterActivity
import io.flutter.embedding.engine.FlutterEngine
import io.flutter.plugin.common.MethodChannel

class MainActivity : FlutterActivity() {
    private lateinit var keyChannel: MethodChannel
    private lateinit var keyAccessibilityService: KeyAccessibilityService

    override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
        super.configureFlutterEngine(flutterEngine)
        keyChannel = MethodChannel(flutterEngine.dartExecutor.binaryMessenger, "com.example/key_listener")
        keyAccessibilityService = KeyAccessibilityService()
        keyAccessibilityService.setMethodChannel(keyChannel)

        keyChannel.setMethodCallHandler { call, result ->
            when (call.method) {
                "startListening" -> {
                    // 引导用户开启辅助功能权限
                    startActivity(Intent(android.provider.Settings.ACTION_ACCESSIBILITY_SETTINGS))
                    result.success(null)
                }
                "stopListening" -> {
                    // 停止服务逻辑
                    result.success(null)
                }
                else -> result.notImplemented()
            }
        }
    }
}

iOS端实现（Swift） #

iOS后台监听键盘受沙盒限制，需使用Accessibility框架（需要用户授权辅助功能权限）：

在AppDelegate.swift中添加监听逻辑：

import UIKit
import Flutter
import Accessibility

@UIApplicationMain
@objc class AppDelegate: FlutterAppDelegate {
    private let channelName = "com.example/key_listener"
    private var keyObserver: Any?

    override func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {
        let controller : FlutterViewController = window?.rootViewController as! FlutterViewController
        let keyChannel = FlutterMethodChannel(name: channelName, binaryMessenger: controller.binaryMessenger)

        keyChannel.setMethodCallHandler { [weak self] call, result in
            switch call.method {
            case "startListening":
                self?.startKeyListening(channel: keyChannel)
                // 引导用户开启辅助功能权限
                if let settingsUrl = URL(string: UIApplication.openSettingsURLString) {
                    UIApplication.shared.open(settingsUrl)
                }
                result.success(nil)
            case "stopListening":
                self?.stopKeyListening()
                result.success(nil)
            default:
                result.notImplemented()
            }
        }

        GeneratedPluginRegistrant.register(with: self)
        return super.application(application, didFinishLaunchingWithOptions: launchOptions)
    }

    private func startKeyListening(channel: FlutterMethodChannel) {
        // 注：iOS公开API中后台监听键盘非常受限，以下为示例逻辑，实际需结合CGEventTap（仅限macOS）或确认App Store合规性
        keyObserver = AXUIElementAddNotificationListener(
            AXUIElementCreateSystemWide(),
            kAXUserDefinedNotification as CFString,
            { _, _, _, info in
                guard let keyInfo = info as? [String: Any],
                      let isCtrlPressed = keyInfo["isCtrlPressed"] as? Bool,
                      let character = keyInfo["character"] as? String else { return }
                channel.invokeMethod("onKeyPressed", arguments: [
                    "isCtrlPressed": isCtrlPressed,
                    "character": character
                ])
            },
            nil
        )
    }

    private func stopKeyListening() {
        if let observer = keyObserver {
            AXUIElementRemoveNotificationListener(AXUIElementCreateSystemWide(), observer)
            keyObserver = nil
        }
    }
}

重要注意事项 #

• 权限要求：Android和iOS都需要用户手动开启辅助功能权限，应用需要引导用户到系统设置页面开启。
• 合规性：iOS使用某些后台监听API可能违反App Store审核规则，若需上架需仔细核对苹果开发者规范。
• 资源释放：务必在Flutter页面销毁时通知原生停止监听，避免内存泄漏。

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