Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека Разработчика iOS

Разработчик

Ссылка платформы CoreLocation ссылка класса CLBeaconRegion

Опции
Развертывание Target:

На этой странице
Язык:

CLBeaconRegion

Наследование

Соответствует

Оператор импорта

Swift

import CoreLocation

Objective C

@import CoreLocation;

Доступность

Доступный в iOS 7.0 и позже.

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

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

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

Указание идентификационных данных маркера

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

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

  • major свойство содержит значение, которое может использоваться для группировки связанных наборов маркеров. Например, универмаг мог бы присвоить то же главное значение для всех маркеров на том же полу.

  • minor свойство указывает отдельный маркер в группе. Например, для группы маркеров на том же этаже универмага, это значение могло бы быть присвоено маркеру в определенном разделе.

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

Инициализация области маркера
  • init (proximityUUID:identifier:) - initWithProximityUUID:identifier:

    Инициализирует и возвращается, область возражают, что предназначается для маркера с указанной близостью ID.

    Объявление

    Swift

    init!(proximityUUID proximityUUID: NSUUID!, identifier identifier: String!)

    Objective C

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

    Параметры

    proximityUUID

    Уникальный идентификатор предназначаемых маркеров. Это значение не должно быть nil.

    identifier

    Уникальный идентификатор для соединения с возвращенным объектом области. Вы используете этот идентификатор для дифференциации областей в приложении. Это значение не должно быть nil.

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

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

    Обсуждение

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

    Оператор импорта

    Objective C

    @import CoreLocation;

    Swift

    import CoreLocation

    Доступность

    Доступный в iOS 7.0 и позже.

  • init (proximityUUID:major:identifier:) - initWithProximityUUID:major:identifier:

    Инициализирует и возвращается, область возражают, что предназначается для маркера с указанной близостью ID и главное значение.

    Объявление

    Swift

    init!(proximityUUID proximityUUID: NSUUID!, major major: CLBeaconMajorValue, identifier identifier: String!)

    Objective C

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

    Параметры

    proximityUUID

    Уникальный идентификатор предназначаемых маркеров. Это значение не должно быть nil.

    major

    Главное значение, которое Вы используете для идентификации одного или более маркеров.

    identifier

    Уникальный идентификатор для соединения с возвращенным объектом области. Вы используете этот идентификатор для дифференциации областей в приложении. Это значение не должно быть nil.

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

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

    Обсуждение

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

    Оператор импорта

    Objective C

    @import CoreLocation;

    Swift

    import CoreLocation

    Доступность

    Доступный в iOS 7.0 и позже.

  • init (proximityUUID:major:minor:identifier:) - initWithProximityUUID:major:minor:identifier:

    Инициализирует и возвращается, область возражают, что предназначается для маркера с указанной близостью ID, главное значение и незначительное значение.

    Объявление

    Swift

    init!(proximityUUID proximityUUID: NSUUID!, major major: CLBeaconMajorValue, minor minor: CLBeaconMinorValue, identifier identifier: String!)

    Objective C

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

    Параметры

    proximityUUID

    Близость ID предназначаемого маркера. Это значение не должно быть nil.

    major

    Главное значение, которое Вы используете для идентификации одного или более маркеров.

    minor

    Незначительное значение, которое Вы используете для идентификации определенного маркера.

    identifier

    Уникальный идентификатор для соединения с возвращенным объектом области. Вы используете этот идентификатор для дифференциации областей в приложении. Это значение не должно быть nil.

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

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

    Обсуждение

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

    Оператор импорта

    Objective C

    @import CoreLocation;

    Swift

    import CoreLocation

    Доступность

    Доступный в iOS 7.0 и позже.

Доступ к атрибутам маркера
  • proximityUUID Свойство

    Уникальный идентификатор предназначаемых маркеров. (только для чтения)

    Объявление

    Swift

    var proximityUUID: NSUUID! { get }

    Objective C

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

    Оператор импорта

    Objective C

    @import CoreLocation;

    Swift

    import CoreLocation

    Доступность

    Доступный в iOS 7.0 и позже.

  • major Свойство

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

    Объявление

    Swift

    var major: NSNumber! { get }

    Objective C

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

    Обсуждение

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

    Оператор импорта

    Objective C

    @import CoreLocation;

    Swift

    import CoreLocation

    Доступность

    Доступный в iOS 7.0 и позже.

  • minor Свойство

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

    Объявление

    Swift

    var minor: NSNumber! { get }

    Objective C

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

    Обсуждение

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

    Оператор импорта

    Objective C

    @import CoreLocation;

    Swift

    import CoreLocation

    Доступность

    Доступный в iOS 7.0 и позже.

Поставка уведомлений маркера
  • notifyEntryStateOnDisplay Свойство

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

    Объявление

    Swift

    var notifyEntryStateOnDisplay: Bool

    Objective C

    @property(nonatomic, assign) BOOL notifyEntryStateOnDisplay

    Обсуждение

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

    Значение по умолчанию для этого свойства NOfalse.

    Оператор импорта

    Objective C

    @import CoreLocation;

    Swift

    import CoreLocation

    Доступность

    Доступный в iOS 7.0 и позже.

Получение данных рекламы маркера
  • peripheralDataWithMeasuredPower (_:) - peripheralDataWithMeasuredPower:

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

    Объявление

    Swift

    func peripheralDataWithMeasuredPower(_ measuredPower: NSNumber!) -> NSMutableDictionary!

    Objective C

    - (NSMutableDictionary *)peripheralDataWithMeasuredPower:(NSNumber *)measuredPower

    Параметры

    measuredPower

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

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

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

    Обсуждение

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

    Оператор импорта

    Objective C

    @import CoreLocation;

    Swift

    import CoreLocation

    Доступность

    Доступный в iOS 7.0 и позже.

Типы данных

  • CLBeaconMajorValue

    Старшее значащее значение в маркере.

    Объявление

    Swift

    typealias CLBeaconMajorValue = UInt16

    Objective C

    typedef uint16_t CLBeaconMajorValue;

    Оператор импорта

    Objective C

    @import CoreLocation;

    Swift

    import CoreLocation

    Доступность

    Доступный в iOS 7.0 и позже.

  • CLBeaconMinorValue

    Младшее значащее значение в маркере.

    Объявление

    Swift

    typealias CLBeaconMinorValue = UInt16

    Objective C

    typedef uint16_t CLBeaconMinorValue;

    Оператор импорта

    Objective C

    @import CoreLocation;

    Swift

    import CoreLocation

    Доступность

    Доступный в iOS 7.0 и позже.