pp电子

登录

免费开通

微信小程序API蓝牙适配器接口,openBluetoothAdapter初始化蓝牙适配器

—— 2017 ——

12/22

00:00

泉源：

作者：未知

栏目：小程序开发

2017/12/22 0:00:00 泉源：不详作者：未知

蓝牙适配器接口

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

iOS 微信客户端 6.5.6 版本最先支持，，Android 客户端暂不支持

wx.openBluetoothAdapter(OBJECT)

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

初始化蓝牙适配器

OBJECT参数说明：

参数	类型	必填	说明
success	Function	是	乐成则返回乐成初始化信息
fail	Function	否	接口挪用失败的回调函数
complete	Function	否	接口挪用竣事的回调函数（挪用乐成、失败都会执行）

示例代码：

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

Bug & Tip

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

wx.closeBluetoothAdapter(OBJECT)

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

关闭蓝牙模？？？。。。。。。挪用该要领将断开所有已建设的链接并释放系统资源

OBJECT参数说明：

参数	类型	必填	说明
success	Function	是	乐成则返回乐成关闭模？？？樾畔
fail	Function	否	接口挪用失败的回调函数
complete	Function	否	接口挪用竣事的回调函数（挪用乐成、失败都会执行）

示例代码：

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

wx.getBluetoothAdapterState(OBJECT)

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

获取本机蓝牙适配器状态

OBJECT参数说明：

参数	类型	必填	说明
success	Function	是	乐成则返回本机蓝牙适配器状态
fail	Function	否	接口挪用失败的回调函数
complete	Function	否	接口挪用竣事的回调函数（挪用乐成、失败都会执行）

success返回参数：

参数	类型	说明
discovering	Boolean	是否正在搜索装备
available	Boolean	蓝牙适配器是否可用
errMsg	String	乐成：ok，，过失：详细信息

示例代码：

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

wx.onBluetoothAdapterStateChange(CALLBACK)

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

监听蓝牙适配器状态转变事务

CALLBACK参数说明：

参数	类型	说明
available	boolean	蓝牙适配器是否可用
discovering	boolean	蓝牙适配器是否处于搜索状态

示例代码：

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

wx.startBluetoothDevicesDiscovery(OBJECT)

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

最先征采周围的蓝牙外围装备。。。。。。注重，，该操作较量泯灭系统资源，，请在搜索并毗连到装备后挪用 stop 要领阻止搜索。。。。。。

OBJECT参数说明：

参数	类型	必填	说明
services	Array	否	蓝牙装备主 service 的 uuid 列表
allowDuplicatesKey	boolean	否	是否允许重复上报统一装备，，若是允许重复上报，，则onDeviceFound 要体会多次上报统一装备，，可是 RSSI 值会有差别
interval	integer	否	上报装备的距离，，默以为0，，意思是找到新装备连忙上报，，否则凭证传入的距离上报
success	Function	是	乐成则返回本机蓝牙适配器状态
fail	Function	否	接口挪用失败的回调函数
complete	Function	否	接口挪用竣事的回调函数（挪用乐成、失败都会执行）

services参数说明：某些蓝牙装备会广播自己的主 service 的 uuid。。。。。。若是这里传入该数组，，那么凭证该 uuid 列表，，只搜索有这个主服务的装备。。。。。。

success返回参数：

参数	类型	说明
errMsg	string	乐成：ok，，过失：详细信息
isDiscovering	boolean	目今蓝牙适配器是否处于搜索状态

示例代码：

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

wx.stopBluetoothDevicesDiscovery(OBJECT)

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

阻止征采周围的蓝牙外围装备。。。。。。请在确保找到需要毗连的装备后挪用该要领阻止搜索。。。。。。

OBJECT参数说明：

参数	类型	必填	说明
success	Function	是	乐成则返回本机蓝牙适配器状态
fail	Function	否	接口挪用失败的回调函数
complete	Function	否	接口挪用竣事的回调函数（挪用乐成、失败都会执行）

success返回参数：

参数	类型	说明
errMsg	string	乐成：ok，，过失：详细信息

adapterState

蓝牙适配器状态信息

参数	类型	说明
discovering	boolean	是否正在搜索装备
available	boolean	蓝牙适配器是否可用

示例代码：

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

wx.getBluetoothDevices(OBJECT)

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

获取所有已发明的蓝牙装备，，包括已经和本机处于毗连状态的装备

OBJECT参数说明：

