Radius Networks Developer Blog

At Radius Networks, we’ve had our SDKs added to a ton of beacon apps, and we’ve tested a large percentage of them.

One of the most frustrating things about working with beacon-enabled apps is testing background triggering. Usually, iPhone 5 and later trigger in the background within a second of seeing a beacon. But sometimes it takes longer. Much longer.

In many cases, we have observed iOS devices behaving as if some sort of beacon region monitoring resource limit had been exceeded. So we had a question…

What is the maximum number of beacon regions you can monitor in the background on iOS?

Apple’s documentation states that each app has a limit of 20 beacon regions, but the documentation doesn’t say anything about a global limit for a device. We decided to investigate if such a limit exists and how exceeding that limit may affect beacon region monitoring behavior.

The results of our investigation are that a global beacon region monitoring limit does exist. The regions are registered first-in-last-out, so that the first regions registered are in the “priority” group, and the latter ones will get bumped to the “best effort” group.

The priority group can contain up to 30 beacon regions. Applications will receive almost immediate region monitoring call backs (ie didEnter Region & didExit Region) for priority group beacon regions regardless of the state of the iOS device, including the black screen state, lock screen state, springboard state and all application states.

The best effort group contains beacon regions registered beyond the 30 beacon region limit. Applications may experience significantly delayed region monitoring call backs based on the state of the mobile device. For example, if a mobile device is in the black screen state, meaning the screen is not illuminated at all, applications may never receive region monitoring call backs for best effort group beacon regions until the user or some event like a push notification, calendar reminder or text message causes the device to wakeup.

Limiting the priority group to the first 30 registered beacon regions seems fairly small given that each app can register up to 20 regions, so we believe this is a very significant finding.

What might be happening?

Apple’s iOS CoreLocation framework is closed source, so this is just speculation, but our best guess is that there is hardware support for monitoring a limited number of beacon regions. After those slots are taken, iOS falls back to software monitoring and makes a best effort to monitor for beacon regions. However in an effort to save battery life iOS may suspend beacon region monitoring by device power management.

What does this mean for you?

What does this mean to you as a developer of beacon-enabled apps on iOS? If your app is not one of the first ones to be installed on an iOS device, your app may be ineligible for fast background detection and relegated to the slow lane. It is therefore important to design your app to take this possibility into account. You must set expectations appropriately when telling clients and app testers how quickly background detections will take place. Since testers are especially likely to have multiple beacon-enabled apps on their devices, and therefore most likely to experience the delays described here. To speed up detection during testing, uninstall other beacon-enabled apps and reboot your phone before installing your app for testing.

The Experiment

Baseline Configuration and Procedure

Since there are so many different permutations and testing can take so long, I decided to come up with a baseline configuration to test under. Obviously, this is not necessarily the conditions always seen in the wild, but was the best way to characterize the behavior I’d been noticing.

The experiments were run with the following devices:

  • iPhone 6, iOS 8.3
  • iPhone 5s, iOS 8.3
  • iPad Air 2, iOS 8.3

I executed the following procedure to establish a baseline configuration:

  1. Uninstall any app with location (or set the location permission to “Never” in settings)
  2. Reboot the phone
  3. Turn off WiFi in settings
  4. Turn off Cellular Data in settings

On each subsequent run I followed this procedure:

  1. Reboot the phone
  2. Deploy App to phone via Xcode
  3. Accept core location permission
  4. Accept notification permission
  5. Stop the app with “stop” button in Xcode
  6. Disconnect from tether
  7. Put phone to sleep with shoulder button
  8. Wait 1 minute
  9. Enable beacon

After test is run, update and redeploy any apps and repeat the steps above.

Running the Experiment

I created an Xcode project with 10 targets that will deploy the same code as 10 different apps. This lets you make minor changes to region settings and redeploy all the apps to the device.

The main approach I took was to install all 10 apps to the device, starting at 1 and going in order. Make sure that each starts up and can see it register the regions in the logs. This would be done with different numbers of regions. For example I might do a run where each app has 5 regions, deploy them all to the phone and run the experiment.

