藍牙 API 提供藍牙使能設備之間的連接。
目前，API 支持下列平颱：
| API 特徵 | Android | iOS | Linux (BlueZ 4.x/5.x) | macOS | WinRT | Windows |
|---|---|---|---|---|---|---|
| 經典藍牙 | x | x | x | x | ||
| 藍牙 LE 中心 | x | x | x | x | x | |
| 藍牙 LE 外圍 | x | x | x | x | ||
| 藍牙 LE 廣告和掃描 |
Bluetooth is a short-range (less than 100 meters) wireless technology. It has a reasonably high data transfer rate of 2.1 Mbit/s, which makes it ideal for transferring data between devices. Bluetooth connectivity is based on basic device management, such as scanning for devices, gathering information about them, and exchanging data between them.
Qt Bluetooth supports Bluetooth Low Energy development for client/central role use cases. Further details can be found in the 低功耗藍牙概述 章節。
A new addition since the Qt Bluetooth 5.7 release covers support for Bluetooth Low Energy applications performing the peripheral/server role. This new API remains in Technology Preview.
要使用 C++ 庫在應用程序，添加以下配置選項到
.pro
文件：
QT += bluetooth
要在應用程序中使用模塊的類，需要以下 import 語句在
.qml
文件：
import QtBluetooth 5.2
Despite the fact that the module can be built for all Qt platforms, the module is not ported to all of them. Not supported platforms such as Windows desktop employ a fake or dummy backend which is automatically selected when the platform is not supported. The dummy backend reports appropriate error messages and values which allow the Qt Bluetooth developer to detect at runtime that the current platform is not supported. The dummy backend is also selected on Linux if BlueZ development headers are not found during build time or Qt was built without Qt D-Bus support.
The usage of the dummy backend is highlighted via an appropriate warning while building and running.
The QtBluetooth 模塊導齣下列 日誌類彆 :
| 日誌類彆 | 描述 |
|---|---|
| qt.bluetooth | Enables logging of cross platform code path in QtBluetooth |
| qt.bluetooth.android | Enables logging of the Android 實現 |
| qt.bluetooth.bluez | Enables logging of the BLuez /Linux implementation |
| qt.bluetooth.ios | Enables logging of the iOS 實現 |
| qt.bluetooth.osx | Enables logging of the macOS 實現 |
| qt.bluetooth.qml | Enables logging of the QtBluetooth QML implementation |
| qt.bluetooth.winrt | Enables logging of the WinRT 實現 |
日誌類彆可用於啓用額外警告和調試輸齣為
QtBluetooth
。可以找到有關日誌的更多詳細信息在
QLoggingCategory
. A quick way to enable all
QtBluetooth
logging is to add the following line to the
main()
函數：
QLoggingCategory::setFilterRules(QStringLiteral("qt.bluetooth* = true"));
Qt Bluetooth 在商業許可下是可用的來自 Qt 公司 。此外，它是可用的根據 GNU LGPL (次一般公共許可) 第 3 版 ，或 GNU GPL (一般公共許可) 第 2 版 。見 Qt 許可 進一步瞭解細節。
在 Linux，Qt Bluetooth 使用單獨可執行文件
sdpscanner
, to integrate with the official Linux bluetooth protocol stack
BlueZ
.
BlueZ
is available under the
GNU GPL (一般公共許可) 第 2 版
.
| BlueZ | GNU General Public License v2.0 only (This does not force user code to be GPL'ed. For more info see details.) |
