GattDeviceService Classe

Definição

Namespace:

Windows.Devices.Bluetooth.GenericAttributeProfile

Representa um serviço primário GATT em um dispositivo Bluetooth. A classe GattDeviceService representa um serviço GATT em um dispositivo Bluetooth LE. Ele é instanciado usando um caminho de instância de serviço de dispositivo, obtido localizando um dispositivo usando a 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

Herança

Object Platform::Object IInspectable GattDeviceService

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementações

IClosable IDisposable

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)
Funcionalidades do aplicativo	bluetooth

Comentários

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
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	Session
1703	15063	SharingMode

Propriedades

AttributeHandle	Obtém o identificador usado para identificar exclusivamente atributos de serviço baseados em GATT, conforme declarado no dispositivo Bluetooth LE.
Device	Obtém o objeto BluetoothLEDevice que descreve o dispositivo associado ao objeto GattDeviceService atual. Importante A API do Dispositivo foi preterida e pode não estar disponível em versões futuras do Windows. Em vez disso, use Session.
DeviceAccessInformation	Obtém as informações de acesso do dispositivo associadas ao objeto GattDeviceService atual.
DeviceId	Obtenha a cadeia de caracteres que representa o caminho da instância de serviço gatt usado para instanciar o GattDeviceService.
ParentServices	Obtém a lista somente leitura de serviços pai para esse serviço. Importante A API ParentServices foi preterida e pode não estar disponível em versões futuras do Windows.
Session	Obtém a sessão para esta instância de serviço de dispositivo GATT.
SharingMode	Obtém o modo de compartilhamento para essa instância de serviço de dispositivo GATT.
Uuid	Obtém a UUID do Serviço GATT associada a este GattDeviceService.

Métodos

Close()	Libera os recursos associados à classe GattDeviceService . Isso permite que outros aplicativos acessem os recursos do GattDeviceService em questão. Não use um objeto GattDeviceService depois de invocar Close nele; em vez disso, instancie um novo objeto GattDeviceService usando o método FromIdAsync . Para C++, chame Fechar. Para linguagens .NET, esse método Close é projetado em Dispose.
ConvertShortIdToUuid(UInt16)	Converte uma ID curta definida por SIG bluetooth em uma UUID gatt completa. Importante A API ConvertShortIdToUuid foi preterida e pode não estar disponível em versões futuras do Windows. Em vez disso, use BluetoothUuidHelper.FromShortId.
Dispose()	Realiza tarefas definidas pelo aplicativo associadas à liberação ou à redefinição de recursos não gerenciados.
FromIdAsync(String)	Cria uma instância de um novo GattDeviceService da ID do dispositivo.
FromIdAsync(String, GattSharingMode)	Cria uma instância de um novo objeto GattDeviceService da ID do dispositivo.
GetAllCharacteristics()	Obtém a coleção de todas as características pertencentes a esta instância gattDeviceService. Importante A API GetAllCharacteristics foi preterida e pode não estar disponível em versões futuras do Windows. Em vez disso, use GetCharacteristicsAsync.
GetAllIncludedServices()	Obtém a coleção de todos os serviços incluídos pertencentes a esta instância gattDeviceService. Importante A API GetAllCharacteristics foi preterida e pode não estar disponível em versões futuras do Windows. Em vez disso, use GetIncludedServicesAsync.
GetCharacteristics(Guid)	Retorna um vetor de características, que são identificadas pelo UUID especificado e pertencem a essa instância gattDeviceService. Importante A API GetCharacteristics foi preterida e pode não estar disponível em versões futuras do Windows. Em vez disso, use GetCharacteristicsForUuidAsync.
GetCharacteristicsAsync()	Obtém as características que fazem parte dessa instância gattDeviceService.
GetCharacteristicsAsync(BluetoothCacheMode)	Obtém as características que fazem parte dessa instância gattDeviceService.
GetCharacteristicsForUuidAsync(Guid)	Obtém os characterisitics que fazem parte dessa instância gattDeviceService e associados à characteristicUuid.
GetCharacteristicsForUuidAsync(Guid, BluetoothCacheMode)	Obtém os characterisitics que fazem parte dessa instância gattDeviceService e associados à characteristicUuid.
GetDeviceSelectorForBluetoothDeviceId(BluetoothDeviceId)	Cria uma cadeia de caracteres de filtro AQS adequada para uso com o método CreateWatcher , de um BluetoothDeviceId.
GetDeviceSelectorForBluetoothDeviceId(BluetoothDeviceId, BluetoothCacheMode)	Cria uma cadeia de caracteres de filtro AQS adequada para uso com o método CreateWatcher , de um BluetoothDeviceId.
GetDeviceSelectorForBluetoothDeviceIdAndUuid(BluetoothDeviceId, Guid)	Cria uma cadeia de caracteres de filtro AQS adequada para uso com o método CreateWatcher , de um BluetoothDeviceId e serviceUuid.
GetDeviceSelectorForBluetoothDeviceIdAndUuid(BluetoothDeviceId, Guid, BluetoothCacheMode)	Cria uma cadeia de caracteres de filtro AQS adequada para uso com o método CreateWatcher , de um BluetoothDeviceId e serviceUuid.
GetDeviceSelectorFromShortId(UInt16)	Cria uma cadeia de caracteres de filtro AQS adequada para uso com o método CreateWatcher , de um UUID de serviço Bluetooth GATT de 16 bits. Importante A API GetDeviceSelectorFromShortId foi preterida e pode não estar disponível em versões futuras do Windows. Em vez disso, use GetDeviceSelectorFromUuid.
GetDeviceSelectorFromUuid(Guid)	Cria uma cadeia de caracteres de filtro AQS adequada para uso com o método CreateWatcher , de um UUID de serviço Bluetooth.
GetIncludedServices(Guid)	Retorna um vetor de serviços incluídos, que são identificados pelo UUID especificado e pertencem a esta instância gattDeviceService. Importante A API GetIncludedServices foi preterida e pode não estar disponível em versões futuras do Windows. Em vez disso, use GetIncludedServicesForUuidAsync.
GetIncludedServicesAsync()	Obtém os serviços incluídos associados a essa instância gattDeviceService.
GetIncludedServicesAsync(BluetoothCacheMode)	Obtém os serviços incluídos associados a essa instância gattDeviceService.
GetIncludedServicesForUuidAsync(Guid)	Obtém os serviços incluídos do serviceUuid associado a essa instância gattDeviceService.
GetIncludedServicesForUuidAsync(Guid, BluetoothCacheMode)	Obtém os serviços incluídos do serviceUuid associado a essa instância gattDeviceService.
OpenAsync(GattSharingMode)	Abre o serviço de dispositivo GATT com o sharingMode especificado.
RequestAccessAsync()	Solicita acesso ao GattDeviceService.

Confira também

• BluetoothLEDevice
• IClosable