The most predictable way I found to see where this limit is:

  1. Install all 10 apps starting at 1 and going in order
  2. Lock the phone and let the screen go dark
  3. Start at 10 and work backwards to find which beacon triggers the notification

An example run might look like:

10 apps @ 7 regions

App UUID Region Time till notification
10 7 None (5 min wait)
10 6 None (5 min wait)
10 5 None (5 min wait)
10 4 None (5 min wait)
10 3 None (5 min wait)
10 2 None (5 min wait)
10 1 None (5 min wait)
9 7 None (5 min wait)
9 6 None (5 min wait)
9 5 None (5 min wait)
9 4 None (5 min wait)
9 3 None (5 min wait)
9 2 None (5 min wait)
9 1 None (5 min wait)
8 7 None (5 min wait)
8 6 None (5 min wait)
8 5 None (5 min wait)
8 4 None (5 min wait)
8 3 None (5 min wait)
8 2 None (5 min wait)
8 1 None (5 min wait)
7 7 None (5 min wait)
7 6 None (5 min wait)
7 5 None (5 min wait)
7 4 None (5 min wait)
7 3 None (5 min wait)
7 2 None (5 min wait)
7 1 None (5 min wait)
6 7 None (5 min wait)
6 6 None (5 min wait)
6 5 None (5 min wait)
6 4 None (5 min wait)
6 2 None (5 min wait)
6 1 None (5 min wait)
5 7 None (5 min wait)
5 6 None (5 min wait)
5 5 None (5 min wait)
5 4 None (5 min wait)
5 3 None (5 min wait)
5 2 1 second
5 1 1 second
4 7 1 second
4 6 1 second
4 5 1 second
4 4 1 second
4 3 1 second
4 2 1 second
4 1 1 second
3 7 1 second
3 6 1 second
3 5 1 second
3 4 1 second
3 3 1 second
3 2 1 second
3 1 1 second
2 7 1 second
2 6 1 second
2 5 1 second
2 4 1 second
2 3 1 second
2 2 1 second
2 1 1 second
1 7 1 second
1 6 1 second
1 5 1 second
1 4 1 second
1 3 1 second
1 2 1 second
1 1 1 second

Other Variants

I ran this test under many configurations with similar results. I always found the limit to be 29-30 regions. I assume something is going on that registers something in the hardware layer. I am not sure how best to control the configuration, but believe the inconsistency to be a lack of clean baseline.

Other configuration I tried:

  • 10 apps @ 10 regions
  • 10 apps @ 5 regions
  • 10 apps @ 7 regions
  • 1 app @ 20 regions; 9 apps @ 5 regions
  • 1 app @ 20 regions; 9 apps @ 7 regions

Other Experiments

I also ran a number of ad-hoc experiments to see what would happen under other circumstances, but those were often run on just one device and not repeated.

Reboot

Rebooting the device and waiting. The regions were still registered in the same order.

Uninstall

Uninstalling an app does not re-register any best effort regions. So if I removed the app #1, it didn’t free up the “priority” region slots. Most likely this will be freed up as the apps are re-registering or the device is rebooted. But I didn’t try that.

Best Effort Behavior

I spent a fair amount of time trying to characterize region monitoring behavior for beacons in the best effort group. I would often turn on a beacon and wait for up to 30 minutes to see if it would wake up the app and send a notification. Sometimes it would, most of the time it wouldn’t. But then again, I didn’t wait for 30 minutes that often.

Older Models

This research does not characterize the amount of time it takes to detect in the background when the fast background detection slots are exhausted. However, previous research shows that iPhone 4S devices (which apparently do not have fast background detection at all) may take as long as 15 minutes to trigger in the background.

In closing

This was a very interesting couple of days worth of work. I certainly learned quite a bit about how iOS registers beacon regions. I would be curious what your experience is, in particular if you wanted to run controlled tests using the code above.

I also want to note that this is likely to change as Apple makes updates to iOS and their hardware. We already know that there are innate differences in the older iPhone 4 models, and I am sure they will continue to tweak things going forward.

If you run similar experiments let us know, we’d love to compare notes.