Android-WifiP2pManager-官方API文档翻译.docx

WifiP2pManagerjava.lang.O.wifi.p2p.WifiP2pManager这个类提供了 API 来管理 Wi-Fi 点对点连接。这使得应用可以发现存在的P2P点、建立与其他P2P点的连接以及搜索获得所有P2P点的名单。当一个通过使用wifi的P2P连接生成时，设备继续保持着在移动或其他任何可用的网络设备上的互联网链接。这个 API 是以异步方式来响应一个应用通过该应用提供的监听回调(listener callbacks)。 在做任何p2p操作前，应用需要使用initialize(Context, Looper, WifiP2pManager.ChannelListener)来做初始化。大部分调用的应用需要WifiP2pManager.ActionListener实例来接收回调onSuccess()oronFailure(int)。这个动作返回了初始化动作是成功还是失败的标识，如果失败，则原因可能是如下三种的其中一种：ERROR , P2P_UNSUPPORTED ,BUSY。应用程序可通过discoverPeers(WifiP2pManager.Channel, WifiP2pManager.ActionListener)来初始化p2p点搜索。应用的一个初始化完成的搜索请求在设备开始连接到一个P2P点、形成一个P2P组或者是一个明确的指令(stopPeerDiscovery(WifiP2pManager.Channel, WifiP2pManager.ActionListener)之前都是保持存活的。 应用程序可以通过监听WIFI_P2P_DISCOVERY_CHANGED_ACTION来知晓一个p2p点对点搜索是在运行还是已经停止。另外，,WIFI_P2P_PEERS_CHANGED_ACTION可表明搜索到的p2p点名单是否已变化。应用程序可通过requestPeers(WifiP2pManager.Channel, WifiP2pManager.PeerListListener)来获取当前搜索到的所有p2p点的名单。通过使用device list配合方法onPeersAvailable(WifiP2pDeviceList)来判断是否存在可见。应用程序通过connect(WifiP2pManager.Channel, WifiP2pConfig, WifiP2pManager.ActionListener)来初始化一个连接到p2p点的请求，详细的配置信息可通过WifiP2pConfig来获取。如果想与传统不支持p2p的设备通信，应用程序可通过createGroup(WifiP2pManager.Channel, WifiP2pManager.ActionListener)创建一个组从而创建一个访问接入点，这个接入点可通过requestGroupInfo(WifiP2pManager.Channel, WifiP2pManager.GroupInfoListener)来获取到。在成功的创建形成一个组后(通过createGroup(WifiP2pManager.Channel, WifiP2pManager.ActionListener)或者connect(WifiP2pManager.Channel, WifiP2pConfig, WifiP2pManager.ActionListener)，可使用requestConnectionInfo(WifiP2pManager.Channel, WifiP2pManager.ConnectionInfoListener)来获取连接信息的详细情况。连接信息WifiP2pInfo中包含了这个组的owner的地址groupOwnerAddress和一个标识了当前设备是否是这个组的owner的标志位isGroupOwner。一个P2P客户端因此可以套接字通信的方式来与组的owner来通信。使用discoverPeers(WifiP2pManager.Channel, WifiP2pManager.ActionListener), 应用可以找到周围的p2p点，但是并没有好的方法找出哪些点可以去建立连接。举例说明，除非是建立了连接，否则一个游戏程序是无法找出周围其他玩同样游戏的点。 预关联搜索服务的目的就是基于运行的服务商来解决这个筛选p2p点问题的。使用预关联搜索服务，应用程序可以先于设备之间的连接建立前给予建议。当前，基于DNS的搜索服务（Bonjour）和Upnp是支持的较高层的协议，可在找到Bonjour资源，在上找到Upnp资源。应用程序可通过调用addLocalService(WifiP2pManager.Channel, WifiP2pServiceInfo, WifiP2pManager.ActionListener)注册一个Upnp或者Bonjour服务。当添加完一个本地的服务后，framwork会在一个p2p连接建立之前自动的响应点搜索服务。调用removeLocalService(WifiP2pManager.Channel, WifiP2pServiceInfo, WifiP2pManager.ActionListener)可以取消一个本地服务，而clearLocalServices(WifiP2pManager.Channel, WifiP2pManager.ActionListener)可以用来清除所有的本地服务。应用程序可以通过调用discoverServices(WifiP2pManager.Channel, WifiP2pManager.ActionListener)来查找那些支持P2P服务的设备，而在初始化搜索之前，应用程序可使用addServiceRequest(WifiP2pManager.Channel, WifiP2pServiceRequest, WifiP2pManager.ActionListener)来添加搜索服务请求，使用removeServiceRequest(WifiP2pManager.Channel, WifiP2pServiceRequest, WifiP2pManager.ActionListener)来清除某个搜索服务请求或者使用clearServiceRequests(WifiP2pManager.Channel, WifiP2pManager.ActionListener)来清除所有的搜索服务请求。而如果没有服务请求保留，那么之前运行的搜索服务将停止。应用程序可以通过用于Bonjour 的setDnsSdResponseListeners(WifiP2pManager.Channel, WifiP2pManager.DnsSdServiceResponseListener, WifiP2pManager.DnsSdTxtRecordListener)或者用于Upnp的setUpnpServiceResponseListener(WifiP2pManager.Channel, WifiP2pManager.UpnpServiceResponseListener)设置监听回调来获得搜索服务请求的结果。注意:使用initialize(Contex