Android Wifi 扫描及自动连接

  • 缘起
  • 拆解需求
  • 核心API
  • 权限
  • 核心代码
  • 完整Demo


缘起

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

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

拆解需求

核心的动作有三个:

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

核心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);
    }
  1. 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();
        }
    }
  1. 连接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;

    }
  1. 广播监听
@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。有问题留言一起探讨。