准备工作

android:nameandroid.permission.ACCE…本文主要介绍蓝牙设备与手机一对一相连的

蓝牙单点

android:nameandroid.permission.ACCESS_COARSE_LOCATION

uses-permission

android:nameandroid.permission.ACCESS_FINE_LOCATION

uses-permission

android:nameandroid.permission.BLUETOOTH

uses-permission

android:nameandroid.permission.BLUETOOTH_ADMIN

App

定位权限是否被允许。

检查蓝牙状态是否为开启。

说明该部分检查逻辑智能生活

SDK

会根据协议对广播包进行解析发现周围的涂鸦蓝牙单点设备和双模设备等。

⚠️注意蓝牙设备扫描前需要进行权限检测只有具备权限才能正常扫描

void

参数类型说明settingLeScanSetting扫描的设置responseTyBleScanResponse扫描结果的回调不能为空

构建类说明

方法名参数说明是否必需setTimeout()long设置超时时间

默认40000单位毫秒可选addScanType()ScanType

Mesh

设备SINGLE_QR扫码配网设备。

必需setRepeatFilter()boolean重复过滤默认true可选

示例代码

LeScanSetting.Builder().setTimeout(60000)

扫描的超时时间ms.addScanType(ScanType.SINGLE)

若需要扫描蓝牙设备则只需要添加

.addScanType(ScanType.SIG_MESH)

开始扫描

TuyaHomeSdk.getBleOperator().startLeScan(scanSetting,

new

组成可以唯一区别设备nameString扫描到的蓝牙名称一般为空providerNameString取值为

SingleBleProvider

则表示只开发单点设备您无需关注该字段databyte[]原始数据configTypeString

config_type_single单点设备config_type_wifi双模设备productIdString产品

IDuuidString设备

Mac不可作为唯一码isbindboolean设备是否被绑定能回调的均为未配网的设备flagint

Wi-Fibit2是否分享设备bit3是否⽀持蓝牙兜底配网设备bit4是否是扫码配网设备addressString设备地址deviceTypeint设备类型用于区分不同协议的设备您无需关注该字段

deviceType

值configType设备类型200config_type_single蓝牙设备300config_type_single蓝牙设备301config_type_wifiWi-Fi

蓝牙双模设备支持蓝牙兜底配网400config_type_single蓝牙设备401config_type_wifiWi-Fi

蓝牙双模设备支持蓝牙兜底配网

ITuyaDataCallbackConfigProductInfoBean

callback);参数说明

参数类型说明productIdStringScanDeviceBean.getProductIduuidStringScanDeviceBean.getUuidmacStringScanDeviceBean.getMac

该值一般设备为

