Multipeer Connectivity Framework

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里加入一个显示连接状态的statuslabel，再加入一个发送图片的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:)用于改变statuslabel。

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