WiFi模块主要包括三部分:WLAN Station,WiFi Direct, Mobileap(Hotspot)(热点) ,应用主要涉及上网、打印、文件传输、热点共享、远程控制、局域网等方面。
我们所做的应用主要是涉及到了WiFidirect的一些API。所以在其他方面就不多做介绍了。
几乎所有较新的Android手机都支持WLAN直连(WiFidirect)功能,UI层主要有两个入口,其中一个直接进入(WifiP2pSettings),所以这也是我们为什么要开发这个软件的原因之一。
搜索显示出的每一个设备,实际上都被封装成了一个个Preference对象。
Wi-Fi 直连技术允许已经配备了相应硬件并预装了Android 4.0(API level 14)或更后的操作系统的设备在不需要Wi-Fi中间热点的支持下通过Wi-Fi直接互联的技术。使用这些API,你可以发现和连接其他支持此技术的设备,然后以距离远超蓝牙连接技术且速度更快的方式进行通信。这项技术对于一些多用户共享资料,比如多用户联机游戏或者相片分享等应用非常有用。
Wi-Fi直连技术的API包含以下主要部分:
允许用户发现,请求然后连接对等设备的各种方法,定义在WifiP2pManager类中。
允许用户定义收到调用WifiP2pManager类中方法成功或失败的通知的监听器。当用户调用WifiP2pManager类中的方法时,每一个方法都可以收到一个以参数形式传过来的特定监听。
通知用户被Wi-Fi直连技术框架检测到的特定事件的意图,比如一个已丢掉的连接或者一个新的对等设备的发现等。
你经常会同时使用这三个主要组件的相关功能。例如,你可以为去调用android.net.wifi.p2p.WifiP2pManager.ActionListener) discoverPeers()方法而提供一个WifiP2pManager.ActionListener的监听器,这样以后你可以收到一个ActionListener.onSuccess()或者ActionListener.onFailure()方法的通知。一个WIFI_P2P_PEERS_CHANGED_ACTION意图同时也是当android.net.wifi.p2p.WifiP2pManager.ActionListener) discoverPeers()方法发现的对等设备列表发生改变时的一个广播。
WifiP2pManager类提供了很多方法允许用户通过设备的Wi-Fi模块来进行交互,比如做一些如发现,连接其他对等设备的事情。下列的方法都是可以使用的: 表格1.Wi-Fi直连技术方法
方法名 |
详细描述 |
initialize() |
通过Wi-Fi框架对应用来进行注册。这个方法必须在任何其他Wi-Fi直连方法使用之前调用。 |
connect()] |
开始一个拥有特定设置的设备的点对点连接。 |
cancelConnect() |
取消任何一个正在进行的点对点组的连接。 |
requestConnectInfo() |
获取一个设备的连接信息。 |
createGroup() |
以当前设备为组拥有者来创建一个点对点连接组。 |
removeGroup() |
移除当前的点对点连接组。 |
requestGroupInfo() |
获取点对点连接组的信息。 |
discoverPeers() |
初始化对等设备的发现。 |
requestPeers() |
获取当前发现的对等设备列表。 |
WifiP2pManager的方法可以让你在一个监听器里传递参数,这样Wi-fi直连框架就可以通知给你的窗体这个方法调用的状态。可以被使用的监听器接口和使用监听器的相应的WifiP2pManager的方法的调用都将在下面这张表中有所描述:
表格 2. Wi-Fi直连监听器方法
监听器接口 |
相关联的方法 |
WifiP2pManager.ActionListener |
connect(), cancelConnect(), createGroup(), removeGroup(), and discoverPeers() |
WifiP2pManager.ChannelListener |
initialize() |
WifiP2pManager.ConnectionInfoListener |
requestConnectInfo() |
WifiP2pManager.GroupInfoListener |
requestGroupInfo() |
WifiP2pManager.PeerListListener |
requestPeers() |
Wi-Fi直连技术的API定义了一些当特定的Wi-Fi直连事件发生时作为广播的意图,比如说当一个新的对等设备被发现,或者一个设备的Wi-Fi状态的改变。你可以在你的应用里通过创建一个处理这些意图的广播接收器来注册去接收这些意图。
Table 3. Wi-Fi 直连意图
意图名称 |
详细描述 |
WIFI_P2P_CONNECTION_CHANGED_ACTION |
当设备的Wi-Fi连接信息状态改变时候进行广播。 |
WIFI_P2P_PEERS_CHANGED_ACTION |
当调用discoverPeers()方法的时候进行广播。在你的应用里处理此意图时,你通常会调用requestPeers()去获得对等设备列表的更新。 |
WIFI_P2P_STATE_CHANGED_ACTION |
当设备的Wi-Fi 直连功能打开或关闭时进行广播。 |
WIFI_P2P_THIS_DEVICE_CHANGED_ACTION |
当设备的详细信息改变的时候进行广播,比如设备的名称 |
一个广播接收器允许你接收由android系统发布的意图广播,这样你的应用就可以对那些你感兴趣的事件作出响应。创建一个基本的Wi-Fi直连意图使用的广播接收器的步骤如下:
1.创建一个继承自BroadcastReceiver的类。对于类的构造,一般最常用的就是以WifiP2pManager, WifiP2pManager.Channel作为参数,同时这个广播接收器对应的窗体也将被注册进来。这个广播接收器可以像窗体发送更新或者在需要的时候可以访问Wi-Fi硬件或通信通道。
2.在广播接收器里,处理onReceive()方法里你感兴趣的意图。执行接收到的意图的任何需要的动作。比如,广播接收器接收到一个WIFI_P2P_PEERS_CHANGED_ACTION的意图,你就要调用requestPeers()方法去获得当前发现的对等设备列表。
创建一个Wi-Fi直连的应用包括创建和注册一个广播接收器,发现其他设备,连接其他设备,然后传输数据等步骤。接下来的几个部分描述了怎么去做这些工作。
在使用Wi-Fi直连的API之前,你必须确保你的应用可以访问设备的硬件并且你的设备要支持Wi-Fi直连的通讯协议。如果Wi-Fi直连技术是支持的,你可以获得一个WifiP2pManager的实例对象,然后创建并注册你的广播接收器,然后开始使用Wi-Fi直连的API方法。
1.为设备的Wi-Fi硬件获取权限并在Android的清单文件中声明你的应用正确使用的最低SDK版本:
2.检查设备是否支持Wi-Fi直连技术。一种好的解决办法是当你的广播接收器接收到一个WIFI_P2P_STATE_CHANGED_ACTION意图。通知你的窗体Wi-Fi直连的状态和相应的反应。
3.在你的窗体的onCreate()方法里,获得一个WifiP2pManager的实例并调用initialize()方法通过Wi-Fi直连框架去注册你的应用。这个方法返回一个WifiP2pManager.Channel对象,是被用来连接你的应用和Wi-Fi直连框架的。你应该再创建一个以WifiP2pManager和WifiP2pManager.Channel为参数且关联你的窗体的广播接收器的实例。这样你的广播接收器就可以接收到你感兴趣的事件去通知你的窗体并更新它。它还可以让你在需要的时候操纵设备的Wi-Fi状态。
4.创建一个意图过滤器并把它添加在你的广播接收器需要处理的意图上。
5.注册你的广播接收器在窗体的onResume()方法,解除注册在onPause()方法中。
6.当你获取到一个WifiP2pManager.Channel对象并且设置好你的广播接收器时,你的应用就可以调用Wi-Fi直连的方法并且可以接收Wi-Fi直连的意图。
你可以现在就通过调用WifiP2pManager中的方法取实现你的应用体验Wi-Fi直连技术的特性了。下面的章节描述了怎样去实现一些常用的操作,比如说发现其他设备和连接它们。
要发现可以使用并连接的对等设备,调用discoverPeers()方法去检测在范围内的可使用设备。这个方法的调用是异步的同时如果你创建了一个WifiP2pManager.ActionListener监听器的话你会通过onSuccess()或者onFailure()方法收到发现成功或失败的消息。onSuccess()方法只能通知你发现的过程是否成功而不能提供任何关于发现设备的信息:
如果发现过程成功且检测到了对等设备,系统将会广播出一个WIFI_P2P_PEERS_CHANGED_ACTION意图,这样你就可以利用广播监听器监听并获得发现设备的列表。当你的应用接收到WIFI_P2P_PEERS_CHANGED_ACTION意图时,你就可以调用requestPeers()方法来获取发现设备的列表
当你已经找到你要连接的设备在获得发现设备列表之后,调用connect()方法去连接指定设备。这个方法的调用需要一个包含待连接设备信息的WifiP2pConfig对象。你可以通过WifiP2pManager.ActionListener接收到连接是否成功的通知。下面的代码展示了怎样去连接一个想得到的连接:
一旦连接已经建立,你可以通过套接字来进行数据的传输。基本的数据传输步骤如下:
1.创建一个ServerSocket对象。这个服务端套接字对象等待一个来自指定地址和端口的客户端的连接且阻塞线程直到连接发生,所以把它建立在一个后台线程里。
2.创建一个客户端Socket.这个客户端套接字对象使用指定ip地址和端口去连接服务端设备。
3.从客户端给服务端发送数据。当客户端成功连接服务端设备后,你可以通过字节流从客户端给服务端发送数据。
4.服务端等待客户端的连接(使用accept()方法)。这个调用阻塞服务端线程直到客户端连接上,所以叫这个过程一个新的线程。当连接建立时,服务端就可以接受来自客户端的数据。