android.net.wifi.p2p package API

2024-04-19 22:32
文章标签 android wifi api net package p2p

本文主要是介绍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 directSamsung Nexus是第一部符合条件的手机。

 


package最重要的classWifiP2pManager,用它主要做下列事情:

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,创建groupget group info(见下面)

 

Listeners

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

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

 

listener2callback方法onSuccess” and “onFailure(int)”,分别作为success and failurecallback

 

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

 

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

 

listener1个方法onChannelDisconnected(),作为wifi directchannel disconnect时的callback

 

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

 

listener1个方法onPeersAvailable(WifiP2pDeviceList peers)作为当调用requestPeers来获取peer list成功时的callback.

 

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

 

listener1个方法onConnectionInfoAvailable(WifiP2pInfo info),作为当调用requestConnectionInfo来获取requestedconnection info成功时的callback.

 

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

 

listener1个方法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 channelWifiManager的其他方法在调用时都会用该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,有下面4event/intentnotification我们需要在自定义的wifi direct broadcastReceiver里接收注意,这4event/intent是定义在WifiP2pManager class

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

 

l WIFI_P2P_STATE_CHANGED_ACTION:接收到的消息/意图是Wi-Fi p2pstate发生变化。State2种:enable and disable

 

l WIFI_P2P_CONNECTION_CHANGED_ACTION:接收到的消息/意图是Wi-Fi p2pconnectivitystate发生改变. 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方法!!@Overridepublic 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 Stateif (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 stateif (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

 

 

 

 

 

这篇关于android.net.wifi.p2p package API的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/918615

相关文章

Android实现在线预览office文档的示例详解

《Android实现在线预览office文档的示例详解》在移动端展示在线Office文档(如Word、Excel、PPT)是一项常见需求,这篇文章为大家重点介绍了两种方案的实现方法,希望对大家有一定的... 目录一、项目概述二、相关技术知识三、实现思路3.1 方案一:WebView + Office Onl

Android实现两台手机屏幕共享和远程控制功能

《Android实现两台手机屏幕共享和远程控制功能》在远程协助、在线教学、技术支持等多种场景下,实时获得另一部移动设备的屏幕画面,并对其进行操作,具有极高的应用价值,本项目旨在实现两台Android手... 目录一、项目概述二、相关知识2.1 MediaProjection API2.2 Socket 网络

Android实现悬浮按钮功能

《Android实现悬浮按钮功能》在很多场景中,我们希望在应用或系统任意界面上都能看到一个小的“悬浮按钮”(FloatingButton),用来快速启动工具、展示未读信息或快捷操作,所以本文给大家介绍... 目录一、项目概述二、相关技术知识三、实现思路四、整合代码4.1 Java 代码(MainActivi

Android Mainline基础简介

《AndroidMainline基础简介》AndroidMainline是通过模块化更新Android核心组件的框架,可能提高安全性,本文给大家介绍AndroidMainline基础简介,感兴趣的朋... 目录关键要点什么是 android Mainline?Android Mainline 的工作原理关键

如何解决idea的Module:‘:app‘platform‘android-32‘not found.问题

《如何解决idea的Module:‘:app‘platform‘android-32‘notfound.问题》:本文主要介绍如何解决idea的Module:‘:app‘platform‘andr... 目录idea的Module:‘:app‘pwww.chinasem.cnlatform‘android-32

springboot项目中常用的工具类和api详解

《springboot项目中常用的工具类和api详解》在SpringBoot项目中,开发者通常会依赖一些工具类和API来简化开发、提高效率,以下是一些常用的工具类及其典型应用场景,涵盖Spring原生... 目录1. Spring Framework 自带工具类(1) StringUtils(2) Coll

Android实现打开本地pdf文件的两种方式

《Android实现打开本地pdf文件的两种方式》在现代应用中,PDF格式因其跨平台、稳定性好、展示内容一致等特点,在Android平台上,如何高效地打开本地PDF文件,不仅关系到用户体验,也直接影响... 目录一、项目概述二、相关知识2.1 PDF文件基本概述2.2 android 文件访问与存储权限2.

Android Studio 配置国内镜像源的实现步骤

《AndroidStudio配置国内镜像源的实现步骤》本文主要介绍了AndroidStudio配置国内镜像源的实现步骤,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,... 目录一、修改 hosts,解决 SDK 下载失败的问题二、修改 gradle 地址,解决 gradle

在Android平台上实现消息推送功能

《在Android平台上实现消息推送功能》随着移动互联网应用的飞速发展,消息推送已成为移动应用中不可或缺的功能,在Android平台上,实现消息推送涉及到服务端的消息发送、客户端的消息接收、通知渠道(... 目录一、项目概述二、相关知识介绍2.1 消息推送的基本原理2.2 Firebase Cloud Me

Android中Dialog的使用详解

《Android中Dialog的使用详解》Dialog(对话框)是Android中常用的UI组件,用于临时显示重要信息或获取用户输入,本文给大家介绍Android中Dialog的使用,感兴趣的朋友一起... 目录android中Dialog的使用详解1. 基本Dialog类型1.1 AlertDialog(