快连模式

更新时间：2024-06-24 06:11:16下载pdf

Wi-Fi 快连配网又被称为 快连模式（Easy-Connect）、SmartConfig 或 EZ 配网。用户将手机连接到路由器后，利用路由器广播报文与设备进行通信配对。用户操作简单，但对手机和路由器有兼容性要求，成功率低于热点配网。

IActivator 初始化

参数说明

参数名	类型	是否必填	说明
`mode`	`ActivatorMode`	是	配网模式

代码示例

EZActivator ezActivator = (EZActivator) ActivatorService.activator(ActivatorMode.EZ);

获取配网 Token

参数说明

参数名	类型	是否必填	说明
assetId	String	是	指定的资产或空间 ID
callback	IndustryDataCallBack	是	回调函数

代码示例

// 获取资产激活令牌
ActivatorService.activatorToken("assetId", new IndustryDataCallBack<String>() {
            @Override
            public void onSuccess(String s) {
                Log.d(TAG, "onSuccess: " + s);
            }

            @Override
            public void onFailure(@NonNull String s, @NonNull String s1) {
                Log.d(TAG, "onFailure: " + s);
            }
        });

初始化配网参数

参数说明

参数名	类型	说明
ssid	String	Wi-Fi 网络的 SSID
password	String	Wi-Fi 网络的密码
token	String	令牌

代码示例

WiFiActivatorParams params = new WiFiActivatorParams.Builder()
                .setWifi("your_ssid", "your_password")
                .setToken("your_token")
                .build();

注册 IActivatorListener 监听配网结果

IDevice 对象说明

接口	说明
getDeviceId(): String	设备 ID
getUUID(): String	设备 UUID
getName(): String	设备名称
getIcon(): String	设备图标
getProductId(): String	产品 ID
getCategory(): String	设备品类缩写，用于标注该产品所属的品类。例如，`kg` 表示开关，`cz` 表示插座。详情请参考标准指令集。
getCapability(): Int	联网通信能力标位： `0`：Wi-Fi `1`：有线 `2`：GPRS `3`：NB-IoT `10`：蓝牙 `11`：蓝牙 Mesh `12`：Zigbee `13`：红外 `14`：Zigbee 配网
getProtocolAttribute(): Long	协议支持接入标位
getTimezoneId(): String	设备所在的时区
isCloudOnline(): Boolean	设备的云端在线状态
isLocalOnline(): Boolean	设备的局域网在线状态
isOnline(): Boolean	设备是否在线，指局域网或者云端在线
getLatitude(): String	设备纬度
getLongitude(): String	设备经度
getDps(): Map<String, Any>	获取设备数据点（DP）
publishDps(dps: DpCommand, callback: IndustryCallBack)	设备 DP 功能控制
getSchemas(): Map<String, DpSchema>	获取设备 DP 模式
addDeviceListener(listener: IDeviceListener)	设置设备监听
removeDeviceListener(listener: IDeviceListener)	移除设备监听
getWifiSignalStrength(callback: IndustryValueCallBack)	查询 Wi-Fi 信号强度
getDevAttribute(): Long	设备标志位： bit0：设备是否支持免配网 bit1：设备是否支持 DP query 31 号协议查询 bit2：设备是否支持本地联动能力 bit3：设备是否支持 Wi-Fi 扫描 bit4：设备是否支持 Google local home bit5：设备是否支持闪电配网能力 bit6：设备是否支持蓝牙控制 bit7：设备是否支持安防能力 bit8：设备是否是共享设备 bit9：设备是否支持日出日落定时 bit10：设备是否支持故障替换能力 bit11：设备是否支持 OTA bit12：设备是否支持 Wi-Fi 备用网络切换 bit14：设备是否支持涂鸦标准协议 bit15：设备是否支持自定义透传 bit16：设备是否支持行业 bit17：设备是否支持 OCPP 协议 bit18：设备是否支持云快充协议 bit19：设备是否支持物模型
newOtaManager(): IDeviceOtaManager	获取设备 OTA 管理实例
newBackupManager(): IDeviceWifiBackupManager	设备备用网络。是否支持此功能，需要参考 `getDevAttribute()` 返回的值，bit12 支持此功能

代码示例

ezActivator.setListener(new IActivatorListener() {
            @Override
            public void onSuccess(@Nullable IDevice iDevice) {
                Log.d(TAG, "onSuccess: ");

            }

            @Override
            public void onError(@NonNull String s, @NonNull String s1) {
                Log.d(TAG, "onError: ");

            }
        });

开始配网

代码示例

ezActivator.start();

停止配网

代码示例

ezActivator.stop();

上一篇设备配网

下一篇热点配网