wifi

1    关于wifi的操作主要包括以下几个类和接口：

1.1      ScanResult：主要用来描述已经检测出的接入点，包括介入点的地址，介入点的名称，身份认证，频率，信号强度等信息

1.2      wifiConfiguration：wifi网络的配置，包括安全配置等

1.3      wifiInfo：wifi无线连接的描述，包括接入点，网络连接状态，隐藏的接入点，IP地址，连接速度，mac地址，网络ID，信号强度等信息。

1.4      wifiManager：提供了管理wifi连接的大部分API，它主要包括如下内容：

a）已经配置好的网络的清单。这个清单可以查看和修改，而且可以修改个别记录的属性

b）        当连接中有活动的wi-fi网络时，可以建立或者关闭这个连接，并且可以查询有关网络的状态的动态信息。

c）对接入点的扫描结果包含足够的信息来决定需要与什么接入点建立连接。

d）        还定义了许多常量来表示wi-fi状态的改变。

1.5      wifiManager.WifiLock：允许程序一直使用wifi无线网络，使其一直保持连接

2. 代码例子：

2.1  TestWiFi:

import java.util.List;
import android.content.Context;
import android.net.wifi.ScanResult;
import android.net.wifi.WifiConfiguration;
import android.net.wifi.WifiInfo;
import android.net.wifi.WifiManager;
import android.net.wifi.WifiManager.WifiLock;

public class TestWiFi
{
    // 定义WifiManager对象
    private WifiManager mWifiManager;

    // 定义WifiInfo对象
    private WifiInfo mWifiInfo;

    // 扫描出的网络连接列表
    private List<ScanResult> mWifiList;

    // 网络连接列表
    private List<WifiConfiguration> mWifiConfigurations;

    // wifiLock锁
    WifiLock mWifiLock;

    public TestWiFi(Context context)
    {
        // 取得WifiManager对象
        mWifiManager = (WifiManager) context.getSystemService(Context.WIFI_SERVICE);
        // 取得WifiInfo对象
        mWifiInfo = mWifiManager.getConnectionInfo();
    }

    /**
     * 打开wifi
     * 
     * @see [类、类#方法、类#成员]
*/
    public void openWifi()
    {
        if (!mWifiManager.isWifiEnabled())
        {
            mWifiManager.setWifiEnabled(true);
        }
    }

    /**
     * 关闭wifi
     * 
     * @see [类、类#方法、类#成员]
*/
    public void closeWifi()
    {
        if (mWifiManager.isWifiEnabled())
        {
            mWifiManager.setWifiEnabled(false);
        }
    }

    /**
     * 锁定wifi
     * 
     * @see [类、类#方法、类#成员]
*/
    public void acquireWifiLock()
    {
        mWifiLock.acquire();
    }

    /**
     * 解锁wif
     * 
     * @see [类、类#方法、类#成员]
*/
    public void releaseWifiLock()
    {
        // 解锁前锁定
        if (mWifiLock.isHeld())
        {
            mWifiLock.acquire();
        }
    }

    /**
     * 创建一个wifiLock
     * 
     * @see [类、类#方法、类#成员]
*/
    public void creatWifiLock()
    {
        mWifiLock = mWifiManager.createWifiLock("Test");
    }

    /**
     * 得到配置好的网络
     * 
     * @return
     * @see [类、类#方法、类#成员]
*/
    public List<WifiConfiguration> getConfiguration()
    {
        return mWifiConfigurations;
    }

    /**
     * 指定配置好的网络进行连接
     * 
     * @param index
     * @see [类、类#方法、类#成员]
*/
    public void conectConfiguration(int index)
    {
        // 索引大于配置好的网络索引
        if (index > mWifiConfigurations.size())
        {
            return;
        }
        // 连接配置好的指定ID的网络
        mWifiManager.enableNetwork(mWifiConfigurations.get(index).networkId, true);
    }

    /**
     * 开始扫描
     * 
     * @see [类、类#方法、类#成员]
*/
    public void startScan()
    {
        mWifiManager.startScan();
        // 得到扫描结果
        mWifiList = mWifiManager.getScanResults();
        // 得到配置好的网络连接
        mWifiConfigurations = mWifiManager.getConfiguredNetworks();
    }

    /**
     * 得到网络列表
     * 
     * @return
     * @see [类、类#方法、类#成员]
*/
    public List<ScanResult> getwifiList()
    {
        return mWifiList;
    }

    /**
     * 查看扫描结果
     * 
     * @return
     * @see [类、类#方法、类#成员]
*/
    public StringBuilder lookUpScan()
    {
        StringBuilder stringBuilder = new StringBuilder();
        for (int i = 0; i < mWifiList.size(); i++)
        {
            stringBuilder.append("Index " + new Integer(i + 1).toString() + ":");
            // 将ScanResult信息转换成一个字符串
// 其中包括BSSID,SSID,capabilities,frequency和level
            stringBuilder.append((mWifiList.get(i)).toString());
            stringBuilder.append("\n");
        }
        return stringBuilder;
    }

    /**
     * 得到Mac地址
     * 
     * @return
     * @see [类、类#方法、类#成员]
*/
    public String getMacAdrress()
    {
        return (mWifiInfo == null) ? "NULL" : mWifiInfo.toString();
    }

    /**
     * 得到接入点的BSSID
     * 
     * @return
     * @see [类、类#方法、类#成员]
*/
    public String getBSSID()
    {
        return (mWifiInfo == null) ? "NULL" : mWifiInfo.getBSSID();
    }

    /**
     * 得到IP地址
     * 
     * @return
     * @see [类、类#方法、类#成员]
*/
    public int getIPAddress()
    {
        return (mWifiInfo == null) ? 0 : mWifiInfo.getIpAddress();

    }

    /**
     * 得到连接的ID
     * 
     * @return
     * @see [类、类#方法、类#成员]
*/
    public int getNetWorkId()
    {
        return (mWifiInfo == null) ? 0 : mWifiInfo.getNetworkId();
    }

    /**
     * 得到wifiInfo的所有信息包
     * 
     * @return
     * @see [类、类#方法、类#成员]
*/
    public String getWifiInfo()
    {
        return (mWifiInfo == null) ? "NULL" : mWifiInfo.toString();
    }

    /**
     * 添加一个网络并连接
     * 
     * @see [类、类#方法、类#成员]
*/
    public void addNetwork(WifiConfiguration wcg)
    {
        int wcgID = mWifiManager.addNetwork(wcg);
        mWifiManager.enableNetwork(wcgID, true);
    }

    /**
     * 断开指定的ID的网络
*/
    public void disconnectWifi(int netId)
    {
        mWifiManager.disableNetwork(netId);
        mWifiManager.disconnect();
    }
}

2.2使用wifi网络连接，需要在AndroidManifest.xml中加入对应的权限：

<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
    <uses-permission android:name="android.permission.ACCESS_CHECKIN_PROPERTIES"/>
    <uses-permission android:name="android.permission.WAKE_LOCK"/>
    <uses-permission android:name="android.permission.INTERNET"/>
    <uses-permission android:name="android.permission.CHANGE_WIFI_STATE"/>
    <uses-permission android:name="android.permission.MODIFY_PHONE_STATE"/>