cordova-plugin-boni

http://boni.io

Overview

The BONI platform provides a complete backend solution for your mobile application that facilitate the interaction with Bluetooth Low Energy Beacons (iBeacons).

Once you install the BONI SDK, your mobile app will be able to detect Bluetooth Low Energy Beacons. Once the beacon has been detected, the BONI SDK gets the payload that receive from it and send it to BONI Server that exchange the beacon payload for predefined content and send it back to the mobile app.

BONI SDK is the Content gateway for your mobile app. It takes care about iBeacon detection and delivering of appropreate Content.

BONI Console is a lightweight Content Management System that helps you to organize your BONI Content and map it to BONI Spot.

Our goal is to enable developers to start create smarter mobile apps with no need for writing server code or maintaining servers.

Our SDK is ready to use out of the box with minimal configuration on your part.

Supported Platforms

• Android
• iOS

Installation

As a Cordova plugin, BONI SDK can be installed with the next command:

Latest Stable Version:
cordova plugin add cordova-plugin-boni

Development Version:
cordova plugin add https://github.com/BONI-hub/cordova-plugin-boni.git

See also:

• Add Plugins

Sample

onDeviceReady: function() {
  app.receivedEvent('deviceready');

  cordova.plugins.boni.configure({
    uuid: ['your-ibeacon-uuid']
  });

  cordova.plugins.boni.ranging();

  cordova.plugins.boni.onAlwaysForSpot(function(error, beacons) {
    console.log("Always");
    document.body.style.background = "purple";
  });
  cordova.plugins.boni.onImmediateToSpot(function(error,beacons) {
      console.log("Immediate");
      document.body.style.background = "green";
  });
  cordova.plugins.boni.onNearToSpot(function(error, beacons) {
      console.log("NEAR");
      document.body.style.background = "red";
  });
  cordova.plugins.boni.onFarFromSpot(function(error, beacons) {
      console.log("FAR");
      document.body.style.background = "blue";
  });
}

Each calback functions will receive error and content agruments. The content object looks like:

[ 
    {
        "name": "Content Name",
        "description": "Content Description",
        "data": {
            "url": "https://my.content.com",
            "imageUrl": "http://image.content.com"
        },
        "type": "website",
        "spotId": "462b9890-0663-11e6-b26c-a90549403799",
        "createdAt": "2016-04-20T09:29:09.607Z",
        "modifiedAt": "2016-06-13T16:49:19.302Z",
        "id": "55f3ff70-06da-11e6-9ad6-0fee46c4b16f"
    },

    ...
]

Bare in mind that the content is array of content items that are pinned up to the particular spot.

See also:

• Documentation