JMCiBeaconManager
iBeacon is a name of technology that is enabling new location awareness possibilities for apps. "Leveraging Bluetooth Low Energy (BLE), a device with iBeacon technology can be used to establish a region around an object. This allows an iOS device to determine when it has entered or left the region, along with an estimation of proximity to a beacon."
🔶
An iBeacon Manager library was created to simplify your interactions with iBeacons. In essence it serves several roles:
- Checking the iBeacon permission matrix
- Registering & listening for nearby beacons
- Detecting nearby beacons
- Visualizing nearby beacons in a radar look like custom made user interface.
Example
To run the example project, clone the repo, and run pod install
from the Example directory first.
Installation
CocoaPods
JMCiBeaconManager is available through CocoaPods. To install it, simply add the following line to your Podfile:
pod "JMCiBeaconManager"
Manually
- Download and drop
/JMCiBeaconManager
folder in your project. - Congratulations!
Usage
import JMCiBeaconManager
let beaconManager = JMCBeaconManager()
let kontaktIOBeacon = iBeacon(minor: nil, major: nil, proximityId: "f7826da6-4fa2-4e98-8024-bc5b71e0893e")
let estimoteBeacon = iBeacon(minor: nil, major: nil, proximityId: "B9407F30-F5F8-466E-AFF9-25556B57FE6D")
beaconManager.registerBeacons([kontaktIOBeacon, estimoteBeacon])
NSNotificationCenter.defaultCenter().addObserver(self, selector: #selector(beaconsRanged(_:)), name: iBeaconNotifications.BeaconProximity.rawValue, object: nil)
beaconManager.startMonitoring({
}) { (messages) in
print("Error Messages \(messages)")
}
/**Called when the beacons are ranged*/
func beaconsRanged(notification:NSNotification){
if let visibleIbeacons = notification.object as? [iBeacon]{
for beacon in visibleIbeacons{
/// Do something with the iBeacon
}
}
}
Add the key NSLocationAlwaysUsageDescription
to your project info.plist file.
Authors
Janusz Chudzynski, [email protected]
Felipe N. Brito, [email protected]
Contribute
We would love for you to contribute to JMCiBeaconManager, check the LICENSE
file for more info.
Requirements
- iOS 8.0+
- Xcode 7.3
License
JMCiBeaconManager is available under the BSD
license. See the LICENSE
file for more info.