WifiP2pManager
java.lang.Object
android.net.wifi.p2p.WifiP2pManager ? 这个类提供了 API 来管理 Wi-Fi 点对点连接。这使得应用可以发现存在的P2P点、建立与其他P2P点的连接以及搜索获得所有P2P点的名单。当一个通过使用wifi的P2P连接生成时，设备继续保持着在移动或其他任何可用的网络设备上的互联网链接。 这个 API 是以异步方式来响应一个应用通过该应用提供的监听回调(listener callbacks)。 在做任何p2p操作前，应用需要使用 initialize(Context, Looper, WifiP2pManager.ChannelListener) 来做初始化。 大部分调用的应用需要 WifiP2pManager.ActionListener 实例来接收回调 onSuccess() or onFailure(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是支持的较高层的协议，可在dns-sd.org找到Bonjour资源，在upnp.org上找到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(Context, Looper,
WifiP2pManager.ChannelListener) 需要注册权限
ACCESS_WIFI_STATE 和 CHANGE_WIFI_STATE 从而来完成更多的操作。可通过调用Context.getSystemService(Context.WIFI_P2P_SERVICE) 来获取这个类的实例。
相关推荐：
loading