微信小程序开发API 蓝牙适配器接口

蓝牙适配器接口

基础库版本 1.1.0 开始支持，低版本需做兼容处理

iOS 微信客户端 6.5.6 版本开始支持，Android 客户端暂不支持

wx.openBluetoothAdapter(OBJECT)

---

基础库版本 1.1.0 开始支持，低版本需做兼容处理

初始化蓝牙适配器

OBJECT参数说明：

示例代码：

wx.openBluetoothAdapter({  success: function (res) {    console.log(res)  }})

Bug & Tip

1. tip: 由于系统的问题，目前仅在 mac 版的开发工具上支持蓝牙调试
2. tip: 基础库版本 1.1.0 开始支持，低版本需做兼容处理

wx.closeBluetoothAdapter(OBJECT)

---

基础库版本 1.1.0 开始支持，低版本需做兼容处理

关闭蓝牙模块。调用该方法将断开所有已建立的链接并释放系统资源

OBJECT参数说明：

示例代码：

wx.closeBluetoothAdapter({  success: function (res) {    console.log(res)  }})

wx.getBluetoothAdapterState(OBJECT)

---

基础库版本 1.1.0 开始支持，低版本需做兼容处理

获取本机蓝牙适配器状态

OBJECT参数说明：

success返回参数：

示例代码：

wx.getBluetoothAdapterState({  success: function (res) {    console.log(res)  }})

wx.onBluetoothAdapterStateChange(CALLBACK)

---

基础库版本 1.1.0 开始支持，低版本需做兼容处理

监听蓝牙适配器状态变化事件

CALLBACK参数说明：

示例代码：

wx.onBluetoothAdapterStateChange(function(res) {  console.log(`adapterState changed, now is`, res)})

wx.startBluetoothDevicesDiscovery(OBJECT)

---

基础库版本 1.1.0 开始支持，低版本需做兼容处理

开始搜寻附近的蓝牙外围设备。注意，该操作比较耗费系统资源，请在搜索并连接到设备后调用 stop 方法停止搜索。

OBJECT参数说明：

services参数说明：某些蓝牙设备会广播自己的主 service 的 uuid。如果这里传入该数组，那么根据该 uuid 列表，只搜索有这个主服务的设备。

success返回参数：

示例代码：

// 以微信硬件平台的蓝牙智能灯为例，主服务的 UUID 是 FEE7。传入这个参数，只搜索主服务 UUID 为 FEE7 的设备wx.startBluetoothDevicesDiscovery({  services: ['FEE7'],  success: function (res) {    console.log(res)  }})

wx.stopBluetoothDevicesDiscovery(OBJECT)

---

基础库版本 1.1.0 开始支持，低版本需做兼容处理

停止搜寻附近的蓝牙外围设备。请在确保找到需要连接的设备后调用该方法停止搜索。

OBJECT参数说明：

success返回参数：

adapterState

蓝牙适配器状态信息

示例代码：

wx.stopBluetoothDevicesDiscovery({  success: function (res) {    console.log(res)  }})

wx.getBluetoothDevices(OBJECT)

---

基础库版本 1.1.0 开始支持，低版本需做兼容处理

获取所有已发现的蓝牙设备，包括已经和本机处于连接状态的设备

OBJECT参数说明：

success返回参数：

device 对象

蓝牙设备信息

示例代码：

wx.getBluetoothDevices({  success: function (res) {    console.log(res)  }})

Bug & Tip

1. tip: Mac系统可能无法获取advertisData及RSSI，请使用真机调试
2. tip: 开发者工具和 Android 上获取到的deviceId为设备 MAC 地址，iOS 上则为设备 uuid。因此deviceId不能硬编码到代码中

wx.getConnectedBluetoothDevices(OBJECT)

---

基础库版本 1.1.0 开始支持，低版本需做兼容处理

根据 uuid 获取处于已连接状态的设备

OBJECT参数说明：

success返回参数：

device对象

蓝牙设备信息

示例代码：

wx.getConnectedBluetoothDevices({  success: function (res) {    console.log(res)  }})

Bug & Tip

1. tip: 开发者工具和 Android 上获取到的deviceId为设备 MAC 地址，iOS 上则为设备 uuid。因此deviceId不能硬编码到代码中