참조 > 함수 참조 > 모바일 함수 > RangeBeacons
 

RangeBeacons

iBeacon 목록 및 iOS 장비와 가까운 정도를 반환합니다.

포맷 

RangeBeacons(UUID {; 시간 제한 ; 주 ; 보조 })

매개 변수 

UUID - iBeacon이 검색할 수 있는 범용 고유 식별자입니다. UUID는 하나 이상의 iBeacon을 특정 유형으로 확인하거나 특정 조직의 iBeacon을 확인합니다. 예를 들어 특정 백화점의 모든 지점에 대한 iBeacon은 동일한 UUID를 공유할 수 있습니다.

시간 제한 - 값을 반환하기까지 기다려야 하는 시간입니다(초 단위). 시간 제한이 지정되지 않은 경우 해당 함수는 5초 후 값을 반환합니다.

- iBeacon 그룹을 확인하는 값입니다. 예를 들어 특정 백화점 지점의 모든 iBeacon은 동일한 주 값을 공유할 수 있습니다.

보조 - iBeacon 그룹에서 특정 iBeacon을 확인하는 값입니다. 예를 들어 특정 백화점 지점 장난감 코너의 모든 iBeacon은 동일한 보조 값을 공유할 수 있습니다.

괄호{ }의 매개 변수는 옵션입니다.

반환되는 데이터 유형 

텍스트

다음에서 발생 

FileMaker Pro 15.0

설명 

FileMaker Go에서 다음을 반환합니다.

UUID - 각각의 확인된 iBeacon에 대한 범용 고유 식별자입니다.

- iBeacon 그룹을 확인하는 값입니다.

보조 - iBeacon 그룹에서 특정 iBeacon을 확인하는 값입니다.

proximity - iBeacon의 가까운 정도를 상대적으로 표시하는 숫자입니다. 반환 결과:

0(알 수 없음): iBeacon의 가까운 정도를 결정할 수 없습니다.

1(아주 가까움): iBeacon이 iOS 장비와 아주 가까이에 있습니다.

2(근처): iBeacon이 iOS 장비와 비교적 가까이에 있습니다.

3(멀리 있음): iBeacon이 iOS 장비와 멀리 떨어져 있습니다.

정확성 - 미터 단위로 측정된 iBeacon의 근접성에 대한 정확성 값입니다. 이 값으로 여러 iBeacon의 같은 근접성 값을 구분할 수 있습니다. 음수 값은 정확성을 결정할 수 없다는 의미입니다.

rssi - 데시벨로 측정된 iBeacon의 수신 신호 강도입니다.

참고 

조건과 일치하는 iBeacon이 없는 경우 이 함수는 빈 문자열을 반환합니다.

iOS 위치 서비스 설정이 꺼져 있는 경우 이 함수는 빈 문자열을 반환합니다.

쿼리가 유효하지 않은 경우 이 함수는 물음표(?)를 반환합니다.

예제 1 

RangeBeacons("D9B9EC1F-XXXX-YYYY-80A9-1E39D4CEA95C")는 가까이에 있는 모든 iBeacon에 관한 정보와 다음과 같은 지정된 UUID를 반환합니다.

D9B9EC1F-XXXX-YYYY-80A9-1E39D4CEA95C, 10, 1, 0, -1.00, 0
D9B9EC1F-XXXX-YYYY-80A9-1E39D4CEA95C, 5, 1, 3, 14.68, -79
D9B9EC1F-XXXX-YYYY-80A9-1E39D4CEA95C, 5, 2, 3, 18.96, -81

예제 2 

RangeBeacons("D9B9EC1F-XXXX-YYYY-80A9-1E39D4CEA95C"; 30)는 30초 후에 결과를 반환합니다.

예제 3 

RangeBeacons("D9B9EC1F-XXXX-YYYY-80A9-1E39D4CEA95C"; 20; 10; 1)는 iBeacon에 대한 정보와 지정된 UUID, 값 10, 보조 값 1을 반환합니다. 이 함수는 20초 후에 결과를 반환합니다.

관련 주제 

함수 참조(카테고리순)

함수 참조(알파벳순)

함수 정보

공식 정보