参数	类型	必填	说明
success	Function	是	乐成则返回本机蓝牙适配器状态
fail	Function	否	接口挪用失败的回调函数
complete	Function	否	接口挪用竣事的回调函数（挪用乐成、失败都会执行）

success返回参数：

参数	类型	说明
devices	Array	uuid 对应的的已毗连装备列表
errMsg	string	乐成：ok，，过失：详细信息

device 工具

蓝牙装备信息

参数	类型	说明
name	string	蓝牙装备名称，，某些装备可能没有
deviceId	string	用于区分装备的 id
RSSI	int	目今蓝牙装备的信号强度
advertisData	ArrayBuffer	目今蓝牙装备的广播内容（注重：vConsole 无法打印出 ArrayBuffer 类型数据）

示例代码：

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

Bug & Tip

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

wx.getConnectedBluetoothDevices(OBJECT)

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

凭证 uuid 获取处于已毗连状态的装备

OBJECT参数说明：

参数	类型	必填	说明
services	Array	是	蓝牙装备主 service 的 uuid 列表
success	Function	是	乐成则返回本机蓝牙适配器状态
fail	Function	否	接口挪用失败的回调函数
complete	Function	否	接口挪用竣事的回调函数（挪用乐成、失败都会执行）

success返回参数：

参数	类型	说明
devices	Array	搜索到的装备列表
errMsg	string	乐成：ok，，过失：详细信息

device工具

蓝牙装备信息

参数	类型	说明
name	string	蓝牙装备名称，，某些装备可能没有
deviceId	string	用于区分装备的 id

示例代码：

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

Bug & Tip

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

wx.onBluetoothDeviceFound(CALLBACK)

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

监听寻找到新装备的事务

CALLBACK参数说明：

参数	类型	说明
devices	Array	新搜索到的装备列表

device工具

参数	类型	说明
deviceId	string	蓝牙装备 id，，参考 device 工具
name	string	蓝牙装备名称，，参考 device 工具
RSSI	int	目今蓝牙装备的信号强度
advertisData	ArrayBuffer	目今蓝牙装备的广播内容（注重：vConsole 无法打印出 ArrayBuffer 类型数据）

示例代码：

wx.onBluetoothDeviceFound(function(devices) {
  console.log('new device list has founded')
  console.dir(devices)
})

Bug & Tip

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

低功耗蓝牙接口

wx.createBLEConnection(OBJECT)

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

毗连低功耗蓝牙装备

OBJECT参数说明：

参数	类型	必填	说明
deviceId	string	是	蓝牙装备 id，，参考 getDevices 接口
success	Function	是	乐成则返回本机蓝牙适配器状态
fail	Function	否	接口挪用失败的回调函数
complete	Function	否	接口挪用竣事的回调函数（挪用乐成、失败都会执行）

success返回参数：

参数	类型	说明
errMsg	string	乐成：ok，，过失：详细信息

示例代码：

wx.createBLEConnection({
  // 这里的 deviceId 需要在上面的 getBluetoothDevices 或 onBluetoothDeviceFound 接口中获取
  deviceId: deviceId,
  success: function (res) {
    console.log(res)
  }
})

wx.closeBLEConnection(OBJECT)

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

断开与低功耗蓝牙装备的毗连

OBJECT参数说明：

参数	类型	必填	说明
deviceId	string	是	蓝牙装备 id，，参考 getDevices 接口
success	Function	是	乐成则返回本机蓝牙适配器状态
fail	Function	否	接口挪用失败的回调函数
complete	Function	否	接口挪用竣事的回调函数（挪用乐成、失败都会执行）

success返回参数：

参数	类型	说明
errMsg	string	乐成：ok，，过失：详细信息

示例代码：

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

wx.getBLEDeviceServices(OBJECT)

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

获取蓝牙装备所有 service（服务）

OBJECT参数说明：

参数	类型	必填	说明
deviceId	string	是	蓝牙装备 id，，参考 getDevices 接口
success	Function	是	乐成则返回本机蓝牙适配器状态
fail	Function	否	接口挪用失败的回调函数
complete	Function	否	接口挪用竣事的回调函数（挪用乐成、失败都会执行）

success返回参数：

参数	类型	说明
services	array	装备服务列表
errMsg	string	乐成：ok，，过失：详细信息

service工具

蓝牙装备service(服务)信息

参数	类型	说明
uuid	string	蓝牙装备服务的 uuid
isPrimary	boolean	该服务是否为主服务

