@system.bluetooth (蓝牙)

说明：

• 从API Version 7 开始，该接口不再维护，推荐使用@ohos.bluetooth.ble等相关profile接口。

• 本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import bluetooth from '@system.bluetooth';

bluetooth.startBLEScan(OBJECT)

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

系统能力： SystemCapability.Communication.Bluetooth.Lite

参数： 表1 StartBLEScanOptions

示例：

bluetooth.startBLEScan({
  interval:0,
  success() {
    console.log('call bluetooth.startBLEScan success.');
  },
  fail(code, data) {
    console.log('call bluetooth.startBLEScan failed, code:' + code + ', data:' + data);
  },
  complete() {
    console.log('call bluetooth.startBLEScan complete.');
  }
});

bluetooth.stopBLEScan(OBJECT)

停止搜寻附近的低功耗蓝牙外围设备。与bluetooth.startBLEScan(OBJECT)接口配套使用。

系统能力： SystemCapability.Communication.Bluetooth.Lite

参数： 表2 StopBLEScanOptions

示例：

bluetooth.stopBLEScan({
  success() {
    console.log('call bluetooth.stopBLEScan success.');
  },
  fail(data, code) {
    console.log('call bluethooth.stopBLEScan fail, code:' + code + ', data:' + data);
  },
  complete() {
    console.log('call bluethooth.stopBLEScan complete.');
  }
});

bluetooth.subscribeBLEFound(OBJECT)

订阅寻找到新设备。再次调用时，会覆盖前一次调用效果，即仅最后一次调用生效。

系统能力： SystemCapability.Communication.Bluetooth.Lite

参数： 表3 SubscribeBLEFoundOptions

表4 success返回值：

表5 BluethoothDevice

示例：

bluetooth.subscribeBLEFound({
  success(data) {
    console.log('call bluetooth.subscribeBLEFound success, data: ${data}.');
  },
  fail(data, code) {
    console.log('call bluetooth.startBLEScan failed, code:' + code + ', data:' + data);
  }
});

bluetooth.unsubscribeBLEFound()

解除订阅寻找到新设备。

系统能力： SystemCapability.Communication.Bluetooth.Lite

示例：

bluetooth.unsubscribeBLEFound();

常见错误码