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