RangeBeacons
iBeacon 목록 및 iOS 또는 iPadOS 장비와 가까운 정도를 반환합니다.
포맷
RangeBeacons(UUID {; 시간 제한 ; 주 ; 보조 })
매개 변수
UUID
- iBeacon이 검색할 수 있는 범용 고유 식별자입니다. UUID는 하나 이상의 iBeacon을 특정 유형으로 확인하거나 특정 조직의 iBeacon을 확인합니다. 예를 들어 특정 백화점의 모든 지점에 대한 iBeacon은 동일한 UUID를 공유할 수 있습니다.
시간 제한
- 값을 반환하기까지 기다려야 하는 시간입니다(초 단위). 시간 제한
이 지정되지 않은 경우 해당 함수는 5초 후 값을 반환합니다.
주
- iBeacon 그룹을 확인하는 값입니다. 예를 들어 특정 백화점 지점의 모든 iBeacon은 동일한 주 값을 공유할 수 있습니다.
보조
- iBeacon 그룹에서 특정 iBeacon을 확인하는 값입니다. 예를 들어 특정 백화점 지점 장난감 코너의 모든 iBeacon은 동일한 보조 값을 공유할 수 있습니다.
괄호{ }의 매개 변수는 옵션입니다.
반환되는 데이터 유형
텍스트
다음 버전에서 시작됨
15.0
설명
FileMaker Go에서 다음을 반환합니다.
UUID - 각각의 확인된 iBeacon에 대한 범용 고유 식별자입니다.
주 - iBeacon 그룹을 확인하는 값입니다.
보조 - iBeacon 그룹에서 특정 iBeacon을 확인하는 값입니다.
proximity - iBeacon의 가까운 정도를 상대적으로 표시하는 숫자입니다. 반환 결과:
- 0(알 수 없음): iBeacon의 가까운 정도를 결정할 수 없습니다.
- 1(아주 가까움): iBeacon이 장비와 아주 가까이에 있습니다.
- 2(근처): iBeacon이 장비와 비교적 가까이에 있습니다.
- 3(멀리 있음): iBeacon이 장비와 멀리 떨어져 있습니다.
정확성 - 미터 단위로 측정된 iBeacon의 근접성에 대한 정확성 값입니다. 이 값으로 여러 iBeacon의 같은 근접성 값을 구분할 수 있습니다. 음수 값은 정확성을 결정할 수 없다는 의미입니다.
rssi - 데시벨로 측정된 iBeacon의 수신 신호 강도입니다.
참고
- 조건과 일치하는 iBeacon이 없는 경우 이 함수는 빈 문자열을 반환합니다.
- 위치 서비스 설정이 꺼져 있는 경우 이 함수는 빈 문자열을 반환합니다.
- 쿼리가 유효하지 않은 경우 이 함수는 물음표(?)를 반환합니다.
예제 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초 후에 결과를 반환합니다.