示例代码：

wx.getBLEDeviceServices({
  // 这里的 deviceId 需要在上面的 getBluetoothDevices 或 onBluetoothDeviceFound 接口中获取
  deviceId: deviceId,
  success: function (res) {
    console.log('device services:', res.services)
  }
})

wx.getBLEDeviceCharacteristics(OBJECT)

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

获取蓝牙装备所有 characteristic（特征值）

OBJECT参数说明：

参数	类型	必填	说明
deviceId	string	是	蓝牙装备 id，，参考 device 工具
serviceId	string	是	蓝牙服务 uuid
success	Function	是	乐成则返回本机蓝牙适配器状态
fail	Function	否	接口挪用失败的回调函数
complete	Function	否	接口挪用竣事的回调函数（挪用乐成、失败都会执行）

success返回参数：

参数	类型	说明
characteristics	array	装备特征值列表
errMsg	string	乐成：ok，，过失：详细信息

characteristic工具

蓝牙装备characteristic(特征值)信息

参数	类型	说明
uuid	string	蓝牙装备特征值的 uuid
properties	object	该特征值支持的操作类型

properties工具

参数	类型	说明
read	boolean	该特征值是否支持 read 操作
write	boolean	该特征值是否支持 write 操作
notify	boolean	该特征值是否支持 notify 操作
indicate	boolean	该特征值是否支持 indicate 操作

示例代码：

wx.getBLEDeviceCharacteristics({
  // 这里的 deviceId 需要在上面的 getBluetoothDevices 或 onBluetoothDeviceFound 接口中获取
  deviceId: deviceId,
  // 这里的 serviceId 需要在上面的 getBLEDeviceServices 接口中获取
  serviceId: serviceId,
  success: function (res) {
    console.log('device getBLEDeviceCharacteristics:', res.characteristics)
  }
})

wx.readBLECharacteristicValue(OBJECT)

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

读取低功耗蓝牙装备的特征值的二进制数据值。。。。。。注重：必需装备的特征值支持read才可以乐成挪用，，详细参照 characteristic 的 properties 属性

OBJECT参数说明：

参数	类型	必填	说明
deviceId	string	是	蓝牙装备 id，，参考 device 工具
serviceId	string	是	蓝牙特征值对应服务的 uuid
characteristicId	string	是	蓝牙特征值的 uuid
success	Function	是	乐成则返回本机蓝牙适配器状态
fail	Function	否	接口挪用失败的回调函数
complete	Function	否	接口挪用竣事的回调函数（挪用乐成、失败都会执行）

success返回参数：

参数	类型	说明
characteristic	object	装备特征值信息
errMsg	string	乐成：ok，，过失：详细信息

characteristic工具

蓝牙装备characteristic(特征值)信息

参数	类型	说明
characteristicId	string	蓝牙装备特征值的 uuid
serviceId	object	蓝牙装备特征值对应服务的 uuid
value	ArrayBuffer	蓝牙装备特征值对应的二进制值（注重：vConsole 无法打印出 ArrayBuffer 类型数据）

示例代码：

// 必需在这里的回调才华获取
wx.onBLECharacteristicValueChange(function(characteristic) {
  console.log('characteristic value comed:', characteristic)
})

wx.readBLECharacteristicValue({
  // 这里的 deviceId 需要在上面的 getBluetoothDevices 或 onBluetoothDeviceFound 接口中获取
  deviceId: deviceId,
  // 这里的 serviceId 需要在上面的 getBLEDeviceServices 接口中获取
  serviceId: serviceId,
  // 这里的 characteristicId 需要在上面的 getBLEDeviceCharacteristics 接口中获取
  characteristicId: characteristicId,
  success: function (res) {
    console.log('readBLECharacteristicValue:', res.characteristic.value)
  }
})

Bug & Tip

tip: 并行挪用多次读写接口保存读写失败的可能性。。。。。。
tip:read接口读取到的信息需要在onBLECharacteristicValueChange要领注册的回调中获取。。。。。。

wx.writeBLECharacteristicValue(OBJECT)

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

向低功耗蓝牙装备特征值中写入二进制数据。。。。。。注重：必需装备的特征值支持write才可以乐成挪用，，详细参照 characteristic 的 properties 属性

tips: 并行挪用多次读写接口保存读写失败的可能性

OBJECT参数说明：

