Wifi的初步使用

前言：wifi是手机上非常重要的功能，了解wifi的基本使用对我们开发帮助是很大的。

项目地址：https://github.com/JQMotee/wificonnection

Android Wi-Fi基本操作
从用户角度看，Android Wi-Fi模块自下向上可以看为5层：硬件驱动程序，wpa_suppplicant,JNI,WiFi API,WifiSettings应用程序。

1.wpa_supplicant是一个开源库，是android实现Wi-Fi功能的基础，它从上层接到命令后，通过Socket与硬件驱动进行通讯，操作硬件完成需要的操作。

2.JNI(Java Native Interface)实现了java代码与其他代码的交互，使得在java虚拟机中运行的java代码能够与其他语言编写的应用程序和库进行交互，在android中，JNI可以让java程序调用C程序。

3.Wi-Fi API使应用程序可以使用Wi-Fi的功能。

4.Wi-FI Settings应用程序是android中自带的一个应用程序，选择手机的Settings->WireLess & netWorks->Wi-Fi，可以让用户手动打开或关闭Wi-Fi功能。当用户打开Wi-Fi功能后，它会自动搜索周围的无线网络，并以列表的形式显示，供用户选择。默认会连接用户上一次成功连接的无线网络。

在android.net.wifi包中提供了一些类管理设备的Wi-Fi功能。主要包括ScanResult,wifiConfiguration,WifiInfo,WifiManager.

1.ScanResult

ScanResult主要是通过Wi-Fi硬件的扫描来获取一些周边的Wi-Fi热点的信息。该类包括以下五个域:
返回类型 域名 解释
public String BSSID 接入点地址
public String SSID 网络的名称
public String capabilities 网络性能，包括介入点支持的认证，密钥管理，加密机制等
public int frequency 以MHz为单位的接入频率
public int level 以dBm为单位的信号强度
该类还提供了一个方法toString()，可将结果转换为简洁，易读的字符串形式。

2.wifiConfiguration类

通过该类可获取一个Wi-Fi网络的网络配置，包括安全配置等。该类包括六个子类，如下：
子类 解释
WifiConfiguration.AuthAlgorthm 获取IEEE802.11的加密方法
WifiConfiguration.GroupCipher 获取组密钥
WifiConfiguration.KeyMgmt 获取密码管理机制
WifiConfiguration.PairwiseCipher 获取WPA方式的成对密钥
WifiConfiguration.Protocol 获取机密协议
WifiConfiguration.Status 获取当前网络状态
每个子类都以常量形式给出相关的配置信息，有些还包括含域和方法。

3.WifiInfo类

通过该类可以获取已经建立或处于活动状态的Wi-Fi网络的状态信息。该类提供的方法较多，部分常用的如下：
方法 解释
getBSSIS() 获取当前接入点的BSSID
getIpAddress() 获取IP地址
getLinkSpeed() 获取当前连接的速度
getMacAddress() 获取MAC地址
getRssi() 获得802.11n网络的信号强度指示
getSSID() 获得网络SSID
getSupplicanState() 返回客户端状态的信息

4.wifiManager类

该类用于管理Wi-Fi连接，其定义了26个常量和23个方法。下面列出常用方法：

addNetwork(WifiConfiguration config) 向设置好的网络里添加新网络
calculateSignalLevel(int rssi,int numLevels) 计算信号的等级
compareSignalLevel(int rssiA,int rssiB) 对比两个信号的强度
createWifiLock(int lockType,String tag) 创建一个Wi-Fi锁，锁定当前的Wi-Fi连接
disableNetWork(int netId) 让一个网络连接失败
disconnect() 与当前接入点断连接
enableNetwork(int netId,Boolean disableOthers) 与之前设置好的网络建立连接
getConfiguredNetworks() 客户端获取网络连接状态
getConnectionInfo() 获取当前连接信息
getDhcpInfo() 获取DHCP信息
getScanResult() 获取扫描测试结果
getWifiState() 获取一个Wi-Fi接入点是否有效
isWifiEnabled() 判断一个Wi-Fi连接是否有效
pingSupplicant() 看看客户后台程序是否响应请求
ressociate() 重连到接入点，即使已经连接上了
reconnect() 如果现在没有连接的话，则重连接
removeNetwork(int netId) 移出某一个特定网络
saveConfiguration() 保留一个配置信息
setWifiEnabled(boolean enabled) 让一个连接有效或失效
startScan() 开始扫描
updateNetwork(WifiConfiguration config) 更新一个网络连接信息

