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.IDisposablePublic NotInheritable Class BluetoothDevice
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 | 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 для устройства. |