System.Bluetooth.TBluetoothLEAdapter.StartDiscovery
Delphi
function StartDiscovery(Timeout: Cardinal; const AFilterUUIDList: TBluetoothUUIDsList = nil; ForceConnect: Boolean = False;
const ABluetoothLEScanFilterList: TBluetoothLEScanFilterList = nil): Boolean;
C++
bool __fastcall StartDiscovery(unsigned Timeout, TBluetoothUUIDsList* const AFilterUUIDList = (TBluetoothUUIDsList*)(0x0), bool ForceConnect = false, TBluetoothLEScanFilterList* const ABluetoothLEScanFilterList = (TBluetoothLEScanFilterList*)(0x0));
プロパティ
| 種類 | 可視性 | ソース | ユニット | 親 |
|---|---|---|---|---|
| function | protected | System.Bluetooth.pas System.Bluetooth.hpp |
System.Bluetooth | TBluetoothLEAdapter |
説明
Bluetooth LE を使用するリモート デバイスを見つけるための検出操作を開始します。
お使いのアダプタのマネージャの StartDiscovery メソッドから StartDiscovery が呼び出されます。StartDiscovery から DoStartDiscovery が呼び出されます。
StartDiscovery は次のパラメータを受け取ります。
Timeout： Bluetooth LE を使用するリモート デバイスの検出にかける時間を指定します。AFilterUUIDList： 1 つ以上の Bluetooth GATT サービス UUID から成るリストです（任意指定）。このリストが指定された場合、アダプタは、指定されたサービスの少なくとも 1 つをアドバタイズしないリモート デバイスを無視します。ForceConnectがTrueでAFilterUUIDListの値が指定された場合、アダプタは、検出したすべてのリモート デバイスに接続して、各リモート デバイスから提供されるサービスの完全なリストを取得します。そのため、StartDiscovery では、指定されたサービスのいずれかを提供はするがアドバタイズしないデバイスを無視しません。
StartDiscovery の第2オーバーロード メソッドは、次のパラメータをとります：
ABluetoothLEScanFilterListは、スキャンしたい BLE デバイスに関する特定のデータ フィールドを格納する BLE スキャン フィルタのリストを表します。
検出されたリモート デバイスごとに、お使いのアダプタのマネージャの OnDiscoverLeDevice イベントが 1 回発生します。検出操作が終了すると、お使いのアダプタのマネージャの OnDiscoveryEnd イベントが発生します。検出されたリモート デバイスのリストが OnDiscoveryEnd から提供されます。
StartDiscovery は、検出が正常に開始された場合は True を返し、何らかの原因で検出が開始されなかった場合は False を返します。
プラットフォーム サポート
| プラットフォーム | 備考 |
|---|---|
|
32 ビット Windows |
|
|
OS X |
|
|
iOS |
|
|
Android |
|