调研完Android的wifi相关操作,刚好单位要求整理个文档,顺便园子里也发个记录下。。。

 

wifi模块简介

android本身已经提供了包来处理Android环境下对Wifi的操作,位置是android.net.wifi下面。调用wifi操作需要在mainfest中添加对应权限。

 

主要功能类

官方提供的大致可以分为四个主要的类:WifiManager,ScanResult,WifiConfiguration,WifiInfo,此外还有WifiLock,MulticastLock等

 

WifiManager

提供wifi管理的各种主要API,主要包含wifi的扫描,建立连接,配置等

http://developer.android.com/reference/android/net/wifi/WifiManager.html

 

ScanResult

描述开启扫描后的Wifi热点的信息。包含SSID、Capabilities、frequency、level(信号强度)等。

http://developer.android.com/reference/android/net/wifi/ScanResult.html

 

WifiConfiguration

描述wifi的连接信息,包含SSID、SSID隐藏、Password等的设置。

http://developer.android.com/reference/android/net/wifi/WifiConfiguration.html

 

WifiInfo

描述已建立连接后的wifi信息。包含ip、mac地址、连接速度等信息。区别与ScanResult的概念。

http://developer.android.com/reference/android/net/wifi/WifiInfo.html

 

WifiLock

用于给wifi加锁,通常用于下载大体积文件的时候。
如果应用程序想在屏幕被关掉后继续使用WiFi则可以调用 acquireWifiLock来锁住WiFi,该操作会阻止WiFi进入睡眠状态。当应用程序不再使用WiFi时需要调用 releaseWifiLock来释放WiFi。之后WiFi可以进入睡眠状态以节省电源。
默认情况下当屏幕被关掉以后,如果没有应用程序在使用WiFi,WiFi会在2分钟后进入睡眠状态。这主要是为防止频繁地改变WiFi的电源模式。

wifiLock可通过setReferenceCounted(boolean refCounted)来设置加锁方式。一种是不计数锁,另一种是计数锁。
区别在于:前者无论 acquire() 了多少次,只要通过一次 release()即可解锁。后者正真解锁是在( --count == 0 )的时候。 
http://developer.android.com/reference/android/net/wifi/WifiManager.WifiLock.html

 

常用功能代码

获取WifiManager

WifiManager wm = (WifiManager) this.getSystemService(Context.WIFI_SERVICE);

设置wifi功能开启

bRet = wifiManager.isWifiEnabled();//判断是否开启

bRet = wifiManager.setWifiEnabled(true);//设置开启关闭

注意,调用setWifiEnabled后,系统进行wifi模块的开启需要一定时间,此时通过wifiManager.getWifiState()获取的状态来判断是否完成。

 

WifiManager.WIFI_STATE_DISABLED : WIFI网卡不可用(1)

WifiManager.WIFI_STATE_DISABLING : WIFI网卡正在关闭(0)

WifiManager.WIFI_STATE_ENABLED : WIFI网卡可用(3)

WifiManager.WIFI_STATE_ENABLING : WIFI网正在打开(2) (WIFI启动需要一段时间)

WifiManager.WIFI_STATE_UNKNOWN  : 未知网卡状态

 

复制代码
while (wifiManager.getWifiState() == WifiManager.WIFI_STATE_ENABLING) {

                            try {

                                     Thread.currentThread();

                                     Thread.sleep(100);

                            } catch (InterruptedException ie) {

                            }

                   }
复制代码

 

扫描附近接入点AP

List<ScanResult> list = null;

if ( wifiManager.startScan())

list = wifiManager.getScanResults();

 

获取AP的信号强度、频率等

scanResult.level  //信号强度

scanResult.frequency  //频率

 

获取手机中保存过配置的连接信息

List<WifiConfiguration> existingConfigs = wifiManager.getConfiguredNetworks();//获取保存的配置信息

 

判断某ssid的AP是否有保存过配置信息

复制代码
for (WifiConfiguration existingConfig : existingConfigs) {

         if (existingConfig.SSID.equals("\"" + SSID + "\"")) {

                   return existingConfig;

         }

}
复制代码

 

关闭Wifi连接

wifiManager.disableNetwork(existingConfig.networkId);

 

移除Wifi连接配置

wifiManager.removeNetwork(networkId);

