Web Bluetooth API 中的制造商数据与服务数据过滤机制详解-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00651/article/details/149012721

Web Bluetooth API 中的制造商数据与服务数据过滤机制详解

前言

在现代Web开发中，蓝牙设备交互变得越来越重要。Web Bluetooth API为开发者提供了在浏览器中与蓝牙设备交互的能力。本文将深入探讨该API中制造商数据(manufacturer data)和服务数据(service data)过滤机制的设计原理与使用方法。

为什么需要数据过滤

传统过滤方式的局限性

传统上，开发者可以通过设备名称或服务UUID来过滤蓝牙设备。然而，这种方法存在明显缺陷：

设备名称不可靠：用户可能重命名设备，导致基于名称的过滤失效
128位UUID占用空间：自定义服务通常使用128位UUID，这会占用宝贵的广播数据空间
识别效率低：无法直接识别特定厂商或特定应用数据模式的设备

数据过滤的优势

通过制造商数据和服务数据过滤，开发者可以：

直接识别特定厂商的设备（通过公司标识符）
识别携带特定应用数据的设备
提高设备发现效率，减少用户选择负担
优化广播数据结构，避免不必要的信息传输

API设计详解

基本过滤语法

制造商数据过滤

let manufacturerData = [{ companyIdentifier: 0xffff }];
navigator.bluetooth.requestDevice({ 
  filters: [{ manufacturerData }] 
});

服务数据过滤

let serviceData = [{ service: "battery_service" }];
navigator.bluetooth.requestDevice({ 
  filters: [{ serviceData }] 
});

高级过滤功能

数据前缀匹配

开发者可以指定数据前缀来匹配特定模式的广播数据：

let manufacturerData = [{
  companyIdentifier: 0x00e0, // Google公司标识符
  dataPrefix: new Uint8Array([0x01, 0x02]), // 匹配以[0x01, 0x02]开头的数据
}];

掩码匹配

对于更复杂的匹配需求，可以使用掩码进行模式匹配：

let manufacturerData = [{
  companyIdentifier: 0xffff,
  dataPrefix: new Uint8Array([0x91, 0xaa]), // 二进制: 10010001 10101010
  mask: new Uint8Array([0x0f, 0x57]),       // 二进制: 00001111 01010111
}];

掩码工作原理：

掩码中的1表示对应位必须匹配
掩码中的0表示对应位不关心
上例中，第一个字节的低4位必须匹配，高4位不关心

技术演进与最佳实践

API设计改进历程

早期版本使用对象键作为标识符，存在以下问题：

可读性差：{ 0x00e0: {} }形式不够直观
键唯一性问题：不同字符串形式("224"和"0224")表示相同值

改进后的设计采用结构化字典：

dictionary BluetoothManufacturerDataFilterInit {
  required [EnforceRange] unsigned short companyIdentifier;
  BufferSource dataPrefix;
  BufferSource mask;
};