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

用法：setBluetoothEnable(OBJECT)

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

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

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

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

• 此接口回调 success/fail/complete 只是代表api执行完成，不代表蓝牙开关状态已经发生改变
• 可从 getBluetoothAdapterState 接口主动获得当前蓝牙状态
• 可从 onBluetoothAdapterStateChange 接口被动监听当前蓝牙状态

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

警告：

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

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 为空或者是格式不正确

示例代码

UniAppX:

let enable: boolean = true;
UTSBLE.setBluetoothEnable({
    enable: enable,
    success: (res) => {
        console.log("开关蓝牙API执行完成：", res)
    },
    fail: (err) => {
        console.log("开关蓝牙API执行失败：", err)
    },
} as SetBluetoothEnableOptions);

UniAppJS:

let enable = true;
UTSBLE.setBluetoothEnable({
    enable: enable ,
    success: (res) => {
        console.log("开关蓝牙API执行完成: ", res);
    },
    fail: (err) => {
        console.log("开关蓝牙API执行失败: ", err);
    },
})