BluetoothLEDevice 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
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- 繼承
- 屬性
- 實作
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 |
發生于裝置的名稱變更時。 |