闪电搜索和配网

更新时间:2024-11-18 06:40:50下载pdf

赋予闪电配网能力的路由器或 Wi-Fi 类设备,可以添加其他 Wi-Fi 类设备。

闪电搜索

流程示意

闪电搜索和配网

查询家庭中支持闪电配网的设备

接口说明

/**
     * Get activated devices with lightning activation support.
     *
     * @param homeId Home id.
     * @return Device id list.
     */
TuyaHomeSdk.getActivatorInstance().getSupportLightningActiveDevices(homeId)

参数说明

参数 说明
homeId 家庭ID

闪电搜索

参数说明

参数 类型 说明
devIds List 家庭中支持闪电配网的设备devId集合
serverTimeout long 已配网设备搜索时长,单位秒
clientTimeout long 待配网设备锁定时长,单位秒
ITuyaLightningSearchListener Callback 闪电搜索回调

示例代码

TuyaHomeSdk.getActivatorInstance().newLightningActivator().startSearch(devList, serverTimeout, clientTimeout, new ITuyaLightningSearchListener() {
			@Override
			public void onSearchResponse(LightningSearchBean bean) {
				//搜索返回实体
			}
		});

停止搜索

ITuyaLightningActivator.stopSearch();

重置已被搜索到的设备状态

参数 类型 说明
devList List 搜索到的闪电设备实体
ITuyaLightningActivator.cancel(devList);

闪电配网

流程示意

闪电搜索和配网

获取 Token

开始配网之前,SDK 需要在联网状态下从云端获取配网 Token,Token 的有效期为 10 分钟。且配置成功后就会失效,再次配网需要重新获取。

参数说明

参数 类型 说明
homeId String 家庭 ID,详情参考 家庭管理 章节

代码示例

TuyaHomeSdk.getActivatorInstance().getActivatorToken(homeId, new ITuyaActivatorGetToken() {
	@Override
	public void onSuccess(String token) {

	}

	@Override
	public void onFailure(String errorCode, String errorMsg) {

	}
});

开始配网

参数说明

参数 类型 说明
lightningSearchBeanList List 已被搜索到的闪电设备
token String 配网所需要的激活 Token
timeout Int 配网超时时长,单位 ms,推荐 120s
ITuyaDevActivatorListener Callback 配网结果回调

代码示例

TuyaHomeSdk.getActivatorInstance()
		.newLightningActivator()
		.startActive(new TuyaLightningDevActivatorBuilder()
				.setLightningSearchBeanList(lightningSearchBeans)
				.setTimeOut(60 * 1000)
				.setToken(token)
				.setListener(new ITuyaDevActivatorListener() {
					@Override
					public void onError(String errorCode, String errorMsg) {

					}

					@Override
					public void onActiveSuccess(DeviceBean devResp) {

					}
				}));

停止配网

ITuyaLightningActivator.stopActive();