GattDeviceService Класс

Определение

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

Windows.Devices.Bluetooth.GenericAttributeProfile

Представляет основную службу GATT на устройстве Bluetooth. Класс GattDeviceService представляет службу GATT на устройстве Bluetooth LE. Экземпляр создается с помощью пути экземпляра службы устройства, полученного путем поиска устройства с помощью API Windows.Devices.Enumeration .

public ref class GattDeviceService sealed : IClosable

/// [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 GattDeviceService final : IClosable

[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 GattDeviceService : System.IDisposable

Public NotInheritable Class GattDeviceService
Implements IDisposable

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

Object Platform::Object IInspectable GattDeviceService

Атрибуты

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Реализации

IClosable IDisposable

Требования к 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	DeviceAccessInformation
1703	15063	FromIdAsync(String;GattSharingMode)
1703	15063	GetCharacteristicsAsync
1703	15063	GetCharacteristicsAsync(BluetoothCacheMode)
1703	15063	GetCharacteristicsForUuidAsync(Guid)
1703	15063	GetCharacteristicsForUuidAsync(Guid,BluetoothCacheMode)
1703	15063	GetDeviceSelectorForBluetoothDeviceId(BluetoothDeviceId)
1703	15063	GetDeviceSelectorForBluetoothDeviceId(BluetoothDeviceId,BluetoothCacheMode)
1703	15063	GetDeviceSelectorForBluetoothDeviceIdAndUuid(BluetoothDeviceId,Guid)
1703	15063	GetDeviceSelectorForBluetoothDeviceIdAndUuid(BluetoothDeviceId,Guid,BluetoothCacheMode)
1703	15063	GetIncludedServicesAsync
1703	15063	GetIncludedServicesAsync(BluetoothCacheMode)
1703	15063	GetIncludedServicesForUuidAsync(Guid)
1703	15063	GetIncludedServicesForUuidAsync(Guid,BluetoothCacheMode)
1703	15063	OpenAsync
1703	15063	RequestAccessAsync
1703	15063	Сеанс
1703	15063	SharingMode

Свойства

AttributeHandle	Получает дескриптор, используемый для уникальной идентификации атрибутов службы на основе GATT, объявленных на устройстве Bluetooth LE.
Device	Возвращает объект BluetoothLEDevice , описывающий устройство, связанное с текущим объектом GattDeviceService . Важно! API устройства является нерекомендуемой и может быть недоступен в будущих версиях Windows. Вместо этого используйте сеанс.
DeviceAccessInformation	Возвращает сведения о доступе к устройству, связанные с текущим объектом GattDeviceService .
DeviceId	Получите строку, представляющую путь к экземпляру службы GATT, используемый для создания экземпляра GattDeviceService.
ParentServices	Возвращает доступный только для чтения список родительских служб для этой службы. Важно! API ParentServices не рекомендуется использовать и может быть недоступен в будущих версиях Windows.
Session	Возвращает сеанс для этого экземпляра службы устройства GATT.
SharingMode	Возвращает режим общего доступа для этого экземпляра службы устройства GATT.
Uuid	Возвращает идентификатор UUID службы GATT, связанный с данной службой GattDeviceService.

Методы

Close()	Освобождает ресурсы, связанные с классом GattDeviceService . Это позволяет другим приложениям получать доступ к ресурсам GattDeviceService . Не используйте объект GattDeviceService после вызова close в нем; Вместо этого создайте экземпляр нового объекта GattDeviceService с помощью метода FromIdAsync . Для C++ вызовите Close. Для языков .NET этот метод Close проецируется в Dispose.
ConvertShortIdToUuid(UInt16)	Преобразует короткий идентификатор, определенный Bluetooth SIG, в полный идентификатор UUID GATT. Важно! API ConvertShortIdToUuid является устаревшим и может быть недоступен в будущих версиях Windows. Вместо этого используйте BluetoothUuidHelper.FromShortId.
Dispose()	Выполняет определяемые приложением задачи, связанные с удалением, высвобождением или сбросом неуправляемых ресурсов.
FromIdAsync(String)	Создает экземпляр новой службы GattDeviceService из идентификатора устройства.
FromIdAsync(String, GattSharingMode)	Создает экземпляр нового объекта GattDeviceService из идентификатора устройства.
GetAllCharacteristics()	Возвращает коллекцию всех характеристик, принадлежащих данному экземпляру GattDeviceService. Важно! API GetAllCharacteristics является устаревшим и может быть недоступен в будущих версиях Windows. Вместо этого используйте GetCharacteristicsAsync.
GetAllIncludedServices()	Возвращает коллекцию всех включенных служб, принадлежащих этому экземпляру GattDeviceService. Важно! API GetAllCharacteristics является устаревшим и может быть недоступен в будущих версиях Windows. Вместо этого используйте GetIncludedServicesAsync.
GetCharacteristics(Guid)	Возвращает вектор характеристик, которые идентифицируются указанным UUID и принадлежат данному экземпляру GattDeviceService. Важно! API GetCharacteristics не рекомендуется использовать и может быть недоступен в будущих версиях Windows. Вместо этого используйте GetCharacteristicsForUuidAsync.
GetCharacteristicsAsync()	Возвращает характеристики, которые являются частью данного экземпляра GattDeviceService.
GetCharacteristicsAsync(BluetoothCacheMode)	Возвращает характеристики, которые являются частью данного экземпляра GattDeviceService.
GetCharacteristicsForUuidAsync(Guid)	Возвращает характеристики, которые являются частью данного экземпляра GattDeviceService и связаны с параметром characterUuid.
GetCharacteristicsForUuidAsync(Guid, BluetoothCacheMode)	Возвращает характеристики, которые являются частью данного экземпляра GattDeviceService и связаны с параметром characterUuid.
GetDeviceSelectorForBluetoothDeviceId(BluetoothDeviceId)	Создает подходящую строку фильтра AQS для использования с методом CreateWatcher из BluetoothDeviceId.
GetDeviceSelectorForBluetoothDeviceId(BluetoothDeviceId, BluetoothCacheMode)	Создает подходящую строку фильтра AQS для использования с методом CreateWatcher из BluetoothDeviceId.
GetDeviceSelectorForBluetoothDeviceIdAndUuid(BluetoothDeviceId, Guid)	Создает подходящую строку фильтра AQS для использования с методом CreateWatcher из BluetoothDeviceId и serviceUuid.
GetDeviceSelectorForBluetoothDeviceIdAndUuid(BluetoothDeviceId, Guid, BluetoothCacheMode)	Создает подходящую строку фильтра AQS для использования с методом CreateWatcher из BluetoothDeviceId и serviceUuid.
GetDeviceSelectorFromShortId(UInt16)	Создает подходящую строку фильтра AQS для использования с методом CreateWatcher на основе UUID 16-разрядной службы Bluetooth GATT. Важно! API GetDeviceSelectorFromShortId устарел и может быть недоступен в будущих версиях Windows. Вместо этого используйте GetDeviceSelectorFromUuid.
GetDeviceSelectorFromUuid(Guid)	Создает подходящую строку фильтра AQS для использования с методом CreateWatcher из UUID службы Bluetooth.
GetIncludedServices(Guid)	Возвращает вектор включенных служб, которые определены указанным UUID и принадлежат этому экземпляру GattDeviceService. Важно! API GetIncludedServices является устаревшим и может быть недоступен в будущих версиях Windows. Вместо этого используйте GetIncludedServicesForUuidAsync.
GetIncludedServicesAsync()	Возвращает включенные службы, связанные с этим экземпляром GattDeviceService.
GetIncludedServicesAsync(BluetoothCacheMode)	Возвращает включенные службы, связанные с этим экземпляром GattDeviceService.
GetIncludedServicesForUuidAsync(Guid)	Возвращает включенные службы из serviceUuid, связанного с этим экземпляром GattDeviceService.
GetIncludedServicesForUuidAsync(Guid, BluetoothCacheMode)	Возвращает включенные службы из serviceUuid, связанного с этим экземпляром GattDeviceService.
OpenAsync(GattSharingMode)	Открывает службу устройств GATT с указанным sharingMode.
RequestAccessAsync()	Запрашивает доступ к GattDeviceService.

См. также раздел

• BluetoothLEDevice
• IClosable