QLowEnergyAdvertisingParameters Class
QLowEnergyAdvertisingParameters 类表示用于蓝牙低功耗广播的参数。更多内容...
| 头文件： | #include <QLowEnergyAdvertisingParameters> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Bluetooth) target_link_libraries(mytarget PRIVATE Qt6::Bluetooth) |
| qmake： | QT += bluetooth |
- 所有成员的列表，包括继承的成员
- QLowEnergyAdvertisingParameters 属于“隐式共享类”。
公共类型
| class | AddressInfo |
| enum | FilterPolicy { IgnoreWhiteList, UseWhiteListForScanning, UseWhiteListForConnecting, UseWhiteListForScanningAndConnecting } |
| enum | Mode { AdvInd, AdvScanInd, AdvNonConnInd } |
公共函数
| QLowEnergyAdvertisingParameters() | |
| QLowEnergyAdvertisingParameters(const QLowEnergyAdvertisingParameters &other) | |
| ~QLowEnergyAdvertisingParameters() | |
| QLowEnergyAdvertisingParameters::FilterPolicy | filterPolicy() const |
| int | maximumInterval() const |
| int | minimumInterval() const |
| QLowEnergyAdvertisingParameters::Mode | mode() const |
| void | setInterval(quint16 minimum, quint16 maximum) |
| void | setMode(QLowEnergyAdvertisingParameters::Mode mode) |
| void | setWhiteList(const QList<QLowEnergyAdvertisingParameters::AddressInfo> &whiteList, QLowEnergyAdvertisingParameters::FilterPolicy policy) |
| void | swap(QLowEnergyAdvertisingParameters &other) |
| QList<QLowEnergyAdvertisingParameters::AddressInfo> | whiteList() const |
| QLowEnergyAdvertisingParameters & | operator=(const QLowEnergyAdvertisingParameters &other) |
相关的非成员
| bool | operator!=(const QLowEnergyAdvertisingParameters &a, const QLowEnergyAdvertisingParameters &b) |
| bool | operator==(const QLowEnergyAdvertisingParameters &a, const QLowEnergyAdvertisingParameters &b) |
详细说明
在运行广播程序时，可以配置一些参数，例如广播速度，或者哪些客户端（如有）可以连接到广播设备。这些参数通过此类进行设置，当通过调用QLowEnergyController::startAdvertising()启动广播时，将使用这些参数的值。
另请参阅 QLowEnergyAdvertisingData 和QLowEnergyController::startAdvertising()。
成员类型文档
enum QLowEnergyAdvertisingParameters::FilterPolicy
指定白名单的语义。
| 常量 | 值 | 描述 |
|---|---|---|
QLowEnergyAdvertisingParameters::IgnoreWhiteList | 0x00 | 白名单的值将被忽略，也就是说，在使用无定向广播时，无论是扫描请求还是连接请求，都不会进行过滤。 |
QLowEnergyAdvertisingParameters::UseWhiteListForScanning | 0x01 | 处理扫描请求时使用白名单，但处理连接请求时则忽略白名单。 |
QLowEnergyAdvertisingParameters::UseWhiteListForConnecting | 0x02 | 处理连接请求时会使用白名单，但处理扫描请求时会忽略白名单。 |
QLowEnergyAdvertisingParameters::UseWhiteListForScanningAndConnecting | 0x03 | 白名单同时用于连接请求和扫描请求。 |
另请参阅 QLowEnergyAdvertisingParameters::whiteList()。
enum QLowEnergyAdvertisingParameters::Mode
指定广告投放的方式。
| 常量 | 值 | 描述 |
|---|---|---|
QLowEnergyAdvertisingParameters::AdvInd | 0x0 | 用于非定向、可连接的广播。广播并非针对特定设备，看到该广播的设备可以连接到广播设备或发送扫描请求。 |
QLowEnergyAdvertisingParameters::AdvScanInd | 0x2 | 用于非定向、可扫描的广播。广播不针对特定设备，接收到广播的设备可以向广播设备发送扫描请求，但无法与其建立连接。 |
QLowEnergyAdvertisingParameters::AdvNonConnInd | 0x3 | 适用于非定向、不可连接的广告。广告并非针对特定设备发送。看到该广告的设备既无法连接到广告设备，也无法向其发送扫描请求。因此，此模式属于纯粹的广播模式。 |
成员函数文档
QLowEnergyAdvertisingParameters::QLowEnergyAdvertisingParameters()
创建该类的一个新对象。所有值均根据蓝牙低功耗（Bluetooth Low Energy）规范初始化为默认值。
QLowEnergyAdvertisingParameters::QLowEnergyAdvertisingParameters(const QLowEnergyAdvertisingParameters &other)
创建该类的一个新对象，该对象是other 的副本。
[noexcept] QLowEnergyAdvertisingParameters::~QLowEnergyAdvertisingParameters()
销毁此对象。
QLowEnergyAdvertisingParameters::FilterPolicy QLowEnergyAdvertisingParameters::filterPolicy() const
返回用于确定白名单使用方式的过滤策略。默认值为QLowEnergyAdvertisingParameters::IgnoreWhiteList 。
int QLowEnergyAdvertisingParameters::maximumInterval() const
返回最大广告间隔（单位为毫秒）。默认值为 1280。
int QLowEnergyAdvertisingParameters::minimumInterval() const
返回广告间隔的最小值（以毫秒为单位）。默认值为 1280。
QLowEnergyAdvertisingParameters::Mode QLowEnergyAdvertisingParameters::mode() const
返回广告模式。默认值为QLowEnergyAdvertisingParameters::AdvInd 。
另请参阅 setMode()。
void QLowEnergyAdvertisingParameters::setInterval(quint16 minimum, quint16 maximum)
设置广播间隔。该范围为控制器提供了发送广播数据的频率上下限。minimum 和maximum 均以毫秒为单位。如果maximum 小于minimum ，则将设置为minimum 的值。
注意： 间隔的最小值和最大值存在 限制；具体数值取决于模式。如果超出范围，将分别采用可能的最低值或最高值。
在 BlueZ 的后续版本中，如果其实验性状态发生变化（或在实验模式下运行），BlueZ DBus 后端将支持设置广播间隔。
void QLowEnergyAdvertisingParameters::setMode(QLowEnergyAdvertisingParameters::Mode mode)
将广告模式设置为mode 。
另请参阅 mode()。
void QLowEnergyAdvertisingParameters::setWhiteList(const QList<QLowEnergyAdvertisingParameters::AddressInfo> &whiteList, QLowEnergyAdvertisingParameters::FilterPolicy policy)
设置可能用于过滤扫描和连接请求的白名单。whiteList 参数是用于过滤的地址列表，而policy 则指定了具体如何使用whiteList 。
BlueZ DBus 后端不支持白名单，因为 BlueZ 本身不支持白名单。
另请参阅 whiteList()。
[noexcept] void QLowEnergyAdvertisingParameters::swap(QLowEnergyAdvertisingParameters &other)
将此对象与other 互换。
QList<QLowEnergyAdvertisingParameters::AddressInfo> QLowEnergyAdvertisingParameters::whiteList() const
返回用于过滤扫描和连接请求的白名单。默认情况下，该列表为空。
另请参阅 setWhiteList()。
QLowEnergyAdvertisingParameters &QLowEnergyAdvertisingParameters::operator=(const QLowEnergyAdvertisingParameters &other)
将该对象复制为other 的副本，并返回该对象的新值。
相关的非成员
bool operator!=(const QLowEnergyAdvertisingParameters &a, const QLowEnergyAdvertisingParameters &b)
如果 `a ` 和 `b ` 的公共状态不相同，则返回 `true `；否则返回 `false`。
bool operator==(const QLowEnergyAdvertisingParameters &a, const QLowEnergyAdvertisingParameters &b)
如果a 和b 的公共状态相等，则返回true ；否则返回false 。
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
