System.Bluetooth.TBluetoothLEAdapter.StartDiscovery

• Aller au parent : TBluetoothLEAdapter

Delphi

function StartDiscovery(Timeout: Cardinal; const AFilterUUIDList: TBluetoothUUIDsList = nil; ForceConnect: Boolean = False): Boolean;

C++

bool __fastcall StartDiscovery(unsigned Timeout, TBluetoothUUIDsList* const AFilterUUIDList = (TBluetoothUUIDsList*)(0x0), bool ForceConnect = false);

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 vaut True et que vous fournissez une valeur pour AFilterUUIDList, 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.

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 Windows 64 bits	Timeout est ignoré car StartDiscovery déclenche immédiatement l'événement OnDiscoveryEnd. Renvoie toujours True.
Mac OS X	OnDiscoveryEnd se produit toujours un certain temps après le Timeout spécifié, jamais avant. Renvoie toujours True.
iOS	OnDiscoveryEnd se produit toujours un certain temps après le Timeout spécifié, jamais avant. Renvoie toujours True.
Android	OnDiscoveryEnd se produit toujours après le Timeout spécifié, jamais avant.

Voir aussi

• System.Boolean
• System.Integer

• System.Bluetooth.TBluetoothLEAdapter.FManager

• System.Bluetooth.TBluetoothLEManager.OnDiscoveryEnd

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