Inherits from NSObject
Declared in RECOBeaconManager.h

Overview

RECOBeaconManager 클래스는 RECOBeacon 과 관련된 이벤트의 알람 설정에 대한 인터페이스를 제공합니다. 이 클래스의 인스턴스를 통해 RECOBeacon 의 이벤트 알람을 보낼 것인지 안 보낼 것인지를 설정하는 파라미터 값을 설정합니다.

RECOBeaconManager 는 아래 기능들을 지원합니다.

  • 지정한 region에 대해 모니터링을 수행하고 region 진입 여부에 따라 관련 이벤트를 발생.
  • 근처의 beacon들에 대해 ranging 을 수행

RECOBeaconManager 객체는 CLLocationManager 객체의 인스턴스를 포함하고 있습니다. CLLocationManager 에 대한 자세한 설명은 여기를 참고하십시오.

Tasks

Properties

delegate

발생하는 이벤트에 대한 알림을 받을 delegate 객체.

@property (nonatomic, assign) id<RECOBeaconManagerDelegate> delegate

Discussion

발생하는 이벤트에 대한 알림을 받을 delegate 객체.

Declared In

RECOBeaconManager.h

Class Methods

isMonitoringAvailable

이 기기가 region에 대한 모니터링을 지원하는지에 대한 Boolean 값을 리턴.

+ (BOOL)isMonitoringAvailable

Return Value

모니터링이 가능하면 YES, 불가능하면 NO.

Discussion

이 기기가 region에 대한 모니터링을 지원하는지에 대한 Boolean 값을 리턴.

모니터링의 지원여부는 기기의 하드웨어 지원 여부에만 영향을 받습니다. 즉, 위치서비스의 on/off 상태와는 별개입니다. 위치서비스의 사용가능 여부는 RECOBeaconManager 클래스의 locationServiceEnabled 메소드를 통해 알 수 있습니다.

Declared In

RECOBeaconManager.h

isRangingAvailable

이 기기가 bluetooth beacon에 대한 ranging을 지원하는지에 대한 Boolean 값을 리턴.

+ (BOOL)isRangingAvailable

Return Value

Ranging을 지원하면 YES, 지원하지 않으면 NO.

Discussion

이 기기가 bluetooth beacon에 대한 ranging을 지원하는지에 대한 Boolean 값을 리턴.

Declared In

RECOBeaconManager.h

locationServicesEnabled

위치서비스가 활성화 되어있는지에 대한 Boolean 값을 리턴.

+ (BOOL)locationServicesEnabled

Return Value

위치서비스가 활성화 상태이면 YES, 비활성화 상태이면 NO.

Discussion

위치서비스가 활성화 되어있는지에 대한 Boolean 값을 리턴.

Declared In

RECOBeaconManager.h

Instance Methods

getMonitoredRegions

모든 RECOBeaconManager 객체에 의해 공유되고 모니터링 되고 있는 region의 Set (읽기전용).

이 속성에 직접 region을 추가할 수 없습니다. 대신 startMonitoringForRegion: 메소드를 호출하여 등록해야 합니다. 이 속성에 속한 모든 region은 어플리케이션 내의 모든 RECOBeaconManager 가 공유합니다. 이 set 에 속한 region은 iOS system에 의해 관리되기 때문에 등록한 region과 같은 객체가 아닐 수도 있습니다. 따라서 등록한 region과 같은 region인지 판별할 때에는 region의 identifier속성을 통해 비교해야 합니다. 이 set은 어플리케이션의 실행/종료와 관계없이 유지됩니다. 따라서 기존에 등록한 region이 존재할 경우, 어플리케이션을 종료한 후 다시 실행하여도 이 set 은 기존에 등록된 region을 포함하도록 다시 생성됩니다.

- (NSSet *)getMonitoredRegions

Return Value

현재 모니터링 되고 있는 RECOBeaconRegion 들의 set.

Discussion

모든 RECOBeaconManager 객체에 의해 공유되고 모니터링 되고 있는 region의 Set (읽기전용).

이 속성에 직접 region을 추가할 수 없습니다. 대신 startMonitoringForRegion: 메소드를 호출하여 등록해야 합니다. 이 속성에 속한 모든 region은 어플리케이션 내의 모든 RECOBeaconManager 가 공유합니다. 이 set 에 속한 region은 iOS system에 의해 관리되기 때문에 등록한 region과 같은 객체가 아닐 수도 있습니다. 따라서 등록한 region과 같은 region인지 판별할 때에는 region의 identifier속성을 통해 비교해야 합니다. 이 set은 어플리케이션의 실행/종료와 관계없이 유지됩니다. 따라서 기존에 등록한 region이 존재할 경우, 어플리케이션을 종료한 후 다시 실행하여도 이 set 은 기존에 등록된 region을 포함하도록 다시 생성됩니다.

