GattCharacteristic Класс

Определение

Пространство имен:

Windows.Devices.Bluetooth.GenericAttributeProfile

Представляет характеристику службы GATT. Объект GattCharacteristic представляет характеристику GATT определенной службы и получается из свойства Characteristics объекта 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

Наследование

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	Возвращает дескриптор, используемый для уникальной идентификации атрибутов характеристик на основе GATT, объявленных на устройстве Bluetooth LE.
CharacteristicProperties	Возвращает свойства характеристик GATT, определенные профилем GATT. Если флаг ExtendedProperties присутствует, он также представляет свойства дескриптора расширенных свойств характеристики.
PresentationFormats	Возвращает список дескрипторов формата представления, связанных с этим объектом GattCharacteristic, в порядке, указанном дескриптором агрегированного формата. Список должен быть пустым, если дескрипторы PresentationFormat или Aggregate Format не найдены.
ProtectionLevel	Возвращает или задает требуемые параметры безопасности GATT для беспроводной связи с устройством. Windows будет согласовывать максимальную возможную безопасность с устройством в рамках процесса связывания, а указание более низкого уровня безопасности не приведет к снижению существующего уровня безопасности.
Service	Возвращает GattDeviceService , членом которого является данная характеристика.
UserDescription	Получите понятное описание для этого GattCharacteristic, если присутствует дескриптор описания пользователя, в противном случае это будет пустая строка.
Uuid	Возвращает идентификатор UUID характеристики GATT для этого GattCharacteristic.

Методы

ConvertShortIdToUuid(UInt16)	Преобразует короткий идентификатор, определенный Bluetooth SIG, в полный идентификатор UUID GATT. Важно! API ConvertShortIdToUuid является устаревшим и может быть недоступен в будущих версиях Windows. Вместо этого используйте BluetoothUuidHelper.FromShortId.
GetAllDescriptors()	Возвращает коллекцию всех дескрипторов, принадлежащих данному экземпляру GattCharacteristic. Важно! API GetAllDescriptors является устаревшим и может быть недоступен в будущих версиях Windows. Вместо этого используйте GetDescriptorsAsync.
GetDescriptors(Guid)	Возвращает вектор дескрипторов, которые идентифицируются указанным UUID и принадлежат этому экземпляру GattCharacteristic. Важно! API GetDescriptors является устаревшим и может быть недоступен в будущих версиях Windows. Вместо этого используйте GetDescriptorsForUuidAsync.
GetDescriptorsAsync()	Возвращает дескрипторы для данного экземпляра GattCharacteristic.
GetDescriptorsAsync(BluetoothCacheMode)	Возвращает дескрипторы с указанным режимом кэша для данного экземпляра GattCharacteristic.
GetDescriptorsForUuidAsync(Guid)	Возвращает дескрипторы, идентификаторы UUI которых соответствуют descriptorUuid.
GetDescriptorsForUuidAsync(Guid, BluetoothCacheMode)	Возвращает дескрипторы, идентификаторы UUI которых соответствуют descriptorUuid с указанным cacheMode.
ReadClientCharacteristicConfigurationDescriptorAsync()	Считывает текущее значение ClientCharacteristicConfigurationDescriptor.
ReadValueAsync()	Выполняет чтение значения характеристики из кэша значений, поддерживаемого Windows.
ReadValueAsync(BluetoothCacheMode)	Выполняет чтение значения характеристики либо из кэша значений, поддерживаемого Windows, либо непосредственно с устройства.
WriteClientCharacteristicConfigurationDescriptorAsync(GattClientCharacteristicConfigurationDescriptorValue)	Записывает clientCharacteristicConfigurationDescriptor на устройство Bluetooth LE, и если записываемое значение представляет собой указание или уведомление и зарегистрирован обработчик событий ValueChanged, позволяет получать события ValueChanged с устройства.
WriteClientCharacteristicConfigurationDescriptorWithResultAsync(GattClientCharacteristicConfigurationDescriptorValue)	Записывает clientCharacteristicConfigurationDescriptor на устройство Bluetooth LE, и если записываемое значение представляет собой указание или уведомление и зарегистрирован обработчик событий ValueChanged, позволяет получать события ValueChanged с устройства.
WriteValueAsync(IBuffer)	Выполняет запись значения характеристики на устройство Bluetooth LE.
WriteValueAsync(IBuffer, GattWriteOption)	Выполняет запись значения характеристики на устройство Bluetooth LE.
WriteValueWithResultAsync(IBuffer)	Выполняет запись значения характеристики на устройство Bluetooth LE.
WriteValueWithResultAsync(IBuffer, GattWriteOption)	Выполняет запись значения характеристики на устройство Bluetooth LE.

События

ValueChanged

Приложение может зарегистрировать обработчик событий, чтобы получать события при получении уведомлений или указаний от устройства после установки дескриптора конфигурации характеристики клиента.