7.3.1 WifiP2pSettings工作流程
最后更新于：2022-04-02 06:05:00
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层核心模块。
';