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));
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
function | protected | System.Bluetooth.pas System.Bluetooth.hpp |
System.Bluetooth | TBluetoothLEAdapter |
Description
Démarre une opération découverte (ou détection) pour trouver les périphériques distants via le protocole Bluetooth Low Energy.
La méthode StartDiscovery du gestionnaire de votre adaptateur appelle StartDiscovery. StartDiscovery appelle DoStartDiscovery.
StartDiscovery accepte les paramètres suivants :
Timeout
détermine le temps passé pour la découverte des périphériques distants via le protocole Bluetooth Low Energy.AFilterUUIDList
est une liste facultative d'un ou plusieurs UUID de services GATT Bluetooth. Si vous fournissez cette liste, l'adaptateur ignore les périphériques distants qui ne publient pas au moins l'un des services spécifiés.- Si
ForceConnect
vautTrue
et que vous fournissez une valeur pourAFilterUUIDList
, l'adaptateur se connecte à chaque périphérique distant découvert pour obtenir une liste complète des services fournis par chaque périphérique distant. Ainsi, StartDiscovery n'ignore pas les périphériques qui fournissent l'un des services spécifiés mais ne le publient pas.
La seconde méthode surchargée de StartDiscovery accepte le paramètre suivant :
ABluetoothLEScanFilterList
représente une liste de filtres d'analyse BLE contenant des champs de données spécifiques relatifs aux périphériques BLE à analyser.
L'événement OnDiscoverLeDevice du gestionnaire de votre adaptateur se produit une fois pour chacun des périphériques distants découverts. Lorsque l'opération de découverte est terminée, l'événement OnDiscoveryEnd du gestionnaire de votre adaptateur se produit. OnDiscoveryEnd fournit la liste des périphériques distants découverts.
StartDiscovery renvoie True
si la découverte a démarré avec succès, ou False
si quelque chose a empêché son démarrage.
Prise en charge de la plate-forme
Plate-forme | Remarques |
---|---|
Windows 32 bits |
|
OS X |
|
iOS |
|
Android |
|