QLowEnergyAdvertisingParameters Class
QLowEnergyAdvertisingParameters 类表示用于蓝牙低功耗广告的参数。更多
| Header: | #include <QLowEnergyAdvertisingParameters> |
| 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()
构建该类的新对象。所有值均根据蓝牙低功耗规范初始化为默认值。
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 DBus 后端在以后的 BlueZ 版本中更改了实验状态（或以实验模式运行），则支持设置广告间隔。
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 。
© 2025 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.
