BluetoothLEDevice Classe

Référence

Définition

Espace de noms:: Windows.Devices.Bluetooth

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

Représente un appareil Bluetooth LE.

Pour obtenir des exemples de code, consultez Exemple Bluetooth Low Energy et Exemple d’énumération et de jumelage d’appareils.

public ref class BluetoothLEDevice sealed : IClosable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class BluetoothLEDevice final : IClosable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class BluetoothLEDevice : System.IDisposable

Public NotInheritable Class BluetoothLEDevice
Implements IDisposable

Héritage: Object Platform::Object IInspectable BluetoothLEDevice

Attributs: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implémente: IClosable IDisposable

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)
Fonctionnalités de l’application	bluetooth

Remarques

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
1511	10586	Apparence
1511	10586	BluetoothAddressType
1511	10586	DeviceInformation
1511	10586	FromBluetoothAddressAsync(UInt64,BluetoothAddressType)
1511	10586	GetDeviceSelectorFromAppearance
1511	10586	GetDeviceSelectorFromBluetoothAddress(UInt64)
1511	10586	GetDeviceSelectorFromBluetoothAddress(UInt64,BluetoothAddressType)
1511	10586	GetDeviceSelectorFromConnectionStatus
1511	10586	GetDeviceSelectorFromDeviceName
1511	10586	GetDeviceSelectorFromPairingState
1703	15063	DeviceAccessInformation
1703	15063	GetGattServicesAsync
1703	15063	GetGattServicesAsync(BluetoothCacheMode)
1703	15063	GetGattServicesForUuidAsync(Guid)
1703	15063	GetGattServicesForUuidAsync(Guid,BluetoothCacheMode)
1703	15063	RequestAccessAsync
1709	16299	BluetoothDeviceId
1803	17134	WasSecureConnectionUsedForPairing

Propriétés

Appearance	Obtient l’objet BluetoothLEAppearance pour l’appareil Bluetooth LE.
BluetoothAddress	Obtient l’adresse de l’appareil.
BluetoothAddressType	Obtient le type d’adresse de l’appareil Bluetooth LE.
BluetoothDeviceId	Obtient l’ID d’appareil Bluetooth.
ConnectionStatus	Obtient le status de connexion de l’appareil.
DeviceAccessInformation	Obtient deviceAccessInformation.
DeviceId	Obtient l’ID de l’appareil.
DeviceInformation	Obtient les informations de l’appareil Bluetooth LE.
GattServices	Obtient la liste en lecture seule des services GATT pris en charge par l’appareil. Important L’API GattServices est déconseillée et peut ne pas être disponible dans les futures versions de Windows. Utilisez plutôt GetGattServicesAsync.
Name	Obtient le nom de l’appareil Bluetooth LE.
WasSecureConnectionUsedForPairing	Obtient une valeur booléenne indiquant si l’appareil BluetoothLEDevice a été associé à l’aide d’une connexion sécurisée.

Méthodes

