android.net.wifi.p2p package API

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 receiverpublic 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 activityIntentFilter intentFilter = new IntentFilter();//只filter和wifi p2p相关的4个intent，即表示只会收到这4个intent的broadcast messageintentFilter.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

更多相关文章

随机推荐