GattDeviceService 类

定义

命名空间:

Windows.Devices.Bluetooth.GenericAttributeProfile

表示蓝牙设备上的 GATT 主服务。 GattDeviceService 类表示蓝牙 LE 设备上的 GATT 服务。 它通过使用设备服务实例路径进行实例化，该路径通过使用 Windows.Devices.Enumeration API 查找设备来获取。

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	获取用于唯一标识蓝牙 LE 设备上声明的基于 GATT 的服务属性的句柄。
Device	获取 BluetoothLEDevice 对象，该对象描述与当前 GattDeviceService 对象关联的设备。 重要 设备 API 已弃用，在将来的 Windows 版本中可能不可用。 请改用 会话。
DeviceAccessInformation	获取与当前 GattDeviceService 对象关联的设备访问信息。
DeviceId	获取表示用于实例化 GattDeviceService 的 GATT 服务实例路径的字符串。
ParentServices	获取此服务的父服务的只读列表。 重要 ParentServices API 已弃用，它可能在将来的 Windows 版本中不可用。
Session	获取此 GATT 设备服务实例的会话。
SharingMode	获取此 GATT 设备服务实例的共享模式。
Uuid	获取与此 GattDeviceService 关联的 GATT 服务 UUID。

方法

Close()	释放与 GattDeviceService 类关联的资源。 这允许其他应用访问相关 GattDeviceService 的资源。 调用 GattDeviceService 对象后，请勿使用 GattDeviceService 对象;而是使用 FromIdAsync 方法实例化新的 GattDeviceService 对象。 对于 C++，请调用 Close。 对于 .NET 语言，此 Close 方法投影到 Dispose 中。
ConvertShortIdToUuid(UInt16)	将蓝牙 SIG 定义的短 ID 转换为完整的 GATT UUID。 重要 ConvertShortIdToUuid API 已弃用，将来的 Windows 版本中可能不可用。 请改用 BluetoothUuidHelper.FromShortId。
Dispose()	执行与释放或重置非托管资源关联的应用程序定义的任务。
FromIdAsync(String)	从设备 ID 实例化新的 GattDeviceService。
FromIdAsync(String, GattSharingMode)	从设备 ID 实例化新的 GattDeviceService 对象。
GetAllCharacteristics()	获取属于此 GattDeviceService 实例的所有特征的集合。 重要 GetAllCharacteristics API 已弃用，将来的 Windows 版本中可能不可用。 请改用 GetCharacteristicsAsync。
GetAllIncludedServices()	获取属于此 GattDeviceService 实例的所有包含服务的集合。 重要 GetAllCharacteristics API 已弃用，将来的 Windows 版本中可能不可用。 请改用 GetIncludedServicesAsync。
GetCharacteristics(Guid)	返回由指定的 UUID 标识并属于此 GattDeviceService 实例的特征向量。 重要 GetCharacteristics API 已弃用，将来的 Windows 版本中可能不可用。 请改用 GetCharacteristicsForUuidAsync。
GetCharacteristicsAsync()	获取属于此 GattDeviceService 实例的特征。
GetCharacteristicsAsync(BluetoothCacheMode)	获取属于此 GattDeviceService 实例的特征。
GetCharacteristicsForUuidAsync(Guid)	获取属于此 GattDeviceService 实例并与特征Uuid 关联的字符。
GetCharacteristicsForUuidAsync(Guid, BluetoothCacheMode)	获取属于此 GattDeviceService 实例并与特征Uuid 关联的字符。
GetDeviceSelectorForBluetoothDeviceId(BluetoothDeviceId)	从 BluetoothDeviceId 创建适合用于 CreateWatcher 方法的 AQS 筛选器字符串。
GetDeviceSelectorForBluetoothDeviceId(BluetoothDeviceId, BluetoothCacheMode)	从 BluetoothDeviceId 创建适合用于 CreateWatcher 方法的 AQS 筛选器字符串。
GetDeviceSelectorForBluetoothDeviceIdAndUuid(BluetoothDeviceId, Guid)	从 BluetoothDeviceId 和 serviceUuid 创建合适的 AQS 筛选器字符串以用于 CreateWatcher 方法。
GetDeviceSelectorForBluetoothDeviceIdAndUuid(BluetoothDeviceId, Guid, BluetoothCacheMode)	从 BluetoothDeviceId 和 serviceUuid 创建合适的 AQS 筛选器字符串以用于 CreateWatcher 方法。
GetDeviceSelectorFromShortId(UInt16)	从 16 位蓝牙 GATT 服务 UUID 创建合适的 AQS 筛选器字符串以用于 CreateWatcher 方法。 重要 GetDeviceSelectorFromShortId API 已弃用，将来的 Windows 版本中可能不可用。 请改用 GetDeviceSelectorFromUuid。
GetDeviceSelectorFromUuid(Guid)	从蓝牙服务 UUID 创建合适的 AQS 筛选器字符串，以便与 CreateWatcher 方法一起使用。
GetIncludedServices(Guid)	返回包含的服务的向量，这些服务由指定的 UUID 标识并属于此 GattDeviceService 实例。 重要 GetIncludedServices API 已弃用，它可能在将来的 Windows 版本中不可用。 请改用 GetIncludedServicesForUuidAsync。
GetIncludedServicesAsync()	获取与此 GattDeviceService 实例关联的包含的服务。
GetIncludedServicesAsync(BluetoothCacheMode)	获取与此 GattDeviceService 实例关联的包含的服务。
GetIncludedServicesForUuidAsync(Guid)	从与此 GattDeviceService 实例关联的 serviceUuid 中获取包含的服务。
GetIncludedServicesForUuidAsync(Guid, BluetoothCacheMode)	从与此 GattDeviceService 实例关联的 serviceUuid 中获取包含的服务。
OpenAsync(GattSharingMode)	使用指定的 sharingMode 打开 GATT 设备服务。
RequestAccessAsync()	请求访问 GattDeviceService。

另请参阅

• BluetoothLEDevice
• IClosable