鸿蒙语言基础类库:【@system.bluetooth (蓝牙)】
创始人
2024-12-29 02:03:26
0次

蓝牙

说明:
开发前请熟悉鸿蒙开发指导文档: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

参数名类型必填说明
intervalnumber否上报设备的间隔,单位毫秒,默认值为0。0表示找到新设备立即上报,其他数值根据传入的间隔上报。
successFunction否接口调用成功的回调函数。
failFunction否接口调用失败的回调函数。
completeFunction否接口调用结束的回调函数。

示例:

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

参数名类型必填说明
successFunction否接口调用成功的回调函数。
failFunction否接口调用失败的回调函数。
completeFunction否接口调用结束的回调函数。

示例:

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

参数类型必填说明
successFunction是寻找到新设备上报时调用的回调函数。
failFunction否接口调用失败的回调函数。

表4 success返回值:

参数名类型说明
devicesArray新搜索到的设备列表。

表5 BluethoothDevice

在这里插入图片描述

参数名类型说明
addrTypestring设备地址类型,可能值有: - public: 公共地址 - random: 随机地址
addrstring设备MAC地址。
rssinumber设备蓝牙的信号强弱指标。
txpowerstring广播数据中的txpower字段。
datahex 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。

相关内容

热门资讯

一分钟了解辅助!新518互游辅... 一分钟了解辅助!新518互游辅助多功能AI软件,新518互游真是真的是有辅助软件1、新518互游辅助...
终于清楚开挂!卡米大厅开挂多功... 终于清楚开挂!卡米大厅开挂多功能AI方法,卡米大厅其实存在有开挂方法1、下载好卡米大厅正确养号方法之...
六分钟了解作弊器!玄灵大厅作弊... 六分钟了解作弊器!玄灵大厅作弊器多功能AI软件,玄灵大厅真是有作弊器软件1、很好的工具软件,可以解锁...
一起来讨论外挂!椰子大厅外挂多... 一起来讨论外挂!椰子大厅外挂多功能AI攻略,椰子大厅原来是真的有外挂攻略1、椰子大厅辅助软件下载优化...
玩家必看教程辅助!鲨鱼众娱辅助... 玩家必看教程辅助!鲨鱼众娱辅助多功能AI攻略,鲨鱼众娱一直真的是有辅助攻略1、许多玩家不知道鲨鱼众娱...
盘点一款开挂!皇豪大厅开挂多功... 盘点一款开挂!皇豪大厅开挂多功能AI攻略,皇豪大厅确实是真的有开挂攻略1、进入到皇豪大厅是否有挂之后...
教学盘点辅助器!老夫子大厅辅助... 教学盘点辅助器!老夫子大厅辅助器多功能AI攻略,老夫子大厅竟然真的是有辅助器攻略1、该软件可以轻松地...
热点推荐透视挂!嗨玩娱乐麻将透... 热点推荐透视挂!嗨玩娱乐麻将透视挂多功能AI软件,嗨玩娱乐麻将本来真的是有透视挂软件1、下载好嗨玩娱...
一分钟揭秘作弊器!黑莓大厅作弊... 一分钟揭秘作弊器!黑莓大厅作弊器多功能AI教程,黑莓大厅本来是真的有作弊器教程1、首先打开黑莓大厅辅...
玩家必看科普开挂!七天娱乐开挂... 玩家必看科普开挂!七天娱乐开挂多功能AIapp,七天娱乐竟然存在有开挂app1、七天娱乐公共底牌简单...