Android Wifi 扫描及自动连接
缘起拆解需求核心API权限核心代码完整Demo缘起
最近有个需求,要求App能够自动扫描到某个热点然后自动连接上热点。背景是我们公司属于IoT行业,这个热点是设备发出的,有固定的前缀(比如设备热点名为SmartLife-xx),可以直接连接无需密码。
本来觉得这个需求非常简单,然鹅GitHub上仅有的几个相关Demo并不能满足需求,只好自己撸起。
拆解需求
核心的动作有三个:
扫描WiFi列表匹配到相关的热点后连接返回连接结果
核心API
参考Android API 文档,扫描获取扫描结果也需要三步 注册 WifiManager.SCAN_RESULTS_AVAILABLE_ACTION广播监听调用 WifiManager.startScan()方法扫描调用 WifiManager.getScanResults()获取扫描结果其中:WifiManager.startScan()方法被标记为@deprecated ,文档提示"The ability for apps to trigger scan requests will be removed in a future release".结合Stack Overflow这篇回复,估计Android以后会阉割这个功能,好在文档中说API 29还能使用,Android 10 release 后允许继续使用。如果以后真阉割这个API了我们再找解决方案。 自动连接到热点也有2个API:Wifimanager.updateNetwork(config) 和Wifimanager.addNetwork(config)。这2个API作用不同,看下源码: Wifimanager.updateNetwork(config)
public int updateNetwork(WifiConfiguration config) {if (config == null || workId < 0) {return -1;}return addOrUpdateNetwork(config);}
Wifimanager.addNetwork(config)
public int addNetwork(WifiConfiguration config) {if (config == null) {return -1;}workId = -1;return addOrUpdateNetwork(config);}
显然,2个API的区别是workId是否等于 -1;如果连接过指定的WiFi,系统会有记录,workId > 0,否则workId = -1;源码注释对Wifimanager.addNetwork的说法是
Add a new network description to the set of configured networks.* The {@code networkId} field of the supplied configuration object* is ignored.* <p/>* The new network will be marked DISABLED by default. To enable it,* called {@link #enableNetwork}.
对某个WiFi调用这个API后,这个WiFi就会被标记为DISABLED,如果想要连接必须再调用enableNetwork方法。杯具的是自动连接到热点也有2个API在API 29会过期,文档推荐使用WifiNetworkSpecifier.Builder相关方法代替,后续会继续研究更新。
返回连接结果,成功或者失败,我注册了广播WORK_STATE_CHANGED_ACTION来监听。在连接target WiFi之前需要断开当前连接WiFi,连接成功之后会收到WiFi变化的广播,然后获取当前连接的WiFi和target WiFi进行对比,就可以知道是否连接成功。
权限
如果想要正常使用以上核心API,除了常规的
<uses-permission android:name="android.permission.INTERNET"/>
权限外,还需要以下权限
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /><uses-permission android:name="android.permission.CHANGE_WIFI_STATE" /><uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/><uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
文档里都有解释,这里就不一一列举了。
核心代码
WiFi扫描核心代码public void wifiScan(final AppCompatActivity mActivity) {index = 0;if (rxPermissions == null) {rxPermissions = new RxPermissions(mActivity);pool = Executors.newScheduledThreadPool(1);}rxPermissions.request(Manifest.permission.ACCESS_COARSE_LOCATION, Manifest.permission.ACCESS_FINE_LOCATION).subscribe(new Consumer<Boolean>() {@Overridepublic void accept(Boolean aBoolean) {if (aBoolean) {final WifiManager wifimanager = (WifiManager) mActivity.getApplicationContext().getSystemService(Context.WIFI_SERVICE);pool.scheduleAtFixedRate(new Runnable() {@Overridepublic void run() {if (index < TOTAL_TIMES) {wifimanager.startScan();Log.i("WIFI_LIST", "1 : wifimanager.startScan()" + " index = " + index);index++;}}}, 0, DELAYT_TIME, TimeUnit.MILLISECONDS);} else {Log.i("WIFI_LIST", "1 : no permission");}}});}
简单解释下,使用了线程池循环扫描。如果没有扫描到target WiFi 就每隔2s扫描一次,最多扫描20次。如果扫描到target WiFi就停止扫描,调用以下方法
public void stopScan() {if (pool != null) {pool.shutdown();}}
连接target WiFi 核心 代码
public static boolean addNetWork(WifiConfiguration config, Context context) {WifiManager wifimanager = (WifiManager) context.getSystemService(Context.WIFI_SERVICE);WifiInfo wifiinfo = wifimanager.getConnectionInfo();if (null != wifiinfo) {wifimanager.disableNetwork(wifiinfo.getNetworkId());}boolean result = false;if (workId > 0) {result = wifimanager.enableNetwork(workId, true);wifimanager.updateNetwork(config);} else {int i = wifimanager.addNetwork(config);result = false;if (i > 0) {wifimanager.saveConfiguration();return wifimanager.enableNetwork(i, true);}}return result;}
广播监听
@Overridepublic void onReceive(Context context, Intent intent) {if(WifiManager.SCAN_RESULTS_AVAILABLE_ACTION.equals(intent.getAction())){ //扫描到WiFi列表if(delegate != null){List<ScanResult> results = delegate.getWifiScanResult(context);Log.i("WIFI_LIST", "2 : WifiBroadcastReceiver#onReceive" + " currentIndex = " + delegate.getCurrentIndex() + " results.size = " + results.size());if(listener != null){if(delegate.getCurrentIndex() == TOTAL_TIME){listener.resultSuc(results,true);}else {listener.resultSuc(results,false);}}}}else if(WORK_STATE_CHANGED_ACTION.equals(intent.getAction())){ //连接的WiFi变化了WifiInfo connectedWifiInfo = ((WifiManager) context.getSystemService(Context.WIFI_SERVICE)).getConnectionInfo();if(listener != null){listener.connectedWifiCallback(connectedWifiInfo);}}}
完整Demo
Github地址
欢迎star ,欢迎fork。有问题留言一起探讨。
如果觉得《Android Wifi 扫描及自动连接》对你有帮助,请点赞、收藏,并留下你的观点哦!