ubudu Mesh SDK for iOS allows devices to connect to a Mesh network, in order to create two-way communication.
The following details the steps to add Mesh capability to your iOS app.
To help you further, we're giving you an Example of sample implementation code.
For iBeacon related features:
-
iOS 7.0 or higher (IOS 7.1.2 or iOS 8.0+ recommended).
-
iPhone 4S / iPad 3rd generation / iPad mini / iPod touch 5th generation, or any more recent device.
First of all, you have to prepare your uBeacon Mesh devices, and to setup the Mesh network properties from the ubudu Manager. If you're following the step-by-step instructions in ubudu's Knowledge Base, then you should already have done it. Go straight to the next chapter.
Otherwise:
Once logged in, go to the tab 'Devices', 'Edit' the beacon you want to configure, then you'll reach the Mesh network settings at the bottom of the page. Now, you'll be able to setup :
- The UUID of the Mesh network
- The Mesh network settings
- The beacon ID in the Mesh network
- Indicate if the node is connected to the Internet
Setting up the ubudu Mesh SDK on an iOS native app only takes a few minutes, either using CocoaPods (recommended) or manually.
This is the easiest way to get started. Add to your Podfile the line pod 'UbuduMeshSDK'
, then execute pod install
.
If you are not already using CocoaPods for your project, you can get started by reading the CocoaPods documentation.
If you don't want to use CocoaPods, you can manually install the SDK:
-
Drag & drop the UbuduMeshSDK.framework folder into the "Frameworks" folder of your project in XCode. If needed, check the "Copy items into destination group's folder" option.
-
Add the following list of frameworks and libraries to your project, if not already displayed.
- "Foundation"
- "CoreBluetooth"
-
In your project settings, follow the steps
"General"
>"Your Target"
>"Build Settings"
>"(All)"
>"Other Linker Flags"
. Then, add the flag-ObjC
.
Import the SDK in the header file.
#import <UbuduMeshSDK/UbuduMeshSDK.h>
To use Mesh in your app you need to start the service :UBeaconMeshManager * meshManager
It may done by calling [self.meshManager startScanning]
.
startScanning
method starts the search for enabled Mesh beacons.
To stop searching for Mesh beacons, call the stopScanning
method.
UBUMeshBeaconManagerDelegate
provides callback method which you can implement to receive events from the ubudu Manager:
Implement the method below to receive events relevant to your application :
- (void)meshManager:(UBUMeshBeaconManager *)meshManager didUpdateVisibleAndConnectableNodes:(NSArray *)meshNodes;
meshManager
method callbacks :
meshNodes
: array of objects ofUBUMeshBeacon
class
To send message through a Mesh network, use the following method :
- (void)sendMeshMessage:(NSString *)meshMessage
networkId:(NSUUID *)networkId
toDevice:(uint16_t)address
withConfirmation:(BOOL)confirmation
disconnectImmediatly:(BOOL)disconnect
successBlock:(UBeaconMeshManagerSuccessBlock)successBlock
progressBlock:(UBeaconMeshManagerProgressBlock)progressBlock
failedBlock:(UBeaconMeshManagerFailedBlock)failedBlock;
sendMeshMessage
method parameters:
-
meshMessage is a string containing the Mesh message to be send. It should be no longer than 16 bytes.
-
networkId is a string containing the Mesh network UUID.
meshId
should be part of the network. -
address may be the target Mesh beacon address in decimal format. The value Should be between 1-32767.
sendMeshMessage
method callbacks :
successBlock
indicates whether the message was sent or notprogressBlock
indicates the retries (10times) after a failurefailedBlock
indicates failure to send the message. Failure can be cause by a time out / nearby node not connectable / mesh service missed.
If iOS device is connected to mesh beacon it will be notified about incoming message via the delegate method
- (void)meshManager:(UBUMeshBeaconManager *)meshManager didReceiveMeshData:(NSData *)meshData from:(NSData *)sourceAddress;
- meshData is the package of data received
- sourceAddress is the sender's address