TuyaHomeSdk.getActivatorInstance().getActivatorDeviceInfo(scanDeviceBean.getProductId(),scanDeviceBean.getUuid(),scanDeviceBean.getMac(),new

ITuyaDataCallbackConfigProductInfoBean()

{Overridepublic

onSuccess(ConfigProductInfoBean

result)

属性类型说明nameString产品名称云端配置一般是用户首次创建产品时的名称iconString产品图标

停止扫描

当退出配网页面或者在执行设备入网时建议停止设备扫描以防止扫描影响到配网过程。

接口说明

TuyaHomeSdk.getBleOperator().stopLeScan();单点设备配网

开始单点设备入网

startActivator(BleActivatorBean

bleActivatorBean,

参数类型说明bleActivatorBeanBleActivatorBean需要连接的设备的参数集合listenerIBleActivatorListener配网结果的回调

BleActivatorBean

UUID通过扫描可以查询必需addressString设备地址通过扫描可以查询可选productIdString产品

ID通过扫描可以查询可选deviceTypeInteger设备类型通过扫描可以查询必需isShareboolean是否为共享设备通过扫描可以查询默认为

false可选timeoutlong配网总超时配网超时失败以该参数为准。

代码示例

mScanDeviceBean.getDeviceType();

设备类型

mScanDeviceBean.getProductId();

0x01

TuyaHomeSdk.getActivator().newBleActivator().startActivator(bleActivatorBean,

new

TuyaHomeSdk.getBleManager().stopBleConfig(uuid);双模设备配网

双模设备入网

双模设备扫描到后可以进行入网激活扫描到的设备。

configType

属性取值为

startActivator(MultiModeActivatorBean

listener);参数说明

参数类型说明multiModeActivatorBeanMultiModeActivatorBean需要配网的双模设备参数集合listenerIMultiModeActivatorListener配网结果回调

属性类型说明deviceTypeInteger设备类型通过扫描可以查询uuidString设备

UUID通过扫描可以查询addressString设备地址通过扫描可以查询macString设备

SSIDpwdStringWi-Fi

IDtimeoutlong配网总超时配网超时失败以该参数为准单位为毫秒说明若未说明一般设备只支持

2.4G

multiModeActivatorBean.deviceType

mScanDeviceBean.getDeviceType();

设备类型

TuyaHomeSdk.getActivator().newMultiModeActivator().startActivator(multiModeActivatorBean,

new

参数类型说明nameString设备名称errorCodeString错误码devIdString设备

IDiconUrlString设备图标errorMsgString错误信息

取消双模设备配网

说明如果在配网过程中终止了配网若设备已经进行到云端激活阶段虽取消设备配网但可能会配网成功。

接口说明

TuyaHomeSdk.getActivator().newMultiModeActivator().stopActivator(uuid);参数说明

UUID

TuyaHomeSdk.getActivator().newMultiModeActivator().stopActivator(uuidxxxx);双模设备蓝牙兜底配网

App

Wi-Fi。

若激活云端链路失败会启动本地连接模式使用手机蓝牙直接与设备通信。

ScanDeviceBean

304则表示该设备拥有蓝牙兜底配网能力。

其它结果则表示没有该能力。

接口说明

startActivator(MultiModeActivatorBean

listener);MultiModeActivatorBean

UUIDdeviceTypeint设备类型addressString设备地址timeoutlong设备配网超时总时长单位为

msphase1Timeoutlong设备连云激活配网超时时长默认60000单位msssidString需要连接的

Wi-Fi

密码若无密码则传空字符串tokenString从云端查询的账号身份认证信息获取

Token

multiModeActivatorBean.deviceType

scanDeviceBean.getDeviceType();

设置设备

multiModeActivatorBean.phase1Timeout

1000L;//

TuyaHomeSdk.getActivator().newMultiModeActivator().startActivator(multiModeActivatorBean,

listener);说明

开启连云激活需要确保设备当前处于蓝牙链路激活状态即通过蓝牙将连云激活的信息传输给设备。

调用

DeviceBean

getCommunicationOnline(CommunicationEnum.BLE)

true

deviceBean.getMeta().get(wifiEnable)

蓝牙兜底双模设备连云

激活失败会进入蓝牙本地连接进行操作。

此时若想重新尝试让设备连接

Wi-Fi

进行云端激活可以调用如下接口调用时需要确保设备处于本地蓝牙连接状态且云端链路未激活

DeviceBean

getCommunicationOnline(CommunicationEnum.BLE)

deviceBean.getMeta().get(wifiEnable)

接口说明

startWifiEnable(MultiModeActivatorBean

listener);参数说明

参数类型说明multiModeActivatorBeanMultiModeActivatorBean需要重连

Wi-Fi

的设备参数集合listenerIMultiModeActivatorListener重连

Wi-Fi

TuyaHomeSdk.getActivator().newMultiModeActivator().startWifiEnable(multiModeActivatorBean,

listener);设备操作

设备一致。

查询的结果是综合状态若蓝牙设备添加到网关下面则蓝牙设备可云端在线。

TuyaHomeSdk.getDataInstance().getDeviceBean(devId).getIsOnline();方式二查询设备蓝牙是否本地连接。

通常情况下蓝牙只需要考虑本地状态即可。

只有加入蓝牙网关下的蓝牙设备才需要考虑是否云端在线。

TuyaHomeSdk.getBleManager().isBleLocalOnline(devId);连接离线设备

接口说明

connectBleDevice(ListBleConnectBuilder

builderList);参数说明

参数类型说明builderListListBleConnectBuilder

BleConnectBuilder

方法名参数说明setDirectConnect()boolean

true使用缓存连接使用缓存普通情况下会增快连接速度false不使用缓存连接setDevId()String需要连接的设备

IDsetScanTimeout()Integer扫描超时时长单位为毫秒setLevel()BleConnectBuilder.Level

NORMAL如果连接资源已满则将忽略该连接FORCE如果连接资源已满将释放其它资源以连接到当前设备

默认值NORMAL

BleConnectBuilder();bleConnectBuilder1.setDevId(devId1);

devId

bleConnectBuilder2.setDevId(devId2);

devIdbuilderList.add(bleConnectBuilder1);

添加设备

builderList.add(bleConnectBuilder2);

添加设备

2TuyaHomeSdk.getBleManager().connectBleDevice(builderList);

开始连接断开连接设备

disconnectBleDevice(ListBleConnectBuilder

builderList);参数说明

参数类型说明builderListListBleConnectBuilder

BleConnectBuilder

ArrayList();builderList.add(new

BleConnectBuilder().setDevId(devId1));

devId

BleConnectBuilder().setDevId(devId2));

devIdTuyaHomeSdk.getBleManager().disconnectBleDevice(builderList);

断开连接设备管理操作

TuyaHomeSdk.newDeviceInstance(devId).removeDevice()

蓝牙设备除了进行云端移除之外若设备此时本地连接状态则会自动移除设备。

若此时设备离线则只会云端移除设备会仍处于绑定状态。

下次想要继续重新绑定设备用户需要将设备手动置为配网状态。

SDK

在扫描时若发现设备处于绑定状态但是云端已解绑也会进行自动重置。

回收设备资源

IDcallbackIRequestUpgradeInfoCallback检查回调

示例代码

TuyaHomeSdk.getMeshInstance().requestUpgradeInfo(mDevID,

new

onSuccess(ArrayListBLEUpgradeBean

bleUpgradeBeans)

0无新版本1有新版本2在升级中versionString最新版本currentVersionString当前版本timeoutInteger超时时间单位秒upgradeTypeInteger

0App

设备typeDescString来源描述lastUpgradeTimelong上次升级时间单位毫秒urlString新固件下载地址type

取值为

时有值fileSizelong新固件大小md5String新固件

MD5

9versionString新固件版本号binPackagePathString下载到本地的固件的路径listenerOnBleUpgradeListener升级进度回调

TuyaHomeSdk.getBleManager().startBleOta(uuid,

type,

错误码说明1设备接收的数据包格式错误2设备找不到路由器3Wi-Fi

密码错误4设备连不上路由器5设备

失败6设备连云失败100用户取消配网101蓝牙连接错误102发现蓝牙服务错误103打开蓝牙通讯通道失败104蓝牙查询设备信息失败105蓝牙配对失败106配网超时107Wi-Fi

信息发送失败108Token

失效109查询蓝牙加密密钥失败110设备不存在111设备云端注册失败112设备云端激活失败113云端设备已被绑定114主动断开115云端查询设备信息失败116设备此时正被其他方式配网117OTA

升级失败118OTA