機能概要
指定した名前空間またはインスタンスIDであるすべてのEddystoneの情報を取得します。
機能詳細
指定した名前空間ID、インスタンスIDのEddystoneの情報をすべて取得します。
名前空間IDとインスタンスIDをそれぞれ指定しなかった場合はすべてのEddystoneにマッチします。
- 注意
- OS別動作状況
OS 動作状況 Android BLE機能を搭載している、Android 5.0以上の端末のみ動作します。 iOS BLE機能を搭載している端末のみ動作します。 Windows 未対応です。
- 結果のディクショナリーの内容 このロジックは各要素に次の内容を含むディクショナリーを返します。
キー 値 time 日時データ
このデバイスを最後に検出した時刻identifier 文字列データ
デバイスの識別に使用する文字列name 文字列データ
デバイス名rssi 数値データ
受信強度eddystone_EID ディクショナリー(連想配列)
(デバイスがEddystone-EIDに対応している場合)
デバイスのEddystone-EID情報eddystone_TLM ディクショナリー(連想配列)
(デバイスがEddystone-TLMに対応している場合)
デバイスのEddystone-TLM情報eddystone_UID ディクショナリー(連想配列)
(デバイスがEddystone-UIDに対応している場合)
デバイスのEddystone-UID情報eddystone_URL ディクショナリー(連想配列)
(デバイスがEddystone-URLに対応している場合)
デバイスのEddystone-URL情報
デバイスのEddystone-EID情報は、次の内容を含むディクショナリーです。
キー | 値 |
---|---|
tx_power | 数値データ パワー値 |
eid | 文字列データ EID値 |
デバイスのEddystone-TLM情報は、次の内容を含むディクショナリーです。
キー | 値 |
---|---|
version | 数値データ バージョン |
battery_voltage | 数値データ バッテリー値 |
beacon_temperature | 数値データ 温度 |
advertisement_count | 数値データ アドバタイズメント回数 |
elapsed_time | 数値データ 経過時間 |
デバイスのEddystone-UID情報は、次の内容を含むディクショナリーです。
キー | 値 |
---|---|
tx_power | 数値データ パワー値 |
namespace_id | 文字列データ 名前ID |
instance_id | 文字列データ インスタンスID |
デバイスのEddystone-URL情報は、次の内容を含むディクショナリーです。
キー | 値 |
---|---|
tx_power | 数値データ パワー値 |
url | 文字列データ URL文字列 |
- 覚え書き
- 結果として返されるディクショナリーの例を以下に示します。
キー 値 time 2018/5/1 12:34:56 identifier 13:57:9B:DF name My Beacon rssi -50 eddystone_UID
キー 値 tx_power -42 namespace_id 123456789A instance_id BCDEF0 eddystone_URL
キー 値 tx_power -42 url https://goo.gl/FYr134
キー 値 time 2018/5/1 23:45:6 identifier 12345678-9ABC-4DEF-8123-456789ABCDEF name rssi -70 eddystone_EID
キー 値 tx_power -42 eid 13579BDF eddystone_TLM
キー 値 version 0 battery_voltage 123 beacon_temperature 5.678 advertisement_count 90 elapsed_time 2469
- 注釈
- デバイスや電波状況によっては、スキャンを開始してから実際にデバイス情報が取得できるようになるまでに数秒要する場合があります。
- 携帯端末BLEデバイスやOS側でGPSサービスを開始しておく必要があります。
パラメーター
- 戻り値
- ディクショナリー(連想配列)
デバイスの情報を返します。
<前 1928_デバイス/Eddystoneスキャン開始(名前空間指定)>
<次 1930_デバイス/Eddystoneスキャン中止(名前空間指定)>