System.Bluetooth.TBluetoothLEAdapter.StartDiscovery

• Übergeordnet: TBluetoothLEAdapter

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));

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
function	protected	System.Bluetooth.pas System.Bluetooth.hpp	System.Bluetooth	TBluetoothLEAdapter

Beschreibung

Beginnt die Ermittlung von Remote-Geräten, die Bluetooth Low Energy verwenden.

Die Methode StartDiscovery des Managers Ihres Adapters ruft StartDiscovery auf. StartDiscovery ruft DoStartDiscovery auf.

StartDiscovery nimmt die folgenden Parameter an:

• Timeout legt fest, wie viel Zeit für die Ermittlung von Remote-Geräten mit Bluetooth Low Energy aufgewendet werden soll.
• AFilterUUIDList ist eine optionale Liste mit einer oder mehreren UUIDs von Bluetooth-GATT-Diensten. Wenn Sie diese Liste bereitstellen, ignoriert der Adapter die Remote-Geräte, die nicht mindestens einen der angegebenen Dienste bekanntgeben.
• Wenn ForceConnect True ist und Sie einen Wert für AFilterUUIDList angeben, stellt der Adapter eine Verbindung zu allen ermittelten Remote-Geräten her, um eine vollständige Liste der Dienste zu erstellen, die jedes Remote-Gerät bereitstellt, damit StartDiscovery keine Geräte ignoriert, die einen der angegebenen Dienste bereitstellen, aber nicht bekanntgeben.

Die zweite überladene Methode von StartDiscovery nimmt die folgenden Parameter an:

• ABluetoothLEScanFilterList repräsentiert eine Liste mit den BLE-Suchfiltern, die bestimmte Datenfelder über die BLE-Geräte, nach denen Sie suchen möchten, enthalten.

Das Ereignis OnDiscoverLeDevice des Managers Ihres Adapters wird einmal für jedes ermittelte Remote-Gerät ausgelöst. Bei Abschluss der Ermittlung wird das Ereignis OnDiscoveryEnd des Managers Ihres Adapters ausgelöst. OnDiscoveryEnd stellt eine Liste der ermittelten Remote-Geräte bereit.

StartDiscovery gibt True zurück, wenn die Ermittlung erfolgreich gestartet wurde, oder False, wenn die Ermittlung nicht gestartet werden konnte.

Plattformunterstützung

Plattform	Bemerkungen
32-Bit-Windows 64-Bit-Windows	Timeout wird ignoriert, weil StartDiscovery sofort das Ereignis OnDiscoveryEnd auslöst. Gibt immer True zurück.
OS X	OnDiscoveryEnd wird immer einige Zeit nach der angegebenen Dauer (Timeout), niemals davor ausgelöst. Gibt immer True zurück.
iOS	OnDiscoveryEnd wird immer einige Zeit nach der angegebenen Dauer (Timeout), niemals davor ausgelöst. Gibt immer True zurück.
Android	OnDiscoveryEnd wird immer nach der angegebenen Dauer (Timeout), niemals davor ausgelöst.

Siehe auch

• System.Boolean
• System.Integer

• System.Bluetooth.TBluetoothLEAdapter.FManager

• System.Bluetooth.TBluetoothLEManager.OnDiscoveryEnd

• System.Bluetooth.TBluetoothLEManager.StartDiscovery
• System.Bluetooth.TBluetoothLEAdapter.DoStartLeDiscovery