BluetoothLEDevice Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt ein Bluetooth LE-Gerät dar.
Codebeispiele finden Sie unter Bluetooth Low Energy-Beispiel und Beispiel für Geräteenumeration und Kopplung.
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.IDisposablePublic NotInheritable Class BluetoothLEDevice
Implements IDisposable- Vererbung
- Attribute
- Implementiert
Windows-Anforderungen
| Gerätefamilie |
Windows 10 (eingeführt in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
|
| API contract |
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)
|
| App-Funktionen |
bluetooth
|
Hinweise
Versionsverlauf
| Windows-Version | SDK-Version | Wertschöpfung |
|---|---|---|
| 1511 | 10586 | Darstellung |
| 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 |
Eigenschaften
| Appearance |
Ruft das BluetoothLEAppearance-Objekt für das Bluetooth LE-Gerät ab. |
| BluetoothAddress |
Ruft die Geräteadresse ab. |
| BluetoothAddressType |
Ruft den Adresstyp für das Bluetooth LE-Gerät ab. |
| BluetoothDeviceId |
Ruft die Bluetooth-Geräte-ID ab. |
| ConnectionStatus |
Ruft die Verbindung status des Geräts ab. |
| DeviceAccessInformation |
Ruft deviceAccessInformation ab. |
| DeviceId |
Ruft die Geräte-ID ab. |
| DeviceInformation |
Ruft die Geräteinformationen für das Bluetooth LE-Gerät ab. |
| GattServices |
Ruft die schreibgeschützte Liste der gatt-Dienste ab, die vom Gerät unterstützt werden. Wichtig Die GattServices-API ist veraltet und in zukünftigen Windows-Versionen möglicherweise nicht verfügbar. Verwenden Sie stattdessen GetGattServicesAsync. |
| Name |
Ruft den Namen des Bluetooth LE-Geräts ab. |
| WasSecureConnectionUsedForPairing |
Ruft einen booleschen Wert ab, der angibt, ob das BluetoothLEDevice über eine sichere Verbindung gekoppelt wurde. |
Methoden
| Close() |
Schließt dieses Bluetooth LE-Gerät. Dadurch kann die Verbindung mit dem Gerät geschlossen werden, wenn dies die einzige App mit einer Verbindung ist. |
| Dispose() |
Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen. |
| FromBluetoothAddressAsync(UInt64) |
Gibt ein BluetoothLEDevice-Objekt zurück, das das Bluetooth LE-Peergerät mit der angegebenen Adresse darstellt. Weitere Informationen finden Sie unter Hinweise (in diesem Memberthema). |
| FromBluetoothAddressAsync(UInt64, BluetoothAddressType) |
Gibt ein BluetoothLEDevice-Objekt zurück, das das Peergerät mit der angegebenen Adresse und dem angegebenen Adresstyp darstellt. Weitere Informationen finden Sie unter Hinweise (in diesem Memberthema). |
| FromIdAsync(String) |
Gibt ein BluetoothLEDevice-Objekt für die angegebene ID zurück. Weitere Informationen finden Sie unter Hinweise im Memberthema. |
| GetConnectionParameters() |
Ruft Verbindungsparameter für das Remotegerät ab. Wenn mehrere Apps oder andere Systemszenarien diese Parameter ebenfalls anfordern, kombiniert das System die Parameter automatisch, sofern kompatibel, basierend auf der Systempriorität. Hinweis Wenn das Gerät nicht verbunden ist, sind die Verbindungsparameter ungültig (alle null). |
| GetConnectionPhy() |
Ruft Informationen zur physischen Bluetooth LE-Schicht (PhY) ab. Hinweis Wenn das Gerät nicht verbunden ist, sind die Verbindungs-PHYs ungültig (alle false). |
| GetDeviceSelector() |
Ruft eine AQS-Zeichenfolge (Advanced Query Syntax) zum Identifizieren aller Le-Geräte (Bluetooth Low Energy) ab. Diese Zeichenfolge wird an die FindAllAsync - oder CreateWatcher-Methode übergeben, um eine Liste der Bluetooth LE-Geräte abzurufen. |
| GetDeviceSelectorFromAppearance(BluetoothLEAppearance) |
Erstellt eine AQS-Filterzeichenfolge (Advanced Query Syntax) aus einem BluetoothLEAppearance-Objekt . Die AQS-Zeichenfolge wird an die CreateWatcher-Methode übergeben, um eine Auflistung von DeviceInformation-Objekten mit der angegebenen Darstellung zurückzugeben. |
| GetDeviceSelectorFromBluetoothAddress(UInt64) |
Erstellt eine AQS-Filterzeichenfolge (Advanced Query Syntax) aus einer 64-Bit-Adresse, die ein Bluetooth LE-Gerät darstellt. Die AQS-Zeichenfolge wird an die CreateWatcher-Methode übergeben, um eine Auflistung von DeviceInformation-Objekten zurückzugeben. |
| GetDeviceSelectorFromBluetoothAddress(UInt64, BluetoothAddressType) |
Erstellt eine AQS-Filterzeichenfolge (Advanced Query Syntax) aus einer 64-Bit-Adresse und einem Adresstyp, der ein Bluetooth LE-Gerät darstellt. Die AQS-Zeichenfolge wird an die CreateWatcher-Methode übergeben. |
| GetDeviceSelectorFromConnectionStatus(BluetoothConnectionStatus) |
Erstellt eine AQS-Filterzeichenfolge (Advanced Query Syntax), die eine Abfrage für Bluetooth LE-Geräte mit dem angegebenen BluetoothConnectionStatus enthält. Die AQS-Zeichenfolge wird an die CreateWatcher-Methode übergeben, um eine Auflistung von DeviceInformation-Objekten mit der angegebenen Bluetooth-Verbindung status zurückzugeben. |
| GetDeviceSelectorFromDeviceName(String) |
Erstellt eine AQS-Filterzeichenfolge (Advanced Query Syntax), die eine Abfrage für den Bluetooth LE-Gerätenamen enthält. Die AQS-Zeichenfolge wird an die CreateWatcher-Methode übergeben, um eine Auflistung von DeviceInformation-Objekten zurückzugeben, die den angegebenen Bluetooth LE-Gerätenamen enthalten. |
| GetDeviceSelectorFromPairingState(Boolean) |
Erstellt eine AQS-Filterzeichenfolge (Advanced Query Syntax), die eine Abfrage für Bluetooth LE-Geräte enthält, die entweder gekoppelt oder entkoppelt sind. Die AQS-Zeichenfolge wird an die CreateWatcher-Methode übergeben, um eine Auflistung von DeviceInformation-Objekten zurückzugeben. |
| GetGattService(Guid) |
Gibt den GATT-Dienst mit der angegebenen Dienst-ID zurück. Wichtig Die GetGattService-API ist veraltet und in zukünftigen Windows-Versionen möglicherweise nicht verfügbar. Verwenden Sie stattdessen GetGattServicesAsync. |
| GetGattServicesAsync() |
Ruft gattDeviceServices für dieses Bluetooth LowEnergy-Gerät ab. |
| GetGattServicesAsync(BluetoothCacheMode) |
Gibt die GattDeviceServices für dieses Bluetooth LowEnergy-Gerät mit dem angegebenen Cachemodus zurück. |
| GetGattServicesForUuidAsync(Guid) |
Gibt die GattDeviceServices für das Bluetooth LowEnergy-Gerät mit der angegebenen UUID zurück. |
| GetGattServicesForUuidAsync(Guid, BluetoothCacheMode) |
Gibt die GattDeviceServices für das Bluetooth LowEnergy-Gerät mit der angegebenen UUID zurück. |
| RequestAccessAsync() |
Fordert den Zugriff auf das Bluetooth LowEnergy-Gerät an. |
| RequestPreferredConnectionParameters(BluetoothLEPreferredConnectionParameters) |
Ruft ein Anforderungsobjekt der bevorzugten Bluetooth LE-Verbindungsparameter für das angegebene bevorzugte Bluetooth LE-Verbindungsparameterobjekt ab. |
Ereignisse
| ConnectionParametersChanged |
Ein Ereignis, das ausgelöst wird, wenn sich die aktuellen Verbindungsparameter für das Gerät ändern. Die Parameter werden erst aktualisiert, nachdem eine Verbindung mit dem Gerät hergestellt wurde. |
| ConnectionPhyChanged |
Ein Ereignis, das ausgelöst wird, wenn sich der aktuelle PHY für das Gerät ändert. Das PHY wird erst aktualisiert, nachdem eine Verbindung mit dem Gerät hergestellt wurde. |
| ConnectionStatusChanged |
Tritt auf, wenn die Verbindung status für das Gerät geändert wurde. |
| GattServicesChanged |
Wird ausgelöst, wenn sich die Liste der vom Gerät unterstützten GATT-Dienste geändert hat. |
| NameChanged |
Tritt auf, wenn sich der Name des Geräts geändert hat. |