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


BluetoothDevice Класс

Определение

Представляет устройство 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
Атрибуты
Реализации

Требования к 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 для устройства.

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

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