removeNetwork
清除指定的wifi网络(清除密码),要清除的wifi必须是已配置过的(getConfiguredNetworks方法可获取的)。当Android系统版本小于6.0时,该方法可以无条件(无条件是指相对于系统版本大于等于6.0的系统)清除指定的wifi网络(同样是已配置过的wifi);当Android系统版本大于等于6.0时,根据Google在Android6.0上的变动(官方文档说明https://developer.android.com/about/versions/marshmallow/android-6.0-changes.html#behavior-network,如下文), Android6.0及以上版本不能清除由非本应用创建的wifi连接,即本应用可以调用该方法清除由connect方法创建的wifi连接,由其他应用或用户在系统wifi设置界面手动连接的wifi,调用该方法都不能清除成功。
Android6.0的变动: Your apps can now change the state of WifiConfiguration objects only if you created these objects. You are not permitted to modify or delete WifiConfiguration objects created by the user or by other apps.
removeNetwork({params},callback(ret))
param
ssid:
- 类型:字符串
- 描述:(必选)wifi的ssid(wifi名字)
callback(ret)
ret:
- 类型:JSON对象
- 描述:返回清除是否成功
- 内部字段:
{
"result": 1, //int类型,是否清除成功 ,取值范围如下:
0 清除失败
1 清除成功
"msg": "" //字符串,清除成功时返回"",清除失败时返回错误提示
}
示例代码
var wifi = api.require('wifiMgr');
param = {ssid:"wifi_love"};
wifi.removeNetwork(param,function(ret, err){
alert(JSON.stringify(ret));
});
补充说明
此接口仅支持Android平台
可用性
Android系统
可提供的1.0.0及更高版本