蓝牙
说明:
开发前请熟悉鸿蒙开发指导文档 :[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md
]
导入模块
import bluetooth from '@system.bluetooth';
bluetooth.startBLEScan(OBJECT)
开始搜寻附近的低功耗蓝牙外围设备。此操作比较耗费系统资源,请在搜索并连接到设备后调用[bluetooth.stopBLEScan]方法停止搜索。
需要权限: ohos.permission.DISCOVER_BLUETOOTH、ohos.permission.LOCATION
系统能力: SystemCapability.Communication.Bluetooth.Lite
参数:表1 StartBLEScanOptions
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
interval | number | 否 | 上报设备的间隔,单位毫秒,默认值为0。0表示找到新设备立即上报,其他数值根据传入的间隔上报。 |
success | Function | 否 | 接口调用成功的回调函数。 |
fail | Function | 否 | 接口调用失败的回调函数。 |
complete | Function | 否 | 接口调用结束的回调函数。 |
示例:
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
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
success | Function | 否 | 接口调用成功的回调函数。 |
fail | Function | 否 | 接口调用失败的回调函数。 |
complete | Function | 否 | 接口调用结束的回调函数。 |
示例:
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
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
success | Function | 是 | 寻找到新设备上报时调用的回调函数。 |
fail | Function | 否 | 接口调用失败的回调函数。 |
表4 success返回值:
参数名 | 类型 | 说明 |
---|---|---|
devices | Array | 新搜索到的设备列表。 |
表5 BluethoothDevice
参数名 | 类型 | 说明HarmonyOS与OpenHarmony鸿蒙文档籽料:mau123789是v直接拿 |
---|---|---|
addrType | string | 设备地址类型,可能值有: - public: 公共地址 - random: 随机地址 |
addr | string | 设备MAC地址。 |
rssi | number | 设备蓝牙的信号强弱指标。 |
txpower | string | 广播数据中的txpower字段。 |
data | hex string | 广播数据(包含广播数据和扫描响应数据),十六进制字符串。 |
示例:
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();
常见错误码
错误码 | 说明 |
---|---|
1100 | 是否处于已连接状态。 |
1101 | 当前蓝牙适配器不可用。 |
1102 | 没有找到指定设备。 |
1103 | 连接失败。 |
1104 | 没有找到指定服务。 |
1105 | 没有找到指定特征值。 |
1106 | 当前连接已断开。 |
1107 | 当前特征值不支持此操作。 |
1108 | 其余所有系统上报的异常。 |
1109 | 系统版本不支持 BLE。 |
审核编辑 黄宇
-
蓝牙
+关注
关注
114文章
5659浏览量
167873 -
鸿蒙
+关注
关注
56文章
2264浏览量
42451
发布评论请先 登录
相关推荐
评论