• CLBeaconRegion
 

CLBeaconRegion класс

CLBeaconRegion

Объект CLBeaconRegion определяет тип области, которая основана на близости устройства к маячку Bluetooth, в противоположность географическому местоположению. Маячковые регионы просматриваются устройствами, которым предоставлена их идентифицирующая информация. Когда устройство находится в диапазоне, регион вызывает доставку соответствующего уведомления.

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

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

Задание идентичности маячка

Ваш идентификатор маячка использует комбинацию из трех значений:

  • Свойство proximityUUID - содержит идентификатор, который вы используете для идентификации маячков вашей компании. Вы, как правило, генерируете только один UUID для маячков вашей компании, но можете сгенерировать более, по мере необходимости. Вы генерируете это значение, используя uuidgen инструмент командной строки.
  • Свойство major - содержит значение, которое может быть использовано для группировки связанных наборов маячков. Например, универмаг может присвоить это значение для всех маячков на одном и том же этаже.
  • Свойство minor - определяет индивидуальный маячок в группе. Например, для группы маячков на одном этаже универмага это значение может быть присвоено маячку в определенном отделе.

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

- initWithProximityUUID:identifier:
- initWithProximityUUID:major:identifier:
- initWithProximityUUID:major:minor:identifier:
proximityUUID
major
minor
notifyEntryStateOnDisplay
- peripheralDataWithMeasuredPower:
CLBeaconMajorValue
CLBeaconMinorValue

 

- initWithProximityUUID:identifier:

Инициализирует и возвращает объект региона который связан с маячком с заданным ID.

- (instancetype _Nonnull)initWithProximityUUID:(NSUUID * _Nonnull)proximityUUID identifier:(NSString * _Nonnull)identifier

Аргументы:

proximityUUIDУникальный ID целевых маячков. Не может быть nil.
identifierУникальный идентификатор, ассоциированный с возвращенным объектом региона. Вы используете этот идентификатор, чтобы различать регионы в вашем приложении. Не может быть nil.

Возвращаемое значение:

Инициализированный объект маячкового региона.

Рассмотрение:

Этот метод создает область, которая объединяет все маячки с указанным значением proximityUUID. Значения свойств major и minor игнорируются.

Доступно:

iOS 7.0 и выше

- initWithProximityUUID:major:identifier:

Инициализирует и возвращает объект региона, который нацелен на маячки с заданным ID и major значением.

- (instancetype _Nonnull)initWithProximityUUID:(NSUUID * _Nonnull)proximityUUID major:(CLBeaconMajorValue)major identifier:(NSString * _Nonnull)identifier

Аргументы:

proximityUUIDУникальный ID целевых маячков. Не может быть nil.
majorСодержит значение, которое может быть использовано для группировки связанных наборов маячков.
identifierУникальный идентификатор, ассоциированный с возвращенным объектом региона. Вы используете этот идентификатор, чтобы различать регионы в вашем приложении. Не может быть nil.

Возвращаемое значение:

Инициализированный объект маячкового региона.

Рассмотрение:

Этот метод создает область, которая объединяет все маячки с указанным значением proximityUUID и major. Значение свойства minor игнорируются.

Доступно:

iOS 7.0 и выше

- initWithProximityUUID:major:minor:identifier:

Инициализирует и возвращает регион для маячка с заданными параметрами идентификации.

- (instancetype _Nonnull)initWithProximityUUID:(NSUUID * _Nonnull)proximityUUID major:(CLBeaconMajorValue)major minor:(CLBeaconMinorValue)minor identifier:(NSString * _Nonnull)identifier

Аргументы:

proximityUUIDУникальный ID целевых маячков. Не может быть nil.
majorСодержит значение, которое может быть использовано для группировки связанных наборов маячков.
minorОпределяет индивидуальный маячок в группе.
identifierУникальный идентификатор, ассоциированный с возвращенным объектом региона. Вы используете этот идентификатор, чтобы различать регионы в вашем приложении. Не может быть nil.

Возвращаемое значение:

Инициализированный объект маячкового региона.

Рассмотрение:

Этот метод создает регион на основе переданных proximityUUID, major и minor значений.

Доступно:

iOS 7.0 и выше

proximityUUID

Уникальный ID маячков, которые будут отслеживаться. (только для чтения)

@property(readonly, nonatomic, strong, nonnull) NSUUID *proximityUUID

Доступно:

iOS 7.0 и выше

major

Значение, идентифицирующее группу маячков. (только для чтения)

@property(readonly, nonatomic, strong, nullable) NSNumber *major

Рассмотрение:

Если вы не зададите значение для major маячка, значение этого свойства равно nil. Если это свойство равно nil, то значение major маячка игнорируется при определении на совпадение.

Доступно:

iOS 7.0 и выше

minor

Значение идентификацирует конкретный маячок в группе. (только для чтения)

@property(readonly, nonatomic, strong, nullable) NSNumber *minor

Рассмотрение:

Если вы не зададите значение для minor маячка, значение этого свойства равно nil. Если это свойство равно nil, то значение minor маячка игнорируется при определении на совпадение.

Доступно:

iOS 7.0 и выше

notifyEntryStateOnDisplay

Логическое значение указывающее, что уведомления радиомаячка отправляются, когда дисплей устройства включен.

@property(nonatomic, assign) BOOL notifyEntryStateOnDisplay

Рассмотрение:

При установке в YES, менеджер расположения отправляет уведомления маячка, когда пользователь включает дисплй, и устройство уже находится внутри области. Эти уведомления посылаются даже если ваше приложение не работает. В этой ситуации, система запускает свое приложение в фоновом режиме, так что оно может обрабатывать уведомления. В обоих случаях, менеджер расположения вызывает метод делегата объекта locationManager:didDetermineState:forRegion:.

Значение по умолчанию NO.

Доступно:

iOS 7.0 и выше

- peripheralDataWithMeasuredPower:

Извлекает данные, которые могут использоваться, чтобы афишировать текущее устройство в качестве маячка.

- (NSMutableDictionary<NSString *,id> * _Nonnull)peripheralDataWithMeasuredPower:(NSNumber * _Nullable)measuredPower

Аргументы:

measuredPowerПолученный индикатор уровня сигнала (RSSI) значение (измеряется в децибелах) для устройства. Это значение представляет собой измеренную силу маячка от одного метра и используется во время ранжирования. Укажите ноль, чтобы использовать значение по умолчанию для данного устройства.

Возвращаемое значение:

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

Рассмотрение:

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

Доступно:

iOS 7.0 и выше

CLBeaconMajorValue

typedef uint16_t CLBeaconMajorValue;

Доступно:

iOS 7.0 и выше

CLBeaconMinorValue

typedef uint16_t CLBeaconMinorValue;

Доступно:

iOS 7.0 и выше
 
 
homeЗаметили ошибкукарта сайта 
   Made on a Mac