BluetoothLEDevice Classe
Définition
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.
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.IDisposablePublic NotInheritable Class BluetoothLEDevice
Implements IDisposable- Héritage
- Attributs
- Implémente
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 à
Voir aussi
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour