Cordova iBeacon

一.前言

现在app有个需求，当用户进入到某一领域，如果监测到用户在这一范围内，则发送相应的信息给用户，用户再根据这些信息进一步操作，其中涉及到的2点，一个是位置，另一个就是监测，那么这个时候就可以用到苹果的ibeacon来解决，下面对ibeacon进行详细介绍。

二.iBeacon介绍

iBeacon的官方文档
iBeacon是Apple在2013年iOS7推出的新功能。配备有低功耗蓝牙通信功能的设备使用BLE技术向四周发送自己的uuid，接收到该uuid的application可以根据uuid进行相应的操作。
简单讲，就是iBeacon发送信号，配备有低功耗蓝牙通信功能iOS设备在一定范围内监测到信号，反馈信号。
iBeacon使用的是BLE技术，具体而言，利用的是BLE中名为“通告帧”（Advertising）的广播帧。通告帧是定期发送的帧，只要是支持BLE的设备就可以接收到。
iBeacon的主要参数：
uuid：128位标识符，通用唯一标识符。
Major和Minor由iBeacon发布者自行设定，都是16位的标识符，可以用来区别使用相同uuid的iBeacon。
proximity：表示iBeacon的远近。CLProximityImmediate表示最接近，CLProximityNear表示很接近，CLProximityFar表示远，CLProximityUnknown表示不见了。
rss(Received Single Strength Indicator)：信号的强弱，是负数，越接近0表示信号越强。

三.cordova ibeacon plugin使用

在Github上都有详细的介绍，对iOS和android都有ranging,monitoring功能。
iOS7之后的设备可以当作一个ibeacon。
需要注意在iOS8需要允许使用定位权限 （因为ibaecon的使用是基于蓝牙和定位的）。
这里以ranging为例子
Start ranging a single iBeacon

var delegate = new cordova.plugins.locationManager.Delegate();
     
delegate.didDetermineStateForRegion = function (pluginResult) {
    console.log('didDetermineStateForRegion:', pluginResult);
};

delegate.didStartMonitoringForRegion = function (pluginResult) {
    console.log('didStartMonitoringForRegion:', pluginResult);
};

delegate.didRangeBeaconsInRegion = function (pluginResult) {
    console.log('didRangeBeaconsInRegion:', pluginResult);
};

var uuid = '00000000-0000-0000-0000-000000000000';
var identifier = 'beaconID';
var minor;
var major;
var beaconRegion = new cordova.plugins.locationManager.BeaconRegion(identifier, uuid, major, minor);

cordova.plugins.locationManager.setDelegate(delegate);

// required in iOS 8+
cordova.plugins.locationManager.requestWhenInUseAuthorization(); 
// or cordova.plugins.locationManager.requestAlwaysAuthorization()

cordova.plugins.locationManager.startRangingBeaconsInRegion(beaconRegion)
     .fail(function(e) { console.error(e); })
     .done();

Stop ranging a single iBeacon

var uuid = '00000000-0000-0000-0000-000000000000';
var identifier = 'beaconID'; 
var minor; 
var major; 
var beaconRegion = new cordova.plugins.locationManager.BeaconRegion(identifier, uuid, major, minor); cordova.plugins.locationManager.stopRangingBeaconsInRegion(beaconRegion)      
.fail(function(e) { console.error(e); })      
.done();

四.注意点

以rangingBeacons为例：
1.当app启动的时候，在init_page就开始startRangingBeacons，要注意，这个startRangingBeacons只运行一次，去到其他页面再次进入这个init_page页就不能再进行一次startRangingBeacons，这里可以通过一个字段进行标记。
2.当app进入后台的时候需要停止ranging,当app进入前台的时候需要开始ranging。
在Cordova的官网中有app进入后台和前台相对应的事件。

1. pause

The pause event fires when the native platform puts the application into the background, typically when the user switches to a different application.

app进入后台，会调用pause事件，例如切换不同apps，点击home键等等，该方法都会调用，但是在android中，当点击home键时，pause事件会调用，但是在iOS中，pause事件不会调用，需要使用resign事件。

2. resume

The resume event fires when the native platform pulls the application out from the background.

app进入前台，在android中，call resume事件；在iOS中，call active事件。
需要注意，resume事件和pause事件调起的方法需要包裹在一个setTimeout里面，timeout值为0，否则，程序会挂起。

3.在Cordova中，需要判断platform，可以导入device plugin。

4.如果需要在xcode的控制台输出log，可以导入console plugin，原有的console.log()只能在浏览器的调试中输出，但是对于真机测试，app进入后台，需要在pause的时候输出信息，则导入console plugin来打印。

plugins name