从用户角度看,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;
}