Discussion

The delegate object to receive update events.

Discussion

Returns a Boolean indicating whether the device supports region monitoring using the specified class.

The availability of region monitoring support is dependent on the hardware present on the device. This method does not take into account the availability of location services or the fact that the user might have disabled them for the app or system; you must determine your app’s authorization status separately. You can find out the location service availability by calling locationServiceEnabled of the RECOBeaconManager class.

Discussion

Returns a Boolean indicating whether the device supports ranging of Bluetooth beacons.

Discussion

Returns a Boolean value indicating whether location services are enabled on the device.

The user can enable or disable location services from the Settings application by toggling the Location Services switch in General.

You should check the return value of this method before starting location updates to determine whether the user has location services enabled for the current device. Location services prompts users the first time they attempt to use location-related information in an app but does not prompt for subsequent attempts. If the user denies the use of location services and you attempt to start location updates anyway, the RECOBeaconManager reports an error to its delegate.

Discussion

The set of shared regions monitored by all RECOBeaconManager objects. (read-only)

You cannot add regions to this property directly. Instead, you must register regions by calling the startMonitoringForRegion: method. The regions in this property are shared by all instances of the RECOBeaconManager class in your application.

The objects in this set may not necessarily be the same objects you specified at registration time. Only the region data itself is maintained by the system. Therefore, the only way to uniquely identify a registered region is using its identifier property.

The RECOBeaconManager persists region data between launches of your application. If your application is terminated and then relaunched, the contents of this property are repopulated with region objects that contain the previously registered data.

Discussion

The set of regions currently being tracked using ranging. (read-only)

The objects in the set are instances of the RECOBeaconRegion class.

Discussion

Retrieves the state of a region asynchronously.

This method performs the request asynchronously and delivers the results to the RECOBeaconManager’s delegate. You must implement the locationManager:didDetermineState:forRegion: method in the delegate to receive the results.

If the region parameter contains an unknown type of region object, this method does nothing.

Discussion

Starts monitoring the specified region.

You must call this method once for each region you want 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. The regions you add using this method are shared by all RECOBeaconManager objects in your application and stored in the NSSet object which can be available through getMonitoredRegions: method.

Region events are delivered to the recoManager:didEnterRegion and recoManager:didExitRegion: methods of your delegate. If there is an error, the RECOBeaconManager calls the recoManager:monitoringDidFailForRegion:withError: method of your delegate instead.

An app can register up to 20 regions at a time. In order to report region changes in a timely manner, the region monitoring service requires network connectivity.

An app can expect to receive the appropriate region entered or region exited notification within 3 to 5 minutes on average, if not sooner.

Discussion

Starts the delivery of notifications for beacons in the specified region.

Once registered, the RECOBeaconManager reports any encountered beacons to its delegate by calling the recoManager:didRangeBeacons:inRegion: method. If there is an error registering the specified beacon region, the RECOBeaconManager calls its delegate’s recoManager:rangingBeaconsDidFailForRegion:withError: method and provides the appropriate error information.

Discussion

Stops monitoring the specified region.

Discussion

Stops the delivery of notifications for the specified beacon region.