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.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 |
Возвращает объект 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 |
Происходит при изменении имени устройства. |