蓝牙

jd.closeBluetoothAdapter(Object object)

关闭蓝牙模块。调用该方法将断开所有已建立的连接并释放系统资源。建议在使用蓝牙流程后，与 jd.openBluetoothAdapter 成对调用。

参数

Object object

错误

示例代码

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

jd.getBluetoothAdapterState(Object object)

获取本机蓝牙适配器状态。

参数

Object object

object.success 回调函数

参数

Object res

错误

示例代码

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

jd.getConnectedBluetoothDevices(Object object)

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

参数

Object object

object.success 回调函数

参数

Object res

res.devices 的结构

错误

示例代码

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

jd.onBluetoothAdapterStateChange(function callback)

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

参数

function callback

蓝牙适配器状态变化事件的回调函数

参数

Object res

示例代码

jd.onBluetoothAdapterStateChange(function (res) {
  console.log('adapterState changed, now is', res)
})

jd.onBluetoothDeviceFound(function callback)

监听寻找到新设备的事件

参数

function callback

寻找到新设备的事件的回调函数

参数

object res

res.devices 的结构

注意

• 若在 jd.onBluetoothDeviceFound 回调了某个设备，则此设备会添加到 jd.getConnectedBluetoothDevices 接口获取到的数组中。

示例代码

buf2hex: function (buffer) {
    return Array.prototype.map.call(new Uint8Array(buffer), x => ('00' + x.toString(16)).slice(-2)).join('')
}
jd.onBluetoothDeviceFound(function(res) {
  var devices = res.devices;
  console.log(that.buf2hex(devices[0].advertisData))
})

注意

• 部分安卓机型需打开位置权限才能正常使用蓝牙功能

jd.openBluetoothAdapter(Object object)

初始化蓝牙模块。iOS 上开启主机/从机模式时需分别调用一次，指定对应的 mode。

参数

Object object

错误

object.fail 回调函数返回的 state 参数（仅 iOS）

注意

• 其他蓝牙相关 API 必须在 jd.openBluetoothAdapter 调用之后使用。否则 API 会返回错误（errCode=10000）。
• 在用户蓝牙开关未开启或者手机不支持蓝牙功能的情况下，调用 jd.openBluetoothAdapter 会返回错误（errCode=10001），表示手机蓝牙功能不可用。此时小程序蓝牙模块已经初始化完成，可通过 jd.onBluetoothAdapterStateChange 监听手机蓝牙状态的改变，也可以调用蓝牙模块的所有API。

示例代码

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

jd.startBluetoothDevicesDiscovery(Object object)

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

参数

Object object

object.powerLevel 的合法值

错误

示例代码

jd.startBluetoothDevicesDiscovery({
  services: ['0000'],
  success: function(res) {
    console.log(res)
  }
})

jd.stopBluetoothDevicesDiscovery(Object object)

停止搜寻附近的蓝牙外围设备。若已经找到需要的蓝牙设备并不需要继续搜索时，建议调用该接口停止蓝牙搜索。

参数

Object object

错误

示例代码

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