前言:
作为一名系统开发者, 对应用上 WiFi 的研发是一个 "门外汉" 的角色, 通过阅读 Android 源码, 逐渐对这一部分有了些许认识. 下方主要围绕 WifiManager 的函数系, 做了一些类似工具类的封装, 语言尽量简单, 希望对各位系统开发者能起到帮助的作用, 具体内容以 解释 + 注释 + 代码块的形式展示给大伙.
简介: WifiManager这个类, 是 Android 暴露给开发者使用的一个系统服务管理类, 其中包含对WiFi的响应的操作函数; 其隐藏掉的系统服务类为IWifiService, 为Android私有的, 其具体实现, 未暴露给用户; 只需要使用WifiManager进行函数操作完成UI, 监听对应的广播消息, 就可完成功能了. 换言之, WifiManager会调用service简介地和framework层, 驱动层进行函数调用, 然后驱动层会回调至上层, 以广播的形式实现通知; 这是目前WiFi的简单介绍;
一些简单的工具类的封装 以及 简要说明:
- 获取 WifiManager 实例:
// 获取 WifiManager 实例.
public static WifiManager getWifiManager(Context context) {
return context == null ? null : (WifiManager) context.getApplicationContext().getSystemService(Context.WIFI_SERVICE);
}
注意: 这是官方推荐的获取 WifiManager 类的方式; 其实在看源码的时候, 会有一个公共的构造函数, 但是是需要IWifiService的, 这个类是google私有的, 属于系统安全级别的API类, 所以, 调用上面的方法, 谷歌会帮你实例化IWifiService, 并且后续的连接, 忘记, 保存的真实实现都是由service来完成的;
- 开启, 关闭 WiFi: (操作这个函数的时候, 就会触发系统回调WiFi状态发生改变的广播)
// 开启/关闭 WIFI.
public static boolean setWifiEnabled(WifiManager manager, boolean enabled) {
return manager != null && manager.setWifiEnabled(enabled);
}
- 获取 WiFi 硬件的状态:
// 获取 WIFI 的状态.
public static int getWifiState(WifiManager manager) {
return manager == null ? WifiManager.WIFI_STATE_UNKNOWN : manager.getWifiState();
}
/**
* 注意:
* WiFi 的状态目前有五种, 分别是:
* WifiManager.WIFI_STATE_ENABLING: WiFi正要开启的状态, 是 Enabled 和 Disabled 的临界状态;
* WifiManager.WIFI_STATE_ENABLED: WiFi已经完全开启的状态;
* WifiManager.WIFI_STATE_DISABLING: WiFi正要关闭的状态, 是 Disabled 和 Enabled 的临界状态;
* WifiManager.WIFI_STATE_DISABLED: WiFi已经完全关闭的状态;
* WifiManager.WIFI_STATE_UNKNOWN: WiFi未知的状态, WiFi开启, 关闭过程中出现异常, 或是厂家未配备WiFi外挂模块会出现的情况;
*/
- 开始扫描 WiFi 热点, 在确认开启 WiFi 之后, 我们就可以调用 startScan() 函数开始扫描附近的热点了, 即:
// 开始扫描 WIFI.
public static void startScanWifi(WifiManager manager) {
if (manager != null) {
manager.startScan();
}
}
- 获取扫描到的 WiFi 热点的结果:
// 获取扫描 WIFI 的热点:
public static List<ScanResult> getScanResult(WifiManager manager) {
return manager == null ? null : manager.getScanResult();
}
- 获取配置好的 WiFi 信息:
// 获取已经保存过的/配置好的 WIFI 热点.
public static List<WifiConfiguration> getConfiguredNetworks(WifiManager manager) {
return manager == null ? null : manager.WifiConfiguration();
}
/**
* 注意:
* Android 的 WiFi 连接, 大概可以分为如下两种情况:
* a. 无密码的, 可直接连接, 连接过程中, 此热点一直有, 不管最后是否需要其他方式进行验证操作, 但凡连接成功, 即
* 刻进行了对此热点的配置进行保存;
* b. 有密码的, 暂且不论何种加密手段, 只要用户输入密码, 点击连接, 如果连接途中, 此热点一直有, 不论连接成功还
* 是失败, 都即刻对此热点的配置进行了保存操作; 使用上述的方式获取到的WiFi的配置, 就是上面进行操作保存的WiFi配
* 置;
* c. 连接多个WiFi成功之后, 然后关闭WiFi, 下次开启WiFi的时候, 驱动会主动帮你连接这其中配置好的其中一个WiFi;
* /
- 获取对应到 ScanResult 的 WifiConfiguration, 通常, 此配置对应一个 BSSID, 可能是 null;
List<WifiConfiguration> configs = wifiManager.getMatchingWifiConfig(scanResult);
// 可以打印一下看具体的情况:
if (configs == null || configs.isEmpty()) return;
for (WifiConfiguration config : configs) {
Log.v(TAG, "config = " + config);
}
- 连接WiFi: 连接 WIFI, 安卓提供了两种方式, 一种是通过配置连接, 另一种是通过 networkId 来连接, 两种方式各有使用场景, 可根据需要选择使用, 封装后的函数如下: (反射可抽取方法, 单独提炼, 此处不展示.)
// 使用 WifiConfiguration 连接.
public static void connectByConfig(WifiManager manager, WifiConfiguration config) {
if (manager == null) {
return;
}
try {
Method connect = manager.getClass().getDeclaredMethod("connect", WifiConfiguration.class, Class.forName("android.net.wifi.WifiManager$ActionListener"));
if (connect != null) {
connect.setAccessible(true);
connect.invoke(manager, config, null);
}
} catch (Exception e) {
e.printStackTrace();
}
}
// 使用 networkId 连接.
public static void connectByNetworkId(WifiManager manager, int networkId) {
if (manager == null) {
return;
}
try {
Method connect = manager.getClass().getDeclaredMethod("connect", int.class, Class.forName("android.net.wifi.WifiManager$ActionListener"));
if (connect != null) {
connect.setAccessible(true);
connect.invoke(manager, networkId, null);
}
} catch (Exception e) {
e.printStackTrace();
}
}
- 保存网络:
// 保存网络.
public static void saveNetworkByConfig(WifiManager manager, WifiConfiguration config) {
if (manager == null) {
return;
}
try {
Method save = manager.getClass().getDeclaredMethod("save", WifiConfiguration.class, Class.forName("android.net.wifi.WifiManager$ActionListener"));
if (save != null) {
save.setAccessible(true);
save.invoke(manager, config, null);
}
} catch (Exception e) {
e.printStackTrace();
}
}
- 添加网络:
// 添加网络.
public static int addNetwork(WifiManager manager, WifiConfiguration config) {
if (manager != null) {
manager.addNetwork(config);
}
}
- 忘记网络:
// 忘记网络.
public static void forgetNetwork(WifiManager manager, int networkId) {
if (manager == null) {
return;
}
try {
Method forget = manager.getClass().getDeclaredMethod("forget", int.class, Class.forName("android.net.wifi.WifiManager$ActionListener"));
if (forget != null) {
forget.setAccessible(true);
forget.invoke(manager, networkId, null);
}
} catch (Exception e) {
e.printStackTrace();
}
}
- 禁用网络:
// 禁用网络.
public static void disableNetwork(WifiManager manager, int netId) {
if (manager == null) {
return;
}
try {
Method disable = manager.getClass().getDeclaredMethod("disable", int.class, Class.forName("android.net.wifi.WifiManager$ActionListener"));
if (disable != null) {
disable.setAccessible(true);
disable.invoke(manager, networkId, null);
}
} catch (Exception e) {
e.printStackTrace();
}
}
- 断开连接:
// 断开连接.
public static boolean disconnectNetwork(WifiManager manager) {
return manager != null && manager.disconnect();
}
- 短暂禁用网络:
// 禁用短暂网络.
public static void disableEphemeralNetwork(WifiManager manager, String SSID) {
if (manager == null || TextUtils.isEmpty(SSID))
return;
try {
Method disableEphemeralNetwork = manager.getClass().getDeclaredMethod("disableEphemeralNetwork", String.class);
if (disableEphemeralNetwork != null) {
disableEphemeralNetwork.setAccessible(true);
disableEphemeralNetwork.invoke(manager, SSID);
}
} catch (Exception e) {
e.printStackTrace();
}
}
小结:
如上, 针对会使用到的函数做个简单的封装, 使大家用起来更加简单明了, 希望能带给你一些方便.
如有疑问, 请简信, 或邮箱告知. 亦可下方评论区留言.
qq 邮箱: 1281641968@qq.com
