Android平台中，P2P操作特别简单，用户只需执行如下三个步骤。 1. 进入WifiP2pSettings界面。 2. 搜索周围的P2P设备。搜索到的设备将显示在WifiP2pSettings中。 3. 用户选择其中的某个设备以发起连接。 下面将根据上面的使用步骤来分析WifiP2pSettings。首先来看WifiP2pSettings的onActivityCreate函数。 **1、WifiP2pSettings创建** WifiP2pSettings的onActivityCreated函数代码如下所示。 **WifiP2pSettings.java：：onActivityCreated** ~~~ public void onActivityCreated(Bundle savedInstanceState) { addPreferencesFromResource(R.xml.wifi_p2p_settings);// 加载界面元素 /* 和第5章介绍的WifiSettings类似，WifiP2pSettings也是通过监听广播的方式来了解系统中 Wi-Fi P2P相关的信息及变化情况。下面这几个广播属于P2P特有的，其作用如下。 WIFI_P2P_STATE_CHANGED_ACTION：用于通知系统中P2P功能的启用情况，如该功能是enable还是disable。 WIFI_P2P_PEERS_CHANGED_ACTION：系统内部将保存搜索到的其他P2P设备信息，如果这些信息有变化， 则系统将发送该广播。接收者需要通过WifiP2pManager的requestPeers函数重新获取这些P2P设备的信息。 WIFI_P2P_CONNECTION_CHANGED_ACTION：用于通知P2P连接情况，该广播可携带WifiP2pInfo 和NetworkInfo两个对象。相关信息可从这两个对象中获取。 WIFI_P2P_THIS_DEVICE_CHANGED_ACTION：用于通知本机P2P设备信息发生了变化。 WIFI_P2P_DISCOVERY_CHANGED_ACTION：用于通知P2P Device Discovery的工作状态，如启动或停止。 WIFI_P2P_PERSISTENT_GROUPS_CHANGED_ACTION：用于通知之persistent group信息发生了变化。 */ mIntentFilter.addAction(WifiP2pManager.WIFI_P2P_STATE_CHANGED_ACTION); mIntentFilter.addAction(WifiP2pManager.WIFI_P2P_PEERS_CHANGED_ACTION); mIntentFilter.addAction(WifiP2pManager.WIFI_P2P_CONNECTION_CHANGED_ACTION); mIntentFilter.addAction(WifiP2pManager.WIFI_P2P_THIS_DEVICE_CHANGED_ACTION); mIntentFilter.addAction(WifiP2pManager.WIFI_P2P_DISCOVERY_CHANGED_ACTION); mIntentFilter.addAction(WifiP2pManager.WIFI_P2P_PERSISTENT_GROUPS_CHANGED_ACTION); final Activity activity = getActivity(); // 创建WifiP2pManager对象，它将和WifiP2pService交互 mWifiP2pManager = (WifiP2pManager) getSystemService(Context.WIFI_P2P_SERVICE); if (mWifiP2pManager != null) { // 初始化WifiManager并建立和WifiService的联系 mChannel = mWifiP2pManager.initialize(activity, getActivity().getMainLooper(),null); } ...... ......// 创建UI中按钮对应的onClickListener mRenameListener = new OnClickListener() {......}; ...... super.onActivityCreated(savedInstanceState); } ~~~ WifiP2pSettings将在onResume中注册一个广播接收对象以监听上面代码中介绍的广播事件。这部分代码很简单，请读者自行阅读。 **2、WifiP2pSettings工作流程** **①、WIFI_P2P_STATE_CHANGED_ACTION处理流程** 打开WifiP2pSettings后，首先要等待WIFI_P2P_STATE_CHANGED_ACTION广播以判断P2P功能是否正常启动。相应的处理函数如下所示。 **WifiP2pSettings.java：：onReceive** ~~~ private final BroadcastReceiver mReceiver = new BroadcastReceiver() { public void onReceive(Context context, Intent intent) { String action = intent.getAction(); if (WifiP2pManager.WIFI_P2P_STATE_CHANGED_ACTION.equals(action)) { // 从WIFI_P2P_STATE_CHANGED_ACTION广播中获取相关状态信息以判断P2P功能是否打开 mWifiP2pEnabled = intent.getIntExtra(WifiP2pManager.EXTRA_WIFI_STATE, WifiP2pManager.WIFI_P2P_STATE_DISABLED) == WifiP2pManager.WIFI_P2P_STATE_ENABLED; handleP2pStateChanged(); } ...... } } ~~~ 来看handleP2pStateChange函数，代码如下所示。 **WifiP2pSettings.java：：handleP2pStateChanged** ~~~ private void handleP2pStateChanged() { updateSearchMenu(false);// 该函数将触发WifiP2pSettings的onCreateOptionsMenu被调用 if (mWifiP2pEnabled) { ...... /* 获取系统当前已经搜索到或者之前保存的P2P Device信息列表。Android为此定义了一个名为 WifiP2pDeviceList的数据类型用来存储这些P2P Device信息。 请读者注意requestPeers函数调用的第二个参数，该参数的类型为PeerListener，它是一个 接口类，而WifiP2pSettings实现了它。WifiP2pDeviceList信息将通过这个接口类的 onPeersAvailable函数返回给requestPeers的调用者。 后文将分析onPeersAvailable函数，此处先略过。 */ mWifiP2pManager.requestPeers(mChannel, WifiP2pSettings.this); } } ~~~ 根据上文的介绍，用户下一步要做的事情就是主动搜索周围的P2P设备。Android原生代码中的WifiP2pSettings界面下方有两个按钮，分别是"SEARCH"和"RENAME"。 * "RENAME"用于更改本机的P2P设备名。 * "SEARCH"用于搜索周围的P2P Device。 当P2P功能正常启用后（即上述代码中的mWifiP2pEnabled为true时），这两个按钮将被使能。此后，用户就可单击"SEARCH"按钮以搜索周围的P2P设备。该按钮对应的函数是startSearch，马上来看它。 >[info] 提示　一些手机厂商对WifiP2pSettings界面有所更改，但大体流程没有变化。 **②、startSearch函数** startSearch的代码如下所示。 **WifiP2pSettings.java：：startSearch** ~~~ private void startSearch() { if (mWifiP2pManager != null && !mWifiP2pSearching) { // discoverPeers将搜索周围的P2P设备 mWifiP2pManager.discoverPeers(mChannel, new WifiP2pManager.ActionListener() { ......}); } } ~~~ 上述代码中，WifiP2pSettings通过调用WifiManager的discoverPeers来搜索周围的设备。 当WPAS完成搜索后，WIFI_P2P_PEERS_CHANGED_ACTION广播将被发送。来看WifiP2pSettings中对该广播的处理。 **③、WIFI_P2P_PEERS_CHANGED_ACTION处理流程** 广播事件在onReceive函数中被处理，此函数的代码如下所示。 **WifiP2pSettings.java：：onReceive** ~~~ public class WifiP2pSettings extends SettingsPreferenceFragment implements PersistentGroupInfoListener, GroupInfoListener { ............ private final BroadcastReceiver mReceiver = new BroadcastReceiver() { @Override public void onReceive(Context context, Intent intent) { String action = intent.getAction(); if (WifiP2pManager.WIFI_P2P_STATE_CHANGED_ACTION.equals(action)) { ............... // 如果搜索到新的P2P Device，则WIFI_P2P_PEERS_CHANGED_ACTION将被发送 } else if (WifiP2pManager.WIFI_P2P_PEERS_CHANGED_ACTION.equals(action)) { mPeers = (WifiP2pDeviceList) intent.getParcelableExtra( WifiP2pManager.EXTRA_P2P_DEVICE_LIST); handlePeersChanged(); } else if (WifiP2pManager.WIFI_P2P_CONNECTION_CHANGED_ACTION.equals(action)) { if (mWifiP2pManager == null) return; NetworkInfo networkInfo = (NetworkInfo) intent.getParcelableExtra( WifiP2pManager.EXTRA_NETWORK_INFO); WifiP2pInfo wifip2pinfo = (WifiP2pInfo) intent.getParcelableExtra( WifiP2pManager.EXTRA_WIFI_P2P_INFO); if (mWifiP2pManager != null) { // requestGroupInfo第二个参数的类型是GroupInfoListener，用于返回Group信息 mWifiP2pManager.requestGroupInfo(mChannel, WifiP2pSettings.this); } if (networkInfo.isConnected()) { if (DBG) Log.d(TAG, "Connected"); } else if (mLastGroupFormed != true) { startSearch();// 如果没有加入某个P2P Group，则重新发起设备扫描 } mLastGroupFormed = wifip2pinfo.groupFormed; } else if (WifiP2pManager.WIFI_P2P_THIS_DEVICE_CHANGED_ACTION.equals(action)) { mThisDevice = (WifiP2pDevice) intent.getParcelableExtra( WifiP2pManager.EXTRA_WIFI_P2P_DEVICE); if (DBG) Log.d(TAG, "Update device info: " + mThisDevice); updateDevicePref(); } else if (WifiP2pManager.WIFI_P2P_DISCOVERY_CHANGED_ACTION.equals(action)) { int discoveryState = intent.getIntExtra(WifiP2pManager.EXTRA_DISCOVERY_STATE, WifiP2pManager.WIFI_P2P_DISCOVERY_STOPPED); if (DBG) Log.d(TAG, "Discovery state changed: " + discoveryState); if (discoveryState == WifiP2pManager.WIFI_P2P_DISCOVERY_STARTED) { updateSearchMenu(true);// 更新“SEARCH”按钮显示的名称 } else { updateSearchMenu(false); } } else if (WifiP2pManager.WIFI_P2P_PERSISTENT_GROUPS_CHANGED_ACTION.equals(action)) { if (mWifiP2pManager != null) { mWifiP2pManager.requestPersistentGroupInfo(mChannel, WifiP2pSettings.this); } } } }; ............ } ~~~ 注意，startSearch还将触发系统发送WIFI_P2P_DISCOVERY_CHANGED_ACTION广播，WifiP2pSettings将根据该广播携带的信息来更新"SEARCH"按钮的界面，其规则是：如果P2PDiscovery启动成功（即状态变WIFI_P2P_DISCOVERY_STARTED），则"SEARCH"按钮名显示为"Searching..."，否则该按钮名显示为"Search For Devices"。 当系统搜索到新的P2P Device后，WIFI_P2P_PEERS_CHANGED_ACTION广播将被发送，而WifiP2pSettings对于该广播的处理就是调用WifiP2pManager的requestPeers来获取系统保存的P2P Device信息列表。 前文代码中曾介绍过requestPeers，系统中所有的P2P设备信息将通过PeerListener接口类的onPeersAvailable函数返回给WifiP2pSettings。直接来看该函数，代码如下所示。 **WifiP2pSettings.java：：onPeersAvailable** ~~~ public void onPeersAvailable(WifiP2pDeviceList peers) { // 系统中所有的P2P设备信息都保存在这个类型为WifiP2pDeviceList的peers对象中 mPeersGroup.removeAll();// mPeersGroup类型为PerferenceGroup，属于UI相关的类 mPeers = peers; mConnectedDevices = 0; for (WifiP2pDevice peer: peers.getDeviceList()) { // WifiP2pPeer是Perference的子类，它和UI相关 mPeersGroup.addPreference(new WifiP2pPeer(getActivity(), peer)); if (peer.status == WifiP2pDevice.CONNECTED) mConnectedDevices++; } } ~~~ 在onPeersAvailable函数中，WifiP2pDeviceList中保存的每一个WifiP2pDevice信息将作为一个Preference项添加到mPeersGroup中并显示在UI界面上。 接下来，用户就可在界面中选择某个P2P Device并与之连接。这个步骤由onPreferenceTreeClick函数来完成。 提示　上述代码中提到的WifiP2pDevice等数据结构将放到下文再介绍。 **④、onPreferenceTreeClick函数** onPreferenceTreeClick的代码如下所示。 **WifiP2pSettings.java：：onPreferenceTreeClick** ~~~ public class WifiP2pSettings extends SettingsPreferenceFragment implements PersistentGroupInfoListener, GroupInfoListener { ............ @Override public boolean onPreferenceTreeClick(PreferenceScreen screen, Preference preference) { if (preference instanceof WifiP2pPeer) { mSelectedWifiPeer = (WifiP2pPeer) preference;// 获取用户指定的那一个WifiP2pPeer项 if (mSelectedWifiPeer.device.status == WifiP2pDevice.CONNECTED) { showDialog(DIALOG_DISCONNECT);// 如果已经和该Device连接，则判断是否需要与之断开连接 } else if (mSelectedWifiPeer.device.status == WifiP2pDevice.INVITED) { showDialog(DIALOG_CANCEL_CONNECT); } else {// 向对端P2P设备发起连接 WifiP2pConfig config = new WifiP2pConfig(); config.deviceAddress = mSelectedWifiPeer.device.deviceAddress; // 判断系统是否强制使用了某种WSC配置方法 int forceWps = SystemProperties.getInt("wifidirect.wps", -1); if (forceWps != -1) { config.wps.setup = forceWps; } else { // 获取对端P2P Device支持的WSC配置方法，优先考虑PBC if (mSelectedWifiPeer.device.wpsPbcSupported()) { config.wps.setup = WpsInfo.PBC; } else if (mSelectedWifiPeer.device.wpsKeypadSupported()) { config.wps.setup = WpsInfo.KEYPAD; } else { config.wps.setup = WpsInfo.DISPLAY; } } // 通过WifiP2pManager的connect函数向对端P2P Device发起连接。注意，目标设备 // 信息保存在config对象中 mWifiP2pManager.connect(mChannel, config, new WifiP2pManager.ActionListener() { public void onSuccess() { if (DBG) Log.d(TAG, " connect success"); } public void onFailure(int reason) { Log.e(TAG, " connect fail " + reason); Toast.makeText(getActivity(), R.string.wifi_p2p_failed_connect_message, Toast.LENGTH_SHORT).show(); } }); } } else if (preference instanceof WifiP2pPersistentGroup) { mSelectedGroup = (WifiP2pPersistentGroup) preference; showDialog(DIALOG_DELETE_GROUP); } return super.onPreferenceTreeClick(screen, preference); } .............. } ~~~ **⑤、WIFI_P2P_CONNECTION_CHANGED_ACTION处理流程** 当系统完成和指定P2P Device的连接后，WifiP2pSettings将收到 WIFI_P2P_CONNECTION_CHANGED_ACTION广播，其对应的代码逻辑如下所示。 **WifiP2pSettings.java：：onReceive** ~~~ public class WifiP2pSettings extends SettingsPreferenceFragment implements PersistentGroupInfoListener, GroupInfoListener { ............ private final BroadcastReceiver mReceiver = new BroadcastReceiver() { @Override public void onReceive(Context context, Intent intent) { String action = intent.getAction(); if (WifiP2pManager.WIFI_P2P_STATE_CHANGED_ACTION.equals(action)) { ............... } else if (WifiP2pManager.WIFI_P2P_PEERS_CHANGED_ACTION.equals(action)) { ............... } else if (WifiP2pManager.WIFI_P2P_CONNECTION_CHANGED_ACTION.equals(action)) { if (mWifiP2pManager == null) return; NetworkInfo networkInfo = (NetworkInfo) intent.getParcelableExtra( WifiP2pManager.EXTRA_NETWORK_INFO); WifiP2pInfo wifip2pinfo = (WifiP2pInfo) intent.getParcelableExtra( WifiP2pManager.EXTRA_WIFI_P2P_INFO); if (mWifiP2pManager != null) { // requestGroupInfo第二个参数的类型是GroupInfoListener，用于返回Group信息 mWifiP2pManager.requestGroupInfo(mChannel, WifiP2pSettings.this); } if (networkInfo.isConnected()) { if (DBG) Log.d(TAG, "Connected"); } else if (mLastGroupFormed != true) { startSearch();// 如果没有加入某个P2P Group，则重新发起设备扫描 } mLastGroupFormed = wifip2pinfo.groupFormed; } ................. } }; ............ } ~~~ 当设备加入一个Group后，requestGroupInfo将通过其第二个参数设置的回调函数以返回此Group的信息，这个回调函数由GroupInfoListener接口类定义，WifiP2pSettings只需实现该接口类的onGroupInfoAvailable，相关代码如下所示。 **WifiP2pSettings.java：：onGroupInfoAvailable** ~~~ public void onGroupInfoAvailable(WifiP2pGroup group) { mConnectedGroup = group; // 保存当前所加入的Group的信息 updateDevicePref(); // 更新WifiP2pPeer的界面 } ~~~ 以上是WifiP2pSettings的大体工作流程，读者只要把握几个重要广播的处理流程即可掌握Settings应用中和Wi-Fi P2P相关的知识。 **3、WifiP2pSettings总结** 上述代码中有两个比较重要的数据结构，WifiP2pDevice和WifiP2pGroup，成员比较简单，此处不赘述。它们的类图如图7-23所示。 :-:  图7-23　WifiP2pDevice和WifiP2pGroup类图 通过上面几节的代码可知，WifiP2pSettings将借助WifiP2pManager和系统中的WifiP2pService交互。WifiP2pSettings主要使用WifiP2pManager的几个重要函数。 * **initialize**：初始化WifiP2pManager，其内部将和WifiP2pService通过AsyncChannel建立交互关系。 * **discoverPeers**：触发WifiP2pService发起P2P Device扫描工作。 * **requestPeers**：获取系统中保存的P2P Device信息。 * **connect**：和指定P2P Device发起连接，也就是相互协商以创建或加入一个P2P网络，即一个Group。 * **requestGroupInfo**：获取当前连接上的Group信息。 下面来看WifiP2pService，它是Android系统中P2P功能的Java层核心模块。