Latest1.2.0
Homepagehttps://github.com/WeLikeDigital/RBN-iOS-SDK
LicenseMIT
Platformsios 7.0, requires ARC
DependenciesKZPropertyMapper, AFNetworking, FMDB, SSZipArchive
FrameworksCoreLocation, Foundation, CoreBluetooth, UIKit, AVFoundation, AdSupport
Authors

RBN SDK V1.1 для iOS

SDK позволяет подключить ваше приложение к Russian Beacon Network.

Как добавить в проект?

Установка RBN-iOS-SDK происходит через dependency manager – CocoaPods. Просто добавьте в Ваш Podfile строку:

pod 'RBN-iOS-SDK'

Что такое CocoaPods?

Базовая настройка

1) Импортируйте заголовочный файл RBN.h

    #import <RBN-iOS-SDK/RBN.h>

2) Инициализируйте SDK, используя ваш приватный ключ и delegate для RBN-iOS-SDK. Delegate и ключ не могут быть nil.

    [RBN setupWithAppSecret:@"YOUR_SECRET_KEY" delegate:delegate];

3) В файле info.plist добавьте поле NSLocationAlwaysUsageDescription типа String. В качестве значения текст, который будет показан в приложении при запросе прав на использование геолокации.

Чтобы показывать рекламу

4) Если вы планируете отправлять пользователям уведомления через Russian Beacon Network, необходимо в AppDelegate добавить два метода:


-(void)application:(UIApplication *)application didReceiveLocalNotification:(UILocalNotification *)notification {    
    [RBN handleLocalNotification:notification];
}

- (void)application:(UIApplication *)application handleActionWithIdentifier:(NSString *)identifier forLocalNotification:(UILocalNotification *)notification completionHandler:(void(^)())completionHandler {

    [RBN handleLocalNotification:notification];

    completionHandler();
}

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

5) Затем добавим в наш RBNDelegate метод, который будет сообщать о том, что нужно показать объявление:

-(void)presentAdvertisement:(RBNAd*)ad {
    //Ваш код. Обработайте пришедший объект RBNAd, содержащий информацию о рекламном объявлении, здесь. 
}

Описание RBNDelegate

Все методы являются @optional.

Этот метод будет вызван, если необходимо показать на экране страницу с акцией, информация о которой содержится в объекте ad:

-(void)presentAdvertisement:(RBNAd*)ad;

Перечисленные ниже методы помогают понять, работают ли сервисы iBeacon и если нет, то почему.

Метод вызывается, если использование служб геолокации ограниченно на данном устройстве (iOS Restrictions):

-(void)rbnRequestsDisableRestrictionForLocationServices;

Метод вызывается, если сервисы геолокации отключены для всего устройства и требуется попросить пользователя включить их:

-(void)rbnRequestsEnableLocationServices;

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

-(void)rbnRequestsAlwaysAuthorizationLocationServices;

Метод вызывается, есть BLE недоступен на данном устройстве:

-(void)rbnReportsThatBLEIsNotSupportedForThisDevice;

Метод вызывается, если по каким-то причинам пользователь отключил блютуз:

-(void)rbnRequestsEnableBluetooth;

Следующий метод вызывается, если iBeacon-модуль нашего SDK успешно запущен и функционирует:

-(void)rbnReportsThatBeaconsModuleRunning;

Если вы не желаете описывать методы получения статуса сервиса iBeacon, но хотите уведомлять пользователя о возможных проблемах с ним с помощью стандартный ActionSheet-уведомлений, вам достаточно просто возвращать YES из следующего метода:

-(BOOL)rbnShouldUseDefaultReporting;

Описание RBNAd

Описание RBNLocationDelegate

Следующий метод вызывается (не чаще чем раз в секунду), если RBN-iOS-SDK обновил геопозицию пользователя.

-(void)rbnDidUpdateLocation:(CLLocation*)location fromLocation:(CLLocation*)oldLocation forLayerID:(NSString*)layerID;

/**
location - текущая координата пользователя
oldLocation - предыдущая коордиана пользователя
layerID - идентификатор этажа, на котором находится пользователь
*/

Получение приватного ключа

Для получения уникального API ключа приложения свяжитесь с нами по адресу [email protected]

Требования

  • Xcode 6+ и iOS SDK 8+
  • iOS 7.0+ target deployment

Latest podspec

{
    "name": "RBN-iOS-SDK",
    "version": "1.2.0",
    "summary": "SDK allows you to connect your application to the Russian Beacon Network.",
    "description": "                   You can find everything you want to know on our homepage. RBN-iOS-SDK is an                   * iBeaconsn                   * Statisticsn                   * Advertisingn",
    "homepage": "https://github.com/WeLikeDigital/RBN-iOS-SDK",
    "license": {
        "type": "MIT",
        "file": "LICENSE.txt"
    },
    "authors": {
        "Darius": "[email protected]"
    },
    "platforms": {
        "ios": "7.0"
    },
    "source": {
        "git": "https://github.com/WeLikeDigital/RBN-iOS-SDK.git",
        "tag": "1.2.0"
    },
    "source_files": "*.h",
    "frameworks": [
        "CoreLocation",
        "Foundation",
        "CoreBluetooth",
        "UIKit",
        "AVFoundation",
        "AdSupport"
    ],
    "libraries": "RBN-iOS-SDK",
    "requires_arc": true,
    "vendored_libraries": "libRBN-iOS-SDK.a",
    "xcconfig": {
        "OTHER_LDFLAGS": "-ObjC",
        "LIBRARY_SEARCH_PATHS": ""${PODS_ROOT}/RBN-iOS-SDK/""
    },
    "dependencies": {
        "KZPropertyMapper": [],
        "AFNetworking": [],
        "FMDB": [],
        "SSZipArchive": []
    }
}

Pin It on Pinterest

Share This