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