BluetoothLEDevice 类

定义

命名空间:

Windows.Devices.Bluetooth

表示蓝牙 LE 设备。

有关代码示例，请参阅 蓝牙低功耗示例 和设备 枚举和配对示例。

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

继承

Object Platform::Object IInspectable BluetoothLEDevice

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

实现

IClosable IDisposable

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)
应用功能	bluetooth

注解

版本历史记录

Windows 版本	SDK 版本	已添加值
1511	10586	外观
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

属性

Appearance	获取蓝牙 LE 设备的 BluetoothLEAppearance 对象。
BluetoothAddress	获取设备地址。
BluetoothAddressType	获取蓝牙 LE 设备的地址类型。
BluetoothDeviceId	获取蓝牙设备 ID。
ConnectionStatus	获取设备的连接状态。
DeviceAccessInformation	获取 DeviceAccessInformation。
DeviceId	获取设备 ID。
DeviceInformation	获取蓝牙 LE 设备的设备信息。
GattServices	获取设备支持的 GATT 服务的只读列表。 重要 GattServices API 已弃用，将来的 Windows 版本中可能不可用。 请改用 GetGattServicesAsync。
Name	获取蓝牙 LE 设备的名称。
WasSecureConnectionUsedForPairing	获取一个布尔值，指示 BluetoothLEDevice 是否使用安全连接进行配对。

方法

Close()	关闭此蓝牙 LE 设备。 如果这是唯一具有连接的应用，这可能会关闭与设备的连接。
Dispose()	执行与释放或重置非托管资源关联的应用程序定义的任务。
FromBluetoothAddressAsync(UInt64)	返回一个 BluetoothLEDevice 对象，该对象表示具有给定地址的对等蓝牙 LE 设备。 请参阅此成员主题) 中的 备注 (。
FromBluetoothAddressAsync(UInt64, BluetoothAddressType)	返回一个 BluetoothLEDevice 对象，该对象表示具有给定地址和地址类型的对等设备。 请参阅此成员主题) 中的 备注 (。
FromIdAsync(String)	返回给定 ID 的 BluetoothLEDevice 对象。请参阅成员主题中的 备注 。
GetConnectionParameters()	检索远程设备的连接参数。 如果多个应用或其他系统方案也请求这些参数，则系统会根据系统优先级自动合并这些参数（在兼容的情况下）。 注意 当设备未连接时，连接参数 (所有零) 无效。
GetConnectionPhy()	检索有关蓝牙 LE 物理层的信息 (PHY) 。 注意 设备未连接时，连接 PHY 无效， (所有 false)
GetDeviceSelector()	获取高级查询语法 (AQS) 字符串，用于标识所有蓝牙低功耗 (LE) 设备。 此字符串将传递到 FindAllAsync 或 CreateWatcher 方法，以获取蓝牙 LE 设备的列表。
GetDeviceSelectorFromAppearance(BluetoothLEAppearance)	从 BluetoothLEAppearance 对象 (AQS) 筛选器字符串创建高级查询语法。 AQS 字符串将传递到 CreateWatcher 方法中，以返回具有指定外观的 DeviceInformation 对象的集合。
GetDeviceSelectorFromBluetoothAddress(UInt64)	从表示蓝牙 LE 设备的 64 位地址 (AQS) 筛选器字符串创建高级查询语法。 AQS 字符串将传递到 CreateWatcher 方法，以返回 DeviceInformation 对象的集合。
GetDeviceSelectorFromBluetoothAddress(UInt64, BluetoothAddressType)	从表示蓝牙 LE 设备的 64 位地址和地址类型 (AQS) 筛选器字符串创建高级查询语法。 AQS 字符串将传递到 CreateWatcher 方法中。
GetDeviceSelectorFromConnectionStatus(BluetoothConnectionStatus)	(AQS) 筛选器字符串创建高级查询语法，该字符串包含对具有指示的 BluetoothConnectionStatus 的蓝牙 LE 设备的查询。 AQS 字符串将传递到 CreateWatcher 方法中，以返回具有指示蓝牙连接状态的 DeviceInformation 对象的集合。
GetDeviceSelectorFromDeviceName(String)	(AQS) 筛选器字符串创建高级查询语法，其中包含蓝牙 LE 设备名称的查询。 AQS 字符串将传递到 CreateWatcher 方法，以返回包含指定蓝牙 LE 设备名称的 DeviceInformation 对象的集合。
GetDeviceSelectorFromPairingState(Boolean)	(AQS) 筛选器字符串创建高级查询语法，该字符串包含对配对或未配对的蓝牙 LE 设备的查询。 AQS 字符串将传递到 CreateWatcher 方法，以返回 DeviceInformation 对象的集合。
GetGattService(Guid)	返回具有给定服务 ID 的 GATT 服务。 重要 GetGattService API 已弃用，将来的 Windows 版本中可能不可用。 请改用 GetGattServicesAsync。
GetGattServicesAsync()	获取此蓝牙 LowEnergy 设备的 GattDeviceServices。
GetGattServicesAsync(BluetoothCacheMode)	返回具有指定缓存模式的此蓝牙 LowEnergy 设备的 GattDeviceServices。
GetGattServicesForUuidAsync(Guid)	返回具有指定 UUID 的蓝牙 LowEnergy 设备的 GattDeviceServices。
GetGattServicesForUuidAsync(Guid, BluetoothCacheMode)	返回具有指定 UUID 的蓝牙 LowEnergy 设备的 GattDeviceServices。
RequestAccessAsync()	请求访问蓝牙 LowEnergy 设备。
RequestPreferredConnectionParameters(BluetoothLEPreferredConnectionParameters)	检索指定的蓝牙 LE 首选连接参数对象的蓝牙 LE 首选连接参数请求对象。

事件

ConnectionParametersChanged	设备当前连接参数更改时引发的事件。 只有在与设备建立连接后，参数才会更新。
ConnectionPhyChanged	设备当前 PHY 更改时引发的事件。 仅在与设备建立连接后，PHY 才会更新。
ConnectionStatusChanged	当设备的连接状态发生更改时发生。
GattServicesChanged	当设备支持的 GATT 服务列表已更改时引发。
NameChanged	在设备名称更改时发生。

另请参阅

• GattDeviceService
• Device
• 蓝牙低功耗示例
• 设备枚举和配对示例