GattDeviceService Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Rappresenta un servizio primario GATT in un dispositivo Bluetooth. La classe GattDeviceService rappresenta un servizio GATT in un dispositivo Bluetooth LE. Viene creata un'istanza usando un percorso dell'istanza del servizio dispositivi ottenuta individuando un dispositivo usando l'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- Ereditarietà
- Attributi
- Implementazioni
Requisiti Windows
| Famiglia di dispositivi |
Windows 10 (è stato introdotto in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
|
| API contract |
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)
|
| Funzionalità dell'app |
bluetooth
|
Commenti
Cronologia delle versioni
| Versione di Windows | Versione dell'SDK | Valore aggiunto |
|---|---|---|
| 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 | sessione |
| 1703 | 15063 | SharingMode |
Proprietà
| AttributeHandle |
Ottiene l'handle utilizzato per identificare in modo univoco gli attributi del servizio basati su GATT come dichiarato nel dispositivo Bluetooth LE. |
| Device |
Ottiene l'oggetto BluetoothLEDevice che descrive il dispositivo associato all'oggetto GattDeviceService corrente. Importante L'API del dispositivo è deprecata e potrebbe non essere disponibile nelle versioni future di Windows. Usare invece Session. |
| DeviceAccessInformation |
Ottiene le informazioni di accesso al dispositivo associate all'oggetto GattDeviceService corrente. |
| DeviceId |
Ottiene la stringa che rappresenta il percorso dell'istanza del servizio GATT utilizzata per creare un'istanza di GattDeviceService. |
| ParentServices |
Ottiene l'elenco di sola lettura dei servizi padre per questo servizio. Importante L'API ParentServices è deprecata e potrebbe non essere disponibile nelle versioni future di Windows. |
| Session |
Ottiene la sessione per questa istanza del servizio dispositivi GATT. |
| SharingMode |
Ottiene la modalità di condivisione per questa istanza del servizio dispositivi GATT. |
| Uuid |
Ottiene l'UUID del servizio GATT associato a gattDeviceService. |
Metodi
| Close() |
Rilascia le risorse associate alla classe GattDeviceService . Ciò consente ad altre app di accedere alle risorse di GattDeviceService in questione. Non usare un oggetto GattDeviceService dopo aver richiamato Close su di esso; Creare invece un'istanza di un nuovo oggetto GattDeviceService usando il metodo FromIdAsync . Per C++, chiamare Close. Per i linguaggi .NET, questo metodo Close viene proiettato in Dispose. |
| ConvertShortIdToUuid(UInt16) |
Converte un ID breve definito da Bluetooth SIG in un UUID GATT completo. Importante L'API ConvertShortIdToUuid è deprecata e potrebbe non essere disponibile nelle versioni future di Windows. Usare invece BluetoothUuidHelper.FromShortId. |
| Dispose() |
Esegue attività definite dall'applicazione, come rilasciare o reimpostare risorse non gestite. |
| FromIdAsync(String) |
Crea un'istanza di un nuovo GattDeviceService dall'ID dispositivo. |
| FromIdAsync(String, GattSharingMode) |
Crea un'istanza di un nuovo oggetto GattDeviceService dall'ID dispositivo. |
| GetAllCharacteristics() |
Ottiene la raccolta di tutte le caratteristiche appartenenti a questa istanza gattDeviceService. Importante L'API GetAllCharacteristics è deprecata e potrebbe non essere disponibile nelle versioni future di Windows. Usare invece GetCharacteristicsAsync. |
| GetAllIncludedServices() |
Ottiene la raccolta di tutti i servizi inclusi appartenenti a questa istanza gattDeviceService. Importante L'API GetAllCharacteristics è deprecata e potrebbe non essere disponibile nelle versioni future di Windows. Usare invece GetIncludedServicesAsync. |
| GetCharacteristics(Guid) |
Restituisce un vettore di caratteristiche, identificato dall'UUID specificato e appartenente a questa istanza di GattDeviceService. Importante L'API GetCharacteristics è deprecata e potrebbe non essere disponibile nelle versioni future di Windows. Usare invece GetCharacteristicsForUuidAsync. |
| GetCharacteristicsAsync() |
Ottiene le caratteristiche che fanno parte di questa istanza GattDeviceService. |
| GetCharacteristicsAsync(BluetoothCacheMode) |
Ottiene le caratteristiche che fanno parte di questa istanza GattDeviceService. |
| GetCharacteristicsForUuidAsync(Guid) |
Ottiene i caratteri che fanno parte di questa istanza di GattDeviceService e associati alla caratteristicaUuid. |
| GetCharacteristicsForUuidAsync(Guid, BluetoothCacheMode) |
Ottiene i caratteri che fanno parte di questa istanza di GattDeviceService e associati alla caratteristicaUuid. |
| GetDeviceSelectorForBluetoothDeviceId(BluetoothDeviceId) |
Crea una stringa di filtro AQS adatta da usare con il metodo CreateWatcher da un BluetoothDeviceId. |
| GetDeviceSelectorForBluetoothDeviceId(BluetoothDeviceId, BluetoothCacheMode) |
Crea una stringa di filtro AQS adatta da usare con il metodo CreateWatcher da un BluetoothDeviceId. |
| GetDeviceSelectorForBluetoothDeviceIdAndUuid(BluetoothDeviceId, Guid) |
Crea una stringa di filtro AQS adatta da usare con il metodo CreateWatcher , da BluetoothDeviceId e serviceUuid. |
| GetDeviceSelectorForBluetoothDeviceIdAndUuid(BluetoothDeviceId, Guid, BluetoothCacheMode) |
Crea una stringa di filtro AQS adatta da usare con il metodo CreateWatcher , da BluetoothDeviceId e serviceUuid. |
| GetDeviceSelectorFromShortId(UInt16) |
Crea una stringa di filtro AQS adatta da utilizzare con il metodo CreateWatcher da un UUID del servizio GATT Bluetooth a 16 bit. Importante L'API GetDeviceSelectorFromShortId è deprecata e potrebbe non essere disponibile nelle versioni future di Windows. Usare invece GetDeviceSelectorFromUuid. |
| GetDeviceSelectorFromUuid(Guid) |
Crea una stringa di filtro AQS adatta da usare con il metodo CreateWatcher da un UUID del servizio Bluetooth. |
| GetIncludedServices(Guid) |
Restituisce un vettore di servizi inclusi, identificati dall'UUID specificato e appartenenti a questa istanza di GattDeviceService. Importante L'API GetIncludedServices è deprecata e potrebbe non essere disponibile nelle versioni future di Windows. Usare invece GetIncludedServicesForUuidAsync. |
| GetIncludedServicesAsync() |
Ottiene i servizi inclusi associati all'istanza gattDeviceService. |
| GetIncludedServicesAsync(BluetoothCacheMode) |
Ottiene i servizi inclusi associati all'istanza gattDeviceService. |
| GetIncludedServicesForUuidAsync(Guid) |
Ottiene i servizi inclusi dal serviceUuid associato all'istanza gattDeviceService. |
| GetIncludedServicesForUuidAsync(Guid, BluetoothCacheMode) |
Ottiene i servizi inclusi dal serviceUuid associato all'istanza gattDeviceService. |
| OpenAsync(GattSharingMode) |
Apre il servizio dispositivo GATT con il valore sharingMode specificato. |
| RequestAccessAsync() |
Richiede l'accesso a GattDeviceService. |