【 Android11 WiFi开发 一 】WiFi列表获取与展示

前言

最近在Android11上开发了WiFi相关功能，涉及到WiFi列表的获取、连接有密码的WiFi、连接已保存的WiFi、忘记连接的WiFi、添加其他WiFi。涉及到的知识点较多作以分篇记录，本篇将介绍WiFi列表的获取与展示。

说明

下面梳理下WiFi列表获取流程：

• 判断WiFi开关是否打开（假设打开-Y）
• 打开情况显示WiFi列表布局
• 判断当前是否有扫描任务（假设没有-N）
• 开启扫描动画、延时20S后开始扫描可用WiFi（时间根据需求定义）、获取当前连接的WiFi
• 接收到扫描结果广播
• 停止扫描动画、对获取WiFi列表进行过滤
• 通知WiFi列表刷新
• 不延时扫描可用WiFi、获取当前连接的WiFi

实现

上述介绍了WiFi扫描获取流程，下面将介绍相关的API和功能实现。

Android中提供了WifiManager类用来管理WiFi。

1、WifiManager对象的获取：

	private val wifiManager:WifiManager = context.getSystemService(Context.WIFI_SERVICE) as WifiManager

2、判断WiFi是否使能

   /**
    * WiFi开关是否使能
    */
    fun isWiFiEnabled(): Boolean {
       return wifiManager.isWifiEnabled
    }

   /**
    * 设置WiFi开关是否使能
    */
    fun setWiFiEnable(enable: Boolean) {
       wifiManager.isWifiEnabled = enable
    }

3、扫描WiFi

调用WifiManager的startScan()方法，即可开启对WiFi扫描。此方法已标记为遗弃，但是目前版本可以使用。

 	/**
	 * 开启扫描WiFi事件
	 */
	fun startScan(): Boolean {
	     return wifiManager.startScan()
	}

4、扫描WiFi结果广播

Android WiFi扫描结果提供了对外广播，监听此广播、接收到以后进行业务操作。

 
 	WifiManager：
 
	public static final String SCAN_RESULTS_AVAILABLE_ACTION = "android.net.wifi.SCAN_RESULTS";
  

5、获取扫描结果

注册上述广播，有回调后表示扫描结束，通过wifiManager.getScanResults获取扫描到的WiFi列表。

  
  	val wifiList = wifiManager.scanResults as ArrayList<ScanResult>
   

通过上述方法获取的WiFi列表需要进行过滤才能进行展示，过滤条件有以下几点：

• 过滤同一WiFi：扫描结果中同一个WiFi可能会返回多次，集合中存在多个。
• 过滤名字为空的WiFi：判断当前WiFi名是否为空，为空不添加新的集合中。
• 过滤当前连接的WiFi：列表中不显示当前连接的WiFi。
• 过滤设备自发的热点：列表中不显示设备自发热点。
• 按信号强弱排列：根据WiFi信号强度从高到低排列。

继续了解WifiManager中提供的相关方法。

6、获取当前连接的WiFi信息

通过wifiManager.getConnectionInfo() 可以获取当前连接的WiFi信息。

    /**
     * 获取当前连接的WiFi名称
     */
    fun getSSID(): String? {
        val wifiInfo = wifiManager.connectionInfo
        if (wifiInfo != null) {
            val s = wifiInfo.ssid
            if (s.length > 2 && s.toCharArray()[0] == '"' && s.toCharArray()[s.length - 1] == '"') {
                return s.substring(1, s.length - 1)
            }
        }
        return null
    }

7、WiFi信号强度排序

上面提到了WiFi扫描结果的获取，信号强度level通过扫描结果对象ScanResult中获取。

	
	/**
     * 通道频率
     */
    public static final int CHANNEL_WIDTH_160MHZ = 3;
    public static final int CHANNEL_WIDTH_20MHZ = 0;
    public static final int CHANNEL_WIDTH_40MHZ = 1;
    public static final int CHANNEL_WIDTH_80MHZ = 2;
    public static final int CHANNEL_WIDTH_80MHZ_PLUS_MHZ = 4;
 
 	/**
     * WiFi频段
     */
    public static final int UNSPECIFIED = -1;
    public static final int WIFI_BAND_24_GHZ = 1;
    public static final int WIFI_BAND_5_GHZ = 2;
    public static final int WIFI_BAND_60_GHZ = 16;
    public static final int WIFI_BAND_6_GHZ = 8;
   
   	//访问点的Mac地址	
 	public String BSSID;
 	//WiFi名称
    public String SSID;
    //描述了身份验证、密钥管理和访问点支持的加密方案
    public String capabilities;
  
    //带宽
    public int channelWidth;
    //主20 MHz的频率(MHz)的渠道客户交流访问点
    public int frequency;
    //信号强度，也称RSSI
    public int level;
    

8、WiFi状态获取

提供了广播WIFI_STATE_CHANGED_ACTION来监听WiFi状态的改变，通过通wifiManager.getWifiState() 来获取当前WiFi状态。

	WifiManager：
		
    public static final String WIFI_STATE_CHANGED_ACTION = "android.net.wifi.WIFI_STATE_CHANGED";
    
	public static final String EXTRA_WIFI_STATE = "wifi_state";

  	/**
     * 获取WiFi状态
     */
    fun getState(): Int {
        return wifiManager.wifiState
    }

  

对WiFi开关、列表UI、WiFi相关信息的显示与隐藏的操作，可以在WiFi状态切换中来修改。

在WiFi列表获取和WiFi状态

    /**
     * 网络相关广播
     */
    class WiFiBroadcastReceiver : BroadcastReceiver() {
        override fun onReceive(context: Context, intent: Intent) {
            if(App.DEBUG) Log.i(TAG,"[onReceive] action = ${intent.action}")
            when (intent.action) {
                WifiManager.WIFI_STATE_CHANGED_ACTION -> {
                    if(App.DEBUG) Log.i(TAG,"WIFI_STATE_CHANGED_ACTION")
                    val wifiState = intent.getIntExtra(WifiManager.EXTRA_WIFI_STATE, WifiManager.WIFI_STATE_DISABLED)
                 	stateChange(wifiState)
                }
                WifiManager.SCAN_RESULTS_AVAILABLE_ACTION -> {
                    if(App.DEBUG) Log.i(TAG,"SCAN_RESULTS_AVAILABLE_ACTION")
                    //停止扫描任务
                    cancelScanTask()
                    //停止扫描动画
                    stopAnimation()
                    //获取wifi列表并过滤返回
                    val wifiList = WiFiUtils.scanWiFiListResult()
                    //通知列表刷新
                    notifyWiFiList(wifiList)
                }
            }
        }
    }
		
	fun stateChange(state:Int){
		when(state){
		//WiFi正在关闭中...
		WifiManager.WIFI_STATE_DISABLING ->{
		}
			
		//WiFi已经关闭
  		WifiManager.WIFI_STATE_DISABLED ->{
  		}
  		
		//WiFi正在打开中...
 		WifiManager.WIFI_STATE_ENABLING ->{
 		}
 		
		//WiFi已经打开
  		WifiManager.WIFI_STATE_ENABLED ->{
  		} 
	}
    

结尾

上述介绍了Android11中WiFi列表的获取流程与对应的API方法，下篇文章介绍对WiFi的相关操作，连接与断开连接、获取WiFi信息等。