有线设备配网

有线设备是指通过有线网络连接路由器，配网过程不用输入路由器的热点名称和密码。本文以 Zigbee 有线网关介绍有线配网业务流程。

发现设备

SDK 提供发现待配网有线设备的功能。查询设备前，手机需与设备接入同一网络，然后注册查询有线设备的通知。待 SDK 收到有线设备的广播，即会通过通知转发设备信息。

接口说明

IThingGwSearcher mThingGwSearcher = ThingHomeSdk.getActivatorInstance().newThingGwActivator().newSearcher();
		mThingGwSearcher.registerGwSearchListener(new IGwSearchListener() {
			@Override
			public void onDevFind(HgwBean hgwBean) {

			}
		});

参数说明

初始化配网参数

使用 SDK 的发现设备功能

接口说明

IThingActivator mIThingActivator = ThingHomeSdk.getActivatorInstance().newGwActivator(
		new ThingGwActivatorBuilder()
			.setToken(token)
			.setTimeOut(timeout)
			.setContext(context)
			.setHgwBean(hgwBean)
			.setListener(new IThingSmartActivatorListener() {

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

					}

					@Override
					public void onActiveSuccess(DeviceBean devResp) {

					}

					@Override
					public void onStep(String step, Object data) {

					}
			}
		));

参数说明

不使用 SDK 的发现设备功能

接口说明

IThingActivator mIThingActivator = ThingHomeSdk.getActivatorInstance().newGwActivator(
		new ThingGwActivatorBuilder()
			.setToken(token)
			.setTimeOut(timeout)
			.setContext(context)
			.setListener(new IThingSmartActivatorListener() {

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

					}

					@Override
					public void onActiveSuccess(DeviceBean devResp) {

					}

					@Override
					public void onStep(String step, Object data) {

					}
			}
		));

参数说明

获取配网 Token

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

ThingHomeSdk.getActivatorInstance().getActivatorToken(homeId,
		new IThingActivatorGetToken() {

			@Override
			public void onSuccess(String token) {

			}

			@Override
			public void onFailure(String s, String s1) {

			}
		});

参数说明

配网方法调用

IThingActivator mIThingActivator = ThingHomeSdk.getActivatorInstance().newGwActivator(builder);
//开始配网
mIThingActivator.start()
//停止配网
mIThingActivator.stop()
//退出页面清理
mIThingActivator.onDestroy()