BluetoothDevice 类

定义

命名空间:

Windows.Devices.Bluetooth

表示蓝牙设备。

使用此类的示例应用程序包括 设备枚举和配对示例 以及 蓝牙 RFCOMM 聊天示例。

public ref class BluetoothDevice 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 BluetoothDevice 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 BluetoothDevice : System.IDisposable

Public NotInheritable Class BluetoothDevice
Implements IDisposable

继承

Object Platform::Object IInspectable BluetoothDevice

属性

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	DeviceInformation
1511	10586	GetDeviceSelectorFromBluetoothAddress
1511	10586	GetDeviceSelectorFromClassOfDevice
1511	10586	GetDeviceSelectorFromConnectionStatus
1511	10586	GetDeviceSelectorFromDeviceName
1511	10586	GetDeviceSelectorFromPairingState
1607	14393	DeviceAccessInformation
1607	14393	GetRfcommServicesAsync
1607	14393	GetRfcommServicesAsync (BluetoothCacheMode)
1607	14393	GetRfcommServicesForIdAsync (RfcommServiceId)
1607	14393	GetRfcommServicesForIdAsync (RfcommServiceId，BluetoothCacheMode)
1607	14393	RequestAccessAsync
1709	16299	BluetoothDeviceId
1803	17134	WasSecureConnectionUsedForPairing

属性

BluetoothAddress	获取设备地址。
BluetoothDeviceId	获取蓝牙设备 ID。
ClassOfDevice	获取设备的蓝牙设备类信息。
ConnectionStatus	获取设备的连接状态。
DeviceAccessInformation	设备的当前 DeviceAccessInformation 对象。 用于检查和监视对设备的访问更改。
DeviceId	获取来自 Windows.Devices.Enumeration.DeviceInformation.Id 的设备 ID
DeviceInformation	获取蓝牙设备的 DeviceInformation 对象。
HostName	获取设备的 HostName。
Name	获取设备的名称。
RfcommServices	获取设备支持的 RFCOMM 服务的只读列表。 重要 RfcommServices API 已弃用，将来的 Windows 版本中可能不可用。 请改用 GetRfcommServicesAsync。
SdpRecords	获取设备的 SDP) 记录 (服务发现协议的只读列表。
WasSecureConnectionUsedForPairing	获取一个布尔值，该值指示 BluetoothDevice 是否使用安全连接进行配对。

方法

Close()	关闭蓝牙设备。
Dispose()	执行与释放或重置非托管资源关联的应用程序定义的任务。
FromBluetoothAddressAsync(UInt64)	返回给定 BluetoothAddress 的 BluetoothDevice 对象。
FromHostNameAsync(HostName)	返回由给定主机名标识的 BluetoothDevice 对象。
FromIdAsync(String)	返回由给定 DeviceId 标识的 BluetoothDevice 对象。
GetDeviceSelector()	获取用于标识此设备的实例 (AQS) 字符串的高级查询语法。 此字符串将传递给 FindAllAsync 或 CreateWatcher 方法。
GetDeviceSelectorFromBluetoothAddress(UInt64)	从表示蓝牙设备的 64 位地址创建 (AQS) 筛选器字符串的高级查询语法。 AQS 字符串将传递到 CreateWatcher 方法，以返回 DeviceInformation 对象的集合。
GetDeviceSelectorFromClassOfDevice(BluetoothClassOfDevice)	从 BluetoothClassOfDevice 对象 (AQS) 筛选器字符串创建高级查询语法。 AQS 字符串将传递到 CreateWatcher 方法，以返回 DeviceInformation 对象的集合。
GetDeviceSelectorFromConnectionStatus(BluetoothConnectionStatus)	(AQS) 筛选器字符串创建高级查询语法，该字符串包含针对具有指示的 BluetoothConnectionStatus 的蓝牙设备的查询。 AQS 字符串将传递到 CreateWatcher 方法，以返回具有指示的蓝牙连接状态的 DeviceInformation 对象的集合。
GetDeviceSelectorFromDeviceName(String)	(AQS) 筛选器字符串创建高级查询语法，其中包含蓝牙设备名称的查询。 AQS 字符串将传递到 CreateWatcher 方法，以返回包含指定蓝牙设备名称的 DeviceInformation 对象的集合。
GetDeviceSelectorFromPairingState(Boolean)	(AQS) 筛选器字符串创建高级查询语法，其中包含已配对或未配对的蓝牙设备的查询。 AQS 字符串将传递到 CreateWatcher 方法，以返回 DeviceInformation 对象的集合。
GetRfcommServicesAsync()	检索远程蓝牙设备上的所有 Rfcomm 服务。
GetRfcommServicesAsync(BluetoothCacheMode)	检索远程蓝牙设备上所有缓存的 Rfcomm 服务。
GetRfcommServicesForIdAsync(RfcommServiceId)	检索远程蓝牙设备上与指定的 RfcommServiceId 匹配的所有 Rfcomm 服务。
GetRfcommServicesForIdAsync(RfcommServiceId, BluetoothCacheMode)	检索远程蓝牙设备上与指定的 RfcommServiceId 匹配的所有缓存 的 Rfcomm 服务。
RequestAccessAsync()	用于请求对蓝牙设备的显式访问。 这会调用设备同意，并且必须在 UI 线程上调用。

事件

ConnectionStatusChanged	当设备的连接状态发生更改时发生。
NameChanged	在设备名称更改时发生。
SdpRecordsChanged	当设备的 SDP 记录列表已更改时发生。

另请参阅

• 设备枚举和配对示例
• 蓝牙 RFCOMM 聊天示例