Определение географической области, которая будет контролироваться

Чтобы начать контролировать географическую область, необходимо определить область и зарегистрировать ее в системе. В iOS 7.0 и позже, Вы определяете географические области с помощью CLCircularRegion класс. (В OS X v10.8 и позже и в предыдущих версиях iOS, Вы используете CLRegion класс вместо этого.) Каждая область, которую Вы создаете, должна включить и данные, определяющие желаемую географическую область и строку уникального идентификатора. Строка идентификатора является единственным гарантируемым путем к Вашему приложению для идентификации области позже. Для регистрации области вызовите startMonitoringForRegion: метод Вашего CLLocationManager объект.

Перечисление 2-1 показывает выборочный метод, создающий новую географическую область на основе круговой области наложения. Центральная точка и радиус наложения формируют границу для области, несмотря на то, что, если радиус является слишком большим, чтобы контролироваться, это сокращено автоматически. Вы не должны сохранять сильные ссылки к областям, которые Вы создаете, но могли бы хотеть сохранить идентификатор области, если Вы планируете получить доступ к информации об области позже.

  Создание перечисления 2-1 и регистрация географической области на основе наложения Набора Карты

- (void)registerRegionWithCircularOverlay:(MKCircle*)overlay andIdentifier:(NSString*)identifier {

   // If the overlay's radius is too large, registration fails automatically,

   // so clamp the radius to the max value.

   CLLocationDistance radius = overlay.radius;

   if (radius > self.locManager.maximumRegionMonitoringDistance) {

      radius = self.locManager.maximumRegionMonitoringDistance;

   }

   // Create the geographic region to be monitored.

   CLCircularRegion *geoRegion = [[CLCircularRegion alloc]

      initWithCenter:overlay.coordinate

              radius:radius

          identifier:identifier];

   [self.locManager startMonitoringForRegion:geoRegion];

}

Контроль географической области сразу начинается после регистрации для разрешенных приложений. Однако не ожидайте получать событие сразу же, потому что только граничные пересечения генерируют событие. В частности если расположение пользователя уже в области в регистрационное время, менеджер расположения автоматически не генерирует событие. Вместо этого Ваше приложение должно ожидать пользователя для пересечения границы области, прежде чем событие будет сгенерировано и отправлено делегату. Чтобы проверить, является ли пользователь уже в границе области, используйте requestStateForRegion: метод CLLocationManager класс.

Будьте разумны при указании набора областей для контроля. Области являются совместно используемым системным ресурсом, и общее количество областей, доступных в масштабе всей системы, ограничивается. Поэтому Базовое Расположение ограничивает 20 число областей, которые могут одновременно контролироваться отдельным приложением. Для работы вокруг этого предела считайте регистрацию только теми областями в непосредственной близости пользователя. Когда расположение пользователя изменяется, можно удалить области, которые являются теперь более далеким путем и добавляют области, подходящие на пути пользователя. При попытке зарегистрировать область, и пространство недоступно, вызовы диспетчера расположения locationManager:monitoringDidFailForRegion:withError: метод его делегата с kCLErrorRegionMonitoringFailure код ошибки.

Обработка пересекающих границу событий для географической области

По умолчанию, каждый раз, когда текущее расположение пользователя пересекает граничную область, система генерирует надлежащее событие области для Вашего приложения. Приложения могут реализовать следующие методы для обработки граничных пересечений:

• locationManager:didEnterRegion:

• locationManager:didExitRegion:

Можно настроить, который пересекающие границу события уведомляют приложение путем явной установки notifyOnEntry и notifyOnExit свойства CLRegion класс, когда Вы определяете и регистрируете область. (Значение по умолчанию обоих свойств YES.), Например, если Вы хотите быть уведомленными только, когда пользователь выходит из границы области, можно установить значение области notifyOnEntry свойство к NO.

Система не сообщает о граничных пересечениях, пока не превышена граница плюс определенное с помощью системы расстояние подушки. Это значение подушки препятствует тому, чтобы система генерировала многочисленные вводимые и события, из которых выходят, в быстрой преемственности, в то время как пользователь перемещается близко край границы.

Когда граница области пересечена, наиболее вероятный ответ должен предупредить пользователя близости к целевому элементу. Если Ваше приложение работает в фоновом режиме, можно использовать локальные уведомления для предупреждения пользователя; иначе, можно просто отправить предупреждение.

Определение области маркера, которая будет контролироваться

Чтобы начать контролировать область маркера, определите область и зарегистрируйте ее в системе. Вы определяете область маркера с помощью надлежащего метода инициализации CLBeaconRegion класс. Когда Вы создаете a CLBeaconRegion объект, Вы указываете proximityUUID, major, и minor свойства маркеров, которые Вы хотите контролировать (близость UUID требуется; главные и незначительные значения являются дополнительными). Необходимо также предоставить строку, однозначно определяющую область так, чтобы можно было обратиться к ней в коде. Обратите внимание на то, что идентификатор области не связан с информацией об идентификации, которую распространяет маркер.

Для регистрации области маркера вызовите startMonitoringForRegion: метод Вашего CLLocationManager объект. Перечисление 2-2 показывает выборочный метод, создающий и регистрирующий область маркера.

  Создание перечисления 2-2 и регистрация области маркера

- (void)registerBeaconRegionWithUUID:(NSUUID *)proximityUUID andIdentifier:(NSString*)identifier {

   // Create the beacon region to be monitored.

   CLBeaconRegion *beaconRegion = [[CLBeaconRegion alloc]

      initWithProximityUUID:proximityUUID

                 identifier:identifier];

   // Register the beacon region with the location manager.

   [self.locManager startMonitoringForRegion:beaconRegion];

}

