第14章 Wi-Fi系统应用 14.1 了解Wi-Fi系统的结构

       Android平台中Wi-Fi系统从上到下主要包括Java框架类、Android适配器库、wpa_supplicant守护进程、驱动程序和协议，这几部分的系统结构如图14-3所示。

      （1）Wi-Fi用户空间的程序和库，对应路径如下所示。

14.3  开发Wi-Fi应用程序

14.3.1  类WifiManager

   例如下面一段代码是通用的Wi-Fi应用程序。

package com.example.wifiadmin;

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 WifiAdmin {
    //定义WifiManager对象
    private WifiManager mWifiManager;
    //定义WifiInfo对象
    private WifiInfo mWifiInfo;
    //扫描出的网络连接列表
    private List<ScanResult> mWifiList;
    //网络连接列表
    private List<WifiConfiguration> mWifiConfiguration;
    //定义一个WifiLock
    WifiLock mWifiLock;
    //构造器
    public WifiAdmin(Context context) {
        //取得WifiManager对象
        mWifiManager = (WifiManager) context.getSystemService(Context.WIFI_SERVICE);
        if(mWifiManager != null){
            List<ScanResult> wifiscanResults = mWifiManager.getScanResults();
            if(wifiscanResults != null && wifiscanResults.size() !=0){
                
            }
        }
        //取得WifiInfo对象
        mWifiInfo = mWifiManager.getConnectionInfo();
    }
    //打开Wi-Fi
    public void OpenWifi(){
        if  (!mWifiManager.isWifiEnabled())
        {
            mWifiManager.setWifiEnabled(true);
        }
    }

    //关闭Wi-Fi
    public void CloseWifi(){
        if  (!mWifiManager.isWifiEnabled()){
            mWifiManager.setWifiEnabled(false);
        }
    }
    //锁定WifiLock,当下载大文件时需要锁定
    public void AcquireWifiLock()
    {
        mWifiLock.acquire();      
    }
    //解锁WifiLock
    public void ReleaseWifiLock()
    {
        //判断时候锁定
        if(mWifiLock.isHeld())
        {
           mWifiLock.acquire();    
        }
    }
    //创建一个WifiLock
    public void CreatWifiLock(){
         mWifiLock =   mWifiManager.createWifiLock("Test"); 
    }
    
    //得到配置好的网络
    public List<WifiConfiguration> GetConfiguration()
    {
        return mWifiConfiguration;
    }
    //指定配置好的网络进行连接
    public void ConnectConfiguration(int index){
        //索引大于配置好的网络,索引返回
        if(index > mWifiConfiguration.size()){
            return;
        }
        //连接配置好的指定ID的网络
        mWifiManager.enableNetwork(mWifiConfiguration.get(index).networkId, true);
    }
    
    // 得到网络列表
    public List<ScanResult> GetWifiList()
    {
        return mWifiList;
    }
    //查看扫描结果
    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("
");
        }
        return stringBuilder;
    }
    
    // 得到MAC地址
    public String GetMacAddress(){
        return (mWifiInfo == null) ? "NULL" : mWifiInfo.getMacAddress();
    }
    // 得到接入点的BSSID
    public String GetBSSID()
    {
        return (mWifiInfo == null) ? "NULL" : mWifiInfo.getBSSID();
    }
    //得到IP地址
    public int GetIPAdress(){
        return (mWifiInfo == null) ? 0 : mWifiInfo.getIpAddress();
    }
    //得到连接的ID
    public int GetNetworkId(){
        return (mWifiInfo == null ) ? 0 : mWifiInfo.getNetworkId();
    }
    //得到WifiInfo的所有信息包
    public String GetWifiInfo()
    {
        return (mWifiInfo == null ) ? "NULL" : mWifiInfo.toString();
    }
    
    
    //添加一个网络并连接
    public void AddNetwork(WifiConfiguration wifiConfiguration)
    {
        int wcgID = mWifiManager.addNetwork(wifiConfiguration);
        mWifiManager.enableNetwork(wcgID, true);
    }
    //断开指定ID的网络
    public void DisconnectWifi(int netId){
        mWifiManager.disableNetwork(netId);
        mWifiManager.disconnect();
    }
}

第二点是需要在程序中声明一些相关的权限，Wi-Fi的主要操作权限有如下四个。

●  CHANGE_NETWORK_STATE： 允许修改网络状态的权限。

●  CHANGE_WIFI_STATE：允许修改Wi-Fi状态的权限。

●  ACCESS_NETWORK_STATE：允许访问网络状态的权限。

●  ACCESS_WIFI_STATE：允许访问Wi-Fi状态的权限。

例如下面的代码。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.wifiadmin"
    android:versionCode="1"
    android:versionName="1.0" >

    <uses-sdk
        android:minSdkVersion="8"
        android:targetSdkVersion="17" />
    <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"
        
        />
    <application
        android:allowBackup="true"
        android:icon="@drawable/ic_launcher"
        android:label="@string/app_name"
        android:theme="@style/AppTheme" >
        <activity
            android:name="com.example.wifiadmin.MainActivity"
            android:label="@string/app_name" >
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>

</manifest>

14.3.2  实战演练——在Android系统中控制Wi-Fi

     了解了Wi-Fi的基本知识后，下面将通过具体的演示实例来讲解在Android系统中开发Wi-Fi应用程序的流程。本实例的功能是在Android系统中控制Wi-Fi的状态。

本实例的具体实现流程如下所示。

