使用btleplug在Windows11扫描BLE外设时本地名称缺失，如何解决？

可能的原因及对应解决方案 #

1. 扫描时间过短 #

Windows环境下不同BLE设备的广播包发送间隔差异较大，2秒的扫描时长可能不足以捕获携带设备名称的广播包。

修改方案：延长扫描时间至5-10秒：

time::sleep(Duration::from_secs(5)).await;

2. 设备未在广播包中携带名称 #

多数BLE设备为节省广播带宽，不会在广播包中发送完整名称，仅在建立连接后才暴露名称属性。这种情况下需要主动连接设备读取名称特征：

修改后的代码示例：

use btleplug::api::{Central, Manager as _, Peripheral as _, ScanFilter, UUID};
use btleplug::platform::{Manager, Peripheral};
use std::error::Error;
use std::time::Duration;
use tokio::time;

#[tokio::main]
async fn main() -> Result<(), Box<dyn Error>> {
    let manager = Manager::new().await?;

    // 获取适配器
    let adapters = manager.adapters().await?;
    let central = adapters.into_iter().nth(0).unwrap();

    // 启动扫描，允许接收重复广播包
    let scan_filter = ScanFilter {
        allow_duplicates: true,
        ..Default::default()
    };
    central.start_scan(scan_filter).await?;
    time::sleep(Duration::from_secs(5)).await;

    // 获取已发现设备列表
    let devices = central.peripherals().await?;
    for mut device in devices {
        let address = device.address();
        println!("处理设备: {}", address);

        // 优先尝试从广播属性读取名称
        let name_from_broadcast = if let Some(properties) = device.properties().await? {
            properties.local_name.first().cloned()
        } else {
            None
        };

        if let Some(name) = name_from_broadcast {
            println!("{}: 广播名称 - {}", address, name);
            continue;
        }

        // 广播无名称时，尝试连接设备读取
        match device.connect().await {
            Ok(_) => {
                device.discover_services().await?;
                // 定位设备名称特征（UUID: 0x2A00）
                let name_uuid = UUID::Ble(0x2A00);
                if let Some(characteristic) = device
                    .characteristics()
                    .iter()
                    .find(|c| c.uuid == name_uuid)
                {
                    if let Ok(data) = device.read(characteristic).await {
                        let name = String::from_utf8_lossy(&data);
                        println!("{}: 读取到名称 - {}", address, name);
                    } else {
                        println!("{}: 无法读取名称特征", address);
                    }
                } else {
                    println!("{}: 未找到名称特征", address);
                }
                // 断开连接
                let _ = device.disconnect().await;
            }
            Err(e) => {
                println!("{}: 连接失败 - {}", address, e);
            }
        }
    }

    Ok(())
}

3. 扫描过滤器设置限制 #

默认ScanFilter会过滤重复广播包，而设备名称可能在后续广播包中才出现。修改过滤器允许接收重复包：

let scan_filter = ScanFilter {
    allow_duplicates: true,
    ..Default::default()
};
central.start_scan(scan_filter).await?;

4. Windows蓝牙权限缺失 #

确保程序拥有蓝牙访问权限：

• 打开Windows设置 → 隐私和安全性 → 蓝牙
• 确认你的Rust程序被允许访问蓝牙

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