Conforms to NSObject
Declared in RECOBeaconManager.h

Overview

RECOBeaconManagerDelegate 은 RECOBeaconManager 로부터 관련된 이벤트의 알림을 받기 위한 메소드를 정의하고 있습니다. delegate 객체의 메소드는 상응하는 RECOBeaconManager 메소드를 호출한 쓰레드와 동일한 쓰레드에서 호출됩니다.

Tasks

Instance Methods

recoManager:didDetermineState:forRegion:

해당 region에 대한 상태를 알립니다.

- (void)recoManager:(RECOBeaconManager *)manager didDetermineState:(RECOBeaconRegionState)state forRegion:(RECOBeaconRegion *)region

Parameters

manager

이 메세지를 전달하는 RECOBeaconManager.

state

해당 region의 상태. RECOBeaconRegionState 의 값 중 하나를 갖습니다.

region

현재 상태를 알리는 region.

Discussion

해당 region에 대한 상태를 알립니다.

RECOBeaconManager 는 모니터링중인 region의 state (RECOBeaconRegionState) 변화가 있을 때마다 본 메소드를 호출합니다. 또한 requestStateForRegion: 메소드가 불린 후에도 이 메소드를 호출합니다. State에 변화가 생기는 몇몇 경우는 아래와 같습니다. region의 경계를 통과할 때마다 recoManager:didEnterRegion: 메소드나 recoManager:didExitRegion: 메소드와 함께 이 메소드를 호출합니다.

Declared In

RECOBeaconManager.h

recoManager:didEnterRegion:

사용자가 해당하는 region에 들어갔음을 알립니다.

- (void)recoManager:(RECOBeaconManager *)manager didEnterRegion:(RECOBeaconRegion *)region

Parameters

manager

이 메세지를 전달하는 RECOBeaconManager.

region

진입한 region의 정보를 담고 있는 RECOBeaconRegion 객체.

Discussion

사용자가 해당하는 region에 들어갔음을 알립니다.

region은 어플리케이션의 공유자원 (shared resource)이기 때문에 각각의 RECOBeaconManager 객체는 자신과 관계된 delegate 에게 이 메세지를 전달합니다. 어떤 RECOBeaconManager 객체가 해당 region을 등록했는지는 상관이 없고, 만약 여러개의 RECOBeaconManager 가 하나의 delegate을 공유한다면 해당 delegate은 여러번의 메세지를 받게 됩니다.

전달되는 region은 등록했던 region과 같은 객체가 아닐 수 있기 때문에 객체의 비교시에 pointer를 이용하는 대신 region의 identifier를 이용해야 합니다.

Declared In

RECOBeaconManager.h

recoManager:didExitRegion:

사용자가 해당하는 region에서 떠났음을 알립니다.

- (void)recoManager:(RECOBeaconManager *)manager didExitRegion:(RECOBeaconRegion *)region

Parameters

manager

이 메세지를 전달하는 RECOBeaconManager.

region

떠난 region의 정보를 담고 있는 RECOBeaconRegion 객체.

Discussion

사용자가 해당하는 region에서 떠났음을 알립니다.

region은 어플리케이션의 공유자원 (shared resource)이기 때문에 각각의 RECOBeaconManager 객체는 자신과 관계된 delegate 에게 이 메세지를 전달합니다. 어떤 RECOBeaconManager 객체가 해당 region을 등록했는지는 상관이 없고, 만약 여러개의 RECOBeaconManager 가 하나의 delegate을 공유한다면 해당 delegate은 여러번의 메세지를 받게 됩니다.

전달되는 region은 등록했던 region과 같은 객체가 아닐 수 있기 때문에 객체의 비교시에 pointer를 이용하는 대신 region의 identifier를 이용해야 합니다.

Declared In

RECOBeaconManager.h

recoManager:didRangeBeacons:inRegion:

하나 이상의 beacon이 ranging 되었음을 알립니다.

- (void)recoManager:(RECOBeaconManager *)manager didRangeBeacons:(NSArray *)beacons inRegion:(RECOBeaconRegion *)region

Parameters

manager

이 메세지를 전달하는 RECOBeaconManager.

beacons

현재 range 내의 beacon정보를 담고있는 RECOBeacon 객체 배열. 이 객체들이 담고 있는 정보를 통해 각 beacon의 range와 identifier를 알 수 있습니다.

region

beacons 를 찾기 위해 사용된 파라미터 정보를 포함하는 RECOBeaconRegion 객체.

Discussion

하나 이상의 beacon이 ranging 되었음을 알립니다.

RECOBeaconManager 는 beacon이 range내에 들어오거나 나갈 때마다 이 메소드를 호출합니다. 또한 beacon의 range가 바뀔 때에도 이 메소드를 호출합니다. (예: beacon이 가까워 졌을 때)

전달되는 region은 등록했던 region과 같은 객체가 아닐 수 있기 때문에 객체의 비교시에 pointer를 이용하는 대신 region의 identifier를 이용해야 합니다.

Declared In

RECOBeaconManager.h

recoManager:didStartMonitoringForRegion:

새로운 region에 대한 모니터링이 시작됐음을 알립니다.

- (void)recoManager:(RECOBeaconManager *)manager didStartMonitoringForRegion:(RECOBeaconRegion *)region

Parameters

manager

이 메세지를 전달하는 RECOBeaconManager.

region

모니터링을 시작한 region.

Discussion

새로운 region에 대한 모니터링이 시작됐음을 알립니다.

Declared In

RECOBeaconManager.h

recoManager:monitoringDidFailForRegion:withError:

모니터링 하려는 region에 대해 error가 발생했음을 알립니다.

- (void)recoManager:(RECOBeaconManager *)manager monitoringDidFailForRegion:(RECOBeaconRegion *)region withError:(NSError *)error

Parameters

manager

이 메세지를 전달하는 RECOBeaconManager.

region

모니터링을 실패한 region.

error

region 모니터링이 실패한 이유를 나타내는 error code를 포함하는 error객체.

Discussion

모니터링 하려는 region에 대해 error가 발생했음을 알립니다.

해당 region에 대한 모니터링을 시도하다가 error가 발생할 경우 manager 가 delegate 에게 이 메세지를 전달합니다. 모니터링 할 수 없는 region일 경우나 모니터링 서비스를 준비할 때 발생하는 일반적인 에러에도 이 메소드가 호출됩니다.

Declared In

RECOBeaconManager.h

recoManager:rangingBeaconsDidFailForRegion:withError:

주위의 beacon들에 대한 ranging 정보를 모으던 중 error가 발생했음을 delegate에 알립니다.

- (void)recoManager:(RECOBeaconManager *)manager rangingBeaconsDidFailForRegion:(RECOBeaconRegion *)region withError:(NSError *)error

Parameters

manager

이 메세지를 전달하는 RECOBeaconManager.

region

Ranging을 실패한 region.

error

Ranging이 실패한 이유를 나타내는 error code를 포함하는 error객체.

Discussion

주위의 beacon들에 대한 ranging 정보를 모으던 중 error가 발생했음을 delegate에 알립니다.

대부분의 경우 RECOBeaconRegion 객체의 등록이 실패하는 경우에 error가 발생합니다. region 객체 자체가 유효하지 않은 경우나 유효하지 않은 정보를 포함하고 있는 경우에도 이 메소드가 호출됩니다.

Declared In

RECOBeaconManager.h