蓝牙-低功耗中心设备

has.createBLEConnection

has.createBLEConnection(Object object)

连接蓝牙低功耗设备。

若元服务在之前已有搜索过某个蓝牙设备，并成功建立连接，可直接传入之前搜索获取的deviceId直接尝试连接该设备，无需再次进行搜索操作。

起始版本： 1.0.4

需要权限：

1. 在module.json5文件中声明ohos.permission.ACCESS_BLUETOOTH。

2. 使用has.authorize()中申请[scope.bluetooth]https://developer.huawei.com/consumer/cn/doc/doccenter-atomic-service/develop-authorization#scope列表)。

参数：

参数为Object对象，包括以下字段。

错误码信息：

示例：

has.createBLEConnection({
  deviceId: '',
  success: () => {
    console.info('createBLEConnection success');
  },
  fail: (err) => {
    console.error('createBLEConnection fail', err);
  },
  complete: (res) => {
    console.info('createBLEConnection complete', res);
  }
});

has.closeBLEConnection

has.closeBLEConnection(Object object)

断开与蓝牙低功耗设备的连接。

起始版本： 1.0.4

需要权限：

1. 在module.json5文件中声明ohos.permission.ACCESS_BLUETOOTH。

2. 使用has.authorize()中申请scope.bluetooth。

参数：

参数为Object对象，包括以下字段。

错误码信息：

示例：

has.closeBLEConnection({
  deviceId: '',
  success: () => {
    console.info('closeBLEConnection success');
  },
  fail: (err) => {
    console.error('closeBLEConnection fail', err);
  },
  complete: (res) => {
    console.info('closeBLEConnection complete', res);
  }
});

has.getConnectedBluetoothDevices

has.getConnectedBluetoothDevices(Object object)

根据主服务UUID获取已连接的蓝牙设备。

起始版本： 1.0.12

需要权限：

1. 在module.json5文件中声明ohos.permission.ACCESS_BLUETOOTH。

2. 使用has.authorize()中申请scope.bluetooth。

参数：

参数为Object对象，包括以下字段。

success返回值：

devices说明：

错误码信息：

示例：

has.getConnectedBluetoothDevices({
  services: [''],
  success: (res) => {
    console.info('getConnectedBluetoothDevices success', res);
  },
  fail: (err) => {
    console.error('getConnectedBluetoothDevices fail', err);
  },
  complete: (res) => {
    console.info('getConnectedBluetoothDevices complete', res);
  }
});

has.onBLEConnectionStateChange

has.onBLEConnectionStateChange(function callback)

监听蓝牙低功耗连接状态改变事件。

起始版本： 1.0.12

需要权限：

1. 在module.json5文件中声明ohos.permission.ACCESS_BLUETOOTH。

2. 使用has.authorize()中申请scope.bluetooth。

参数：

callback返回值：

示例：

has.onBLEConnectionStateChange(function(res) {
  console.info(`device ${res.deviceId} state has changed, connected: ${res.connected}`);
});

has.offBLEConnectionStateChange

has.offBLEConnectionStateChange(function callback)

移除蓝牙低功耗连接状态改变事件的监听函数。

起始版本： 1.0.12

需要权限：

1. 在module.json5文件中声明ohos.permission.ACCESS_BLUETOOTH。

2. 使用has.authorize()中申请scope.bluetooth。

参数：

示例：

let listener = function(res) {
  console.info(`device ${res.deviceId} state has changed, connected: ${res.connected}`);
};
has.onBLEConnectionStateChange(listener);
has.offBLEConnectionStateChange(listener);
has.offBLEConnectionStateChange();

has.getBLEDeviceServices

has.getBLEDeviceServices(Object object)

获取蓝牙低功耗设备所有服务。

起始版本： 1.0.12

需要权限：

1. 在module.json5文件中声明ohos.permission.ACCESS_BLUETOOTH。

2. 使用has.authorize()中申请scope.bluetooth。

参数：

参数为Object对象，包括以下字段。

success返回值：

services说明：

错误码信息：

示例：

has.getBLEDeviceServices({
  deviceId: 'deviceId',
  success: (res) => {
    console.info('getBLEDeviceServices success', res);
  },
  fail: (err) => {
    console.error('getBLEDeviceServices fail', err);
  },
  complete: (res) => {
    console.info('getBLEDeviceServices complete', res);
  }
});

has.getBLEDeviceCharacteristics

has.getBLEDeviceCharacteristics(Object object)

获取蓝牙低功耗设备某个服务中所有特征。

起始版本： 1.0.12

需要权限：

1. 在module.json5文件中声明ohos.permission.ACCESS_BLUETOOTH。

2. 使用has.authorize()中申请scope.bluetooth。

参数：

参数为Object对象，包括以下字段。

success返回值：

characteristics说明：

properties说明：

