热点配网

更新时间:2024-06-11 03:49:27下载pdf

热点配网又称 热点模式 或 AP(Access Point)配网,是一种通过 Wi-Fi 进行配网的连接能力。将手机连接到配网设备 Wi-Fi 热点后,设备与手机直接通过 Wi-Fi 进行通信配对。成功率高、可靠性好,可适配 2.4G/5G 混频路由器配网,但用户需要手动切换手机的 Wi-Fi 设置。

IActivator 初始化

参数说明

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

代码示例

APActivator apActivator = (APActivator) ActivatorService.activator(ActivatorMode.AP);

获取配网 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 支持此功能

代码示例

apActivator.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: ");

            }
        });

开始配网

代码示例

apActivator.start();

停止配网

代码示例

apActivator.stop();