参数	类型	必填	说明
deviceId	string	是	蓝牙装备 id，，参考 device 工具
serviceId	string	是	蓝牙特征值对应服务的 uuid
characteristicId	string	是	蓝牙特征值的 uuid
value	ArrayBuffer	是	蓝牙装备特征值对应的二进制值（注重：vConsole 无法打印出 ArrayBuffer 类型数据）
success	Function	是	乐成则返回本机蓝牙适配器状态
fail	Function	否	接口挪用失败的回调函数
complete	Function	否	接口挪用竣事的回调函数（挪用乐成、失败都会执行）

success返回参数：

参数	类型	说明
errMsg	string	乐成：ok，，过失：详细信息

示例代码：

// 这里的回调可以获取到 write 导致的特征值改变
wx.onBLECharacteristicValueChange(function(characteristic) {
  console.log('characteristic value changed:', characteristic)
})

// 向蓝牙装备发送一个0x00的16进制数据
let buffer = new ArrayBuffer(1)
let dataView = new DataView(buffer)
dataView.setUint8(0, 0)

wx.writeBLECharacteristicValue({
  // 这里的 deviceId 需要在上面的 getBluetoothDevices 或 onBluetoothDeviceFound 接口中获取
  deviceId: deviceId,
  // 这里的 serviceId 需要在上面的 getBLEDeviceServices 接口中获取
  serviceId: serviceId,
  // 这里的 characteristicId 需要在上面的 getBLEDeviceCharacteristics 接口中获取
  characteristicId: characteristicId,
  // 这里的value是ArrayBuffer类型
  value: buffer,
  success: function (res) {
    console.log('writeBLECharacteristicValue success', res.errMsg)
  }
})

wx.notifyBLECharacteristicValueChanged(OBJECT)

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

启用低功耗蓝牙装备特征值转变时的 notify 功效。。。。。。注重：必需装备的特征值支持notify才可以乐成挪用，，详细参照 characteristic 的 properties 属性

另外，，必需先启用notify才华监听到装备 characteristicValueChange 事务

OBJECT参数说明：

参数	类型	必填	说明
deviceId	string	是	蓝牙装备 id，，参考 device 工具
serviceId	string	是	蓝牙特征值对应服务的 uuid
characteristicId	string	是	蓝牙特征值的 uuid
state	boolean	是	true: 启用 notify; false: 停用 notify
success	Function	是	乐成则返回本机蓝牙适配器状态
fail	Function	否	接口挪用失败的回调函数
complete	Function	否	接口挪用竣事的回调函数（挪用乐成、失败都会执行）

success返回参数：

参数	类型	说明
errMsg	string	乐成：ok，，过失：详细信息

示例代码：

wx.notifyBLECharacteristicValueChanged({
  state: true, // 启用 notify 功效
  // 这里的 deviceId 需要在上面的 getBluetoothDevices 或 onBluetoothDeviceFound 接口中获取
  deviceId: deviceId,
  // 这里的 serviceId 需要在上面的 getBLEDeviceServices 接口中获取
  serviceId: serviceId,
  // 这里的 characteristicId 需要在上面的 getBLEDeviceCharacteristics 接口中获取
  characteristicId: characteristicId,
  success: function (res) {
    console.log('notifyBLECharacteristicValueChanged success', res.errMsg)
  }
})

wx.onBLEConnectionStateChanged(CALLBACK)

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

监听低功耗蓝牙毗连的过失事务，，包括装备丧失，，毗连异常断开等等。。。。。。

CALLBACK参数说明：

参数	类型	说明
deviceId	string	蓝牙装备 id，，参考 device 工具
connected	boolean	毗连现在的状态

示例代码：

wx.onBLEConnectionStateChanged(function(res) {
  // 该要领回调中可以用于处理毗连意外断开等异常情形
  console.log(`device ${res.deviceId} state has changed, connected: ${res.connected}`)
})

wx.onBLECharacteristicValueChange(CALLBACK)

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

监听低功耗蓝牙装备的特征值转变。。。。。。必需先启用notify接谈锋气吸收到装备推送的notification。。。。。。

CALLBACK参数说明：

参数	类型	说明
deviceId	string	蓝牙装备 id，，参考 device 工具
serviceId	string	特征值所属服务 uuid
characteristicId	string	特征值 uuid
value	ArrayBuffer	特征值最新的值（注重：vConsole 无法打印出 ArrayBuffer 类型数据）

示例代码：

