藍(lán)牙

說明：
開發(fā)前請熟悉鴻蒙開發(fā)指導(dǎo)文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

• 從API Version 7 開始，該接口不再維護(hù)，推薦使用新接口[@ohos.bluetooth]。
• 本模塊首批接口從API version 6開始支持。后續(xù)版本的新增接口，采用上角標(biāo)單獨(dú)標(biāo)記接口的起始版本。

導(dǎo)入模塊

import bluetooth from '@system.bluetooth';

bluetooth.startBLEScan(OBJECT)

開始搜尋附近的低功耗藍(lán)牙外圍設(shè)備。此操作比較耗費(fèi)系統(tǒng)資源，請在搜索并連接到設(shè)備后調(diào)用[bluetooth.stopBLEScan]方法停止搜索。

需要權(quán)限： ohos.permission.DISCOVER_BLUETOOTH、ohos.permission.LOCATION

系統(tǒng)能力： SystemCapability.Communication.Bluetooth.Lite

參數(shù)：表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)

停止搜尋附近的低功耗藍(lán)牙外圍設(shè)備。與[bluetooth.startBLEScan(OBJECT)]接口配套使用。

需要權(quán)限： ohos.permission.DISCOVER_BLUETOOTH、ohos.permission.LOCATION

系統(tǒng)能力： SystemCapability.Communication.Bluetooth.Lite

參數(shù)：表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)

訂閱尋找到新設(shè)備。再次調(diào)用時，會覆蓋前一次調(diào)用效果，即僅最后一次調(diào)用生效。

需要權(quán)限： ohos.permission.DISCOVER_BLUETOOTH、ohos.permission.LOCATION

系統(tǒng)能力： SystemCapability.Communication.Bluetooth.Lite

參數(shù)：表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, data: ${data}, code: ${code}.');
  }
});

bluetooth.unsubscribeBLEFound()

解除訂閱尋找到新設(shè)備。

需要權(quán)限： ohos.permission.DISCOVER_BLUETOOTH、ohos.permission.LOCATION

系統(tǒng)能力： SystemCapability.Communication.Bluetooth.Lite

示例：

bluetooth.unsubscribeBLEFound();

常見錯誤碼

審核編輯 黃宇