蓝牙-通用

has.startBluetoothDevicesDiscovery

has.startBluetoothDevicesDiscovery(Object object)

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

起始版本： 1.0.4

参数：

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

错误码信息：

示例：

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

has.stopBluetoothDevicesDiscovery

has.stopBluetoothDevicesDiscovery (Object object)

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

起始版本： 1.0.4

参数：

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

错误码信息：

示例：

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

has.openBluetoothAdapter

has.openBluetoothAdapter(Object object)

初始化蓝牙模块。

起始版本： 1.0.4

需要权限： 在module.json5文件中声明ohos.permission.ACCESS_BLUETOOTH。

参数：

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

错误码信息：

示例：

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

has.closeBluetoothAdapter

has.closeBluetoothAdapter(Object object)

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

起始版本： 1.0.4

参数：

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

错误码信息：

示例：

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

has.onBluetoothDeviceFound

has.onBluetoothDeviceFound(function callback)

监听搜索到新设备的事件。

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

起始版本： 1.0.4

参数：

callback返回值：

devices说明：

示例：

// ArrayBuffer转16进制字符串示例
function ab2hex(buffer) {
  const hexArr = Array.prototype.map.call(
    new Uint8Array(buffer),
    function (bit) {
      return ('00' + bit.toString(16)).slice(-2)
    }
  );
  return hexArr.join('');
};

has.onBluetoothDeviceFound(function (res) {
  const devices = res.devices;
  console.info('new device list found');
  console.info(ab2hex(devices[0].advertisData));
});

has.offBluetoothDeviceFound

has.offBluetoothDeviceFound()

移除搜索到新设备的事件的全部监听函数。

起始版本： 1.0.4

示例：

has.offBluetoothDeviceFound();

has.onBluetoothAdapterStateChange

has.onBluetoothAdapterStateChange(function callback)

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

起始版本： 1.0.4

参数：

callback返回值：

示例：

has.onBluetoothAdapterStateChange(function(res) {
  console.info('adapterState changed, now is', res);
});

has.offBluetoothAdapterStateChange

has.offBluetoothAdapterStateChange()

移除蓝牙适配器状态变化事件的全部监听函数。

起始版本： 1.0.4

示例：

has.offBluetoothAdapterStateChange();

has.getBluetoothDevices

has.getBluetoothDevices(Object object)

获取在蓝牙模块生效期间所有搜索到的蓝牙设备。包括已经和本机处于连接状态的设备。

起始版本： 1.0.4

参数：

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

success返回值：

devices说明：

错误码信息：

示例：

// ArrayBuffer转16进制字符串示例
function ab2hex(buffer) {
  const hexArr = Array.prototype.map.call(
    new Uint8Array(buffer),
    function (bit) {
      return ('00' + bit.toString(16)).slice(-2);
    }
  );
  return hexArr.join('');
};

has.getBluetoothDevices({
  success: (res) => {
    console.info('getBluetoothDevices success', res);
    if (res.devices[0]) {
      console.info(ab2hex(res.devices[0].advertisData));
    }
  },
  fail: (err) => {
    console.error('getBluetoothDevices fail', err);
  },
  complete: (res) => {
    console.info('getBluetoothDevices complete', res);
  }
});

has.getBluetoothAdapterState

has.getBluetoothAdapterState(Object object)

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

起始版本： 1.0.4

参数：

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

success返回值：

错误码信息：

示例：

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