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

Описание содержимого SDK

SDK состоит из библиотеки:

 libBunchBeaconSDK.a

и пяти заголовочных файлов:

BNCHBunchManager.h

BNCHMutableBunch.h

BNCHBunch.h

BNCHBunchRegion.h

BNCHBunchDefinitions.h

Библиотека собрана в версиях Debug и Release для запуска на iOS устройствах или на симуляторе. Библиотеки лежат в четырех папках.

Библиотека для запуска на iOS-симуляторах лежит в папках:

 Debug-iphonesimulator
 Release-iphonesimulator

Библиотека для запуска на iOS-устройствах лежит в папках:

 Debug-iphoneos
 Release-iphoneos

Порядок установки

Шаг 1. Добавление в проект библиотеки

Необходимая версия библиотеки добавляется в проект. Для этого в Xcode надо выбрать соответствующий Target в разделе TARGETS далее перейти на закладку General и выбрать раздел Linked Frameworks and Libraries. Перетаскивание библиотеки в этот раздел добавляет ее в проект.

Шаг 2. Добавление в проект заголовочных файлов

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

Самый простой способ заставить SDK работать

Для того, чтобы запустить SDK сделайте следующие простые шаги:

  1. Cоздайте объект BNCHBunchManager
     BNCHBunchManager _bunchManager = [[BNCHBunchManager alloc]init];
    
  2. Установите правильный delegate:
     [_bunchManager setDelegate:self];
    
  3. Инициализируйте регион, который вы ходите отслеживать:
     BNCHBunchRegion *region = [[BNCHBunchRegion alloc]initRegionWithIdentifier:@"BunchSampleApp"];
     region.notifyEntryStateOnDisplay = YES;
     region.notifyOnEntry = YES;
     region.notifyOnExit = YES;
    
  4. Начните либо мониторить заданный регион, либо ранжировать Банчи, находящиеся в нем . Стандартный способ выглядит следующим образом: вы начинаете мониторить регион, т.е. отслеживаете события входа или выхода пользователя в/из региона. Если пользователь заходит в регион, то надо начать ранжирование Банчей в данном регионе (если это необходимо) для определения какой именно Банч находится ближе к пользователю. Когда приложение активно, мониторинг иногда работает с запаздываниями, что вызвано особенностями работы iOS с BLE-стеком, поэтому в активном состоянии рекомендуется наряду с мониторингом вызывать метод startRangingBunchesInRegion: сразу.
     [_bunchManager startMonitoringForRegion:region];
     [_bunchManager startRangingBunchesInRegion:region];
    
  5. После выполнения указанных шагов будут вызываться delegate-методы:

     bunchManager:didDetermineState:forRegion:
     bunchManager:didEnterRegion:
     bunchManager:didExitRegion:
    

    в зависимости от произошедшего события