在 WIFI 网络开发过程中，容易对网络变化的系统广播和不同广播对应的网络状态区分不清楚，所以对常用的系统网络广播Intent Action和网络状态含义做了整理，希望能够加强记忆并且帮助到大家理解何时应该监听哪种系统广播。
一、 WifiManager.WIFI_STATE_CHANGED_ACTION
解释： WIFI 开关（是否可用）状态广播
状态相关类： WifiManager
状态如下：
- WIFI_STATE_DISABLED： WIFI功能已经被关闭
- WIFI_STATE_DISABLING： WIFI功能关闭中，处于此状态WIFI不可以用
- WIFI_STATE_ENABLED： WIFI功能已经被打开
- WIFI_STATE_ENABLING： WIFI功能正在打开中，处于此状态WIFI可用
- WIFI_STATE_UNKNOWN： WIFI功能状态不可知
状态获取代码：
Intent.getIntExtra(WifiManager.EXTRA_WIFI_STATE,0)：WIFI当前开关状态；
Intent.getIntExtra(WifiManager.EXTRA_PREVIOUS_WIFI_STATE,0)：WIFI开关前一个状态；
二、 WifiManager.NETWORK_STATE_CHANGED_ACTION
解释： 网络状态变化广播
状态相关类： NetworkInfo
1）通用状态（State）：
- CONNECTING： 正在连接网络；
- CONNECTED： 网络连接成功；
- SUSPENDED： 网络暂停；
- DISCONNECTING： 正在断开连接；
- DISCONNECTED： 连接已断开；
- UNKNOWN: 未知状态；
2）详细状态（DetailedState）：
- IDLE： 准备开始数据连接设置；
- SCANNING：正在搜索可用网络；
- CONNECTING： 正在建立数据连接；
- AUTHENTICATING： 网络连接建立，执行身份认证；
- OBTAINING_IPADDR： 等待DHCP服务器的相应以分配IP地址信息；
- CONNECTED： 此时IP流量应该是可用的；
- SUSPENDED： IP流量暂停
- DISCONNECTING： 当前正在断开数据连接；
- DISCONNECTED： 网络连接已断开，IP流量不可用；
- FAILED：尝试连接失败；
- BLOCKED： 禁止访问此网络；
- VERIFYING_POOR_LINK： 链接连接不良；
- CAPTIVE_PORTAL_CHECK: 检查网络是否是强制网络门户；
通用状态和详细状态在源码中有对应关系，源代码如下：
static {
stateMap.put(DetailedState.IDLE, State.DISCONNECTED);
stateMap.put(DetailedState.SCANNING, State.DISCONNECTED);
stateMap.put(DetailedState.CONNECTING, State.CONNECTING);
stateMap.put(DetailedState.AUTHENTICATING, State.CONNECTING);
stateMap.put(DetailedState.OBTAINING_IPADDR, State.CONNECTING);
stateMap.put(DetailedState.VERIFYING_POOR_LINK, State.CONNECTING);
stateMap.put(DetailedState.CAPTIVE_PORTAL_CHECK, State.CONNECTING);
stateMap.put(DetailedState.CONNECTED, State.CONNECTED);
stateMap.put(DetailedState.SUSPENDED, State.SUSPENDED);
stateMap.put(DetailedState.DISCONNECTING, State.DISCONNECTING);
stateMap.put(DetailedState.DISCONNECTED, State.DISCONNECTED);
stateMap.put(DetailedState.FAILED, State.DISCONNECTED);
stateMap.put(DetailedState.BLOCKED, State.DISCONNECTED);
}
对应关系图表为：
| 详细状态名称 | 通用状态名称 |
|---|---|
| IDLE、SCANNING | DISCONNECTED |
| CONNECTING、AUTHENTICATING、OBTAINING_IPADDR、VERIFYING_POOR_LINK、CAPTIVE_PORTAL_CHECK | CONNECTING |
| CONNECTED | CONNECTED |
| SUSPENDED | SUSPENDED |
| DISCONNECTING | DISCONNECTING |
| DISCONNECTED、FAILED、BLOCKED | DISCONNECTED |
因此，只有在CONNECTED时网络IP才可用，网络才算是连接完成。
注： DHCP : 动态主机设置协议，是局域网的网络协议，用于内部网和网络服务商自动分配IP地址。
状态获取代码：
intent.getParcelableExtra<Parcelable>(WifiManager.EXTRA_NETWORK_INFO): 获取NetworkInfo#State状态
三、 WifiManager.SUPPLICANT_STATE_CHANGED_ACTION
解释： 建立与Access Point的连接状态变化广播
状态标注类： SupplicantState
状态如下：
- DISCONNECTED： 客户端未连接AP，但是正在搜索一个AP，如连接丢失时触发；
- INTERFACE_DISABLED： 禁用网络接口时进入此状态，wpa_supplication拒绝任何使用无线的操作；
- INACTIVE： WIFI配置中没有启用的网络时进入此状态，同时没有和任何网络尝试连接，需要外部交互来建立连接；
- SCANNING： 正在扫描网络；
- AUTHENTICATING： 发现合适网络,尝试与此网络进行认证时进入此状态，与网络驱动相关；
- ASSOCIATING： 尝试与SSID对应的AP进行关联，与网络驱动相关；
- ASSOCIATED： 当网络驱动已经返回与AP的关联成功时进入此状态，如果使用的是IEEE 802.1X模式，会等到起身份认证成功后进入此状态；
- FOUR_WAY_HANDSHAKE： 当WPA/WPA2 四次握手启动时进入此状态，如果是WPA-PSK情况下，关联成功后接收到第一个EAPOL-Key帧时会直接进入此状态。在WPA-EAP的情况下，会完成认证后进入；
- GROUP_HANDSHAKE：四次握手完成，当请求者开始接收消失时，进入此状态；
- COMPLETED：所有认证已经完成进入状态，此时可能没有分配任何IP，需要发送DHCP请求来获取地址；
- DORMANT：用户明确发出中断指令时进入状态；
- UNINITIALIZED： 没有连接wpa_supplicant，是一个伪状态；
- INVALID: 伪状态，一般不会出现；
注： AP代表Access Point，网络热点；WPA、WPA-EAP、IEEE 802.1x等名词请查看博客 Android WiFi 之 认证标准、密钥管理、加密方案；
状态获取代码：
intent.getParcelableExtra<Parcelable>(WifiManager.EXTRA_NEW_STATE) : 获取SupplicantState状态
SupplicantState和NetworkInfo#DetailedState同样存在对应关系，源代码如下：
static {
stateMap.put(SupplicantState.DISCONNECTED, DetailedState.DISCONNECTED);
stateMap.put(SupplicantState.INTERFACE_DISABLED, DetailedState.DISCONNECTED);
stateMap.put(SupplicantState.INACTIVE, DetailedState.IDLE);
stateMap.put(SupplicantState.SCANNING, DetailedState.SCANNING);
stateMap.put(SupplicantState.AUTHENTICATING, DetailedState.CONNECTING);
stateMap.put(SupplicantState.ASSOCIATING, DetailedState.CONNECTING);
stateMap.put(SupplicantState.ASSOCIATED, DetailedState.CONNECTING);
stateMap.put(SupplicantState.FOUR_WAY_HANDSHAKE, DetailedState.AUTHENTICATING);
stateMap.put(SupplicantState.GROUP_HANDSHAKE, DetailedState.AUTHENTICATING);
stateMap.put(SupplicantState.COMPLETED, DetailedState.OBTAINING_IPADDR);
stateMap.put(SupplicantState.DORMANT, DetailedState.DISCONNECTED);
stateMap.put(SupplicantState.UNINITIALIZED, DetailedState.IDLE);
stateMap.put(SupplicantState.INVALID, DetailedState.FAILED);
}
对应关系图表如下：
| SupplicantState状态 | NetworkInfo#DetailedState状态 |
|---|---|
| DISCONNECTED、INTERFACE_DISABLED、DORMANT | DISCONNECTED |
| INACTIVE、UNINITIALIZED | IDLE |
| SCANNING | SCANNING |
| AUTHENTICATING、ASSOCIATING、ASSOCIATED | CONNECTING |
| FOUR_WAY_HANDSHAKE、GROUP_HANDSHAKE | AUTHENTICATING |
| COMPLETED | OBTAINING_IPADDR |
| INVALID | FAILED |
由此可以看出，SupplicantState状态更多的是NetworkInfo#DetailedState的过程状态，对整个网络连接做了更详细的划分，但是没有任何状态表面Access Point已经可用。
通过SupplicantState获取NetworkInfo#DetailedState，调用系统API WifiInfo.getDetailedStateOf(SupplicantState suppState)即可。