藍牙

說明：
開發(fā)前請熟悉鴻蒙開發(fā)指導(dǎo)文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
從API Version 7 開始，該接口不再維護，推薦使用新接口[@ohos.bluetooth]。
本模塊首批接口從API version 6開始支持。后續(xù)版本的新增接口，采用上角標單獨標記接口的起始版本。

導(dǎo)入模塊

import bluetooth from '@system.bluetooth';

bluetooth.startBLEScan(OBJECT)

開始搜尋附近的低功耗藍牙外圍設(shè)備。此操作比較耗費系統(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

參數(shù)名	類型	必填	說明
interval	number	否	上報設(shè)備的間隔，單位毫秒，默認值為0。0表示找到新設(shè)備立即上報，其他數(shù)值根據(jù)傳入的間隔上報。
success	Function	否	接口調(diào)用成功的回調(diào)函數(shù)。
fail	Function	否	接口調(diào)用失敗的回調(diào)函數(shù)。
complete	Function	否	接口調(diào)用結(jié)束的回調(diào)函數(shù)。

示例：

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)

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

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

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

參數(shù)：表2 StopBLEScanOptions

參數(shù)名	類型	必填	說明
success	Function	否	接口調(diào)用成功的回調(diào)函數(shù)。
fail	Function	否	接口調(diào)用失敗的回調(diào)函數(shù)。
complete	Function	否	接口調(diào)用結(jié)束的回調(diào)函數(shù)。

示例：

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

參數(shù)	類型	必填	說明
success	Function	是	尋找到新設(shè)備上報時調(diào)用的回調(diào)函數(shù)。
fail	Function	否	接口調(diào)用失敗的回調(diào)函數(shù)。

表4 success返回值：

參數(shù)名	類型	說明
devices	Array	新搜索到的設(shè)備列表。

表5 BluethoothDevice

搜狗高速瀏覽器截圖20240326151547.png

參數(shù)名	類型	說明`HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿`
addrType	string	設(shè)備地址類型，可能值有： - public: 公共地址 - random: 隨機地址
addr	string	設(shè)備MAC地址。
rssi	number	設(shè)備藍牙的信號強弱指標。
txpower	string	廣播數(shù)據(jù)中的txpower字段。
data	hex string	廣播數(shù)據(jù)（包含廣播數(shù)據(jù)和掃描響應(yīng)數(shù)據(jù)），十六進制字符串。

示例：

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();

常見錯誤碼

錯誤碼	說明
1100	是否處于已連接狀態(tài)。
1101	當前藍牙適配器不可用。
1102	沒有找到指定設(shè)備。
1103	連接失敗。
1104	沒有找到指定服務(wù)。
1105	沒有找到指定特征值。
1106	當前連接已斷開。
1107	當前特征值不支持此操作。
1108	其余所有系統(tǒng)上報的異常。
1109	系統(tǒng)版本不支持 BLE。

審核編輯黃宇

聲明：本文內(nèi)容及配圖由入駐作者撰寫或者入駐合作網(wǎng)站授權(quán)轉(zhuǎn)載。文章觀點僅代表作者本人，不代表電子發(fā)燒友網(wǎng)立場。文章及其配圖僅供工程師學(xué)習(xí)之用，如有內(nèi)容侵權(quán)或者其他違規(guī)問題，請聯(lián)系本站處理。舉報投訴