RangeBeacons

iBeacon と iOS デバイスまたは iPadOS デバイスとの距離の一覧を返します。

構文 

RangeBeacons (UUID {; タイムアウト ; メジャー ; マイナー})

引数 

UUID - 検索対象の iBeacon の Universally Unique Identifier。UUID によって特定の種類としての 1 つ以上の iBeacon または特定の組織からの 1 つ以上の iBeacon が識別されます。たとえば、デパートのすべての支店の iBeacon で同じ UUID を共有できます。

タイムアウト - 値が返されるまでに待機する秒数。タイムアウトが指定されていない場合、5 秒後に値が返されます。

メジャー - iBeacon のグループを識別する値。たとえば、デパートの特定の支店のすべての iBeacon で同じメジャー値を共有できます。

マイナー - iBeacon のグループ内の特定の iBeacon を識別する値。たとえば、デパートの特定の支店の玩具セクションのすべての iBeacon で同じマイナー値を共有できます。

中カッコ { } 内の引数はオプションです。

戻り値のデータタイプ 

テキスト

起点バージョン 

15.0

説明 

FileMaker Go の場合は、次を返します:

UUID - 識別された iBeacon ごとの Universally Unique Identifier。

メジャー - 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 秒後に結果が返されます。