GattDeviceService Classe

Definizione

Spazio dei nomi:

Windows.Devices.Bluetooth.GenericAttributeProfile

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)]
/// [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

Ereditarietà

Object Platform::Object IInspectable GattDeviceService

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementazioni

IClosable IDisposable

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.

Vedi anche

• BluetoothLEDevice
• IClosable