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	取得藍牙裝置識別碼。
ConnectionStatus	取得裝置的線上狀態。
DeviceAccessInformation	取得 DeviceAccessInformation。
DeviceId	取得裝置識別碼。
DeviceInformation	取得藍牙 LE 裝置的裝置資訊。
GattServices	取得裝置所支援之 GATT 服務的唯讀清單。 重要 GattServices API 已被取代，未來版本的 Windows 可能無法使用。 請改用 GetGattServicesAsync。
Name	取得藍牙 LE 裝置的名稱。
WasSecureConnectionUsedForPairing	取得布林值，指出藍牙LEDevice 是否已使用安全連線配對。

方法

Close()	關閉此藍牙 LE 裝置。 如果這是唯一具有連線的應用程式，這可能會關閉裝置的連線。
Dispose()	執行與釋放 (Free)、釋放 (Release) 或重設 Unmanaged 資源相關聯之應用程式定義的工作。
FromBluetoothAddressAsync(UInt64)	會傳回 BluetoothLEDevice 物件，代表具有指定位址的對等藍牙 LE 裝置。 See Remarks (in this member topic).
FromBluetoothAddressAsync(UInt64, BluetoothAddressType)	會傳回 BluetoothLEDevice 物件，代表具有指定位址和網址類別型的對等裝置。 See Remarks (in this member topic).
FromIdAsync(String)	會傳回指定識別碼的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)	傳回具有指定服務識別碼的 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
• 藍牙低成本範例
• 裝置列舉和配對範例