Android Wifi 扫描及自动连接

缘起

最近有个需求，要求App能够自动扫描到某个热点然后自动连接上热点。背景是我们公司属于IoT行业，这个热点是设备发出的，有固定的前缀（比如设备热点名为SmartLife-xx），可以直接连接无需密码。

本来觉得这个需求非常简单，然鹅GitHub上仅有的几个相关Demo并不能满足需求，只好自己撸起。

拆解需求

核心的动作有三个：

1. 扫描WiFi列表
2. 匹配到相关的热点后连接
3. 返回连接结果

核心API

• 参考Android API 文档,扫描获取扫描结果也需要三步

1. 注册 WifiManager.SCAN_RESULTS_AVAILABLE_ACTION广播监听
2. 调用 WifiManager.startScan()方法扫描
3. 调用 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作用不同，看下源码：

1. Wifimanager.updateNetwork(config)

 public int updateNetwork(WifiConfiguration config) {
        if (config == null || config.networkId < 0) {
            return -1;
        }
        return addOrUpdateNetwork(config);
    }

2. Wifimanager.addNetwork(config)

public int addNetwork(WifiConfiguration config) {
        if (config == null) {
            return -1;
        }
        config.networkId = -1;
        return addOrUpdateNetwork(config);
    }

显然，2个API的区别是config.networkId是否等于 -1；如果连接过指定的WiFi，系统会有记录，config.networkId > 0,否则config.networkId = -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相关方法代替，后续会继续研究更新。

• 返回连接结果，成功或者失败，我注册了广播WifiManager.NETWORK_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" />

文档里都有解释，这里就不一一列举了。

核心代码

1. 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>() {
                    @Override
                    public void accept(Boolean aBoolean) {
                        if (aBoolean) {
                            final WifiManager wifimanager = (WifiManager) mActivity.getApplicationContext().getSystemService(Context.WIFI_SERVICE);
                            pool.scheduleAtFixedRate(new Runnable() {
                                @Override
                                public 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();
        }
    }

2. 连接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 (config.networkId > 0) {
            result = wifimanager.enableNetwork(config.networkId, true);
            wifimanager.updateNetwork(config);
        } else {

            int i = wifimanager.addNetwork(config);
            result = false;

            if (i > 0) {

                wifimanager.saveConfiguration();
                return wifimanager.enableNetwork(i, true);
            }
        }

        return result;

    }

3. 广播监听

@Override
    public 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(WifiManager.NETWORK_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。有问题留言一起探讨。