藍牙

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

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

導入模塊

import bluetooth from '@system.bluetooth';

bluetooth.startBLEScan(OBJECT)

開始搜尋附近的低功耗藍牙外圍設備。此操作比較耗費系統資源，請在搜索并連接到設備后調用[bluetooth.stopBLEScan]方法停止搜索。

需要權限： ohos.permission.DISCOVER_BLUETOOTH、ohos.permission.LOCATION

系統能力： 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)]接口配套使用。

需要權限： ohos.permission.DISCOVER_BLUETOOTH、ohos.permission.LOCATION

系統能力： 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)

訂閱尋找到新設備。再次調用時，會覆蓋前一次調用效果，即僅最后一次調用生效。

需要權限： ohos.permission.DISCOVER_BLUETOOTH、ohos.permission.LOCATION

系統能力： 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, data: ${data}, code: ${code}.');
  }
});

bluetooth.unsubscribeBLEFound()

解除訂閱尋找到新設備。

需要權限： ohos.permission.DISCOVER_BLUETOOTH、ohos.permission.LOCATION

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

示例：

bluetooth.unsubscribeBLEFound();

常見錯誤碼

審核編輯 黃宇