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	取得藍牙裝置識別碼。
ClassOfDevice	取得裝置的藍牙類別裝置資訊。
ConnectionStatus	取得裝置的線上狀態。
DeviceAccessInformation	裝置目前的 DeviceAccessInformation 物件。 用來檢查和監視裝置的存取變更。
DeviceId	取得來自 Windows.Devices.Enumeration.DeviceInformation.Id 的裝置識別碼
DeviceInformation	取得藍牙裝置的 DeviceInformation 物件。
HostName	取得裝置的 HostName。
Name	取得裝置的名稱。
RfcommServices	取得裝置所支援之 RFCOMM 服務的唯讀清單。 重要 RfcommServices API 已被取代，未來版本的 Windows 可能無法使用。 請改用 GetRfcommServicesAsync。
SdpRecords	取得裝置的服務探索通訊協定 (SDP) 記錄的唯讀清單。
WasSecureConnectionUsedForPairing	取得布林值，指出藍牙Device 是否使用安全連線配對。

方法

Close()	關閉藍牙裝置。
Dispose()	執行與釋放 (Free)、釋放 (Release) 或重設 Unmanaged 資源相關聯之應用程式定義的工作。
FromBluetoothAddressAsync(UInt64)	會傳回指定藍牙Address的BluetoothDevice物件。
FromHostNameAsync(HostName)	傳回指定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) 篩選字串，其中包含具有指定 藍牙ConnectionStatus 的藍牙裝置查詢。 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 聊天範例