错误码信息：

示例：

has.getBLEDeviceCharacteristics({
  deviceId: 'deviceId',
  serviceId: 'serviceId',
  success: (res) => {
    console.info('getBLEDeviceCharacteristics success', res);
  },
  fail: (err) => {
    console.error('getBLEDeviceCharacteristics fail', err);
  },
  complete: (res) => {
    console.info('getBLEDeviceCharacteristics complete', res);
  }
});

has.readBLECharacteristicValue

has.readBLECharacteristicValue(Object object)

读取蓝牙低功耗设备特征值的二进制数据。

设备的特征需支持read才可以成功调用，可通过has.getBLEDeviceCharacteristics查询是否支持。

起始版本： 1.0.12

需要权限：

1. 在module.json5文件中声明ohos.permission.ACCESS_BLUETOOTH。

2. 使用has.authorize()中申请scope.bluetooth。

参数：

参数为Object对象，包括以下字段。

错误码信息：

示例：

has.readBLECharacteristicValue({
  deviceId: 'deviceId',
  serviceId: 'serviceId',
  characteristicId: 'characteristicId',
  success: () => {
    console.info('readBLECharacteristicValue success');
  },
  fail: (err) => {
    console.error('readBLECharacteristicValue fail', err);
  },
  complete: (res) => {
    console.info('readBLECharacteristicValue complete', res);
  }
});

has.writeBLECharacteristicValue

has.writeBLECharacteristicValue(Object object)

向蓝牙低功耗设备特征值中写入二进制数据。

设备的特征需支持write才可以成功调用，可通过has.getBLEDeviceCharacteristics查询是否支持。

起始版本： 1.0.12

需要权限：

1. 在module.json5文件中声明ohos.permission.ACCESS_BLUETOOTH。

2. 使用has.authorize()中申请scope.bluetooth。

参数：

参数为Object对象，包括以下字段。

错误码信息：

示例：

let buffer = new ArrayBuffer(1);
let dataView = new DataView(buffer);
dataView.setUint8(0, 0);

has.writeBLECharacteristicValue({
  deviceId: 'deviceId',
  serviceId: 'serviceId',
  characteristicId: 'characteristicId',
  value: buffer,
  success: () => {
    console.info('writeBLECharacteristicValue success');
  },
  fail: (err) => {
    console.error('writeBLECharacteristicValue fail', err);
  },
  complete: (res) => {
    console.info('writeBLECharacteristicValue complete', res);
  }
});

has.notifyBLECharacteristicValueChange

has.notifyBLECharacteristicValueChange(Object object)

启用蓝牙低功耗设备特征值变化时的notify功能，订阅特征。

设备的特征需支持notify或indicate才可以成功调用，可通过has.getBLEDeviceCharacteristics查询是否支持。

起始版本： 1.0.12

需要权限：

1. 在module.json5文件中声明ohos.permission.ACCESS_BLUETOOTH。

2. 使用has.authorize()中申请scope.bluetooth。

参数：

参数为Object对象，包括以下字段。

错误码信息：

示例：

has.notifyBLECharacteristicValueChange({
  deviceId: 'deviceId',
  serviceId: 'serviceId',
  characteristicId: 'characteristicId',
  state: true,
  success: () => {
    console.info('notifyBLECharacteristicValueChange success');
  },
  fail: (err) => {
    console.error('notifyBLECharacteristicValueChange fail', err);
  },
  complete: (res) => {
    console.info('notifyBLECharacteristicValueChange complete', res);
  }
});

has.onBLECharacteristicValueChange

has.onBLECharacteristicValueChange(function callback)

监听蓝牙低功耗设备的特征值变化事件。

必须先调用has.notifyBLECharacteristicValueChange接口才能接收到设备推送的通知。

起始版本： 1.0.12

需要权限：

1. 在module.json5文件中声明ohos.permission.ACCESS_BLUETOOTH。

2. 使用has.authorize()中申请scope.bluetooth。

参数：

callback返回值：

示例：

function ab2hex(buffer) {
  let hexArr = Array.prototype.map.call(
  new Uint8Array(buffer),
  function(bit) {
    return ('00' + bit.toString(16)).slice(-2)
  }
 )
  return hexArr.join('');
};
has.onBLECharacteristicValueChange(
  function(res) {
    console.info(`characteristic ${res.characteristicId} has changed, now is ${res.value}`);
    console.info(ab2hex(res.value));
  }
);

has.offBLECharacteristicValueChange

has.offBLECharacteristicValueChange()

移除蓝牙低功耗设备的特征值变化事件的全部监听函数。

起始版本： 1.0.12

需要权限：

1. 在module.json5文件中声明ohos.permission.ACCESS_BLUETOOTH。

2. 使用has.authorize()中申请scope.bluetooth。

示例：

has.offBLECharacteristicValueChange();