A wrapper for Apple's MultipeerConnectivity framework for offline data transmission between Apple devices. This framework makes it easy to automatically connect to multiple nearby devices and share information using either bluetooth or wifi radios.
Features
- Supports iOS/macOS/tvOS
- Auto Connection
- Auto Invitations/Advertising
- Send/Receive data via MultipeerConnectivity Framework
- Specify data types for easy handling
Integration
CocoaPods
You can use CocoaPods to install MultiPeer by adding it to your Podfile:
pod 'MultiPeer'
Carthage
You can use Carthage to install MultiPeer by adding it to your Cartfile:
github "dingwilson/MultiPeer"
Swift Package Manager
For SPM, add the following to your package dependencies:
.package(url: "https://github.com/dingwilson/MultiPeer.git", .upToNextMinor(from: "0.0.0"))
Usage
To get started, import MultiPeer.
import MultiPeer
Then, simply initialize MultiPeer with the name of your session (serviceType). There are two modes of connections (advertiser and browser). To utilize both, simply use .autoConnect().
MultiPeer.instance.initialize(serviceType: "demo-app")
MultiPeer.instance.autoConnect()
Any data transmitted by MultiPeer will always be accompanied by a numerical "type", to ensure other peers know what kind of data is being received, and how to properly process it. You can manage this by creating a UInt32 enum, as shown below:
enum DataType: UInt32 {
case string = 1
case image = 2
// ...
}
To send data, simply use the .send(object: type:) function:
MultiPeer.instance.send(object: "Hello World!", type: DataType.string.rawValue)
To receive data, we must conform to the MultiPeerDelegate protocol:
func multiPeer(didReceiveData data: Data, ofType type: UInt32, from peerID: MCPeerID) {
switch type {
case DataType.string.rawValue:
let string = data.convert() as! String
// do something with the received string
break
case DataType.image.rawValue:
let image = UIImage(data: data)
// do something with the received UIImage
break
default:
break
}
}
func multiPeer(connectedDevicesChanged devices: [String]) {
}
Ensure that you set the MultiPeer delegate.
MultiPeer.instance.delegate = self
Finally you'll need to enable incoming / outgoing connections in your entitlements.
Congratulations! You have successfully sent data using MultiPeer! For more detailed information (including details of other functions), please see the docs.
Example
For an example app using MultiPeer, checkout MultiPeer_Sample.
License
MultiPeer is released under an MIT License. See LICENSE for details.
Authors
Project heavily inspired by Apple-Signal.
2.1k Jan 8, 2023
412 Dec 19, 2022
5.8k Jan 9, 2023
62 Aug 21, 2022
66 Dec 19, 2022
1.3k Jan 6, 2023
1 Jan 2, 2022
17 Dec 22, 2022
74 Dec 29, 2022
696 Dec 25, 2022
1k Dec 13, 2022
861 Dec 23, 2022
94 Nov 29, 2022
197 Nov 2, 2022
3 Aug 6, 2022
48 Jun 28, 2021
69 Jul 5, 2022
93 Aug 2, 2022
4.3k Jan 6, 2023