Condividi tramite


BluetoothLEDevice Classe

Definizione

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à
Object Platform::Object IInspectable BluetoothLEDevice
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.

Si applica a

Vedi anche