To help you to download JINS MEME SDK and start programming your application(s) which interacts with JINS MEME, the following guidance provides you with the overview of SDK and how it works.
You won't need to understand the specifications of Bluetooth 4.0 completely, yet some specific BLE words are found in this document.
JINS MEME SDK requires CoreBluetooth framework. Please add this framework to your project on XCode.
iOS 8 or later / Objective C
Bluetooth 4.0 (BLE) - This document includes terms specific in BLE.
JINS MEME has two data modes: the Standard Mode where data is transmitted once every minute in a bid to cut back on power consumption; and Real-time Mode where data is sent at a frequency of approximately 20Hz. Please note that the JINS MEME SDK can only be used in Real Time Mode.
In order to develop and distribute a JINS MEME application, you will need to obtain your own App ID and App Secret. Please set up a JINS account, and create your app. Please note that you will need to specify your App ID and App Secret in the MEMELib setAppClientId argument. MEMELib will not operate without authentication.
JINS MEME is designed so that it can be used from multiple apps at the same time. So when developing your app, you need to consider that it will likely be used with other apps at the same time.
When connecting to JINS MEME for the first time, you need to advertise by pressing the JINS MEME button. Please note when you do so, you will be disconnecting JINS MEME from any other apps.
In order to avoid this from happening, the JINS MEME SDK offers a procedure in which it re-connects with other apps that were once disconnected.
If there is already a JINS MEME connected when you run the MemeLib::startScanningPeripherals command, you will immediately get a CBPeripheral object back which shows the connected JINS MEME device(s). Then connect to the appropriate JINS MEME.
The JINS MEME SDK does not allow commands to be run in the background. However, it is possible to receive commands from JINS MEME even if they are in the background. Please note that the SDK is designed in such a way that you may unexpectedly receive execution results for commands that you did not execute.
There will be times during the course of your day when JINS MEME disconnects, such as when you put down the cell phone that is connected to JINS MEME to leave the room momentarily. JINS MEME automatically reconnects when there is an unexpected disconnection so that JINS MEME does not need to be advertised and scanned each time this happens.
As JINS MEME is capable of connecting to multiple applications simultaneously via the SDK, the application is not capable of controlling MEME in the background.