System.Bluetooth.Components.TBluetoothLE.DiscoverDevices

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function DiscoverDevices(ATimeout: Integer): Boolean; overload;
function DiscoverDevices(ATimeout: Integer; const AList: TBluetoothUUIDsList): Boolean; overload;
function DiscoverDevices(ATimeout: Integer; AList: array of TBluetoothUUID): Boolean; overload;
function DiscoverDevices(ATimeout: Cardinal; const ABluetoothLEScanFilterList: TBluetoothLEScanFilterList): Boolean; overload;

C++

bool __fastcall DiscoverDevices(int ATimeout)/* overload */;
bool __fastcall DiscoverDevices(int ATimeout, System::Bluetooth::TBluetoothUUIDsList* const AList)/* overload */;
bool __fastcall DiscoverDevices(int ATimeout, GUID *AList, const int AList_High)/* overload */;
bool __fastcall DiscoverDevices(unsigned ATimeout, System::Bluetooth::TBluetoothLEScanFilterList* const ABluetoothLEScanFilterList)/* overload */;

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
System.Bluetooth.Components.pas
System.Bluetooth.Components.hpp
System.Bluetooth.Components TBluetoothLE


Beschreibung

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

DiscoverDevices erwartet immer ein einzelnes Timeout-Argument, das die Dauer enthält, die für den Ermittlungsvorgang von Remote-Geräten, die Bluetooth Low Energy verwenden, aufgewendet werden soll.

Sie können auch ein AList-Argument, ein Array oder eine Liste von UUIDs von Diensten angeben, um nach Remote-Geräten zu suchen. Wenn Sie eine Liste mit Dienst-UUIDs angeben, werden bei der Ermittlung Remote-Geräte ignoriert, die nicht mindestens einen Dienst mit einer UUID aus der angegebenen Liste bereitstellen.

Bei Abschluss der Ermittlung wird das Ereignis OnEndDiscoverDevices ausgelöst. OnEndDiscoverDevices stellt eine Liste der gefundenen Remote-Geräte bereit.

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

Beachtung: Bei Verwendung von iOS 13.3.1 und 13.3.0 verursachen die Ermittlungsmethoden TBluetoothManagerLE.StartDiscovery und TBluetoothLE.DiscoverDevices des Bluetooth LE-Geräts, dass die mobile App ohne Hinweis geschlossen wird.

Plattformunterstützung

Plattform Bemerkungen

Windows

OS X

  • OnEndDiscoverDevices wird immer einige Zeit nach der angegebenen Dauer Timeout, niemals davor, ausgelöst.
  • Gibt immer True zurück.

iOS

  • OnEndDiscoverDevices wird immer einige Zeit nach der angegebenen Dauer Timeout, niemals davor, ausgelöst.
  • Gibt immer True zurück.

Android

Siehe auch