Nodle SDK - iOS API and Configuration
The SDK receives configuration remotely from Nodle servers as well as statically using API calls. The static configuration always takes precedence over the remote configuration.
Nodle SDK Api
To interact with the SDK you need to call the Nodle.sharedInstance
method that will give you an Instance of the INodle class. The following are all the public methods for the Nodle API.
start
public fun
start(public_key:
String
)
Immediately starts the Nodle SDK
Example:
isStarted
public fun
isStarted():
Boolean
Checks if the Nodle SDK is started
Example:
isScanning
public fun
isScanning():
Boolean
Checks if the Nodle SDK is currently scanning the BLE neighborhood. This is useful if you want to show that the SDK is working.
Example:
stop
public fun
stop()
Immediately stops the Nodle SDK
Example:
clear
public fun
clear()
Clear any configs by Nodle SDK
Example:
getVersion
public fun
getVersion():
String
Get the version identifier of the Nodle SDK.
Example:
getEvents
public fun
getEvents():
NodleEvent
Get the raw bluetooth events from the Nodle SDK with the following type:
Example of available return event classes below:
Example:
The following data can be collected from the NodleEventType
:
The following data can be collected from the NodleBluetoothScanRecord
:
The following data can be collected from the NodleBluetoothEvent
:
The following data can be collected from the NodleBeaconScanRecord
:
The following data can be collected from the NodleBeaconEvent
:
The table shows rational range for the beacon devices that are found:
registerNodleBackgroundTask
public fun
registerNodleBackgroundTask()
Register the Nodle SDK background task
Example:
scheduleNodleBackgroundTask
public fun
scheduleNodleBackgroundTask()
Schedules the Nodle SDK background task
Example:
config
public fun
config(path: Path)
public fun <T>
config(key:
String,
value:
T
)
configure the SDK either by supplying a json file located in ../config.json
or by directly configuring a key. An example of a json configuration look like this:
the following are the table of all the keys available and their description:
there is another table that will allow you to configure our SDK background modes. There are 4 available modes: NONE, ECO, NORMAL, AGGRESSIVE for the NodleSDK please check them in the table below:
Example:
Last updated