需要指出的是，Wi-Fi网卡状态是由一系列的整型常量来表示的。
WIFI_STATE_DISABLED：Wi-Fi网卡不可用，用整型常量1表示。
WIFI_STATE_DISABLING:Wi-Fi网卡正在关闭，用整型常量0表示。
WIFI_STATE_ENABLED：Wi-Fi网卡可用，用整型常量3表示。
WIFI_STATE_ENABLING:Wi-Fi网卡正在打开，启动需要一段时间，用整型常量2表示。
WIFI_STATE_UNKNOWN:未知网卡状态，用整型常量4表示。

此外wifiManager还提供了一个子类wifiManagerLock.wifiManagerLock的作用是这样的：在普通的状态下，如果Wi-Fi的状态处于闲置，那么网络将会暂时中断；但是如果把当前的网络状态锁上，那么Wi-Fi连通将会保持在一定的状态，在结束锁定之后，才会恢复常态。

---

下面简单介绍一些方法的调用方式：

private WifiInfo mWifiInfo;
private WifiManager mWifiManager;

1.获取WifiManager系统服务

mWifiManager=(WifiManager)context.getSystemService(Context.WIFI_SERVICE);

2.重新获取当前Wi-Fi的连接信息

public void againGetWifiInfo(){
　　mWifiInfo=mWifiManager.getConnectionInfo();
}

3.判断用户是否开启wi-fi网卡

public boolean isNetCardFriendly(){
　　return mWifiManager.isWifiEnabled();
}

4.判断当前是否连接Wi-Fi

private State state;
//创建连接管理器
private ConnectivityManager connManager;
public boolean isConnectioning(){
　　state=connManager.getNetworkInfo(ConnectivityManager.TYPE_WIFI).getState();
　　if(State.CONNECTING==state){
　　　　return true;
　　}else{
　　　　return false;
　　}
}

5.得到当前网络的连接状态

public State getCurrentState(){
　　state=connManager.getNetworkInfo(ConnectivityManager.TYPE_WIFI).getState();
　　return state;
}

6.设置配置好的网络（有密码的网络并配置好密码），指定的

//网络连接列表
private List wifiConfigList=new ArrayList();
//Wi-Fi配置列表
private List wifiConfigedSpecifiedList=new ArrayList();
public void setWifiConfigedSpecifiedList(String ssid){
　　wifiConfigedSpecifiedList.clear();
　　if(wifiConfigList!=null){
　　　　for(WifiConfiguration item : wifiConfigList){
　　　　　　//如果是指定的网络，就加入列表
　　　　　　if(item.SSID.equalsIgnoreCase(“\”“+ssid+”\”“)&& item.preSharedKey!=null){
　　　　　　　　//添加到列表中
　　　　　　　　wifiConfigedSpecifiedList.add(item);
　　　　　　}
　　　　}
　　}
}

7.返回Wi-Fi设置列表

public List getWifiConfigedSpecifiedList(){
　　return wifiConfigedSpecifiedList;
}

8.打开Wi-Fi网卡

public void openNetCard(){
　　if(!mWifiManager.isWifiEnabled()){
　　　　mWifiManager.setWifiEnabled(true);
　　}
}

9.关闭Wi-Fi网卡

public void closeNetCard(){
　　if(mWifiManager.isWifiEnabled()){
　　　　mWifiManager.setWifiEnabled(false);
　　}
}

10.检查当前Wi-Fi网卡状态

public void checkNetCardState(){
　　if(mWifiManager.getWifiState()==0){
　　　　Log.i(“”,”网卡正在关闭”);
　　}else if(mWifiManager.getWifiState()==1){
　　　　Log.i(“”,”网卡已经关闭”);
　　}else if(mWifiManager.getWifiState()==2){
　　　　Log.i(“”,”网卡正在打开”);
　　}else if(mWifiManager.getWifiState()==3){
　　　　Log.i(“”,”网卡已经打开”);　　
　　}else{
　　　　Log.i(“”,”没有获取到状态”);
　　}
}

