SDK для работы с BunchBeacon
 Указатель Классы Функции Свойства Группы Страницы
Полный список членов класса
Класс BNCHMutableBunch

#import <BNCHMutableBunch.h>

Граф наследования:BNCHMutableBunch:
BNCHBunch

Методы экземпляра

Методы для считывания конфигурации Bunch
(void) - readParameterFromBunch:
 
Методы для записи конфигурации Bunch
(void) - writeMajor:
 
(void) - writeMinor:
 
(void) - writeMeasuredPower:
 
(void) - writeAdvInterval:
 
(void) - writePower:
 
(void) - writeBunchType:
 

Свойства

Delegate
id< BNCHMutableBunchDelegatedelegate
 
Cвойства, доступные сразу после получения объекта BNCHMutableBunch
CBPeripheral * peripheral
 
BOOL isConnected
 
Cвойства, обновляемые после установления соединения с Bunch
NSString * macAddress
 
NSNumber * measuredPower
 
NSNumber * txPower
 
NSNumber * advInterval
 
NSNumber * batteryLevel
 
NSString * hardwareVersion
 
NSString * firmwareVersion
 
- Свойства унаследованные от BNCHBunch
NSString * name
 
CBUUID * proximityUUID
 
NSNumber * major
 
NSNumber * minor
 
CLProximity proximity
 
CLLocationAccuracy accuracy
 
NSInteger rssi
 
NSNumber * bunchType
 

Подробное описание

Объект класса BNCHMutableBunch представляет собой Bunch, который был найден рядом с мобильным устройством пользователя. Вы не можете создать объект BNCHMutableBunch напрямую. Объект класса BNCHBunchManager передает найденные им объекты класса BNCHMutableBunch, в соответствующий метод delegate-протокола. Вы можете использовать информацию в объектах класса BNCHMutableBunch для настройки параметров работы конкретного Bunch, который был найден.

Документация метода

- (void) readParameterFromBunch: (BNCHParameterType)  parameter

Чтение параметров

Аргументы
parameterпараметр, который надо прочитать
Возвращает
void

Описание Последовательность действий для чтения параметра следующая:

  • вызывается метод readParameterFromBunch: в который передается имя параметра для считывания
  • после считывания параметра по радио-интерфейсу асинхронно вызывается delegate-метод didUpdateValueForParameter:
  • значение параметра можно получить в соответствующем свойстве BNCHMutableBunch
- (void) writeAdvInterval: (unsigned short)  interval

Запись advInterval (период с которым Bunch отправляет Advertising-сообщения). Требуется предварительное установление соединения с Bunch.

Аргументы
intervalзначение интервала
Возвращает
void

Описание После записи параметра вызывается delegate-метод didWriteValueForParameter:

- (void) writeBunchType: (BNCHBunchType)  type

Запись типа Bunch (обычный iBeacon или защищенный iBeacon)

Аргументы
typeBNCHBunchType: BNCHBunchTypeSimple или BNCHBunchTypeSecured
Возвращает
void

Описание После записи параметра вызывается delegate-метод didWriteValueForParameter:

- (void) writeMajor: (unsigned short)  major

Запись старшего значения. Требуется предварительное установление соединения с Bunch.

Аргументы
majorстаршее значение
Возвращает
void

Описание После записи параметра вызывается delegate-метод didWriteValueForParameter:

- (void) writeMeasuredPower: (char)  power

Запись "эталонной" мощности конкретного Bunch. Это значение, показывает мощность сигнала на расстоянии один метр от Bunch.

Аргументы
powerзначение "эталонной" мощности
Возвращает
void

Описание Значение параметра используется для определения расстояния до Bunch. Зная значение "эталонной" мощности сигнала для Bunch на расстоянии один метр, система проводит расчет расстояния до Bunch на основании оригинального текущео значения сигнала, передаваемого в параметре txPower. Требуется предварительное установление соединения с Bunch. После записи параметра вызывается delegate-метод didWriteValueForParameter:

- (void) writeMinor: (unsigned short)  minor

Запись младшего значения. Требуется предварительное установление соединения с Bunch.

Аргументы
minorмладшее значение
Возвращает
void

Описание После записи параметра вызывается delegate-метод didWriteValueForParameter:

- (void) writePower: (BNCHBunchPower)  power

Запись мощности передатчика. Требуется предварительное установление соединения с Bunch.

Аргументы
powerзначение мощности
Возвращает
void

Описание После записи параметра вызывается delegate-метод didWriteValueForParameter:

Полный список свойств

- (NSNumber*) advInterval
readnonatomicstrong

Период с которым Bunch отправляет Advertising-сообщения. Измеряется в миллисекундах. Чем чаще Bunch отправляет Advertising-сообщения тем быстрее реагирует на них телефон пользователя, чем реже, тем, соответсвенно, медленнее. Это значение обратнопропорционально потреблению батарейки Bunch-ем. Чем чаще Bunch отправляет Advertising-сообщения тем сильнее тратится батарейка. Оптимальное значение находится в диапазоне 1000-2000 миллисекунды. Значение доступно после устновки соединения с Bunch.

- (NSNumber*) batteryLevel
readnonatomicstrong

Уровень заряда батареи в процентах.

Значение меняется от 100 до 0 процентов. Значение доступно после устновки соединения с Bunch.

- (NSString*) firmwareVersion
readnonatomicstrong

Версия программного обеспечения Bunch. Значение доступно после устновки соединения с Bunch.

- (NSString*) hardwareVersion
readnonatomicstrong

Версия аппаратного обеспечения Bunch. Значение доступно после устновки соединения с Bunch.

- (BOOL) isConnected
readnonatomicassign

Флаг, показывающий статус соединения

- (NSString*) macAddress
readnonatomicstrong

MAC-адрес, прошитый в Bunch.

У каждого устройства свой уникальный MAC-адрес, вне зависимости от того, какой major или minor ему присвоены. Т.е. у двух устройств обладающих одинаковыми major и minor MAC-адреса будут отличаться. Значение доступно после устновки соединения с Bunch.

- (NSNumber*) measuredPower
readnonatomicstrong

Значение RSSI, полученное на расстоянии 1 метра от Bunch. Это значение используется для калибровки. Значение доступно после устновки соединения с Bunch.

- (CBPeripheral*) peripheral
readnonatomicstrong

Ссылка на CBPeripheral - объект, представляющий низкоуровневый доступ к Bunch по Bluetooth-интерфейсу

- (NSNumber*) txPower
readnonatomicstrong

Мощность передающего устройства, установленного на Bunch. Значение доступно после устновки соединения с Bunch. Доступные значения представлены в BNCHBunchPower.


Объявления и описания членов класса находятся в файле: