Flutter Android读取游戏手柄数据遇BLUETOOTH_PRIVILEGED权限问题求助

核心问题说明 #

android.permission.BLUETOOTH_PRIVILEGED是系统签名级权限，仅允许系统预装应用（如系统蓝牙设置、默认手柄管理应用）申请，第三方APP无论怎么配置AndroidManifest.xml都无法获取到这个权限。你之前尝试直接读取蓝牙原始数据流的思路，本质上绕开了Android对HID设备的统一管理，所以触发了权限拦截。

正确实现路径 #

游戏手柄配对后会被Android识别为标准输入设备，你不需要直接操作蓝牙连接，只需通过系统提供的输入事件API读取摇杆和按键状态即可。下面提供两种可行方案：

方案1：使用Flutter第三方插件（快速实现） #

推荐使用成熟的游戏手柄插件，它们已经封装了Android/iOS的输入设备逻辑，无需自己处理权限和底层解析：

• flutter_gamepad：支持多平台，能直接获取摇杆轴值、按键按下状态
• game_controller：专注Android平台的手柄输入监听

示例代码（flutter_gamepad）

1. 添加依赖到pubspec.yaml：

dependencies:
  flutter_gamepad: ^0.1.0

2. 监听手柄输入：

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await FlutterGamepad.initialize();
  
  runApp(const MyApp());
}

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

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

class _MyAppState extends State<MyApp> {
  double leftX = 0.0;
  double leftY = 0.0;
  bool aButtonPressed = false;

  @override
  void initState() {
    super.initState();
    // 监听摇杆轴事件
    FlutterGamepad.onAxisEvent.listen((event) {
      if (event.axis == GamepadAxis.leftX) {
        setState(() => leftX = event.value);
      } else if (event.axis == GamepadAxis.leftY) {
        setState(() => leftY = event.value);
      }
    });
    // 监听按键事件
    FlutterGamepad.onButtonEvent.listen((event) {
      if (event.button == GamepadButton.a) {
        setState(() => aButtonPressed = event.pressed);
      }
    });
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              Text("左摇杆X: ${leftX.toStringAsFixed(2)}"),
              Text("左摇杆Y: ${leftY.toStringAsFixed(2)}"),
              Text("A键状态: ${aButtonPressed ? '按下' : '松开'}"),
            ],
          ),
        ),
      ),
    );
  }
}

方案2：原生MethodChannel实现（自定义需求） #

如果需要更定制化的逻辑，可以通过Android原生代码监听输入事件，再通过MethodChannel传递到Flutter：

1. Android原生代码（MainActivity.kt）

import android.view.InputDevice
import android.view.KeyEvent
import android.view.MotionEvent
import io.flutter.embedding.android.FlutterActivity
import io.flutter.embedding.engine.FlutterEngine
import io.flutter.plugin.common.MethodChannel

class MainActivity : FlutterActivity() {
    private val CHANNEL = "com.your.package/gamepad"
    private lateinit var channel: MethodChannel

    override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
        super.configureFlutterEngine(flutterEngine)
        channel = MethodChannel(flutterEngine.dartExecutor.binaryMessenger, CHANNEL)
    }

    override fun onGenericMotionEvent(event: MotionEvent): Boolean {
        // 检查是否是游戏手柄的摇杆事件
        if (event.source and InputDevice.SOURCE_JOYSTICK == InputDevice.SOURCE_JOYSTICK) {
            val leftX = event.getAxisValue(MotionEvent.AXIS_X)
            val leftY = event.getAxisValue(MotionEvent.AXIS_Y)
            channel.invokeMethod("onJoystickEvent", mapOf(
                "leftX" to leftX,
                "leftY" to leftY
            ))
            return true
        }
        return super.onGenericMotionEvent(event)
    }

    override fun onKeyDown(keyCode: Int, event: KeyEvent): Boolean {
        // 检查是否是游戏手柄按键
        if (event.source and InputDevice.SOURCE_GAMEPAD == InputDevice.SOURCE_GAMEPAD) {
            val buttonName = when(keyCode) {
                KeyEvent.KEYCODE_BUTTON_A -> "A"
                KeyEvent.KEYCODE_BUTTON_B -> "B"
                // 可添加更多按键映射
                else -> "unknown"
            }
            channel.invokeMethod("onButtonEvent", mapOf(
                "button" to buttonName,
                "pressed" to true
            ))
            return true
        }
        return super.onKeyDown(keyCode, event)
    }

    override fun onKeyUp(keyCode: Int, event: KeyEvent): Boolean {
        if (event.source and InputDevice.SOURCE_GAMEPAD == InputDevice.SOURCE_GAMEPAD) {
            val buttonName = when(keyCode) {
                KeyEvent.KEYCODE_BUTTON_A -> "A"
                KeyEvent.KEYCODE_BUTTON_B -> "B"
                else -> "unknown"
            }
            channel.invokeMethod("onButtonEvent", mapOf(
                "button" to buttonName,
                "pressed" to false
            ))
            return true
        }
        return super.onKeyUp(keyCode, event)
    }
}

2. Flutter端代码

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

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

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

class _MyAppState extends State<MyApp> {
  static const platform = MethodChannel('com.your.package/gamepad');
  double leftX = 0.0;
  double leftY = 0.0;
  bool aButtonPressed = false;

  @override
  void initState() {
    super.initState();
    platform.setMethodCallHandler((call) async {
      switch(call.method) {
        case 'onJoystickEvent':
          setState(() {
            leftX = call.arguments['leftX'];
            leftY = call.arguments['leftY'];
          });
          break;
        case 'onButtonEvent':
          if (call.arguments['button'] == 'A') {
            setState(() {
              aButtonPressed = call.arguments['pressed'];
            });
          }
          break;
      }
    });
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              Text("左摇杆X: ${leftX.toStringAsFixed(2)}"),
              Text("左摇杆Y: ${leftY.toStringAsFixed(2)}"),
              Text("A键状态: ${aButtonPressed ? '按下' : '松开'}"),
            ],
          ),
        ),
      ),
    );
  }
}

void main() => runApp(const MyApp());

权限配置修正 #

不需要申请BLUETOOTH_PRIVILEGED，只需确保AndroidManifest.xml中有以下权限（如果使用插件，插件会自动处理部分权限）：

<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<!-- 仅当需要扫描未配对手柄时添加 -->
<uses-permission android:name="android.permission.BLUETOOTH_SCAN" android:usesPermissionFlags="neverForLocation" />

针对三星A53 Android14的注意事项 #

三星OneUI在Android14上对蓝牙HID设备的权限管控更严格，直接访问蓝牙Socket的方式完全不可行，必须依赖系统输入API。另外，确保手柄已经通过系统蓝牙设置完成配对，无需在APP中手动处理配对流程。

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