当前位置: 首页 > news >正文

[UTS蓝牙插件文档] setBluetoothEnable 接口描述

名称:setBluetoothEnable

用途:编程式开关系统蓝牙

  • 不支持除了APP之外的其他平台(比如小程序,WEB)
  • 此接口不支持IOS,调用会报错api不支持此系统平台
  • 在Android系统下,targetSDKVersion大于等于33(Android13)时,又或者是部分国产系统(比如小米)有针对性定制的情况下,无法无感操作,只能弹窗让用户选择
  • 在鸿蒙NEXT平台下,只能弹窗让用户选择

基本上国产系统都是深度定制此操作权限的了,所以大部分都是请求用户交互的,尽管我们想要无感操作,但是实际上无感的API还是被拦截成交互的了,无法解决。而且无感操作可能会引起用户反感,使用需谨慎。

警告:需要先调用 openBluetoothAdapter 接口,获取必要权限,才能继续调用此接口,否则可能会出现报错,或者是蓝牙状态的回调无法正常触发。

  • 可从 getBluetoothAdapterState 接口主动获得当前蓝牙状态
  • 可从 onBluetoothAdapterStateChange 接口被动监听当前蓝牙状态

蓝牙已经是对应操作的开关状态时,以上两个接口都无法感知到开关状态变化,请勿重复操作

OBJECT 参数说明

属性 类型 默认值 必填 说明
enable boolean 是否使能/关闭蓝牙,为true表示使能,为false表示关闭
success function 接口调用成功的回调函数
fail function 接口调用失败的回调函数
complete function 接口调用结束的回调函数(调用成功、失败都会执行)

错误

错误码 错误信息 说明
0 ok 正常
-1 already connect 已经连接(WX特性)
10000 not init 未初始化蓝牙适配器
10001 not available 当前蓝牙适配器不可用
10002 no device 没有找到指定设备
10003 connection fail 连接失败
10004 no service 没有找到指定服务
10005 no characteristic 没有找到指定特征值
10006 no connection 当前连接已断开
10007 property not support 当前特征值不支持此操作
10008 system error 其余所有系统上报的异常
10009 system not support Android 系统特有,系统版本低于 4.3 不支持 BLE
10010 already connect 已连接(UNI特性)
10011 need pin 配对设备需要配对码
10012 operate time out 连接超时
10013 invalid_data 连接 deviceId 为空或者是格式不正确

注意

  • 除非你是嵌入式设备,或者是定制系统/设备,并且你确定你调用此接口不会引起用户反感,否则请不要调用!否则这可能会引起你的APP用户反感。
  • 此接口非标准接口,可能会打破跨端需求,请考虑好是否有相关需求再决定是否使用!
http://www.jsqmd.com/news/321242/

相关文章:

  • 函数占位参数:语法规则与实际应用场景
  • 总结福建新东方技工学校推荐指数,是否值得学生报考
  • Hadoop学习 day4 - 呓语
  • 2026年上海地区进口的抗皱紧致精油品牌推荐与选购指南
  • display: inline 详细讲解一下
  • 虎牙ios开发面试题及参考答案(上) - 详解
  • 2026年卫生用品包装厂家推荐,告诉你如何选择高性价比品牌
  • 2025年全球顶尖杀毒软件,从零基础到精通,收藏这篇就够了!
  • 2026年卫生用品包装供应商推荐,这些好用品牌值得关注
  • 成人肠胃调理益生菌哪个好?十大安全益生菌实测榜单,国家认证菌株安全抗幽超靠谱
  • 2026年南昌九江超靠谱风管加工厂排名与风管加工厂怎么选指南
  • 【完整源码+数据集+部署教程】黄桃病害检测检测系统源码 [一条龙教学YOLOV8标注好的数据集一键训练_70+全套改进创新点发刊_Web前端展示]
  • 聊聊椰壳活性炭精品定制,广东地区靠谱的品牌厂家有哪些
  • Claude Code提示词案例
  • 为什么这个经常导致流鼻血
  • HTTPS双向认证深度攻略:从原理到实践,构建AI时代的可信通信壁垒
  • 2026年诚信的零部件吸塑加工公司推荐,性价比高的是哪家
  • 【完整源码+数据集+部署教程】小麦生长状态检测检测系统源码 [一条龙教学YOLOV8标注好的数据集一键训练_70+全套改进创新点发刊_Web前端展示]
  • 【完整源码+数据集+部署教程】木材检测检测系统源码 [一条龙教学YOLOV8标注好的数据集一键训练_70+全套改进创新点发刊_Web前端展示]
  • 深聊专业抗皱紧致精油品牌,花悠花性价比怎么样?值得选吗
  • **AI漫剧软件2025推荐,解锁海量免费资源与智能创作体验
  • 2026古筝市场新发现:这家厂家古筝工艺有何独到?古筝品牌精选优质品牌助力工程采购
  • 利用AI技术实现SEO关键词的高效优化策略
  • **AI漫剧制作2025指南,解锁低成本高转化内容新玩法**
  • 2026智能眼镜电池哪家做的好?行业技术实力品牌解析
  • 自适应控制的Simulink仿真实战
  • 探寻2026年汽车贴膜好去处:这几家店铺不容错过,汽车贴膜/玻璃膜/汽车膜/贴车衣/车衣改色,汽车贴膜专业店口碑推荐
  • 推荐一家靠谱的短视频运营公司
  • 区块链智能合约安全审计:常见漏洞及防范措施详解
  • 好写作AI:学术出版机构对AI生成内容的识别与认证体系