GattCharacteristic Classe

Definição

Namespace:

Windows.Devices.Bluetooth.GenericAttributeProfile

Representa uma característica de um serviço GATT. O objeto GattCharacteristic representa uma Característica GATT de um serviço específico e é obtido da propriedade Characteristics do objeto 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

Herança

Object Platform::Object IInspectable GattCharacteristic

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)
Funcionalidades do aplicativo	bluetooth

Comentários

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
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)

Propriedades

AttributeHandle	Obtém o identificador usado para identificar exclusivamente atributos de característica baseados em GATT, conforme declarado no dispositivo Bluetooth LE.
CharacteristicProperties	Obtém as propriedades características gatt, conforme definido pelo perfil GATT. Se o sinalizador ExtendedProperties estiver presente, ele também representará as propriedades do Descritor de Propriedades de Característica Estendida.
PresentationFormats	Obtém a lista de descritores de formato de apresentação associados a este GattCharacteristic, na ordem especificada pelo Descritor de Formato agregado. A lista ficará vazia se nenhum descritor PresentationFormat ou Aggregate Format for encontrado.
ProtectionLevel	Obtém ou define as opções de segurança gatt desejadas para comunicação via ar com o dispositivo. O Windows negociará a segurança máxima possível com o dispositivo como parte do processo de emparelhamento e especificar um nível mais baixo de segurança não prejudicará o nível de segurança existente.
Service	Obtém o GattDeviceService do qual essa característica é membro.
UserDescription	Obtenha a descrição amigável para este GattCharacteristic, se o Descritor de Descrição do Usuário estiver presente, caso contrário, essa será uma cadeia de caracteres vazia.
Uuid	Obtém a UUID característica gatt para este GattCharacteristic.

Métodos

ConvertShortIdToUuid(UInt16)	Converte uma ID curta definida por SIG bluetooth em uma UUID gatt completa. Importante A API ConvertShortIdToUuid foi preterida e pode não estar disponível em versões futuras do Windows. Em vez disso, use BluetoothUuidHelper.FromShortId.
GetAllDescriptors()	Obtém a coleção de todos os descritores pertencentes a esta instância GattCharacteristic. Importante A API GetAllDescriptors foi preterida e pode não estar disponível em versões futuras do Windows. Em vez disso, use GetDescriptorsAsync.
GetDescriptors(Guid)	Retorna um vetor de descritores, que são identificados pelo UUID especificado e pertencem a essa instância GattCharacteristic. Importante A API GetDescriptors foi preterida e pode não estar disponível em versões futuras do Windows. Em vez disso, use GetDescriptorsForUuidAsync.
GetDescriptorsAsync()	Retorna os descritores para esta instância GattCharacteristic.
GetDescriptorsAsync(BluetoothCacheMode)	Retorna os descritores com o modo de cache especificado para esta instância GattCharacteristic.
GetDescriptorsForUuidAsync(Guid)	Retorna os descritores cujos UUIDs correspondem ao descritorUuid.
GetDescriptorsForUuidAsync(Guid, BluetoothCacheMode)	Retorna os descritores cujos UUIDs correspondem ao descritorUuid com o cacheMode especificado.
ReadClientCharacteristicConfigurationDescriptorAsync()	Lê o valor atual do ClientCharacteristicConfigurationDescriptor.
ReadValueAsync()	Executa um valor de característica lido do cache de valor mantido pelo Windows.
ReadValueAsync(BluetoothCacheMode)	Executa uma leitura de Valor De Característica do cache de valor mantido pelo Windows ou diretamente do dispositivo.
WriteClientCharacteristicConfigurationDescriptorAsync(GattClientCharacteristicConfigurationDescriptorValue)	Grava o ClientCharacteristicConfigurationDescriptor no dispositivo Bluetooth LE e, se o valor a ser gravado representar uma indicação ou uma notificação e um manipulador de eventos ValueChanged for registrado, habilitará o recebimento de eventos ValueChanged do dispositivo.
WriteClientCharacteristicConfigurationDescriptorWithResultAsync(GattClientCharacteristicConfigurationDescriptorValue)	Grava o ClientCharacteristicConfigurationDescriptor no dispositivo Bluetooth LE e, se o valor a ser gravado representar uma indicação ou uma notificação e um manipulador de eventos ValueChanged for registrado, habilitará o recebimento de eventos ValueChanged do dispositivo.
WriteValueAsync(IBuffer)	Executa uma gravação de Valor Característica em um dispositivo Bluetooth LE.
WriteValueAsync(IBuffer, GattWriteOption)	Executa uma gravação de Valor Característica em um dispositivo Bluetooth LE.
WriteValueWithResultAsync(IBuffer)	Executa uma gravação de Valor Característica em um dispositivo Bluetooth LE.
WriteValueWithResultAsync(IBuffer, GattWriteOption)	Executa uma gravação de Valor Característica em um dispositivo Bluetooth LE.

Eventos

ValueChanged

Um aplicativo pode registrar um manipulador de eventos para receber eventos quando a notificação ou as indicações são recebidas de um dispositivo, depois de definir o Descritor de Configuração de Característica do Cliente.