Backup Wi-Fi Networks

To ensure network security, Wi-Fi passwords might be regularly changed. If backup Wi-Fi networks are unavailable, all smart devices connected to the Wi-Fi network must be paired again after the Wi-Fi password is changed. If you predefine multiple Wi-Fi passwords to create backup Wi-Fi networks, the system automatically switches to backup Wi-Fi networks and reconnects to the smart devices. They do not need to be paired again.

Manage network settings

Query current Wi-Fi information

Initialize an object

IThingDevicePlugin devicePlugin = PluginManager.service(IThingDevicePlugin.class);
IThingWifiBackup wifiBackupManager = devicePlugin.getWifiBackupManager(devId);

API description

void getCurrentWifiInfo(IThingDataCallback<CurrentWifiInfoBean> dataCallback);

Parameters

Example

wifiBackupManager.getCurrentWifiInfo(new IThingDataCallback<CurrentWifiInfoBean>() {
    @Override
    public void onSuccess(CurrentWifiInfoBean result) {

    }

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

    }
});

Query current backup Wi-Fi networks

API description

void getBackupWifiList(IThingDataCallback<BackupWifiListInfo> dataCallback);

Parameters

Example

wifiBackupManager.getBackupWifiList(new IThingDataCallback<BackupWifiListInfo>() {
            @Override
            public void onSuccess(BackupWifiListInfo result) {

            }

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

            }
        });

Set a list of backup Wi-Fi networks

API description

void setBackupWifiList(List<BackupWifiBean> backupWifiList, IThingDataCallback<BackupWifiResultBean> dataCallback);

Parameters

Example

ArrayList<BackupWifiBean> backupWifiList = new ArrayList<>();

// Adds a backup Wi-Fi network and sets its password.
BackupWifiBean backupWifiBean = new BackupWifiBean();
backupWifiBean.ssid = "test1";
backupWifiBean.passwd = "12345678";
backupWifiList.add(backupWifiBean);

// Sets a hash value for an existing backup Wi-Fi network.
String ssid="test2";
String pwd="123123";
DeviceBean dev = ThingOSDevice.getDeviceBean(devId);
String hashStr=SHA256Util.getBase64Hash(dev.getLocalKey() + ssid + pwd);
BackupWifiBean backupWifiBean2 = new BackupWifiBean();
backupWifiBean2.ssid = "test2";
backupWifiBean2.hash = hashStr;
backupWifiList.add(backupWifiBean2);

final IThingDataCallback<BackupWifiResultBean> setBackupCallback = new IThingDataCallback<BackupWifiResultBean>() {
    @Override
    public void onSuccess(BackupWifiResultBean result) {

    }

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

    }
};
wifiBackupManager.setBackupWifiList(backupWifiList, setBackupCallback);

Exit page and destroy listener

API description

wifiBackupManager.onDestory();

Switch between Wi-Fi networks

Switch to a new Wi-Fi network

Initialize an object

IThingDevicePlugin devicePlugin = PluginManager.service(IThingDevicePlugin.class);
IThingWifiSwitch wifiSwitchManager = devicePlugin.getWifiSwitchManager(devId);

API description

void switchToNewWifi(String ssid, String password, IThingDataCallback<SwitchWifiResultBean> callback);

Parameters

Example

wifiSwitchManager.switchToNewWifi(String ssid, String password, new IThingDataCallback<SwitchWifiResultBean>() {
            @Override
            public void onSuccess(SwitchWifiResultBean result) {

            }

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

            }
        });

Switch to a backup Wi-Fi network

API description

void switchToBackupWifi(String hash, IThingDataCallback<SwitchWifiResultBean> callback);

Parameters

Example

wifiSwitchManager.switchToBackupWifi(hash,new IThingDataCallback<SwitchWifiResultBean>() {
            @Override
            public void onSuccess(SwitchWifiResultBean result) {

            }

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

            }
        });

Exit page and destroy listener

API description

wifiSwitchManager.onDestory();