Как с географическим контролем области, контроль области маркера сразу начинается после регистрации для разрешенных приложений. Когда устройство пользователя обнаруживает маркер, распространяющий информацию об идентификации, определенную зарегистрированной областью маркера (близость UUID, главное значение и незначительное значение), система генерирует надлежащее событие области для Вашего приложения.

Обработка пересекающих границу событий для области маркера

Когда пользователь вводит зарегистрированную область маркера, вызовы диспетчера расположения locationManager:didEnterRegion: из его объекта делегата. Точно так же, когда пользователь больше не находится в диапазоне никаких маркеров в зарегистрированной области маркера, вызовы диспетчера расположения locationManager:didExitRegion: из его объекта делегата. Обратите внимание на то, что пользователь должен пересечь границу области для инициирования одного из этих вызовов; в частности менеджер расположения не вызывает locationManager:didEnterRegion: если пользователь уже в области. Можно реализовать эти методы делегата предупредить пользователя соответственно или к специфичному для местонахождения UI.

Можно указать, который пересекающие границу события должны уведомить приложение путем установки notifyOnEntry и notifyOnExit свойства области маркера. (Значение по умолчанию обоих свойств YES.), Например, если Вы хотите быть уведомленными только, когда пользователь выходит из границы области, можно установить значение области notifyOnEntry свойство к NO.

Можно также отложить уведомлять пользователя относительно ввода области маркера, пока пользователь не включает дисплей устройства. Для этого просто установите значение области маркера notifyEntryStateOnDisplay значение свойства к YES и набор область notifyOnEntry свойство к NO когда Вы регистрируете область маркера. Чтобы препятствовать тому, чтобы избыточные уведомления были поставлены пользователю, отправьте локальное уведомление только один раз на запись области.

// Delegate method from the CLLocationManagerDelegate protocol.

- (void)locationManager:(CLLocationManager *)manager

        didRangeBeacons:(NSArray *)beacons

               inRegion:(CLBeaconRegion *)region {

   if ([beacons count] > 0) {

      CLBeacon *nearestExhibit = [beacons firstObject];

      // Present the exhibit-specific UI only when

      // the user is relatively close to the exhibit.

      if (CLProximityNear == nearestExhibit.proximity) {

         [self presentExhibitInfoWithMajorValue:nearestExhibit.major.integerValue];

      } else {

         [self dismissExhibitInfo];

   }

}

Создание и распространение области маркера

Для использования устройства на iOS в качестве маркера Вы сначала генерируете 128-разрядный UUID, который будет Вашей близостью области маркера UUID. Откройте Terminal и тип uuidgen на командной строке. Вы получаете уникальное 128-разрядное значение в строке ASCII, акцентированной дефисами, как в этом примере.

$ uuidgen

39ED98FF-2900-441A-802F-9C398FC199D2

Затем, создайте область маркера с UUID, Вы генерировали для близости маркера UUID, определив главные и незначительные значения по мере необходимости. Обязательно также используйте уникальный идентификатор строки для новой области. Этот код показывает, как создать новую область маркера с помощью примера UUID выше.

   NSUUID *proximityUUID = [[NSUUID alloc]

      initWithUUIDString:@"39ED98FF-2900-441A-802F-9C398FC199D2"];

   // Create the beacon region.

   CLBeaconRegion *beaconRegion = [[CLBeaconRegion alloc]

      initWithProximityUUID:proximityUUID

                 identifier:@"com.mycompany.myregion"

Теперь, когда Вы создали область маркера, необходимо распространить близость маркера UUID (и любое главное или незначительное значение, которое Вы указали), использование CBPeripheralManager класс Ядра платформа Bluetooth. В Ядре Bluetooth периферийное устройство является устройством, распространяющим и совместно использующим данные с помощью низкой энергии Bluetooth. Распространение данных Вашего маркера является единственным способом, которым другие устройства могут обнаружить и расположиться Ваш маркер.

Для распространения периферийных данных в Ядре Bluetooth Вы вызываете startAdvertising: метод CBPeripheralManager класс на экземпляре a CBPeripheralManager объект. Этот метод ожидает словарь (экземпляр NSDictionary) из данных рекламы. Поскольку следующий пример показывает, используйте peripheralDataWithMeasuredPower: метод CLBeaconRegion класс для получения словаря, кодирующего информацию об идентификации маркера вместе с другой информацией, необходимой для Ядра Bluetooth для распространения маркера как периферийного устройства.

   // Create a dictionary of advertisement data.

   NSDictionary *beaconPeripheralData =

      [beaconRegion peripheralDataWithMeasuredPower:nil];

Затем, создайте экземпляр CBPeripheralManager класс, и просит, чтобы он распространил Ваш маркер для других устройств для обнаружения, как показано в коде ниже.

   // Create the peripheral manager.

   CBPeripheralManager *peripheralManager = [[CBPeripheralManager alloc]

      initWithDelegate:selfqueue:nil options:nil];

   // Start advertising your beacon's data.

   [peripheralManager startAdvertising:beaconPeripheralData];

После распространения Вашего приложения как маркер Ваше приложение должно продолжать работать на переднем плане для широковещательной передачи необходимых Сигналов Bluetooth. Если пользователь выходит из приложения, система прекращает распространять Ваше устройство как периферийное устройство.

Для получения дополнительной информации о том, как использовать периферийного менеджера для распространения данных с помощью низкой энергии Bluetooth, посмотрите Ссылку класса CBPeripheralManager и Ядро Руководство по программированию Bluetooth.