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 di enumerazione Bluetooth Low Energye Esempio di associazione del dispositivo.
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
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 | Aspetto |
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à
Appearance |
Ottiene l'oggetto BluetoothLEAppearance per il dispositivo Bluetooth LE. |
BluetoothAddress |
Ottiene l'indirizzo del dispositivo. |
BluetoothAddressType |
Ottiene il tipo di indirizzo per il dispositivo Bluetooth LE. |
BluetoothDeviceId |
Ottiene l'ID dispositivo Bluetooth. |
ConnectionStatus |
Ottiene lo stato della connessione del dispositivo. |
DeviceAccessInformation |
Ottiene DeviceAccessInformation. |
DeviceId |
Ottiene l'ID dispositivo. |
DeviceInformation |
Ottiene le informazioni sul dispositivo Bluetooth LE. |
GattServices |
Ottiene l'elenco di sola lettura dei servizi GATT supportati dal dispositivo. Importante L'API GattServices è 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
Close() |
Chiude questo dispositivo Bluetooth LE. Questa operazione può chiudere la connessione al dispositivo se si tratta dell'unica app con una connessione. |
Dispose() |
Esegue attività definite dall'applicazione, come rilasciare o reimpostare risorse non gestite. |
FromBluetoothAddressAsync(UInt64) |
Restituisce un oggetto BluetoothLEDevice che rappresenta il dispositivo Bluetooth LE peer con l'indirizzo specificato. Vedere la sezione Osservazioni (in questo argomento membro). |
FromBluetoothAddressAsync(UInt64, BluetoothAddressType) |
Restituisce un oggetto BluetoothLEDevice che rappresenta il dispositivo peer con l'indirizzo e il tipo di indirizzo specificati. Vedere la sezione Osservazioni (in questo argomento membro). |
FromIdAsync(String) |
Restituisce un oggetto BluetoothLEDevice per l'ID specificato. Vedere la sezione Osservazioni nell'argomento membro. |
GetConnectionParameters() |
Recupera i parametri di connessione per il dispositivo remoto. Se più app o altri scenari di sistema richiedono anche 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 (tutti 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 . La stringa AQS viene passata al metodo CreateWatcher per restituire una raccolta di oggetti DeviceInformation con l'aspetto specificato. |
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 . |
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 . |
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 CreateWatcher per restituire una raccolta di oggetti DeviceInformation contenenti il nome del dispositivo Bluetooth LE specificato. |
GetDeviceSelectorFromPairingState(Boolean) |
Crea una stringa di filtro AQS (Advanced Query Syntax) contenente 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 servizio specificato. Importante L'API GetGattService è deprecata e potrebbe non essere disponibile nelle versioni future di Windows. Usare invece GetGattServicesAsync. |
GetGattServicesAsync() |
Ottiene il GattDeviceServices per questo dispositivo Bluetooth LowManager. |
GetGattServicesAsync(BluetoothCacheMode) |
Restituisce gattDeviceServices per questo dispositivo Bluetooth LowManager con la modalità cache specificata. |
GetGattServicesForUuidAsync(Guid) |
Restituisce gattDeviceServices per il dispositivo Bluetooth LowIntune con l'UUID specificato. |
GetGattServicesForUuidAsync(Guid, BluetoothCacheMode) |
Restituisce gattDeviceServices per il dispositivo Bluetooth LowIntune con l'UUID specificato. |
RequestAccessAsync() |
Richiede l'accesso al dispositivo Bluetooth LowSphere. |
RequestPreferredConnectionParameters(BluetoothLEPreferredConnectionParameters) |
Recupera un oggetto richiesta di parametri di connessione Bluetooth LE preferito per l'oggetto parametri di connessione preferito Bluetooth LE specificato. |
Eventi
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'oggetto 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 è cambiato. |
GattServicesChanged |
Generato quando l'elenco dei servizi GATT supportati dal dispositivo è cambiato. |
NameChanged |
Si verifica quando il nome del dispositivo è stato modificato. |