Wi-Fi Peer-to-Peer API
在上一篇对 **Wi-Fi Peer-to-Peer **进行初步了解之后，这一篇我们来看看 Android Wi-Fi Peer-to-Peer Application 创建过程。
为此，我们先了解API
Wi-Fi P2P API 主要由以下3个重要部分组成
1.Methods 方法，有发现对等设备，请求对等设备，连接对等设备的方法
2.Listeners 监听器，Methods中的方法都将接受一个监听器作为参数，允许你监听各个方法的调用成功或失败。这些方法都是异步调用的
3.Intents 意图，由Wi-Fi P2P framework通过指定的事件通知你，例如 断开连接或发现新的对等设备
整个过程都是这三个组建的配合使用。
举个例子：我们调用discoverPeers()发现对等设备时，我们需要给他(discoverPeers())提供一个监听器 WifiP2pManager.ActionListener，当discoverPeers()调用成功时监听器的onSuccess()方法会被回调,同理失败时onFailure()方法会被回调。当discoverPeers()发现对等设备列表发生变化时Wi-Fi P2P framework的WIFI_P2P_PEERS_CHANGED_ACTION意图会被广播
我们来看看API详细介绍，然后这些模糊概念会清楚很多
API Overview
Table 1 Wi-Fi P2P Methods
| Method | Description |
|---|---|
initialize() |
Registers the application with the Wi-Fi framework. This must be called before calling any other Wi-Fi P2P method. |
connect() |
Starts a peer-to-peer connection with a device with the specified configuration. |
cancelConnect() |
Cancels any ongoing peer-to-peer group negotiation. |
requestConnectInfo() |
Requests a device's connection information. |
createGroup() |
Creates a peer-to-peer group with the current device as the group owner |
removeGroup() |
Removes the current peer-to-peer group. |
requestGroupInfo() |
Requests peer-to-peer group information. |
discoverPeers() |
Initiates peer discovery |
requestPeers() |
Requests the current list of discovered peers. |
Table 2 Wi-Fi P2P Listeners
| Listener Interface | Associated Action |
|---|---|
WifiP2pManager.ActionListener |
connect(),cancelConnect(),createGroup(),removeGroup(),discoverPeers()
|
WifiP2pManager.ChannelListener |
initialize() |
WifiP2pManager.ConnectionInfoListener |
requestConnectInfo() |
WifiP2pManager.GroupInfoListener |
requestGroupInfo() |
WifiP2pManager.PeerListListener |
requestPeers() |
Table 3 Wi-Fi P2P Intents
| Intent | Description |
|---|---|
WIFI_P2P_CONNECTION_CHANGED_ACTION |
Broadcast when the state of the device's Wi-Fi connection changes. |
WIFI_P2P_PEERS_CHANGED_ACTION |
Broadcast when you call discoverPeers(),you usually want to call requestPeers() to get an updated list of peers if you handle this intent in your application |
WIFI_P2P_STATE_CHANGED_ACTION |
Broadcast when Wi-Fi P2P is enabled or disabled on the device |
WIFI_P2P_THIS_DEVICE_CHANGED_ACTION |
Broadcast when a device's detail have changed,such as the device's name |
使用的API不多，也很容易理解。
我测试连接2部手机，测试成功了。
但是由于今天有急事，代码部分留到第三部分，这一部分就算是对API进行了解，各位同学请见谅O(∩_∩)O。
我们第三部分见ヾ(￣▽￣)ByeBye
