com.voltmx.BeaconManager
BeaconManager is for managing iBeacons in iOS. Your app creates a BeaconManager object by calling the com.voltmx.BeaconManager constructor function.
The BeaconManager object contains the following methods.
Methods
The com.voltmx.BeaconManager class has the following methods.
authorizationStatus
This method helps you know the authorization status of the location services for the application.
Syntax
authorizationStatus();
Input Parameters
None.
Example
var authorizationStatus1 = aBeaconManager.authorizationStatus();
Return Values
Returns one of the following strings.
Constant | Description |
---|---|
BeaconManagerAuthorizationStatusNotDetermined | The user has not made a choice regarding whether this application can use location services. |
BeaconManagerAuthorizationStatusRestricted | This application is not authorized to use location services. The user cannot change this application’s status, possibly due to active restrictions such as parental controls being in place |
BeaconManagerAuthorizationStatusDenied | The user explicitly denied the use of location services for this application or location services are currently disabled in Settings. |
BeaconManagerAuthorizationStatusAuthorized | This application is authorized to use location services. |
Remarks
The authorization status of a given application is managed by the system and determined by several factors. Applications must be explicitly authorized to use location services by the user, and location services must currently be enabled for the system. A request for user authorization is displayed automatically when your application first attempts to use location services.
Availability
Available only on iOS.
getMonitoredRegions
This API gets the Beacon Regions that are currently being monitored. You cannot add regions to this property directly. Instead, you must register regions by calling the startMonitoringForRegion method.
Syntax
getMonitoredRegions();
Input Parameters
None.
Example
var monitoredRegions = aBeaconManager.getMonitoredRegions();
Return Values
Returns an array containing all of the BeaconRegion objects that are being monitored by the BeaconManager.
Availability
Available only on iOS.
getRangedRegions
Gets the the BeaconRegion objects that are currently being ranged.
Syntax
getRangedRegions();
Input Parameters
None
Example
var rangedRegions1 = aBeaconManager.getRangedRegions();
Return Values
Returns an array containing all of the BeaconRegion objects that are being ranged by the BeaconManager.
Availability
Available only on iOS.
isMonitoringAvailableForBeaconRegions
Determine whether monitoring is available for the beacon regions.
Syntax
isMonitoringAvailableForBeaconRegions();
Input Parameters
None.
Example
var isMonitoringAvailableForBeaconRegions1 = aBeaconManager.isMonitoringAvailableForBeaconRegions();
Return Values
Returns True
if monitoring is available for the beacon regions, or false
if it is not.
Availability
Available only on iOS.
isRangingAvailableForBeaconRegions
Determine whether ranging is available for the beacon regions.
Syntax
isRangingAvailableForBeaconRegions();
Input Parameters
None.
Example
var isRangingAvailableForBeaconRegions1 = aBeaconManager.isRangingAvailableForBeaconRegions();
Return Values
Returns True
if ranging is available for the beacon regions, or false
if it is not.
Availability
Available only on iOS.
requestStateForRegion
Determine the state of the current device relative to the beacon region.
Syntax
requestStateForRegion(
beaconRegion);
Input Parameters
Parameter | Description |
---|---|
beaconRegion | The beacon region whose state is queried. |
Example
aBeaconManager.requestStateForRegion(beaconRegion);
Return Values
None.
Remarks
This method performs the request asynchronously and delivers the results through the monitoringCallback function that your app sets by calling setMonitoringStartedForRegionCallback.
Availability
Available only on iOS.
setAuthorizationStatusChangedCallback
Sets the callback function that retrieves the authorization status changes.
Syntax
setAuthorizationStatusChangedCallback(
statusChangedCallbackFunction);
Input Parameters
Parameter | Description |
---|---|
statusChangedCallback | A callback function that retrieves changes in the authorization status. For details, see the Remarks section below. |
Example
aBeaconManager.setAuthorizationStatusChangedCallback(authorizationStatusChanged);
Return Values
None
Remarks
This method sets a callback function that is invoked whenever the authorization status changes. It enables your app to retrieve status change updates asynchronously whenever they occur. The callback must have the following signature.
function authorizationStatusChanged(Status);
where the callback's Status parameter is a string that contains one of the following values.
Constant | Description |
---|---|
BeaconManagerAuthorizationStatusAuthorized | This application is authorized to use location services. |
BeaconManagerAuthorizationStatusDenied | The user explicitly denied the use of location services for this application or location services are currently disabled in Settings. |
BeaconManagerAuthorizationStatusNotDetermined | The user has not made a choice regarding whether this application can use location services. |
BeaconManagerAuthorizationStatusRestricted | This application is not authorized to use location services. The user cannot change this application’s status, possibly due to active restrictions such as parental controls being in place. |
Availability
Available only on iOS.
setMonitoringStartedForRegionCallback
Sets the monitoring started for region callback.
Syntax
setMonitoringStartedForRegionCallback(
regionMonitoringCallback);
Input Parameters
Parameter | Description |
---|---|
regionMonitoringCallback | A callback function that is invoked when a monitoring starts in an new beacon region. For details, see Remarks below. |
Example
aBeaconManager.setMonitoringStartedForRegionCallback(monitoringStartedForRegionCallback);
Return Values
None
Remarks
This method sets a callback that informs the app that a new region is being monitored. The callback must have the following signature.
function monitoringStartedForRegionCallback(beaconRegion);
where the callback's beaconRegion parameter is a BeaconRegion object that contains the beacon region in which monitoring has started.
Availability
Available only on iOS.
startMonitoringBeaconRegion
Start monitoring for the specified Beacon Region.
Syntax
startMonitoringBeaconRegion(
beaconRegion);
Input Parameters
Parameter | Description |
---|---|
beaconRegion | A BeaconRegion object that contains the beacon region to monitor. |
Example
aBeaconManager.startMonitoringBeaconRegion(beaconRegion);
Return Values
None
Remarks
Your app must call this method once for each region it needs to monitor. If an existing region with the same identifier is already being monitored by the application, the old region is replaced by the new one. Region events are delivered through the monitoringCallback function that your app sets by calling setMonitoringStartedForRegionCallback..
Availability
Available only on iOS.
startRangingBeaconsInRegion
Starts ranging beacons in a specified beacon region.
Syntax
startRangingBeaconsInRegion(
beaconRegion);
Input Parameters
Parameter | Description |
---|---|
beaconRegion | A BeaconRegion object to use for ranging. |
Example
aBeaconManager.startRangingBeaconsInRegion(beaconRegion);
Return Values
None.
Remarks
Your app calls this function once the region monitored state is "BeaconRegionStateInside
".
Availability
Available only on iOS.
stopMonitoringBeaconsRegion
Stops monitoring a specified beacon region.
Syntax
stopMonitoringBeaconRegion(
beaconRegion);
Input Parameters
Parameter | Description |
---|---|
beaconRegion | The BeaconRegion to stop monitoring. |
Example
aBeaconManager.stopMonitoringBeaconsRegion(beaconRegion);
Return Values
None
Availability
Available only on iOS.
stopRangingBeaconsInRegion
Stop ranging beacons in a specified Beacon Region.
Syntax
stopRangingBeaconsInRegion();
Input Parameters
Parameter | Description |
---|---|
beaconRegion | The BeaconRegion to stop ranging. |
Example
aBeaconManager.stopRangingBeaconsInRegion(beaconRegion);
Return Values
None.
Remarks
If the specified region object is not currently being monitored, this method has no effect. When you call this method, the beacon attributes should be the same object that you registered.
Availability
Available only on iOS.