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<WifiConfiguration> wifiConfigList=new ArrayList<WifiConfiguration>();

//Wi-Fi配置列表

private List<WifiConfiguration> wifiConfigedSpecifiedList=new ArrayList<WifiConfiguration>();

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<WifiConfiguration> 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<ScanResult> listResult=new ArrayList<ScanResult>();

public void scan(){

　　//开始扫描

　　mWifiManager.startScan();

　　//获取扫描结果

　　listResult=mWifiManager.getScanResults();

　　//扫描配置列表

　　wifiConfigList=mWifiManager.getConfiguredNetworks();

　　if(listResult!=null){

　　　　//当前存在无线网络

　　}else{

　　　　//当前区域没有无线网络　　

　　}

}

12.返回扫描结果

public List<ScanResult> 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<listResult.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<WifiConfiguration> 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;

}