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 d’exemple Bluetooth Low Energy et 'énumération et l’exemple 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
| Configuration requise | Description |
|---|---|
| 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 Kit de développement logiciel (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
| Nom | Description |
|---|---|
| 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 l’état de connexion de l’appareil. |
| DeviceAccessInformation |
Obtient DeviceAccessInformation. |
| DeviceId |
Obtient l’ID de l’appareil. |
| DeviceInformation |
Obtient les informations relatives à 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 elle n’est peut-être pas 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 bluetoothLEDevice a été jumelé à l’aide d’une connexion sécurisée. |
Méthodes
| Nom | Description |
|---|---|
| Close() |
Ferme cet appareil Bluetooth LE. Cela peut fermer la connexion à l’appareil s’il s’agit de la seule application avec une connexion. |
| Dispose() |
Effectue des tâches définies par l’application associées à la libération, à la libération ou à la réinitialisation des ressources non managées. |
| 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). |
| FromBluetoothAddressAsync(UInt64) |
Retourne un objet BluetoothLEDevice représentant l’appareil Bluetooth LE homologue avec l’adresse donnée. Consultez Remarques (dans cette rubrique membre). |
| FromIdAsync(String) |
Renvoie un objet BluetoothLEDevice pour l’ID donné. Consultez Remarques dans la rubrique membre. |
| GetConnectionParameters() |
Récupère les paramètres de connexion pour 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, où ils sont compatibles, en fonction de la priorité du système. Note 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 Bluetooth LE (PHY). Note Lorsque l’appareil n’est pas connecté, les PHY de connexion ne sont pas valides (toutes les valeurs false) |
| GetDeviceSelector() |
Obtient une chaîne AQS (Advanced Query Syntax) pour identifier tous les appareils Bluetooth Low Energy (LE). Cette chaîne est transmise à la méthode FindAllAsync ou CreateWatcher pour 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 |
| GetDeviceSelectorFromBluetoothAddress(UInt64, BluetoothAddressType) |
Crée une chaîne de filtre AQS (Advanced Query Syntax) à partir d’une adresse et d’un type d’adresse 64 bits qui représente un appareil Bluetooth LE. La chaîne AQS est passée à la méthode CreateWatcher. |
| 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 |
| 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 l’état de connexion Bluetooth indiqué. |
| 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 transmise à la méthode CreateWatcher |
| GetDeviceSelectorFromPairingState(Boolean) |
Crée une chaîne de filtre AQS (Advanced Query Syntax) qui contient une requête pour les appareils Bluetooth LE associés ou non appairés. La chaîne AQS est passée à la méthode |
| GetGattService(Guid) |
Retourne le service GATT avec l’ID de service donné. Important L’API GetGattService |
| GetGattServicesAsync() |
Obtient le GattDeviceServices pour cet appareil Bluetooth Low Energy. |
| GetGattServicesAsync(BluetoothCacheMode) |
Retourne le GattDeviceServices pour cet appareil Bluetooth Low Energy avec le mode de cache spécifié. |
| GetGattServicesForUuidAsync(Guid, BluetoothCacheMode) |
Retourne le GattDeviceServices pour l’appareil Bluetooth Low Energy avec l’UUID spécifié. |
| GetGattServicesForUuidAsync(Guid) |
Retourne le GattDeviceServices pour l’appareil Bluetooth Low Energy avec l’UUID spécifié. |
| RequestAccessAsync() |
Demande l’accès à l’appareil Bluetooth Low Energy. |
| RequestPreferredConnectionParameters(BluetoothLEPreferredConnectionParameters) |
Récupère un objet de demande de paramètres de connexion bluetooth LE préféré pour l’objet de paramètres de connexion Bluetooth LE préféré spécifié. |
Événements
| Nom | Description |
|---|---|
| ConnectionParametersChanged |
Événement déclenché lorsque les paramètres de connexion actuels pour l’appareil changent. Les paramètres ne seront mis à jour qu’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 se met à jour qu’une fois qu’une connexion à l’appareil a été établie. |
| ConnectionStatusChanged |
Se produit lorsque l’état de connexion de 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é. |