（1）编写布局文件main.xml,具体代码如下。

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:background="@drawable/white"
    android:orientation="vertical" 
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
>

    <TextView
        android:id="@+id/myTextView1"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:textColor="@drawable/blue"
        android:text="@string/hello" />
    
    <CheckBox
        android:id="@+id/myCheckBox1"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="@string/str_checked"
        android:textColor="@drawable/blue"
        />
        
     
</LinearLayout>

（2）开始实现主程序文件control.java，具体实现流程如下。

● 创建Wi-fiManager对象mWi-FiManager01，具体代码如下。

●  定义mTextView01和mCheckBox01，分别用于显示提示文本和获取复选框的选择状态，具体代码如下。

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
        mTextView01 = (TextView) findViewById(R.id.myTextView1);
        mCheckBox01 = (CheckBox) findViewById(R.id.myCheckBox1);

● 以getSystemService取得WIFI_SERVICE，具体代码如下所示。

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

● 通过if语句判断运行程序后的Wi-Fi状态是否打开或处于打开中，这样便可显示对应的提示信息，具体代码如下所示。

        //判断运行程序后的Wi-Fi转台是否打开或处于打开中
        if(mWiFiManger01.isWifiEnabled())
        {
            //判断Wi-Fi状态是否“已打开”
            if(mWiFiManger01.getWifiState()==WifiManager.WIFI_STATE_ENABLED){                
            /*若Wi-Fi已打开,将选取项打钩*/
            mCheckBox01.setChecked(true);
            /*更改选取项文字为关闭Wi-Fi*/
            mCheckBox01.setText(R.string.str_uncheck);
            }
            else{
                /* 若Wi-Fi未打开,将选取项勾选取消 */
                mCheckBox01.setChecked(false);
                /* 更改选取项文字为打开Wi-Fi     */
                mCheckBox01.setText(R.string.str_checked);
            }
        }else{
            mCheckBox01.setChecked(false);
            mCheckBox01.setText(R.string.str_checked);
        }

● 通过mCheckBox01.setOnClickListener来捕捉CheckBox的单击事件，用onClick(View v)方法获取用户的单击，然后if语句根据操作需求执行对应的操作，并根据需要输出对应的提示信息，具体代码如下所示。

        mCheckBox01.setOnClickListener(new CheckBox.OnClickListener() {

            @Override
            public void onClick(View v) {
                // TODO Auto-generated method stub

                /* 当选取项为取消选取状态 */
                if (mCheckBox01.isChecked() == false)

{
                    /* 尝试关闭Wi-Fi服务 */
                    try {
                        // 判断Wi-Fi状态是否为已打开
                        if (mWiFiManger01.isWifiEnabled()) {
                            // 关闭Wi-Fi
                            if (mWiFiManger01.setWifiEnabled(false)) {
                                mTextView01
                                        .setText(R.string.str_stop_wifi_done);
                            } else {
                                mTextView01
                                        .setText(R.string.str_stop_wifi_failed);
                            }
                        } else {
                            /* Wi-Fi状态不为已打开状态时 */
                            switch (mWiFiManger01.getWifiState()) {
                            /* Wi-Fi正在打开过程中,导致无法关闭..... */
                            case WifiManager.WIFI_STATE_ENABLING:
                                mTextView01.setText(getResources().getText(
                                        R.string.str_stop_wifi_failed)
                                        + ":"
                                        + getResources().getText(
                                                R.string.str_wifi_enabling));
                                break;
                            /* Wi-Fi正在关闭过程中,导致无法关闭...... */
                            case WifiManager.WIFI_STATE_DISABLING:
                                mTextView01.setText(getResources().getText(
                                        R.string.str_stop_wifi_failed)
                                        + ":"
                                        + getResources().getText(
                                                R.string.str_wifi_disabling));
                                break;
                            /* Wi-Fi已经关闭 */
                            case WifiManager.WIFI_STATE_DISABLED:
                                mTextView01.setText(getResources().getText(
                                        R.string.str_stop_wifi_failed)
                                        + ":"
                                        + getResources().getText(
                                                R.string.str_wifi_disabled));
                                break;
                            /* 无法取得或辨识Wi-Fi状态 */
                            case WifiManager.WIFI_STATE_UNKNOWN:
                            default:
                                mTextView01.setText(getResources().getText(
                                        R.string.str_stop_wifi_failed)
                                        + ":"
                                        + getResources().getText(
                                                R.string.str_wifi_unknow));
                                break;
                            }
                            mCheckBox01.setText(R.string.str_checked);
                        }
                    } catch (Exception e) {

（3）编写文件strings.xml，在此设置了在屏幕中显示的文本内容，具体代码如下所示。

<?xml version="1.0" encoding="utf-8"?>
<resources>
  <string name="hello"></string>
  <string name="app_name"></string>
  <string name="str_checked">打开....</string>
  <string name="str_uncheck">关闭....</string>
  <string name="str_start_wifi_failed">打开失败</string>
  <string name="str_start_wifi_done">打开成功</string>
  <string name="str_stop_wifi_failed">打开失败</string>
  <string name="str_stop_wifi_done">关闭成功</string>
  <string name="str_wifi_enabling">正在启动....</string>
  <string name="str_wifi_disabling">正在关闭....</string>
  <string name="str_wifi_disabled">已关闭</string>
  <string name="str_wifi_unknow">未知....</string>
</resources>

（4）最后，在文件AndroidManifest.xml中添加对Wi-Fi的访问以及网络权限的权限，具体代码如下所示。 

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