GattDeviceService Clase

Definición

Espacio de nombres:

Windows.Devices.Bluetooth.GenericAttributeProfile

Representa un servicio principal GATT en un dispositivo Bluetooth. La clase GattDeviceService representa un servicio GATT en un dispositivo Bluetooth LE. Se crea una instancia mediante una ruta de acceso de instancia de servicio de dispositivo, obtenida mediante la búsqueda de un dispositivo mediante la 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

Herencia

Object Platform::Object IInspectable GattDeviceService

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementaciones

IClosable IDisposable

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	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	Sesión
1703	15063	SharingMode

Propiedades

AttributeHandle	Obtiene el identificador utilizado para identificar de forma única los atributos de servicio basados en GATT como declarados en el dispositivo Bluetooth LE.
Device	Obtiene el objeto BluetoothLEDevice que describe el dispositivo asociado al objeto GattDeviceService actual. Importante La API de dispositivo está en desuso y es posible que no esté disponible en versiones futuras de Windows. En su lugar, use Session.
DeviceAccessInformation	Obtiene la información de acceso del dispositivo asociada al objeto GattDeviceService actual.
DeviceId	Obtenga la cadena que representa la ruta de acceso de la instancia del servicio GATT usada para crear instancias de GattDeviceService.
ParentServices	Obtiene la lista de solo lectura de los servicios primarios para este servicio. Importante La API ParentServices está en desuso y es posible que no esté disponible en versiones futuras de Windows.
Session	Obtiene la sesión de esta instancia del servicio de dispositivo GATT.
SharingMode	Obtiene el modo de uso compartido de esta instancia de servicio de dispositivo GATT.
Uuid	Obtiene el UUID del servicio GATT asociado a este GattDeviceService.

Métodos

Close()	Libera los recursos asociados a la clase GattDeviceService . Esto permite que otras aplicaciones accedan a los recursos de GattDeviceService en cuestión. No use un objeto GattDeviceService después de invocar Close en él; en su lugar, cree una instancia de un nuevo objeto GattDeviceService mediante el método FromIdAsync . Para C++, llame a Close. Para los lenguajes .NET, este método Close se proyecta en Dispose.
ConvertShortIdToUuid(UInt16)	Convierte un identificador corto definido por Bluetooth SIG en un UUID de 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.
Dispose()	Realiza tareas definidas por la aplicación asociadas a la liberación o al restablecimiento de recursos no administrados.
FromIdAsync(String)	Crea una instancia de un nuevo GattDeviceService desde el identificador de dispositivo.
FromIdAsync(String, GattSharingMode)	Crea una instancia de un nuevo objeto GattDeviceService desde el identificador de dispositivo.
GetAllCharacteristics()	Obtiene la colección de todas las características que pertenecen a esta instancia gattDeviceService. Importante La API GetAllCharacteristics está en desuso y es posible que no esté disponible en versiones futuras de Windows. En su lugar, use GetCharacteristicsAsync.
GetAllIncludedServices()	Obtiene la colección de todos los servicios incluidos que pertenecen a esta instancia gattDeviceService. Importante La API GetAllCharacteristics está en desuso y es posible que no esté disponible en versiones futuras de Windows. En su lugar, use GetIncludedServicesAsync.
GetCharacteristics(Guid)	Devuelve un vector de características, que se identifican mediante el UUID especificado y pertenecen a esta instancia gattDeviceService. Importante La API GetCharacteristics está en desuso y es posible que no esté disponible en versiones futuras de Windows. En su lugar, use GetCharacteristicsForUuidAsync.
GetCharacteristicsAsync()	Obtiene las características que forman parte de esta instancia gattDeviceService.
GetCharacteristicsAsync(BluetoothCacheMode)	Obtiene las características que forman parte de esta instancia gattDeviceService.
GetCharacteristicsForUuidAsync(Guid)	Obtiene los caracteres que forman parte de esta instancia gattDeviceService y que están asociados a la característicaUuid.
GetCharacteristicsForUuidAsync(Guid, BluetoothCacheMode)	Obtiene los caracteres que forman parte de esta instancia gattDeviceService y que están asociados a la característicaUuid.
GetDeviceSelectorForBluetoothDeviceId(BluetoothDeviceId)	Crea una cadena de filtro de AQS adecuada para su uso con el método CreateWatcher , a partir de un BluetoothDeviceId.
GetDeviceSelectorForBluetoothDeviceId(BluetoothDeviceId, BluetoothCacheMode)	Crea una cadena de filtro de AQS adecuada para su uso con el método CreateWatcher , a partir de un BluetoothDeviceId.
GetDeviceSelectorForBluetoothDeviceIdAndUuid(BluetoothDeviceId, Guid)	Crea una cadena de filtro de AQS adecuada para su uso con el método CreateWatcher , desde un BluetoothDeviceId y serviceUuid.
GetDeviceSelectorForBluetoothDeviceIdAndUuid(BluetoothDeviceId, Guid, BluetoothCacheMode)	Crea una cadena de filtro de AQS adecuada para su uso con el método CreateWatcher , desde un BluetoothDeviceId y serviceUuid.
GetDeviceSelectorFromShortId(UInt16)	Crea una cadena de filtro de AQS adecuada para su uso con el método CreateWatcher , a partir de un UUID de servicio GATT de Bluetooth de 16 bits. Importante La API GetDeviceSelectorFromShortId está en desuso y es posible que no esté disponible en versiones futuras de Windows. En su lugar, use GetDeviceSelectorFromUuid.
GetDeviceSelectorFromUuid(Guid)	Crea una cadena de filtro de AQS adecuada para su uso con el método CreateWatcher , a partir de un UUID de servicio Bluetooth.
GetIncludedServices(Guid)	Devuelve un vector de servicios incluidos, que se identifican mediante el UUID especificado y pertenecen a esta instancia gattDeviceService. Importante La API GetIncludedServices está en desuso y es posible que no esté disponible en versiones futuras de Windows. En su lugar, use GetIncludedServicesForUuidAsync.
GetIncludedServicesAsync()	Obtiene los servicios incluidos asociados a esta instancia gattDeviceService.
GetIncludedServicesAsync(BluetoothCacheMode)	Obtiene los servicios incluidos asociados a esta instancia gattDeviceService.
GetIncludedServicesForUuidAsync(Guid)	Obtiene los servicios incluidos del serviceUuid asociado a esta instancia gattDeviceService.
GetIncludedServicesForUuidAsync(Guid, BluetoothCacheMode)	Obtiene los servicios incluidos del serviceUuid asociado a esta instancia gattDeviceService.
OpenAsync(GattSharingMode)	Abre el servicio de dispositivo GATT con el objeto sharingMode especificado.
RequestAccessAsync()	Solicita acceso al GattDeviceService.

Consulte también

• BluetoothLEDevice
• IClosable