Close()	Ferme cet appareil Bluetooth LE. Cela peut fermer la connexion à l’appareil s’il s’agit de la seule application disposant d’une connexion.
Dispose()	Exécute les tâches définies par l'application associées à la libération ou à la redéfinition des ressources non managées.
FromBluetoothAddressAsync(UInt64)	Renvoie un objet BluetoothLEDevice représentant l’appareil Bluetooth LE homologue avec l’adresse donnée. Consultez Remarques (dans cette rubrique membre).
FromBluetoothAddressAsync(UInt64, BluetoothAddressType)	Renvoie un objet BluetoothLEDevice représentant l’appareil homologue avec l’adresse et le type d’adresse donnés. Consultez Remarques (dans cette rubrique membre).
FromIdAsync(String)	Renvoie un objet BluetoothLEDevice pour l’ID donné. Voir Remarques dans la rubrique membre.
GetConnectionParameters()	Récupère les paramètres de connexion de l’appareil distant. Si plusieurs applications ou d’autres scénarios système demandent également ces paramètres, le système combine automatiquement les paramètres, lorsqu’ils sont compatibles, en fonction de la priorité du système. Notes Lorsque l’appareil n’est pas connecté, les paramètres de connexion ne sont pas valides (tous zéro).
GetConnectionPhy()	Récupère des informations sur la couche physique (PHY) Bluetooth LE. Notes Lorsque l’appareil n’est pas connecté, les PHY de connexion ne sont pas valides (tous faux)
GetDeviceSelector()	Obtient une chaîne AQS (Advanced Query Syntax) permettant d’identifier tous les appareils Bluetooth Low Energy (LE). Cette chaîne est passée à la méthode FindAllAsync ou CreateWatcher afin d’obtenir la liste des appareils Bluetooth LE.
GetDeviceSelectorFromAppearance(BluetoothLEAppearance)	Crée une chaîne de filtre AQS (Advanced Query Syntax) à partir d’un objet BluetoothLEAppearance . La chaîne AQS est passée à la méthode CreateWatcher pour retourner une collection d’objets DeviceInformation avec l’apparence spécifiée.
GetDeviceSelectorFromBluetoothAddress(UInt64)	Crée une chaîne de filtre AQS (Advanced Query Syntax) à partir d’une adresse 64 bits qui représente un appareil Bluetooth LE. La chaîne AQS est passée à la méthode CreateWatcher pour retourner une collection d’objets DeviceInformation .
GetDeviceSelectorFromBluetoothAddress(UInt64, BluetoothAddressType)	Crée une chaîne de filtre AQS (Advanced Query Syntax) à partir d’une adresse 64 bits et d’un type d’adresse qui représente un appareil Bluetooth LE. La chaîne AQS est passée à la méthode CreateWatcher .
GetDeviceSelectorFromConnectionStatus(BluetoothConnectionStatus)	Crée une chaîne de filtre AQS (Advanced Query Syntax) qui contient une requête pour les appareils Bluetooth LE avec le BluetoothConnectionStatus indiqué. La chaîne AQS est passée à la méthode CreateWatcher pour retourner une collection d’objets DeviceInformation avec la connexion Bluetooth indiquée status.
GetDeviceSelectorFromDeviceName(String)	Crée une chaîne de filtre AQS (Advanced Query Syntax) qui contient une requête pour le nom de l’appareil Bluetooth LE. La chaîne AQS est passée à la méthode CreateWatcher pour retourner une collection d’objets DeviceInformation contenant le nom d’appareil Bluetooth LE spécifié.
GetDeviceSelectorFromPairingState(Boolean)	Crée une chaîne de filtre AQS (Advanced Query Syntax) qui contient une requête pour les appareils Bluetooth LE appairés ou non appariés. La chaîne AQS est passée à la méthode CreateWatcher pour retourner une collection d’objets DeviceInformation .
GetGattService(Guid)	Retourne le service GATT avec l’ID de service donné. Important L’API GetGattService est déconseillée et peut ne pas être disponible dans les versions ultérieures de Windows. Utilisez plutôt GetGattServicesAsync.
GetGattServicesAsync()	Obtient le GattDeviceServices pour cet appareil Bluetooth LowEnergy.
GetGattServicesAsync(BluetoothCacheMode)	Retourne le GattDeviceServices pour cet appareil Bluetooth LowEnergy avec le mode de cache spécifié.
GetGattServicesForUuidAsync(Guid)	Renvoie le GattDeviceServices pour l’appareil Bluetooth LowEnergy avec l’UUID spécifié.
GetGattServicesForUuidAsync(Guid, BluetoothCacheMode)	Renvoie le GattDeviceServices pour l’appareil Bluetooth LowEnergy avec l’UUID spécifié.
RequestAccessAsync()	Demande l’accès à l’appareil Bluetooth LowEnergy.
RequestPreferredConnectionParameters(BluetoothLEPreferredConnectionParameters)	Récupère un objet de demande de paramètres de connexion préférés Bluetooth LE pour l’objet de paramètres de connexion préférés Bluetooth LE spécifié.

Événements

ConnectionParametersChanged	Événement déclenché lorsque les paramètres de connexion actuels de l’appareil changent. Les paramètres sont mis à jour uniquement une fois qu’une connexion à l’appareil a été établie.
ConnectionPhyChanged	Événement déclenché lorsque le PHY actuel pour l’appareil change. Le PHY ne sera mis à jour qu’une fois qu’une connexion à l’appareil a été établie.
ConnectionStatusChanged	Se produit lorsque la status de connexion pour l’appareil a changé.
GattServicesChanged	Déclenché lorsque la liste des services GATT pris en charge par l’appareil a changé.
NameChanged	Se produit lorsque le nom de l’appareil a changé.

S’applique à

Partager via