MAUI实现BLE功能需四步到位:权限配置(Android 12+需BLUETOOTH_SCAN/CONNECT,iOS需NSBluetoothAlwaysUsageDescription等)、设备扫描、连接管理、服务读写;推荐使用Plugin.BLE插件,连接后须重新获取服务与特征,调试建议用nRF Connect验证。

MAUI 使用蓝牙 BLE 功能不难,关键是权限配置、设备扫描、连接管理、服务读写四步到位。跨平台统一 API 是优势,但各系统细节差异必须处理好,否则连不上、扫不到、读不出。
权限配置是第一步,不能跳过
Android 和 iOS 的权限要求不同,缺一不可:
-
Android(12+):在
AndroidManifest.xml中添加<uses-permission android:name="android.permission.BLUETOOTH_SCAN" android:usespermissionflags="neverForLocation"></uses-permission><uses-permission android:name="android.permission.BLUETOOTH_CONNECT"></uses-permission>
如果还要后台扫描,补上BLUETOOTH_ADVERTISE;SupportedOSPlatformVersion建议设为 31.0 或更高 -
iOS:在
Info.plist中加入<key>NSBluetoothAlwaysUsageDescription</key><string>需要蓝牙连接外部设备</string><key>UIBackgroundModes</key><array><string>bluetooth-central</string></array>
不加这两项,iOS 会直接拒绝扫描或后台断连
用 Plugin.BLE 插件最省事
官方 MAUI 蓝牙 API(如 BluetoothLEDevice)只支持 Windows,跨平台推荐用成熟插件 Plugin.BLE:
- NuGet 安装:
Install-Package Plugin.BLE - 初始化扫描:
var adapter = CrossBluetoothLE.Current.Adapter;adapter.DeviceDiscovered += (s, a) => { /* 处理新设备 */ };await adapter.StartScanningForDevicesAsync(); - 扫描可加过滤,比如按服务 UUID 或设备名,减少干扰
连接后读写服务和特征要重获取
每次连接成功后,不要缓存服务或特征对象,必须重新枚举:
标签: android windows app 工具 ai ios win red
还木有评论哦,快来抢沙发吧~