11.扫描周边网络

//保存扫描结果列表
public List listResult=new ArrayList();
public void scan(){
　　//开始扫描
　　mWifiManager.startScan();
　　//获取扫描结果
　　listResult=mWifiManager.getScanResults();
　　//扫描配置列表
　　wifiConfigList=mWifiManager.getConfiguredNetworks();
　　if(listResult!=null){
　　　　//当前存在无线网络
　　}else{
　　　　//当前区域没有无线网络　　
　　}
}

12.返回扫描结果

public List getListResult(){
　　return listResult;
}

13.得到扫描结果

//存储扫描结果
private StringBuffer mStringBuffer=new StringBuffer();
private ScanResult mScanResult;
public String getScanResult(){
　　//每次点击扫描之前清空上一次扫描结果
　　if(mStringBuffer!=null){
　　　　mStringBuffer=new StringBuffer();　　
　　}
　　//开始扫描调用11的方法
　　scan();
　　listResult=mWifiManager.getScanResults();
　　if(listResult!=null){
　　　　for(int i=0;i.size();i++){
　　　　　　mScanResult=listResult.get(i);
　　　　　　//将需要的属性连接到字符串里面　
　　　　　mStringBuffer.append(“NO.”).append(i+1).append(” :”).append(mScanResult.SSID).append(“->”).append(mScanResult.BSSID).append(“->”).append(mScanResult.capabilities).append(“->”).append(mScanResult.frequency).append(“->”).append(mScanResult.level).append(“->”).append(mScanResult.describeContents()).append(“\n\n”);
　　　　}
　　}
　　return mStringBuffer.toString();
}

14.断开当前连接的网络

public void disconnectWifi(){
　　//获取网络ID
　　int newId=getNetworkId();
　　//设置网络不可用
　　mWifiManager.disableNetWork(netId);
　　//断开网络
　　mWifiManager.disconnect();
　　//设置Wi-Fi信息为NULL
　　mWifiInfo=null;
}

15.检查当前网络状态

public Boolean checkNetWorkState(){
　　if(mWifiInfo!=null){
　　　　return true;
　　}else{
　　　　return false;
　　}
}

16.得到连接的ID

public int getNetworkId(){
　　return (mWifiInfo==null)?0:mWifiInfo.getNetworkId();
}

17.得到IP地址

public void getIPAddress(){
　　　return (mWifiInfo==null)?0:mWifiInfo.getIpAddress();
}

18.锁定WifiLock

WinfiLock mWifiLock;
public void acquireWifilock(){
　　mWifiLock.acquire();
}

19.解锁WifiLock

public void releaseWifiLock(){
　　if(mWifiLock.isHeld()){
　　　　mWifiLock.acquire();
　　}
}

20.创建一个WifiLock

public void creatWifiLock(){
　　mWifiLock=mWifiManager.createWifiLock(“test”);
}

21.得到配置好的网络wpa_supplicant.conf中的内容,不管有没有配置密码

public List getConfiguration(){
　　return wifiConfigList;
}

22.指定配置好的网络连接

public Boolean connectConfiguration(int index)(){
　　//所引大于配置好的网络返回
　　if(index>=wifiConfigList.size()){
　　　　return false;
　　}
　　return mWifiManager.enableNetwork(wifiConfigedSpecifiedList.get(index).networkId,true);
}

23.得到MAX地址

public String getMacAddress(){
　　return (mWifiInfo=null)?”“:mWifiInfo.getMacAddress();　
}

24.得到接入点BSSID

public String getBSSID(){
　　return (mWifiInfo=null)?”NULL”:mWifiInfo.getBSSID();
}

25.得到WifiInfo的所有信息包

public String getWifiInfo(){
　　return (mWifiInfo=null)?”NULL”:mWifiInfo.toString();
}

26.添加一个网络并连接

public int addNetwork(WifiConfiguration g){
　　//添加网络
　　int wcgID=mWifiManager.addNetwork(g);
　　//设置添加的网络可用
　　mWifiManager.enableNetwork(wcgID,true);
　　return wcgID;
}