GattCharacteristic 类

定义

命名空间:

Windows.Devices.Bluetooth.GenericAttributeProfile

表示 GATT 服务的特征。 GattCharacteristic 对象表示特定服务的 GATT 特征，是从 GattDeviceService 对象的 Characteristics 属性获取的。

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

继承

Object Platform::Object IInspectable GattCharacteristic

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)
应用功能	bluetooth

注解

版本历史记录

Windows 版本	SDK 版本	增值
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)

属性

AttributeHandle	获取用于唯一标识蓝牙 LE 设备上声明的基于 GATT 的特征属性的句柄。
CharacteristicProperties	获取 GATT 配置文件定义的 GATT 特征属性。 如果 ExtendedProperties 标志存在，则它还表示扩展特征属性描述符的属性。
PresentationFormats	按聚合格式描述符指定的顺序获取与此 GattCharacteristic 关联的表示格式描述符的列表。 如果未找到 PresentationFormat 或聚合格式描述符，则列表应为空。
ProtectionLevel	获取或设置与设备的无线通信所需的 GATT 安全选项。 在配对过程中，Windows 将与设备协商可能的最大安全性，并且指定较低安全级别不会降低现有安全级别。
Service	获取此特征所属的 GattDeviceService 。
UserDescription	如果存在用户描述符，则获取此 GattCharacteristic 的用户友好说明，否则将为空字符串。
Uuid	获取此 GattCharacteristic 的 GATT 特征 UUID。

方法

ConvertShortIdToUuid(UInt16)	将蓝牙 SIG 定义的短 ID 转换为完整的 GATT UUID。 重要 ConvertShortIdToUuid API 已弃用，将来的 Windows 版本中可能不可用。 请改用 BluetoothUuidHelper.FromShortId。
GetAllDescriptors()	获取属于此 GattCharacteristic 实例的所有描述符的集合。 重要 GetAllDescriptors API 已弃用，将来的 Windows 版本中可能不可用。 请改用 GetDescriptorsAsync。
GetDescriptors(Guid)	返回由指定的 UUID 标识并属于此 GattCharacteristic 实例的描述符向量。 重要 GetDescriptors API 已弃用，将来的 Windows 版本中可能不可用。 请改用 GetDescriptorsForUuidAsync。
GetDescriptorsAsync()	返回此 GattCharacteristic 实例的描述符。
GetDescriptorsAsync(BluetoothCacheMode)	返回具有此 GattCharacteristic 实例的指定缓存模式的描述符。
GetDescriptorsForUuidAsync(Guid)	返回其 UUID 与描述符Uuid 匹配的描述符。
GetDescriptorsForUuidAsync(Guid, BluetoothCacheMode)	返回其 UUID 与指定的 cacheMode 匹配描述符Uuid 的描述符。
ReadClientCharacteristicConfigurationDescriptorAsync()	读取 ClientCharacteristicConfigurationDescriptor 的当前值。
ReadValueAsync()	执行从 Windows 维护的值缓存中读取的特征值。
ReadValueAsync(BluetoothCacheMode)	从 Windows 维护的值缓存或直接从设备执行特征值读取。
WriteClientCharacteristicConfigurationDescriptorAsync(GattClientCharacteristicConfigurationDescriptorValue)	将 ClientCharacteristicConfigurationDescriptor 写入蓝牙 LE 设备，如果要写入的值表示指示或通知，并且注册了 ValueChanged 事件处理程序，则启用从设备接收 ValueChanged 事件。
WriteClientCharacteristicConfigurationDescriptorWithResultAsync(GattClientCharacteristicConfigurationDescriptorValue)	将 ClientCharacteristicConfigurationDescriptor 写入蓝牙 LE 设备，如果要写入的值表示指示或通知，并且注册了 ValueChanged 事件处理程序，则启用从设备接收 ValueChanged 事件。
WriteValueAsync(IBuffer)	对蓝牙 LE 设备执行特征值写入。
WriteValueAsync(IBuffer, GattWriteOption)	对蓝牙 LE 设备执行特征值写入。
WriteValueWithResultAsync(IBuffer)	对蓝牙 LE 设备执行特征值写入。
WriteValueWithResultAsync(IBuffer, GattWriteOption)	对蓝牙 LE 设备执行特征值写入。

事件

ValueChanged

设置客户端特征配置描述符后，应用可以注册事件处理程序，以便在从设备收到通知或指示时接收事件。