Skip to content

蓝牙能力接入指南 ​

一、能力总览 ​

作为SDK接入方,可通过SDK封装的蓝牙接口,实现与蓝牙设备的互联互通。核心能力覆盖三类场景,适配不同业务需求:

能力类型核心用途支持范围
蓝牙低功耗(BLE)单台BLE设备点对点通信(如智能穿戴、传感器、小家电控制)主机模式(iOS 6.5.6+/Android 6.5.7+)、从机模式(基础库2.10.3+)
BLE Mesh多台BLE设备组网,实现群组控制/大范围覆盖(如智能家居全屋控制)需接入官方插件
蓝牙信标(Beacon)接收广播包实现室内定位、消息推送(无需建立设备连接)基础库1.2.0+,依赖系统位置权限

二、接入前必知核心概念 ​

1. 基础角色 ​

  • 中心设备/主机:APP运行的手机作为中心,主动扫描/连接外围蓝牙设备(绝大多数场景只需关注此模式);
  • 外围设备/从机:蓝牙设备(如传感器、智能灯)广播等待连接(Beacon属于“不可连接的外围设备”);
  • 代理设备:非BLE Mesh设备(如手机)可通过代理设备接入Mesh网络,实现消息收发。

2. 关键协议/标识 ​

  • GATT规范:BLE设备通信核心,数据交互基于「服务(Service)-特征(Characteristic)-描述符(Descriptor)」,读写Characteristic的值是通信核心;
  • UUID:标识Service/Characteristic的唯一ID,支持16/32/128位(iOS/Android 8.0.9+直接支持16/32位,Android 8.0.9以下需补位为128位);
  • Mesh地址:Mesh设备通信标识,含单播(单设备)、组播(群组)、虚拟地址(关联UUID);
  • Beacon标识:UUID+major+minor,用于区分不同Beacon设备。

3. 设备ID(deviceId)注意 ​

  • Android:deviceId为设备MAC地址,相对固定;
  • iOS:deviceId是系统生成的UUID,可能随蓝牙重启/设备忽略变化,且不同设备获取的UUID不同,禁止硬编码。