GattCharacteristic Classe

Définition

Espace de noms:

Windows.Devices.Bluetooth.GenericAttributeProfile

Représente une caractéristique d’un service GATT. L’objet GattCharacteristic représente une caractéristique GATT d’un service particulier et est obtenu à partir de la propriété Characteristics de l’objet GattDeviceService.

public ref class GattCharacteristic sealed

/// [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 GattCharacteristic final

[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 GattCharacteristic

Public NotInheritable Class GattCharacteristic

Héritage

Object Platform::Object IInspectable GattCharacteristic

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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
1703	15063	GetDescriptorsAsync
1703	15063	GetDescriptorsAsync(BluetoothCacheMode)
1703	15063	GetDescriptorsForUuidAsync(Guid)
1703	15063	GetDescriptorsForUuidAsync(Guid,BluetoothCacheMode)
1703	15063	WriteClientCharacteristicConfigurationDescriptorWithResultAsync
1703	15063	WriteValueWithResultAsync(IBuffer)
1703	15063	WriteValueWithResultAsync(IBuffer,GattWriteOption)

Propriétés

AttributeHandle	Obtient le handle utilisé pour identifier de manière unique les attributs caractéristiques basés sur le GATT comme déclarés sur l’appareil Bluetooth LE.
CharacteristicProperties	Obtient les propriétés de caractéristiques GATT, telles que définies par le profil GATT. Si l’indicateur ExtendedProperties est présent, il représente également les propriétés du descripteur Propriétés de caractéristiques étendues.
PresentationFormats	Obtient la liste des descripteurs de format de présentation associés à ce GattCharacteristic, dans l’ordre spécifié par le descripteur de format d’agrégation. La liste doit être vide si aucun descripteur PresentationFormat ou Aggregate Format n’est trouvé.
ProtectionLevel	Obtient ou définit les options de sécurité GATT souhaitées pour la communication en direct avec l’appareil. Windows négociera la sécurité maximale possible avec l’appareil dans le cadre du processus de jumelage, et la spécification d’un niveau de sécurité inférieur ne dégradera pas le niveau de sécurité existant.
Service	Obtient le Service GattDevice dont cette caractéristique est membre.
UserDescription	Obtenez la description conviviale de ce GattCharacteristic, si le descripteur de description de l’utilisateur est présent, sinon il s’agit d’une chaîne vide.
Uuid	Obtient l’UUID de caractéristique GATT pour ce GattCharacteristic.

Méthodes

ConvertShortIdToUuid(UInt16)	Convertit un ID court défini par le SIG Bluetooth en un UUID GATT complet. Important L’API ConvertShortIdToUuid est déconseillée et peut ne pas être disponible dans les versions futures de Windows. Utilisez plutôt BluetoothUuidHelper.FromShortId.
GetAllDescriptors()	Obtient la collection de tous les descripteurs appartenant à cette instance GattCharacteristic. Important L’API GetAllDescriptors est déconseillée et peut ne pas être disponible dans les versions futures de Windows. Utilisez plutôt GetDescriptorsAsync.
GetDescriptors(Guid)	Retourne un vecteur de descripteurs, qui sont identifiés par l’UUID spécifié et qui appartiennent à ce instance GattCharacteristic. Important L’API GetDescriptors est déconseillée et peut ne pas être disponible dans les versions futures de Windows. Utilisez plutôt GetDescriptorsForUuidAsync.
GetDescriptorsAsync()	Retourne les descripteurs pour cette instance GattCharacteristic.
GetDescriptorsAsync(BluetoothCacheMode)	Retourne les descripteurs avec le mode de cache spécifié pour cette instance GattCharacteristic.
GetDescriptorsForUuidAsync(Guid)	Retourne les descripteurs dont les UUID correspondent au descripteurUuid.
GetDescriptorsForUuidAsync(Guid, BluetoothCacheMode)	Retourne les descripteurs dont les UUID correspondent au descripteurUuid avec le cacheMode spécifié.
ReadClientCharacteristicConfigurationDescriptorAsync()	Lit la valeur actuelle de ClientCharacteristicConfigurationDescriptor.
ReadValueAsync()	Effectue une lecture de valeur caractéristique à partir du cache de valeurs géré par Windows.
ReadValueAsync(BluetoothCacheMode)	Effectue une lecture de valeur caractéristique à partir du cache de valeurs géré par Windows ou directement à partir de l’appareil.
WriteClientCharacteristicConfigurationDescriptorAsync(GattClientCharacteristicConfigurationDescriptorValue)	Écrit le ClientCharacteristicConfigurationDescriptor sur l’appareil Bluetooth LE, et si la valeur à écrire représente une indication ou une notification et qu’un gestionnaire d’événements ValueChanged est inscrit, permet de recevoir des événements ValueChanged à partir de l’appareil.
WriteClientCharacteristicConfigurationDescriptorWithResultAsync(GattClientCharacteristicConfigurationDescriptorValue)	Écrit le ClientCharacteristicConfigurationDescriptor sur l’appareil Bluetooth LE, et si la valeur à écrire représente une indication ou une notification et qu’un gestionnaire d’événements ValueChanged est inscrit, permet de recevoir des événements ValueChanged à partir de l’appareil.
WriteValueAsync(IBuffer)	Effectue une écriture de valeur caractéristique sur un appareil Bluetooth LE.
WriteValueAsync(IBuffer, GattWriteOption)	Effectue une écriture de valeur caractéristique sur un appareil Bluetooth LE.
WriteValueWithResultAsync(IBuffer)	Effectue une écriture de valeur caractéristique sur un appareil Bluetooth LE.
WriteValueWithResultAsync(IBuffer, GattWriteOption)	Effectue une écriture de valeur caractéristique sur un appareil Bluetooth LE.

Événements

ValueChanged

Une application peut inscrire un gestionnaire d’événements afin de recevoir des événements lorsque des notifications ou des indications sont reçues d’un appareil, après avoir défini le descripteur de configuration des caractéristiques du client.