Поделиться через


BluetoothLEDevice Класс

Определение

Представляет устройство Bluetooth LE.

Примеры кода см. в разделах Пример Bluetooth Low Energy и Примерперечисления и связывания устройств.

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
Атрибуты
Реализации

Требования к 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

Возвращает объект BluetoothLEAppearance для устройства Bluetooth LE.

BluetoothAddress

Возвращает адрес устройства.

BluetoothAddressType

Возвращает тип адреса для устройства Bluetooth LE.

BluetoothDeviceId

Возвращает идентификатор устройства Bluetooth.

ConnectionStatus

Возвращает состояние подключения устройства.

DeviceAccessInformation

Возвращает DeviceAccessInformation.

DeviceId

Возвращает идентификатор устройства.

DeviceInformation

Возвращает сведения об устройстве для устройства Bluetooth LE.

GattServices

Возвращает доступный только для чтения список служб GATT, поддерживаемых устройством.

Важно!

API GattServices не рекомендуется использовать и может быть недоступен в будущих версиях Windows. Вместо этого используйте GetGattServicesAsync.

Name

Возвращает имя устройства Bluetooth LE.

WasSecureConnectionUsedForPairing

Возвращает логическое значение, указывающее, был ли bluetoothLEDevice связан с использованием безопасного подключения.

Методы

Close()

Закрывает это устройство Bluetooth LE. Это может закрыть подключение к устройству, если это единственное приложение с подключением.

Dispose()

Выполняет определяемые приложением задачи, связанные с удалением, высвобождением или сбросом неуправляемых ресурсов.

FromBluetoothAddressAsync(UInt64)

Возвращает объект BluetoothLEDevice, представляющий одноранговое устройство Bluetooth LE с заданным адресом. См . примечания (в этом разделе).

FromBluetoothAddressAsync(UInt64, BluetoothAddressType)

Возвращает объект BluetoothLEDevice, представляющий одноранговое устройство с заданным адресом и типом адреса. См . примечания (в этом разделе).

FromIdAsync(String)

Возвращает объект BluetoothLEDevice для заданного идентификатора. См . примечания в разделе участника.

GetConnectionParameters()

Извлекает параметры подключения для удаленного устройства. Если несколько приложений или других системных сценариев также запрашивают эти параметры, система автоматически объединяет параметры, если они совместимы, на основе приоритета системы.

Примечание

Если устройство не подключено, параметры подключения недопустимы (все ноль).

GetConnectionPhy()

Извлекает сведения о физическом уровне Bluetooth LE (PHY).

Примечание

Если устройство не подключено, phYs подключения являются недопустимыми (все false)

GetDeviceSelector()

Возвращает строку расширенного синтаксиса запросов (AQS) для идентификации всех устройств Bluetooth с низким энергопотреблением (LE). Эта строка передается в метод FindAllAsync или CreateWatcher , чтобы получить список устройств Bluetooth LE.

GetDeviceSelectorFromAppearance(BluetoothLEAppearance)

Создает строку фильтра расширенного синтаксиса запросов (AQS) из объекта BluetoothLEAppearance . Строка AQS передается в метод CreateWatcher для возврата коллекции объектов DeviceInformation с указанным внешним видом.

GetDeviceSelectorFromBluetoothAddress(UInt64)

Создает строку фильтра расширенного синтаксиса запросов (AQS) из 64-разрядного адреса, представляющего устройство Bluetooth LE. Строка AQS передается в метод CreateWatcher для возврата коллекции объектов DeviceInformation .

GetDeviceSelectorFromBluetoothAddress(UInt64, BluetoothAddressType)

Создает строку фильтра расширенного синтаксиса запросов (AQS) из 64-разрядного адреса и типа адреса, представляющего устройство Bluetooth LE. Строка AQS передается в метод CreateWatcher .

GetDeviceSelectorFromConnectionStatus(BluetoothConnectionStatus)

Создает строку фильтра расширенного синтаксиса запросов (AQS), содержащую запрос для устройств Bluetooth LE с указанным BluetoothConnectionStatus. Строка AQS передается в метод CreateWatcher для возврата коллекции объектов DeviceInformation с указанным состоянием подключения Bluetooth.

GetDeviceSelectorFromDeviceName(String)

Создает строку фильтра расширенного синтаксиса запросов (AQS), содержащую запрос на имя устройства Bluetooth LE. Строка AQS передается в метод CreateWatcher для возврата коллекции объектов DeviceInformation , содержащих указанное имя устройства Bluetooth LE.

GetDeviceSelectorFromPairingState(Boolean)

Создает строку фильтра расширенного синтаксиса запросов (AQS), содержащую запрос для устройств Bluetooth LE, которые являются сопряженными или несвязанными. Строка AQS передается в метод CreateWatcher для возврата коллекции объектов DeviceInformation .

GetGattService(Guid)

Возвращает службу GATT с заданным идентификатором службы.

Важно!

API GetGattService не рекомендуется использовать и может быть недоступен в будущих версиях Windows. Вместо этого используйте GetGattServicesAsync.

GetGattServicesAsync()

Возвращает GattDeviceServices для этого устройства Bluetooth LowХит.

GetGattServicesAsync(BluetoothCacheMode)

Возвращает GattDeviceServices для этого устройства Bluetooth LowSphere с указанным режимом кэша.

GetGattServicesForUuidAsync(Guid)

Возвращает GattDeviceServices для устройства Bluetooth LowХит с указанным UUID.

GetGattServicesForUuidAsync(Guid, BluetoothCacheMode)

Возвращает GattDeviceServices для устройства Bluetooth LowХит с указанным UUID.

RequestAccessAsync()

Запрашивает доступ к устройству Bluetooth Low Энергия.

RequestPreferredConnectionParameters(BluetoothLEPreferredConnectionParameters)

Извлекает объект запроса предпочтительных параметров подключения Bluetooth LE для указанного объекта предпочтительных параметров подключения Bluetooth LE.

События

ConnectionParametersChanged

Событие, возникающее при изменении текущих параметров подключения для устройства. Параметры обновляются только после установки подключения к устройству.

ConnectionPhyChanged

Событие, которое возникает при изменении текущего PHY для устройства. PHY обновляется только после установки подключения к устройству.

ConnectionStatusChanged

Происходит при изменении состояния подключения для устройства.

GattServicesChanged

Возникает при изменении списка служб GATT, поддерживаемых устройством.

NameChanged

Происходит при изменении имени устройства.

Применяется к

См. также раздел