RangeBeacons
返回 iBeacons 及其与 iOS 或 iPadOS 设备之间距离的列表。
格式
RangeBeacons (UUID {; 超时; 较大值; 较小值})
参数
UUID
- 要搜索的 iBeacon 的通用唯一标识符。UUID 标识属于特定类型或来自特定组织的一个或多个 iBeacon。例如,一家百货商店的所有分支的 iBeacon 均可共享同一 UUID。
超时
- 在返回值之前等待的秒数。如果未指定超时
,则此函数将在五秒钟后返回一个值。
较大值
- 标识一组 iBeacon 的值。例如,某个百货商店的特定分支中的所有 iBeacon 可以共享相同的较大值。
较小值
- 标识一组 iBeacon 中的特定 iBeacon 的值。例如,某百货商店特定分店的玩具部中的所有 iBeacon 可以共享相同的较小值。
括号 { } 中的参数是可选的。
返回的数据类型
文本
原始版本
15.0
说明
在 FileMaker Go 中,返回:
UUID - 每个识别出的 iBeacon 的通用唯一标识符。
较大值 - 标识一组 iBeacon 的值。
较小值 - 标识一组 iBeacon 中的特定 iBeacon 的值。
近程 - 表示与 iBeacon 的相对距离的数字。返回:
- 0(未知)无法确定与 iBeacon 的距离。
- 1(邻近)iBeacon 距离设备非常近。
- 2(附近)iBeacon 距离设备相对比较近。
- 3(远)iBeacon 距离设备很远。
精确度 - 距离 iBeacon 的近似值的精确度(以米为单位)。此值可帮助您区分具有相同近程值的 iBeacon。负值表示无法确定精确度。
rssi - 收到的 iBeacon 的信号强度,以分贝为单位。
注释
- 如果没有符合条件的 iBeacon,此函数将返回一个空字符串。
- 如果“位置服务”设置已关闭,则此函数将返回一个空字符串。
- 如果查询无效,此函数将返回一个问号 (?)。
示例 1
RangeBeacons("D9B9EC1F-XXXX-YYYY-80A9-1E39D4CEA95C")
返回有关具有指定 UUID
的所有附近 iBeacon 的信息:
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)
返回有关具有指定 UUID
并且较大值
为 10 且较小值
为 1 的 iBeacon 的信息。它将在 20 秒钟后返回结果。