iOS7将GameKit中的蓝牙模块单独出的一个Multipeer Connectivity Framework,通过发现附近的设备用wifi或蓝牙进行p2p连接。
概念和Class结构
- session,比如一个共同的聊天室就可以称为一个session,class为
MCSession
- peerID,
MCPeerID
代表一个session内的设备ID,类似聊天室的ID号 - Advertiser,告诉附近的设备可以加入自己的session进行通讯,class有两个,
MCAdvertiserAssistant
是自动的Adertiser管理类,另一个是MCNearbyServiceAdvertiser
需要自己实现代理方法 - Browser,寻找并加入附近的Advertiser,类似Advertiser也有两个class,
MCNearbyServiceBrowser
同理MCNearbyServiceAdvertiser
,MCBrowserViewController
类似MCAdvertiserAssistant
是一个有默认视图的browser。
实现multipeer有两种方法,比如官方例子使用的是MCAdvertiserAssistant
和MCBrowserViewController
的组合,这种方法的优点是简单,缺点是自带的UI太丑,也不好明白具体的流程,所以本文选择自己实现代理的方法。
session里peer可以同时是advertiser和browser,比如聊天室,每个人都可以发起或者加入。但peer也可以分开做advertiser和browser,这就类似client和server的模式。由于将advertiser和browser写在一个工程会造成混淆,所以我选择第二种模式来实现一个简单的发送照片的demo,一个设备作为发送者拍照之后发送给session里的其他用户。
Adertiser
我决定将发送者作为Adertiser来实现,称为Server。其实作为browser也是可以的。首先创建一个single view的工程,然后在storyboard里加入一个显示连接状态的status
label,再加入一个发送图片的button,并加入对应的IBOutlet(见本文最后的代码)。
完成UI部分之后,首先需要import frameworkimport MultipeerConnectivity
,然后建立Adertiser。
let serviceType: String = "bs-mc"
var peerID: MCPeerID!
var session: MCSession!
var advertiser: MCNearbyServiceAdvertiser!
let displayName = UIDevice.currentDevice().name
self.peerID = MCPeerID(displayName: displayName)
self.session = MCSession(peer: self.peerID)
self.session.delegate = self
self.advertiser = MCNearbyServiceAdvertiser(peer: self.peerID, discoveryInfo: nil, serviceType: self.serviceType)
self.advertiser.delegate = self
self.advertiser.startAdvertisingPeer()
serviceType
用来标识哪些人能加入session,这个字符串不能超过15个字符,横杆最多只能有一个。当有browser申请加入时就会调用下面的代理方法。
func advertiser(advertiser: MCNearbyServiceAdvertiser!, didReceiveInvitationFromPeer peerID:MCPeerID!, withContext context: NSData!, invitationHandler: ((Bool, MCSession!) -> Void)!) {
println("advertiser receive invitation from peer \(peerID.displayName)")
let alertController = UIAlertController(title: "Permission", message: "\(peerID.displayName) wants to know your position", preferredStyle: .Alert)
let okAction = UIAlertAction(title: "OK", style: .Default) { (action) -> Void in
invitationHandler(true, self.session)
}
let noAction = UIAlertAction(title: "NO", style: .Cancel) { (action) -> Void in
invitationHandler(false, nil)
}
alertController.addAction(okAction)
alertController.addAction(noAction)
self.presentViewController(alertController, animated: true, completion: nil)
}
当有browser申请加入session时该方法调用,这里会弹出一个alert,根据选择来回调invitationHandler
并传入对应的值,这样browser就会接收到同意或拒绝。
MCSessionDelegate
的很多方法都是required,但这里只使用了session(_:peer:didChangeState:)
用于改变status
label。
func session(session: MCSession!, peer peerID: MCPeerID!, didChangeState state: MCSessionState) {
switch state {
case .Connected:
dispatch_async(dispatch_get_main_queue(), { () -> Void in
self.status.text = "connected"
})
case .Connecting:
dispatch_async(dispatch_get_main_queue(), { () -> Void in
self.status.text = "connecting..."
})
case .NotConnected:
dispatch_async(dispatch_get_main_queue(), { () -> Void in
self.status.text = "connect fail"
})
default:
println("error")
}
}
Browser
图片的接受者作为Browser去发现Advertiser的session,称为Client。跟创建Advertiser一样,Browser也需要peerID、session。
let serviceType: String = "bs-mc"
var peerID: MCPeerID!
var session: MCSession!
var browser: MCNearbyServiceBrowser!
let displayName = UIDevice.currentDevice().name
self.peerID = MCPeerID(displayName: displayName)
self.session = MCSession(peer: self.peerID)
self.session.delegate = self
self.browser = MCNearbyServiceBrowser(peer: self.peerID, serviceType: self.serviceType)
self.browser.delegate = self
self.browser.startBrowsingForPeers()
serviceType
需要跟advertiser相同,当Browser发现附近的advertiser之后就会调用方法browser(_:foundPeer:withDiscoveryInfo:)
。
func browser(browser: MCNearbyServiceBrowser!, foundPeer peerID: MCPeerID!, withDiscoveryInfo info: [NSObject : AnyObject]!) {
println("browser found peear \(peerID.displayName)")
browser.invitePeer(peerID, toSession: self.session, withContext: nil, timeout: 0)
}
iOS8之后browser会在找到advertiser之后自动申请加入session,可以去掉browser.invitePeer
,详见Choosing an inviter when using Multipeer Connectivity。
数据传输
当Server和Client建立起连接之后就可以互相发送数据了。首先Server拍照,然后将照片作为数据发送出去。
func imagePickerController(picker: UIImagePickerController!, didFinishPickingImage image: UIImage!, editingInfo: [NSObject : AnyObject]!) {
picker.dismissViewControllerAnimated(true, completion: nil)
if let data = UIImagePNGRepresentation(image) {
var error: NSError?
self.session.sendData(data, toPeers: self.session.connectedPeers, withMode: .Unreliable,
error: &error)
}
}
当Client接受到数据后就会调用方法session(_:didReceiveData:fromPeer:)
。
func session(session: MCSession!, didReceiveData data: NSData!, fromPeer peerID: MCPeerID!) {
if let image = UIImage(data: data) {
dispatch_async(dispatch_get_main_queue(), { () -> Void in
self.imageView.image = image
})
}
}
类似的也可以发送流数据和资源文件,startStreamWithName
和sendResourceAtURL
。
Demo代码已放到Github:MultipeerConnectivityDemo