System.Bluetooth.TBluetoothLEAdapter.StartDiscovery

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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

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

Abgerufen von „https://docwiki.embarcadero.com/Libraries/Athens/d/index.php?title=System.Bluetooth.TBluetoothLEAdapter.StartDiscovery&oldid=764368“