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 秒钟后返回结果。