BluetoothDevice Класс

Определение

Пространство имен:

Windows.Devices.Bluetooth

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

Примеры приложений, использующих этот класс, включают пример перечисления устройств и связывания и пример чата 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	Возвращает идентификатор устройства Bluetooth.
ClassOfDevice	Возвращает сведения о классе Устройства Bluetooth устройства.
ConnectionStatus	Возвращает состояние подключения устройства.
DeviceAccessInformation	Текущий объект DeviceAccessInformation для устройства. Используется для проверка и отслеживания изменений доступа к устройству.
DeviceId	Возвращает идентификатор устройства, полученный из Windows.Devices.Enumeration.DeviceInformation.Id
DeviceInformation	Возвращает объект DeviceInformation для устройства Bluetooth.
HostName	Возвращает имя узла устройства.
Name	Возвращает имя устройства.
RfcommServices	Возвращает доступный только для чтения список служб RFCOMM, поддерживаемых устройством. Важно! API RfcommServices не рекомендуется использовать и может быть недоступен в будущих версиях Windows. Вместо этого используйте GetRfcommServicesAsync.
SdpRecords	Возвращает доступный только для чтения список записей протокола обнаружения служб (SDP) для устройства.
WasSecureConnectionUsedForPairing	Возвращает логическое значение, указывающее, был ли bluetoothDevice связан с использованием безопасного подключения.

Методы

Close()	Закрывает устройство Bluetooth.
Dispose()	Выполняет определяемые приложением задачи, связанные с удалением, высвобождением или сбросом неуправляемых ресурсов.
FromBluetoothAddressAsync(UInt64)	Возвращает объект BluetoothDevice для заданного Объекта BluetoothAddress.
FromHostNameAsync(HostName)	Возвращает объект BluetoothDevice, идентифицируемый заданным именем узла.
FromIdAsync(String)	Возвращает объект BluetoothDevice, идентифицируемый заданным Идентификатором устройства.
GetDeviceSelector()	Возвращает строку расширенного синтаксиса запросов (AQS) для идентификации экземпляров этого устройства. Эта строка передается в метод FindAllAsync или CreateWatcher.
GetDeviceSelectorFromBluetoothAddress(UInt64)	Создает строку фильтра расширенного синтаксиса запросов (AQS) из 64-разрядного адреса, представляющего устройство Bluetooth. Строка AQS передается в метод CreateWatcher для возврата коллекции объектов DeviceInformation .
GetDeviceSelectorFromClassOfDevice(BluetoothClassOfDevice)	Создает строку фильтра расширенного синтаксиса запросов (AQS) из объекта BluetoothClassOfDevice . Строка AQS передается в метод CreateWatcher для возврата коллекции объектов DeviceInformation .
GetDeviceSelectorFromConnectionStatus(BluetoothConnectionStatus)	Создает строку фильтра расширенного синтаксиса запросов (AQS), содержащую запрос для устройств Bluetooth с указанным bluetoothConnectionStatus. Строка AQS передается в метод CreateWatcher для возврата коллекции объектов DeviceInformation с указанным состоянием подключения Bluetooth.
GetDeviceSelectorFromDeviceName(String)	Создает строку фильтра расширенного синтаксиса запросов (AQS), содержащую запрос на имя устройства Bluetooth. Строка AQS передается в метод CreateWatcher для возврата коллекции объектов DeviceInformation , содержащих указанное имя устройства Bluetooth.
GetDeviceSelectorFromPairingState(Boolean)	Создает строку фильтра расширенного синтаксиса запросов (AQS), содержащую запрос для устройств Bluetooth, которые являются сопряженными или несвязанными. Строка AQS передается в метод CreateWatcher для возврата коллекции объектов DeviceInformation .
GetRfcommServicesAsync()	Извлекает все службы Rfcomm на удаленном устройстве Bluetooth.
GetRfcommServicesAsync(BluetoothCacheMode)	Извлекает все кэшированные службы Rfcomm на удаленном устройстве Bluetooth.
GetRfcommServicesForIdAsync(RfcommServiceId)	Извлекает все службы Rfcomm на удаленном устройстве Bluetooth, соответствующие указанному rfcommServiceId.
GetRfcommServicesForIdAsync(RfcommServiceId, BluetoothCacheMode)	Извлекает все кэшированные службы Rfcomm на удаленном устройстве Bluetooth, соответствующие указанному идентификатору RfcommServiceId.
RequestAccessAsync()	Используется для запроса явного доступа к устройству Bluetooth. Это вызывает согласие устройства и должно вызываться в потоке пользовательского интерфейса.

События

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

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

• Пример перечисления и связывания устройств
• Пример чата Bluetooth RFCOMM