android.net.wifi.p2p package API

最新推荐文章于 2024-05-07 20:22:01 发布

totogogo

最新推荐文章于 2024-05-07 20:22:01 发布

阅读量7.6k

点赞数

分类专栏： Google Mobile Android 文章标签： api p2p action callback manager list

本文链接：https://blog.csdn.net/totogogo/article/details/7188152

版权

Mobile 同时被 3 个专栏收录

150 篇文章 1 订阅

订阅专栏

Android

36 篇文章 0 订阅

订阅专栏

Google

18 篇文章 0 订阅

订阅专栏

ref links:

api document: http://developer.android.com/reference/android/net/wifi/p2p/package-summary.html

demo: http://developer.android.com/resources/samples/WiFiDirectDemo/index.html

Overview

该API package是用于create connection with wifi direct协议(http://en.wikipedia.org/wiki/Wi-Fi_Direct)

使用该API，必须是android 4.0 (level 14) or later，而且支持wifi direct。Samsung Nexus是第一部符合条件的手机。

该package最重要的class是WifiP2pManager，用它主要做下列事情：

1. Initialize your application for P2P connectionsby calling initialize()

2. Discover nearby devices by calling discoverPeers() and requestPeers()

3. Start a P2P connection by calling connect()

4. 还有其他功能：如disconnect P2P connection,获取connection info，创建group和get group info（见下面）

Listeners

该package几乎全部都是使用异步消息机制，因此你需要implement下面listener interfaces。

1. WifiP2pManager.ActionListener: WifiP2pManager的5个方法(cancelConnect, connect, createGroup, discoverPeers,removeGroup)都要用该listener作为参数 for receiving callback。

该listener有2个callback方法“onSuccess” and “onFailure(int)”，分别作为success and failure的callback。

onFailure(int)的参数值有3个：ERROR,P2P_UNSUPPORTED or BUSY

2. WifiP2pManager.ChannelListener: WifiP2pManager的initialize方法用该listener作为参数 for receivingcallback.

该listener有1个方法“onChannelDisconnected()”，作为wifi directchannel disconnect时的callback

3. WifiP2pManager.PeerListListener: WifiP2pManager的requestPeers方法用该listener作为参数 for receivingcallback.

该listener有1个方法“onPeersAvailable(WifiP2pDeviceList peers)”，作为当调用requestPeers来获取peer list成功时的callback.

4. WifiP2pManager.ConnectionInfoListener: WifiP2pManager的requestConnectionInfo方法用该listener作为参数 for receivingcallback.

该listener有1个方法“onConnectionInfoAvailable(WifiP2pInfo info)”，作为当调用requestConnectionInfo来获取requestedconnection info成功时的callback.

5. WifiP2pManager.GroupInfoListener: WifiP2pManager的requestGroupInfo方法用该listener作为参数 for receivingcallback.

该listener有1个方法“onGroupInfoAvailable(WifiP2pGroupgroup)”，作为当调用requestGroupInfo来获取requested group info成功时的callback.

WifiP2pManagerclass

关键方法：

l initialize(Context srcContext, Looper srcLooper,WifiP2pManager.ChannelListener listener)

用来initialize wifi，把本android app注册到wifi framwork里，并返回wifi frameworkchannel。在调用其他方法之前必须首先调用它

该方法的返回值是一个WifiP2pManager.Channelobject，它表示wifi framework channel。WifiManager的其他方法在调用时都会用该channel作为参数！

l discoverPeers(WifiP2pManager.Channel c, WifiP2pManager.ActionListener listener)

Initiate peerdiscovery.调用该方法会scan for available Wi-Fi peers。

The functioncall immediately returns after sending a discovery request to the framework，因为是异步消息机制. The application is notified of a success or failure to initiatediscovery through listener callbacks onSuccess() or onFailure(int).

The discoveryremains active until a connection is initiated or a p2p group is formed. Register for WIFI_P2P_PEERS_CHANGED_ACTION intent to determinewhen the framework notifies of a change as peers are discovered.

在收到WIFI_P2P_PEERS_CHANGED_ACTIONintent后，你就可以调用requestPeers(WifiP2pManager.Channel,WifiP2pManager.PeerListListener)来获取peer list!!

l requestPeers(WifiP2pManager.Channel c, WifiP2pManager.PeerListListener listener)

sendrequest to获取current list of peers。返回的peer list要在参数PeerListListener里的onPeersAvailable(WifiP2pDeviceList peers)方法里获取

l connect (WifiP2pManager.Channel c, WifiP2pConfig config,WifiP2pManager.ActionListener listener)

建立p2pconnection to a device with the specified configuration。

Theapplication is notified of a success or failure to initiate connect throughlistener callbacks onSuccess() or onFailure(int).

Register for WIFI_P2P_CONNECTION_CHANGED_ACTION intent todetermine when the framework notifies of a change in connectivity.

If the currentdevice is not part of a p2p group, a connect request initiates a groupnegotiation with the peer.

If thecurrent device is part of an existing p2p group or has created a p2p group withcreateGroup(WifiP2pManager.Channel, WifiP2pManager.ActionListener), aninvitation to join the group is sent to the peer device.

l requestConnectionInfo(WifiP2pManager.Channel c, WifiP2pManager.ConnectionInfoListenerlistener)

sendrequest to获取currentconnection info。返回的connection info要在参数ConnectionInfoListener里的onConnectionInfoAvailable(WifiP2pInfo info)方法里获取。

l cancelConnect(WifiP2pManager.Channel c, WifiP2pManager.ActionListener listener)

disconnect current connection

l createGroup(WifiP2pManager.Channel c, WifiP2pManager.ActionListener listener)

Create a p2p groupwith the current device as the group owner.This essentially creates an access point that can acceptconnections from legacy clients as well as other p2p devices.

Note: This function would normally not be used unless thecurrent device needs to form a p2p connection with a legacy client

Forcommunication with legacy Wi-Fi devices that do not support p2p, an app cancreate a group usingcreateGroup(WifiP2pManager.Channel, WifiP2pManager.ActionListener)which creates an access point whose details can be fetched withrequestGroupInfo(WifiP2pManager.Channel,WifiP2pManager.GroupInfoListener).

l requestGroupInfo(WifiP2pManager.Channel c, WifiP2pManager.GroupInfoListenerlistener)

l removeGroup(WifiP2pManager.Channel c, WifiP2pManager.ActionListener listener)

Wifi Direct BroadcastReceiver

APP要自己定义一个wifi direct broadcastReceiver (extends android.content.BroadcastReceiver)，并register it。该receiver用来接收来自wifi framework的消息/意图通知 (event/intent notification)。

对于wifi direct p2p，有下面4个event/intentnotification我们需要在自定义的wifi direct broadcastReceiver里接收。注意，这4个event/intent是定义在WifiP2pManager class。

l WIFI_P2P_PEERS_CHANGED_ACTION：接收到的消息/意图是available peerlist发生了变化。

l WIFI_P2P_STATE_CHANGED_ACTION：接收到的消息/意图是Wi-Fi p2p的state发生变化。State有2种：enable and disable

l WIFI_P2P_CONNECTION_CHANGED_ACTION：接收到的消息/意图是Wi-Fi p2pconnectivity的state发生改变. State应该是connected and disconnected

l WIFI_P2P_THIS_DEVICE_CHANGED_ACTION：接收到的消息/意图是正连接的device发生变化。

下面是define and register custom wifi direct broadcastreceiver的最简单例子：

//定义custom wifi direct broadcast receiver
public class WiFiDirectBroadcastReceiver extends BroadcastReceiver {

    private WifiP2pManager manager;
    private Channel channel;

    public WiFiDirectBroadcastReceiver(WifiP2pManager manager, Channel channel) {
        super();
        this.manager = manager;
        this.channel = channel;
    }
    
    //当wifi framework broadcast 相关的intent时，就会callback 该onReceive方法!!
    @Override
    public void onReceive(Context context, Intent intent) {
        String action = intent.getAction();  //获取意图

        if (WifiP2pManager.WIFI_P2P_STATE_CHANGED_ACTION.equals(action)) { //意图为WIFI P2P State发生变化
            int state = intent.getIntExtra(WifiP2pManager.EXTRA_WIFI_STATE, -1); //get WIFI P2P State

            if (state == WifiP2pManager.WIFI_P2P_STATE_ENABLED) { //WIFI P2P State为enable
		...
            } else { //WIFI P2P State为disable
		...
            }

        } else if (WifiP2pManager.WIFI_P2P_PEERS_CHANGED_ACTION.equals(action)) { //意图为WIFI P2P current peer list发生变化
            if (manager != null) {
                manager.requestPeers(channel, peerListListener);  //send request to get current peers list
            }
        } else if (WifiP2pManager.WIFI_P2P_CONNECTION_CHANGED_ACTION.equals(action)) { //意图为WIFI P2P connection state发生变化
            if (manager == null) {
                return;
            }
            NetworkInfo networkInfo = (NetworkInfo) intent
                    .getParcelableExtra(WifiP2pManager.EXTRA_NETWORK_INFO);  //获取wifi p2p connection state

            if (networkInfo.isConnected()) { //WIFI P2P connection state is "connected"
                manager.requestConnectionInfo(channel, connectionInfoListener);
            } else { //WIFI P2P connection state is "disconnected"
		...
            }
        } else if (WifiP2pManager.WIFI_P2P_THIS_DEVICE_CHANGED_ACTION.equals(action)) { //意图为正连接的device发生变化发生变化
            WifiP2pDevice device=((WifiP2pDevice) intent.getParcelableExtra(
                    WifiP2pManager.EXTRA_WIFI_P2P_DEVICE));  //获取正连接的device
	    ....

        }
    }
}

//Register custom wifi direct broadcast receiver in your app activity
IntentFilter intentFilter = new IntentFilter();
//只filter和wifi p2p相关的4个intent，即表示只会收到这4个intent的broadcast message
intentFilter.addAction(WifiP2pManager.WIFI_P2P_STATE_CHANGED_ACTION);
intentFilter.addAction(WifiP2pManager.WIFI_P2P_PEERS_CHANGED_ACTION);
intentFilter.addAction(WifiP2pManager.WIFI_P2P_CONNECTION_CHANGED_ACTION);
intentFilter.addAction(WifiP2pManager.WIFI_P2P_THIS_DEVICE_CHANGED_ACTION);

WiFiDirectBroadcastReceiver receiver = new WiFiDirectBroadcastReceiver(manager, channel);
//register broadcast receiver        
registerReceiver(receiver, intentFilter);

Simple Flow