GattDeviceService Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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)]
class GattDeviceService final : 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)]
public sealed class GattDeviceService : System.IDisposable[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.IDisposablePublic NotInheritable Class GattDeviceService
Implements IDisposable- Herança
- Atributos
- Implementações
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. |