GattCharacteristic Classe

Definizione

Spazio dei nomi:

Windows.Devices.Bluetooth.GenericAttributeProfile

Rappresenta una caratteristica di un servizio GATT. L'oggetto GattCharacteristic rappresenta una caratteristica GATT di un servizio specifico e viene ottenuta dalla proprietà Characteristics dell'oggetto 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

Ereditarietà

Object Platform::Object IInspectable GattCharacteristic

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)
Funzionalità dell'app	bluetooth

Commenti

Cronologia delle versioni

Versione di Windows	Versione dell'SDK	Valore aggiunto
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)

Proprietà

AttributeHandle	Ottiene l'handle usato per identificare in modo univoco gli attributi delle caratteristiche basate su GATT come dichiarato nel dispositivo Bluetooth LE.
CharacteristicProperties	Ottiene le proprietà caratteristiche GATT, come definito dal profilo GATT. Se il flag ExtendedProperties è presente, rappresenta anche le proprietà del descrittore proprietà caratteristiche estese.
PresentationFormats	Ottiene l'elenco dei descrittori di formato di presentazione associati a questo GattCharacteristic, nell'ordine specificato dal descrittore formato aggregato. L'elenco deve essere vuoto se non vengono trovati descrittori Di formato di presentazione o formato aggregato.
ProtectionLevel	Ottiene o imposta le opzioni di sicurezza GATT desiderate per la comunicazione aerea con il dispositivo. Windows negozierà la sicurezza massima possibile con il dispositivo come parte del processo di associazione e specificando un livello inferiore di sicurezza non degraderà il livello di sicurezza esistente.
Service	Ottiene gattDeviceService di cui questa caratteristica è un membro.
UserDescription	Ottenere la descrizione descrittiva per questo GattCharacteristic, se il descrittore Descrizione utente è presente, in caso contrario, questa sarà una stringa vuota.
Uuid	Ottiene l'UUID caratteristica GATT per questo GattCharacteristic.

Metodi

ConvertShortIdToUuid(UInt16)	Converte un ID breve di Bluetooth SIG definito in un UUID GATT completo. Importante L'API ConvertShortIdToUuid è deprecata e potrebbe non essere disponibile nelle versioni future di Windows. Usare invece BluetoothUuidHelper.FromShortId.
GetAllDescriptors()	Ottiene la raccolta di tutti i descrittori appartenenti a questa istanza GattCharacteristic. Importante L'API GetAllDescriptors è deprecata e potrebbe non essere disponibile nelle versioni future di Windows. Usare invece GetDescriptorsAsync.
GetDescriptors(Guid)	Restituisce un vettore di descrittori, identificati dall'UUID specificato e appartengono a questa istanza gattcharacteristica. Importante L'API GetDescriptors è deprecata e potrebbe non essere disponibile nelle versioni future di Windows. Usare invece GetDescriptorsForUuidAsync.
GetDescriptorsAsync()	Restituisce i descrittori per questa istanza GattCharacteristic.
GetDescriptorsAsync(BluetoothCacheMode)	Restituisce i descrittori con la modalità cache specificata per questa istanza GattCharacteristic.
GetDescriptorsForUuidAsync(Guid)	Restituisce i descrittori i cui UUID corrispondono al descrittoreUuid.
GetDescriptorsForUuidAsync(Guid, BluetoothCacheMode)	Restituisce i descrittori i cui UUID corrispondono al descrittoreUuid con la cacheMode specificata.
ReadClientCharacteristicConfigurationDescriptorAsync()	Legge il valore corrente del clientCharacteristicConfigurationDescriptor.
ReadValueAsync()	Esegue un valore caratteristica letto dalla cache dei valori gestita da Windows.
ReadValueAsync(BluetoothCacheMode)	Esegue un valore caratteristica letto dalla cache dei valori gestita da Windows o direttamente dal dispositivo.
WriteClientCharacteristicConfigurationDescriptorAsync(GattClientCharacteristicConfigurationDescriptorValue)	Scrive il clientCharacteristicConfigurationDescriptor nel dispositivo Bluetooth LE e se il valore da scrivere rappresenta un'indicazione o una notifica e un gestore eventi ValueChanged viene registrato, consente di ricevere eventi ValueChanged dal dispositivo.
WriteClientCharacteristicConfigurationDescriptorWithResultAsync(GattClientCharacteristicConfigurationDescriptorValue)	Scrive il clientCharacteristicConfigurationDescriptor nel dispositivo Bluetooth LE e se il valore da scrivere rappresenta un'indicazione o una notifica e un gestore eventi ValueChanged viene registrato, consente di ricevere eventi ValueChanged dal dispositivo.
WriteValueAsync(IBuffer)	Esegue una scrittura di valore caratteristica in un dispositivo Bluetooth LE.
WriteValueAsync(IBuffer, GattWriteOption)	Esegue una scrittura di valore caratteristica in un dispositivo Bluetooth LE.
WriteValueWithResultAsync(IBuffer)	Esegue una scrittura di valore caratteristica in un dispositivo Bluetooth LE.
WriteValueWithResultAsync(IBuffer, GattWriteOption)	Esegue una scrittura di valore caratteristica in un dispositivo Bluetooth LE.

Eventi

ValueChanged

Un'app può registrare un gestore eventi per ricevere eventi quando vengono ricevute notifiche o indicazioni da un dispositivo, dopo aver impostato il descrittore Configurazione caratteristica client.