BluetoothLEDevice Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.Devices.Bluetooth

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.

Modifica

Rappresenta un dispositivo Bluetooth LE.

Per esempi di codice, vedere Esempio di enumerazione Bluetooth Low Energy e 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à: Object Platform::Object IInspectable BluetoothLEDevice

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
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.

Si applica a