0
  • 聊天消息
  • 系统消息
  • 评论与回复
登录后你可以
  • 下载海量资料
  • 学习在线课程
  • 观看技术视频
  • 写文章/发帖/加入社区
会员中心
创作中心

完善资料让更多小伙伴认识你,还能领取20积分哦,立即完善>

3天内不再提示

鸿蒙语言基础类库:system.bluetooth 蓝牙

jf_46214456 来源:jf_46214456 作者:jf_46214456 2024-07-15 17:28 次阅读

蓝牙

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

搜狗高速浏览器截图20240326151547.png

参数名类型说明HarmonyOSOpenHarmony鸿蒙文档籽料:mau123789是v直接拿
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。

审核编辑 黄宇

声明:本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人,不代表电子发烧友网立场。文章及其配图仅供工程师学习之用,如有内容侵权或者其他违规问题,请联系本站处理。 举报投诉
  • 蓝牙
    +关注

    关注

    114

    文章

    5811

    浏览量

    170194
  • 鸿蒙
    +关注

    关注

    57

    文章

    2342

    浏览量

    42821
收藏 人收藏

    评论

    相关推荐

    鸿蒙语言TypeScript学习第16天:【

    TypeScript 支持面向对象的所有特性,比如 、接口等。
    的头像 发表于 04-15 09:29 1015次阅读
    <b class='flag-5'>鸿蒙语言</b>TypeScript学习第16天:【<b class='flag-5'>类</b>】

    ArkTS语言基础-解析

    ArkTS语言基础是HarmonyOS系统上为应用开发者提供的常用基础能力,主要包含能力如下图所示。 图1 ArkTS语言基础
    发表于 02-20 16:44

    鸿蒙原生应用开发-ArkTS语言基础概述

    ArkTS语言基础是HarmonyOS系统上为应用开发者提供的常用基础能力,主要包含能力如下图所示。 1.提供异步并发和多线程并发的能力。 支持Promise和async/await等标准
    发表于 03-05 15:42

    如何在鸿蒙2.0系统上移植增加蓝牙驱动?

    bluetooth_hdi_adapter),蓝牙头文件bluetooth_hdi.h名字和一些名字都和2.0的名字不一样,有更新,直接而且我看3.1子系统通信
    发表于 05-13 10:13

    蓝牙(Bluetooth)技术

    蓝牙(Bluetooth)技术  所谓蓝牙(Bluetooth)技术,实际上是一种短距离无线电技术,利用"蓝牙"技术,能够有效
    发表于 01-06 11:08 751次阅读

    HarmonyOS语言基础开发指南上线啦!

    语言基础提供哪些功能?多线程并发如何实现?TaskPool(任务池)和Worker在实现和使用场景上有何不同? 针对开发者关注的并发等语言基础
    的头像 发表于 10-18 16:20 576次阅读
    HarmonyOS<b class='flag-5'>语言</b>基础<b class='flag-5'>类</b><b class='flag-5'>库</b>开发指南上线啦!

    鸿蒙OpenHarmony大合集:【语言基础

    本示例集合语言基础的各个子模块,展示了各个模块的基础功能
    的头像 发表于 04-29 16:38 571次阅读
    <b class='flag-5'>鸿蒙</b>OpenHarmony大合集:【<b class='flag-5'>语言</b>基础<b class='flag-5'>类</b><b class='flag-5'>库</b>】

    鸿蒙语言基础:ohos.bytrace 性能打点

    用来标记一个预追踪的数值变量,该变量的数值会不断变化。
    的头像 发表于 07-18 15:41 254次阅读

    鸿蒙语言基础system.brightness 屏幕亮度

    获得设备当前的屏幕亮度值。
    的头像 发表于 07-15 17:56 767次阅读
    <b class='flag-5'>鸿蒙语言</b>基础<b class='flag-5'>类</b><b class='flag-5'>库</b>:<b class='flag-5'>system</b>.brightness 屏幕亮度

    鸿蒙语言基础system.configuration 应用配置

    获取应用当前的语言和地区。默认与系统的语言和地区同步。
    的头像 发表于 07-16 09:34 317次阅读

    鸿蒙语言基础system.device 设备信息

    在首页的onShow生命周期之前不建议调用device.getInfo接口。
    的头像 发表于 07-16 09:17 383次阅读

    鸿蒙语言基础system.file 文件存储

    将指定文件移动到其他指定位置。
    的头像 发表于 07-17 10:41 493次阅读
    <b class='flag-5'>鸿蒙语言</b>基础<b class='flag-5'>类</b><b class='flag-5'>库</b>:<b class='flag-5'>system</b>.file  文件存储

    鸿蒙语言基础system.mediaquery 媒体查询

    根据媒体查询条件,创建MediaQueryList对象。
    的头像 发表于 07-17 16:50 307次阅读
    <b class='flag-5'>鸿蒙语言</b>基础<b class='flag-5'>类</b><b class='flag-5'>库</b>:<b class='flag-5'>system</b>.mediaquery  媒体查询

    鸿蒙语言基础system.network 网络状态

    获取当前设备的网络类型。
    的头像 发表于 07-18 09:37 262次阅读

    鸿蒙语言基础system.notification 通知消息

    以下各项对应的系统能力均为SystemCapability.Notification.Notification
    的头像 发表于 07-18 09:23 327次阅读