快连 Plus 配网

更新时间:2025-04-02 10:02:15下载pdf

快连 Plus(Smart Config Plus)配网在安全性和可靠性方面进行了多重优化:

  • 数据加密传输:通过引入端到端的数据加密技术,确保在设备配网过程中,用户的 Wi-Fi 信息和设备通讯数据不会被第三方截获或篡改,大幅提升配网数据的安全性。
  • 抗干扰能力增强:在复杂网络环境下,通过优化通信协议和数据包传输机制,有效降低因干扰导致的配网失败概率,保证配网的稳定性。
  • 多重失败恢复机制:在配网失败时,系统能够快速定位问题,执行自动重试等操作,减少用户的手动干预,进一步提高用户体验。
  • 动态兼容性适配:通过动态调整与路由器的通信参数,提升设备对不同型号、不同设置路由器的兼容性,降低因路由器防火墙或频段问题导致的配网障碍。

快连 Plus 配网,是双模配网的优化版本,旨在提升设备批量配网速度。

  • 支持批量添加设备。
  • 在配网失败时,系统能够快速定位问题,自动重试。
  • 提升设备对不同型号、不同设置路由器的兼容性。
  • 方法调用保持跟普通双模一致,快速接入。

接口说明

开启搜索/停止搜索

代码示例

val scanKey = 
ThingActivatorCoreKit.getScanDeviceManager().startBlueToothDeviceSearch(
  60 * 1000,
  arrayListOf(ScanType.SINGLE),
  object : ThingActivatorScanCallback {
    
    override fun deviceFound(scanBean: ThingActivatorScanDeviceBean) {
      // 扫描的结果
    }

    override fun deviceRepeat(scanBean: ThingActivatorScanDeviceBean) {
    }

    override fun deviceUpdate(scanBean: ThingActivatorScanDeviceBean) {
    }

    override fun scanFailure(failureBean: ThingActivatorScanFailureBean) {
    }

    override fun scanFinish() {
    }

})

//停止搜索
ThingActivatorCoreKit.getScanDeviceManager().stopScan(scanKey)
    )

参数说明

参数 说明
scanTypeList SINGLE - 使用 BLE 类型设备扫描
millisTimeOut 搜索时长(单位:ms,建议 30,000 ms)
thingActivatorScanCallback 扫描结果回调
scanBean 搜索到的对应设备

开始配网/停止配网

代码示例

val thingDeviceActiveModeEnum = deviceBean.supprotActivatorTypeList[0]
if (thingDeviceActiveModeEnum == ThingDeviceActiveModeEnum.MULT_MODE 
    || thingDeviceActiveModeEnum == ThingDeviceActiveModeEnum.BLE_WIFI
   	|| thingDeviceActiveModeEnum == ThingDeviceActiveModeEnum.BLE_WIFI_BATCH
) {
    val activeManager = ThingActivatorCoreKit.getActiveManager().newThingActiveManager()
    activeManager!!.startActive(ThingDeviceActiveBuilder().apply {
        activeModel = thingDeviceActiveModeEnum
        ssid = "ssid"
        password = "password"
        timeOut = 60
        relationId = homeId
        listener = object : IThingDeviceActiveListener {
            override fun onActiveError(errorBean: ThingDeviceActiveErrorBean) {
            	// 配网失败
            }

            override fun onActiveLimited(limitBean: ThingDeviceActiveLimitBean) {
            }

            override fun onActiveSuccess(deviceBean: DeviceBean) {
            	// 配网成功
            }

            override fun onBind(devId: String) {
            }

            override fun onFind(devId: String) {
            }

        }
    })
}

参数说明

参数 说明
thingActivatorScanDeviceBean 搜索到的对应设备
relationId 家庭 ID
ssid Wi-Fi 名称
password Wi-Fi 密码
timeout 配网超时时长(单位:s)
activeModel 配网能力枚举
listener 配网结果回调

错误码

错误码 原因
“10002” 参数不合法
“10003” Token 创建失败
“DEVICE_ALREADY_BIND” 强绑定类型错误(需要当前宜配网该设备账号先解绑)