PySide6.QtBluetooth#

详细描述#

Qt Bluetooth 允许启用蓝牙的设备之间进行连接。

蓝牙API为启用蓝牙的设备之间提供连接性。

目前，API支持以下平台

API功能

Android

iOS

Linux (BlueZ 5.x)

macOS

Qt for Windows

经典蓝牙

x

x

x

x

蓝牙LE中心

x

x

x

x

x

蓝牙LE外围

x

x

x

x

蓝牙LE广告和扫描

Qt 5.14增加了一个原生的Win32端口，支持Windows 7或更新的系统上的经典蓝牙，以及Windows 8或更新的系统上的蓝牙LE。它必须通过配置选项-native-win32-bluetooth在构建时启用。如果没有设置此选项并且Win32目标平台支持所需的UWP API（最低需求为Windows 10版本1507，自Windows 10版本1607以来略有改进的服务发现），则默认使用UWP后端。

概述#

蓝牙是一种短距离无线技术（小于100米）。它具有相对较高的数据传输率，为2.1 Mbit/s，使其非常适合用于设备之间的数据传输。蓝牙连接基于基本设备管理，如搜索设备、收集有关它们的信息以及在它们之间交换数据。

Qt蓝牙支持用于客户端/中心角色的蓝牙低功耗（BLE）开发。更详细的信息可以在蓝牙低功耗概述部分找到。

使用模块#

要包含模块类的定义，请使用以下指令

import PySide6.QtBluetooth

macOS 专用#

macOS上的蓝牙API需要一种特定类型的事件分派器，它在Qt中会导致对QGuiApplication的依赖。然而，您可以设置环境变量 QT_EVENT_DISPATCHER_CORE_FOUNDATION=1 来绕过这个问题。

不使用经典蓝牙的应用会发现QtBluetooth的一个子集可用，因为CoreBluetooth（蓝牙LE）不需要QApplication 或 QGuiApplication。

指南#

日志类别#

QtBluetooth模块导出以下日志类别

日志类别

说明

qt.bluetooth

启用QtBluetooth中的跨平台代码路径日志

qt.bluetooth.android

启用Android实现日志

qt.bluetooth.bluez

启用BLuez/Linux实现日志

qt.bluetooth.ios

启用iOS实现日志

qt.bluetooth.osx

启用macOS实现日志

qt.bluetooth.windows

启用Qt for Windows实现日志

日志类别可用于为QtBluetooth启用额外的警告和调试输出。更详细的日志信息可以在QLoggingCategory中找到。快速启用所有QtBluetooth日志的方法是在main()函数中添加以下行

QLoggingCategory.setFilterRules("qt.bluetooth* = true")

类列表#

A

B

L

S