UWP蓝牙广告问题求助：设备不显示、名称设置失败及服务数据疑问

针对你遇到的三个问题，逐一给出解决办法：

1. 设备广播不显示的排查要点 #

• 先确认蓝牙硬件已开启，且你的设备支持BLE广播功能（部分老旧蓝牙适配器不支持）
• 检查项目权限：UWP项目需在Package.appxmanifest中添加蓝牙权限，勾选蓝牙功能选项
• 验证GATT服务初始化流程：必须通过GattServiceProvider.CreateAsync成功创建服务实例后，再配置广播参数
• 确保广播参数的IsConnectable和IsDiscoverable都设为true，否则扫描端无法发现设备
• 重启蓝牙适配器，避免其他进程占用广播资源

2. 自定义名称设置导致启动失败的解决 #

报错Value does not fall within the expected range的核心原因是BLE广播数据包总长度不能超过31字节，自定义名称加上Service UUID、Service Data等内容的总长度必须控制在这个上限内：

• 缩短自定义名称：比如把"MyDevice"改成"MyDev"这类短字符串
• 若需要保留较长名称，可改用ShortName字段，或者移除非必要的广播数据项
• 示例代码调整：

// 缩短名称确保总长度合规
provider.Advertisement.LocalName = "MyDev";
// 或者使用短名称
provider.Advertisement.ShortName = "MyD";

3. ServiceData字节数组格式说明 #

ServiceData由UUID前缀和自定义业务数据组成，具体规则：

• 16位UUID：前2字节为UUID的小端字节序，后续为自定义数据
  例：UUID为0xFFE0，自定义数据是0x01,0x02，则ServiceData数组为{0xE0, 0xFF, 0x01, 0x02}
• 128位UUID：前16字节为UUID的小端字节序，后续为自定义数据
• 构造示例代码：

Guid serviceUuid = Guid.Parse("0000FFE0-0000-1000-8000-00805F9B34FB");
// 构造ServiceData：UUID小端+自定义数据
byte[] serviceData = new byte[] { 0xE0, 0xFF, 0x01, 0x02 };
advertisingParameters.ServiceData.Add(serviceUuid, serviceData);

完整可运行示例代码 #

using Windows.Devices.Bluetooth;
using Windows.Devices.Bluetooth.GenericAttributeProfile;

async Task StartBleBroadcast()
{
    // 创建GATT服务实例
    Guid serviceUuid = Guid.Parse("0000FFE0-0000-1000-8000-00805F9B34FB");
    GattServiceProviderResult createResult = await GattServiceProvider.CreateAsync(serviceUuid);
    if (createResult.Error != BluetoothError.Success)
    {
        // 处理服务创建失败逻辑
        return;
    }
    GattServiceProvider provider = createResult.ServiceProvider;

    // 配置广播参数
    var advParams = new GattServiceProviderAdvertisingParameters
    {
        IsConnectable = true,
        IsDiscoverable = true
    };

    // 添加ServiceData
    byte[] serviceData = new byte[] { 0xE0, 0xFF, 0x01, 0x02 };
    advParams.ServiceData.Add(serviceUuid, serviceData);

    // 设置合规的广播名称
    provider.Advertisement.LocalName = "MyDev";

    // 启动广播
    provider.StartAdvertising(advParams);
}

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