GattCharacteristic Clase

Definición

Espacio de nombres:

Windows.Devices.Bluetooth.GenericAttributeProfile

Representa una característica de un servicio GATT. El objeto GattCharacteristic representa una característica GATT de un servicio determinado y se obtiene de la propiedad Characteristics del 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

Herencia

Object Platform::Object IInspectable GattCharacteristic

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)
Características de aplicaciones	bluetooth

Comentarios

Historial de versiones

Versión de Windows	Versión del SDK	Valor agregado
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)

Propiedades

AttributeHandle	Obtiene el identificador utilizado para identificar de forma única los atributos de características basados en GATT como declarados en el dispositivo Bluetooth LE.
CharacteristicProperties	Obtiene las propiedades de características del GATT, tal como se define en el perfil gatt. Si la marca ExtendedProperties está presente, también representa las propiedades del descriptor de propiedades de características extendidas.
PresentationFormats	Obtiene la lista de descriptores de formato de presentación asociados a este GattCharacteristic, en el orden especificado por el Descriptor de formato agregado. La lista estará vacía si no se encuentra ningún descriptor PresentationFormat o Aggregate Format.
ProtectionLevel	Obtiene o establece las opciones de seguridad gatt deseadas para la comunicación inalámbrica con el dispositivo. Windows negociará la máxima seguridad posible con el dispositivo como parte del proceso de emparejamiento y especificar un nivel inferior de seguridad no degradará el nivel de seguridad existente.
Service	Obtiene el GattDeviceService del que esta característica es un miembro.
UserDescription	Obtenga la descripción fácil de usar de esta GattCharacteristic, si el Descriptor de descripción de usuario está presente, de lo contrario, será una cadena vacía.
Uuid	Obtiene el UUID de la característica GATT para este GattCharacteristic.

Métodos

ConvertShortIdToUuid(UInt16)	Convierte un identificador corto definido por Bluetooth SIG en un UUID gatt completo. Importante La API ConvertShortIdToUuid está en desuso y es posible que no esté disponible en versiones futuras de Windows. En su lugar, use BluetoothUuidHelper.FromShortId.
GetAllDescriptors()	Obtiene la colección de todos los descriptores que pertenecen a esta instancia GattCharacteristic. Importante La API GetAllDescriptors está en desuso y es posible que no esté disponible en versiones futuras de Windows. En su lugar, use GetDescriptorsAsync.
GetDescriptors(Guid)	Devuelve un vector de descriptores, que se identifican mediante el UUID especificado y pertenecen a esta instancia GattCharacteristic. Importante La API GetDescriptors está en desuso y es posible que no esté disponible en versiones futuras de Windows. En su lugar, use GetDescriptorsForUuidAsync.
GetDescriptorsAsync()	Devuelve los descriptores de esta instancia GattCharacteristic.
GetDescriptorsAsync(BluetoothCacheMode)	Devuelve los descriptores con el modo de caché especificado para esta instancia GattCharacteristic.
GetDescriptorsForUuidAsync(Guid)	Devuelve los descriptores cuyos UUID coinciden con descriptorUuid.
GetDescriptorsForUuidAsync(Guid, BluetoothCacheMode)	Devuelve los descriptores cuyos UUID coinciden con descriptorUuid con el cacheMode especificado.
ReadClientCharacteristicConfigurationDescriptorAsync()	Lee el valor actual del ClientCharacteristicConfigurationDescriptor.
ReadValueAsync()	Realiza una lectura del valor de característica de la memoria caché de valores mantenida por Windows.
ReadValueAsync(BluetoothCacheMode)	Realiza una lectura de valor característico de la memoria caché de valores mantenida por Windows o directamente desde el dispositivo.
WriteClientCharacteristicConfigurationDescriptorAsync(GattClientCharacteristicConfigurationDescriptorValue)	Escribe clientCharacteristicConfigurationDescriptor en el dispositivo Bluetooth LE y si el valor que se va a escribir representa una indicación o una notificación y se registra un controlador de eventos ValueChanged, permite recibir eventos ValueChanged del dispositivo.
WriteClientCharacteristicConfigurationDescriptorWithResultAsync(GattClientCharacteristicConfigurationDescriptorValue)	Escribe clientCharacteristicConfigurationDescriptor en el dispositivo Bluetooth LE y si el valor que se va a escribir representa una indicación o una notificación y se registra un controlador de eventos ValueChanged, permite recibir eventos ValueChanged del dispositivo.
WriteValueAsync(IBuffer)	Realiza una escritura de valor característico en un dispositivo Bluetooth LE.
WriteValueAsync(IBuffer, GattWriteOption)	Realiza una escritura de valor característico en un dispositivo Bluetooth LE.
WriteValueWithResultAsync(IBuffer)	Realiza una escritura de valor característico en un dispositivo Bluetooth LE.
WriteValueWithResultAsync(IBuffer, GattWriteOption)	Realiza una escritura de valor característico en un dispositivo Bluetooth LE.

Eventos

ValueChanged

Una aplicación puede registrar un controlador de eventos para recibir eventos cuando se reciben notificaciones o indicaciones de un dispositivo, después de establecer el Descriptor de configuración de características de cliente.