BluetoothLEDevice 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 dispositivo Bluetooth LE.
Per esempi di codice, vedere esempio Bluetooth Low Energy e 'enumerazione e associazione di dispositivi.
public ref class BluetoothLEDevice 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 BluetoothLEDevice 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 BluetoothLEDevice : System.IDisposable
Public NotInheritable Class BluetoothLEDevice
Implements IDisposable
- Ereditarietà
- Attributi
- Implementazioni
Requisiti Windows
| Requisiti | Descrizione |
|---|---|
| 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 |
|---|---|---|
| 1511 | 10586 | Apparenza |
| 1511 | 10586 | BluetoothAddressType |
| 1511 | 10586 | DeviceInformation |
| 1511 | 10586 | FromBluetoothAddressAsync(UInt64,BluetoothAddressType) |
| 1511 | 10586 | GetDeviceSelectorFromAppearance |
| 1511 | 10586 | GetDeviceSelectorFromBluetoothAddress(UInt64) |
| 1511 | 10586 | GetDeviceSelectorFromBluetoothAddress(UInt64,BluetoothAddressType) |
| 1511 | 10586 | GetDeviceSelectorFromConnectionStatus |
| 1511 | 10586 | GetDeviceSelectorFromDeviceName |
| 1511 | 10586 | GetDeviceSelectorFromPairingState |
| 1703 | 15063 | DeviceAccessInformation |
| 1703 | 15063 | GetGattServicesAsync |
| 1703 | 15063 | GetGattServicesAsync(BluetoothCacheMode) |
| 1703 | 15063 | GetGattServicesForUuidAsync(Guid) |
| 1703 | 15063 | GetGattServicesForUuidAsync(Guid,BluetoothCacheMode) |
| 1703 | 15063 | RequestAccessAsync |
| 1709 | 16299 | BluetoothDeviceId |
| 1803 | 17134 | WasSecureConnectionUsedForPairing |
Proprietà
| Nome | Descrizione |
|---|---|
| Appearance |
Ottiene l'oggetto BluetoothLEAppearance |
| BluetoothAddress |
Ottiene l'indirizzo del dispositivo. |
| BluetoothAddressType |
Ottiene il tipo di indirizzo per il dispositivo Bluetooth LE. |
| BluetoothDeviceId |
Ottiene l'ID del dispositivo Bluetooth. |
| ConnectionStatus |
Ottiene lo stato di connessione del dispositivo. |
| DeviceAccessInformation |
Ottiene DeviceAccessInformation. |
| DeviceId |
Ottiene l'ID dispositivo. |
| DeviceInformation |
Ottiene le informazioni sul dispositivo per il dispositivo Bluetooth LE. |
| GattServices |
Ottiene l'elenco di sola lettura dei servizi GATT supportati dal dispositivo. Importante La GattServices API è deprecata e potrebbe non essere disponibile nelle versioni future di Windows. Usare invece GetGattServicesAsync. |
| Name |
Ottiene il nome del dispositivo Bluetooth LE. |
| WasSecureConnectionUsedForPairing |
Ottiene un valore booleano che indica se BluetoothLEDevice è stato associato tramite una connessione sicura. |
Metodi
| Nome | Descrizione |
|---|---|
| Close() |
Chiude questo dispositivo Bluetooth LE. Ciò potrebbe chiudere la connessione al dispositivo se si tratta dell'unica app con una connessione. |
| Dispose() |
Esegue attività definite dall'applicazione associate alla liberazione, al rilascio o alla reimpostazione di risorse non gestite. |
| FromBluetoothAddressAsync(UInt64, BluetoothAddressType) |
Restituisce un oggetto BluetoothLEDevice che rappresenta il dispositivo peer con l'indirizzo e il tipo di indirizzo specificati. Vedere osservazioni (in questo argomento membro). |
| FromBluetoothAddressAsync(UInt64) |
Restituisce un oggetto BluetoothLEDevice che rappresenta il dispositivo Bluetooth LE peer con l'indirizzo specificato. Vedere osservazioni (in questo argomento membro). |
| FromIdAsync(String) |
Restituisce un oggetto BluetoothLEDevice |
| GetConnectionParameters() |
Recupera i parametri di connessione per il dispositivo remoto. Se anche più app o altri scenari di sistema richiedono questi parametri, il sistema combina automaticamente i parametri, se compatibili, in base alla priorità di sistema. Nota Quando il dispositivo non è connesso, i parametri di connessione non sono validi (tutti zero). |
| GetConnectionPhy() |
Recupera informazioni sul livello fisico Bluetooth LE (PHY). Nota Quando il dispositivo non è connesso, i phy di connessione non sono validi (tutto false) |
| GetDeviceSelector() |
Ottiene una stringa AQS (Advanced Query Syntax) per identificare tutti i dispositivi Bluetooth Low Energy (LE). Questa stringa viene passata al metodo FindAllAsync o CreateWatcher per ottenere un elenco di dispositivi Bluetooth LE. |
| GetDeviceSelectorFromAppearance(BluetoothLEAppearance) |
Crea una stringa di filtro AQS (Advanced Query Syntax) da un oggetto BluetoothLEAppearance |
| GetDeviceSelectorFromBluetoothAddress(UInt64, BluetoothAddressType) |
Crea una stringa di filtro AQS (Advanced Query Syntax) da un indirizzo e un tipo di indirizzo a 64 bit che rappresenta un dispositivo Bluetooth LE. La stringa AQS viene passata al metodo CreateWatcher |
| GetDeviceSelectorFromBluetoothAddress(UInt64) |
Crea una stringa di filtro AQS (Advanced Query Syntax) da un indirizzo a 64 bit che rappresenta un dispositivo Bluetooth LE. La stringa AQS viene passata al metodo CreateWatcher per restituire una raccolta di oggetti DeviceInformation. |
| GetDeviceSelectorFromConnectionStatus(BluetoothConnectionStatus) |
Crea una stringa di filtro AQS (Advanced Query Syntax) contenente una query per i dispositivi Bluetooth LE con il BluetoothConnectionStatus indicato. La stringa AQS viene passata al metodo CreateWatcher per restituire una raccolta di oggetti DeviceInformation con lo stato di connessione Bluetooth indicato. |
| GetDeviceSelectorFromDeviceName(String) |
Crea una stringa di filtro AQS (Advanced Query Syntax) che contiene una query per il nome del dispositivo Bluetooth LE. La stringa AQS viene passata al metodo |
| GetDeviceSelectorFromPairingState(Boolean) |
Crea una stringa di filtro AQS (Advanced Query Syntax) che contiene una query per i dispositivi Bluetooth LE associati o non abbinati. La stringa AQS viene passata al metodo CreateWatcher per restituire una raccolta di oggetti DeviceInformation. |
| GetGattService(Guid) |
Restituisce il servizio GATT con l'ID del servizio specificato. Importante L'API GetGattService |
| GetGattServicesAsync() |
Ottiene il GattDeviceServices per questo dispositivo Bluetooth LowDeviceServices. |
| GetGattServicesAsync(BluetoothCacheMode) |
Restituisce gattDeviceServices per questo dispositivo Bluetooth LowDeviceServices con la modalità cache specificata. |
| GetGattServicesForUuidAsync(Guid, BluetoothCacheMode) |
Restituisce gattDeviceServices per il dispositivo Bluetooth LowDeviceServices con l'UUID specificato. |
| GetGattServicesForUuidAsync(Guid) |
Restituisce gattDeviceServices per il dispositivo Bluetooth LowDeviceServices con l'UUID specificato. |
| RequestAccessAsync() |
Richiede l'accesso al dispositivo Bluetooth LowSphere. |
| RequestPreferredConnectionParameters(BluetoothLEPreferredConnectionParameters) |
Recupera un oggetto richiesta di parametri di connessione Bluetooth LE preferiti per l'oggetto di parametri di connessione preferito Bluetooth LE specificato. |
Eventi
| Nome | Descrizione |
|---|---|
| ConnectionParametersChanged |
Evento generato quando cambiano i parametri di connessione correnti per il dispositivo. I parametri verranno aggiornati solo dopo che è stata stabilita una connessione al dispositivo. |
| ConnectionPhyChanged |
Evento generato quando cambia l'PHY corrente per il dispositivo. Il PHY verrà aggiornato solo dopo che è stata stabilita una connessione al dispositivo. |
| ConnectionStatusChanged |
Si verifica quando lo stato della connessione per il dispositivo è stato modificato. |
| GattServicesChanged |
Generato quando l'elenco dei servizi GATT supportati dal dispositivo è cambiato. |
| NameChanged |
Si verifica quando il nome del dispositivo è stato modificato. |