Declared In

RECOBeaconManager.h

getRangedRegions

현재 ranging 되고 있는 모든 region의 set (읽기전용).

- (NSSet *)getRangedRegions

Return Value

현재 ranging 되고 있는 RECOBeaconRegion 들의 set.

Discussion

현재 ranging 되고 있는 모든 region의 set (읽기전용).

이 set 에 담겨있는 객체의 타입은 RECOBeaconRegion 입니다.

Declared In

RECOBeaconManager.h

getVersion

RECO SDK Version.

- (NSString *)getVersion

Return Value

RECO SDK Version.

Discussion

RECO SDK Version.

Declared In

RECOBeaconManager.h

requestStateForRegion:

해당 region의 상태를 비동기적으로 가져옵니다.

- (void)requestStateForRegion:(RECOBeaconRegion *)recoRegion

Parameters

recoRegion

상태를 알고자 하는 region.

Discussion

해당 region의 상태를 비동기적으로 가져옵니다.

이 메소드를 통한 요청은 비동기식으로 처리되며 그 결과는 RECOBeaconManager 객체의 delegate 으로 전달됩니다. 결과를 전달받기 위해서는 recoManager:didDetermineState:forRegion: 메소드를 구현해야 합니다.

Declared In

RECOBeaconManager.h

startMonitoringForRegion:

해당 region에 대한 모니터링을 시작.

- (void)startMonitoringForRegion:(RECOBeaconRegion *)recoRegion

Parameters

recoRegion

모니터링 할 RECOBeaconRegion 객체. 본 파라미터는 nil이 될 수 없습니다.

Discussion

해당 region에 대한 모니터링을 시작.

모니터링 하고자 하는 모든 region에 대해 이 메소드를 각각 호출해야 합니다. 같은 identifier를 가지는 region이 이미 모니터링 중일 때에는 기존의 region이 신규 region과 교체됩니다. 이 메소드를 이용해 등록한 region은 어플리케이션 내의 모든 RECOBeaconManager 객체들이 공유하게 되며 현재 모니터링 중인 region들은 getMonitoredRegions: 메소드를 이용해 접근할 수 있습니다.

Region 에 관한 이벤트는 recoManager:didEnterRegion 메소드와 recoManager:didExitRegion 메소드를 통해 전달되며 만약 error가 발생할 경우, recoManager:monitoringDidFailForRegion: 메소드가 호출됩니다.

하나의 어플리케이션은 한 번에 20개의 region까지만 등록할 수 있습니다. 어플리케이션은 region에 진입 여부에 대한 이벤트 알림을 즉각 받지 못하면 평균 3분~5분사이에 받을 수 있습니다.

이벤트 알람을 받기까지 걸리는 시간은 iOS에서 직접 컨트롤하는 사항입니다.

Declared In

RECOBeaconManager.h

startRangingBeaconsInRegion:

해당 region내의 beacon들에 대한 알림을 전달하기 시작합니다.

- (void)startRangingBeaconsInRegion:(RECOBeaconRegion *)recoRegion

Parameters

recoRegion

타겟 beacon을 정의하는 정보를 포함하는 region객체. 어떤 identifier값을 사용하여 RECOBeaconRegion 객체를 초기화했느냐에 따라 매칭되는 beacon의 수가 결정됩니다. 사용된 모든 identifier정보와 매칭되는 beacon만을 찾습니다.

Discussion

해당 region내의 beacon들에 대한 알림을 전달하기 시작합니다.

region이 등록되면 발견하는 모든 beacon에 대해 recoManager:didRangeBeacons:inRegion: 메소드를 호출하여 알림을 보냅니다. 만약 해당 region을 등록하는 중 error가 발생하면 recoManager:rangingBeaconsDidFailForRegion:withError: 메소드를 호출하여 error정보를 알립니다.

Declared In

RECOBeaconManager.h

stopMonitoringForRegion:

해당 region에 대한 모니터링을 멈춥니다.

- (void)stopMonitoringForRegion:(RECOBeaconRegion *)recoRegion

Parameters

recoRegion

모니터링을 멈출 RECOBeaconRegion.

Discussion

해당 region에 대한 모니터링을 멈춥니다.

Declared In

RECOBeaconManager.h

stopRangingBeaconsInRegion:

해당 region내의 beacon들에 대한 알림 전달을 멈춥니다.

- (void)stopRangingBeaconsInRegion:(RECOBeaconRegion *)recoRegion

Parameters

recoRegion

알림 전달을 멈출 RECOBeaconRegion.

Discussion

해당 region내의 beacon들에 대한 알림 전달을 멈춥니다.

Declared In

RECOBeaconManager.h