微信开放文档

蓝牙 (Bluetooth)

小程序将各平台的蓝牙能力通过统一的接口封装提供给开发者使用。利用小程序的蓝牙接口，开发者可以通过无线方式与其他蓝牙设备交换数据。

1. 蓝牙能力概述

蓝牙技术规范由蓝牙技术联盟 (Bluetooth Special Interest Group, SIG) 制定，开发者可以在其官方网站获取到详细的技术文档。

目前蓝牙最为普遍使用的有两种规格：

2. 小程序中的蓝牙能力

在小程序中，要使用蓝牙能力（Beacon 除外）必须首先调用 wx.openBluetoothAdapter 初始化蓝牙适配器模块，其生效周期为调用 wx.openBluetoothAdapter 至调用 wx.closeBluetoothAdapter 或小程序被销毁为止。只有在小程序蓝牙适配器模块生效期间，开发者才能够正常调用蓝牙相关的小程序 API，并收到蓝牙模块相关的事件回调（绑定监听不受此限制）。

小程序对蓝牙支持情况如下：

3. 注意事项

由于各平台对蓝牙协议栈的实现和限制有较大差异，开发者在使用小程序蓝牙能力时还需要注意以下方面：

3.1 设备 ID (deviceId)

每个蓝牙外围设备都有唯一的 deviceId 来标识。由于部分系统实现的限制，对于同一台蓝牙外围设备，在不同中心设备上扫描获取到的 deviceId 可能是变化的。因此 deviceId 不能硬编码到代码中。

3.2 调试

不同平台的蓝牙实现也存在较大差异。小程序会在提供统一接口的基础上，尽可能的提供完整的系统蓝牙能力，弱化不同平台的实现差异。

但由于操作系统本身的限制，部分能力无法保证完全一致，请开发者注意文档中的注意事项，并在各端的真机都进行调试。开发者工具上只能模拟部分蓝牙接口能力，完整功能请使用真机调试。

示例代码

在开发者工具中预览效果