wx.onBLECharacteristicValueChange(function(res) {
  console.log(`characteristic ${res.characteristicId} has changed, now is ${res.value}`)
})

蓝牙过失码(errCode)列表

过失码	说明	备注
0	ok	正常
10000	not init	未初始化蓝牙适配器
10001	not available	目今蓝牙适配器不可用
10002	no device	没有找到指定装备
10003	connection fail	毗连失败
10004	no service	没有找到指定服务
10005	no characteristic	没有找到指定特征值
10006	no connection	目今毗连已断开
10007	property not support	目今特征值不支持此操作
10008	system error	其余所有系统上报的异常
10009	system not support	Android 系统特有，，系统版本低于 4.3 不支持BLE
10010	no descriptor	没有找到指定形貌符

更多微信小程序开发教程，，可以关注。。。。。。

【本站声明】
1、本站文章中所选用的图片及文字泉源于网络以及用户投稿，，由于未联系到知识产权人或未发明有关知识产权的挂号，，若有知识产权人并不肯意我们使用，，若是有侵权请连忙联系。。。。。。
2、本网站差池文章中所涉及的内容真实性、准确性、可靠性认真，，仅系客观性形貌，，如您需要相识该类商品/服务详细的资讯，，请您直接与该类商品/服务的提供者联系。。。。。。

KESION pp电子软件
KESION pp电子软件是海内领先的在线教育软件及私域社交电商软件服务提供商，，恒久专注于为企业提供在线教育软件及社交电商SaaS平台解决方案。。。。。。
公司焦点产品云开店SaaS社交电商服务平台、在线教育SaaS服务平台、教育企业数字化SaaS云平台、企微营销助手、私有化自力安排品牌网校和在线教育咨询等。。。。。。
KESION 一直通过手艺立异，，提供产品和服务，，助力企业向数字化转型，，通过科技驱动商业刷新，，让商业变得更智慧！

▼点击进入pp电子官网相识更多

热门标签

微信小程序开发微信小程序

上/下篇

微信小程序API剪贴板,setClipboardData设置系统剪贴板的内容

wx.setClipboardData(OBJECT) 基础库版本 1.1.0 最先支持，，低版本需做兼容处理设置系统剪贴板的内容。。。。。。 OBJECT参数说明：参数类型必填说明 data Stri

微信小程序开发微信小程序 2017/12/22 0:00:00
微信小程序APIiBeacon,wx.startBeaconDiscovery最先搜索周围的iBeacon装备

wx.startBeaconDiscovery(OBJECT) 基础库 1.2.0 最先支持，，低版本需做兼容处理最先搜索周围的 iBeacon 装备 OBJECT参数说明：参数名类型必填说明

微信小程序开发微信小程序 2017/12/22 0:00:00

换一换相关推荐

精选内容

热门精选

运营学院
模板超市
课程超市
授权盘问
下载体验
资质办理服务
手艺论坛

© 2006-2026 pp电子版权所有

ICP证闽B2-20190777 闽ICP备06009871号-1 JdPFEevTjyc2gv0eqUhR+TZ0r6FNfW8rjQju4bIixlNWoxViStHHLcXeCAIttKrJsbXY0hzT2KM0EQovG3f6IszmdycbiD4+09Zt81Jtjk15+yLm9NtJUr0qTyxvOf53dkeWWqyk4cqk0KW0HISNBvNLwgrbW4OugAAAAASUVORK5CYII=

JdPFEevTjyc2gv0eqUhR+TZ0r6FNfW8rjQju4bIixlNWoxViStHHLcXeCAIttKrJsbXY0hzT2KM0EQovG3f6IszmdycbiD4+09Zt81Jtjk15+yLm9NtJUr0qTyxvOf53dkeWWqyk4cqk0KW0HISNBvNLwgrbW4OugAAAAASUVORK5CYII=

闽公网安备 35020302001540号统一社会信用代码：91350206MA2XN2XQ4A 国家高新手艺企业编号：GR201735100465 软件企业证书号：厦RQ-2017-0034 软件产品证书号：厦RC-2017-0005 认证同盟企业编号：928180109031687687593 国际权威认证：信息手艺服务治理系统标准（ISO 20000）信息清静治理系统国际认证（ISO/IEC 27001）

pp电子·模拟器(试玩游戏)官方网站

pp电子·模拟器(试玩游戏)官方网站

pp电子·模拟器(试玩游戏)官方网站

【网站地图】