注意与上面的disableNetwork的区别。Disable只是单纯的断开连接,保存的ssid和密码并不清除。

Remove则是从手机中移除(忘记)该连接配置,用来清除保存的密码

在网络正常连接的状态,也可直接调用remove来代替disable中断网络,但会清除密码信息。

 

创建连接Configuration

复制代码
public WifiConfiguration CreateWifiConfig(String SSID, String Password,

                            WifiCipherType Type) {

                   WifiConfiguration config = new WifiConfiguration();

                  

                   config.allowedAuthAlgorithms.clear();

                   config.allowedGroupCiphers.clear();

                   config.allowedKeyManagement.clear();

                   config.allowedPairwiseCiphers.clear();

                   config.allowedProtocols.clear();

                  

                   config.SSID = "\"" + SSID + "\"";

                  

                   //无密码

                   if (Type == WifiCipherType.WIFICIPHER_NOPASS) {

                            config.wepKeys[0] = "";

                            config.allowedKeyManagement.set(WifiConfiguration.KeyMgmt.NONE);

                            config.wepTxKeyIndex = 0;

                   }

                  

                   //WEP加密

                   if (Type == WifiCipherType.WIFICIPHER_WEP) {

                            config.preSharedKey = "\"" + Password + "\"";

                            config.hiddenSSID = true;

                            config.allowedAuthAlgorithms

                                               .set(WifiConfiguration.AuthAlgorithm.SHARED);

                            config.allowedGroupCiphers.set(WifiConfiguration.GroupCipher.CCMP);

                            config.allowedGroupCiphers.set(WifiConfiguration.GroupCipher.TKIP);

                            config.allowedGroupCiphers.set(WifiConfiguration.GroupCipher.WEP40);

                            config.allowedGroupCiphers

                                               .set(WifiConfiguration.GroupCipher.WEP104);

                            config.allowedKeyManagement.set(WifiConfiguration.KeyMgmt.NONE);

                            config.wepTxKeyIndex = 0;

                   }

                  

                   //WPA加密

                   if (Type == WifiCipherType.WIFICIPHER_WPA) {

                            config.preSharedKey = "\"" + Password + "\"";

                            config.hiddenSSID = true;

                            // config.allowedAuthAlgorithms.set(WifiConfiguration.AuthAlgorithm.OPEN);

                            // config.allowedGroupCiphers.set(WifiConfiguration.GroupCipher.TKIP);

                            // config.allowedKeyManagement.set(WifiConfiguration.KeyMgmt.WPA_PSK);

                            // config.allowedPairwiseCiphers.set(WifiConfiguration.PairwiseCipher.TKIP);

                            // config.allowedProtocols.set(WifiConfiguration.Protocol.WPA);

                            // config.status = WifiConfiguration.Status.ENABLED;

                   }

                   else {

                            return null;

                   }

                   return config;

         }
复制代码

 

 

添加、开启一个wifi

复制代码
public boolean addNewWifi(WifiConfiguration newConfig){

                   int netID = wifiManager.addNetwork(newConfig);//添加

                   boolean bRet = wifiManager.enableNetwork(netID, false);//启动

                   return bRet;

         }
复制代码

 

获取目前的WifiInfo(IP、mac等)

复制代码
WifiInfo wInfo = wifiManager.getConnectionInfo();//获取当前连接的info

 

wInfo.getBSSID();// 获取BSSID

wInfo.getHiddenSSID();// 获得SSID 是否被隐藏

wInfo.getIpAddress();// 获取IP 地址

wInfo.getLinkSpeed();// 获得连接的速度

wInfo.getMacAddress();// 获得Mac 地址

wInfo.getRssi();// 获得802.11n 网络的信号

wInfo.getSSID();// 获得SSID

SupplicantState suppState = wInfo.getSupplicantState();// 返回具体客户端状态的信息

wInfo.getDetailedStateOf(suppState);// 获取客户端的连通性

 
复制代码

 

相关权限

复制代码
修改网络状态的权限

<uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" >

</uses-permission>

 

修改WIFI状态的权限

<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" >

</uses-permission>

 

访问网络权限

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" >

</uses-permission>

 

访问WIFI权限

<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" >

</uses-permission>
复制代码

 

点赞(0)

评论列表 共有 0 条评论

暂无评论
立即
投稿
发表
评论
返回
顶部