QLowEnergyAdvertisingParameters 类
QLowEnergyAdvertisingParameters 类表示用于蓝牙低功耗广告的参数。更多...
| 头文件 | #include <QLowEnergyAdvertisingParameters> |
| qmake | QT += bluetooth |
- 成员列表，包括继承的成员
- QLowEnergyAdvertisingParameters 是 隐式共享类 的部分。
公共类型
| 类 | AddressInfo |
| 枚举 | FilterPolicy { IgnoreWhiteList, UseWhiteListForScanning, UseWhiteListForConnecting, UseWhiteListForScanningAndConnecting } |
| 枚举 | 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().
枚举 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)
设置广告间隔。这是一个范围，为控制器提供发送广告数据的上限和下限。最小值和最大值都给定以毫秒为单位。如果最大值小于最小值，则将最大值设置为最小值的值。
注意：最小值和最大 interval 具有限制；确切数值取决于模式。如果超过了这些值，将分别使用可能的最小值或最大值。
在 BlueZ DBus 后端中支持设置广告间隔，如果其后端在 BlueZ 的后期版本中改变了实验状态（或以实验模式运行）。
void QLowEnergyAdvertisingParameters::setMode(QLowEnergyAdvertisingParameters::Mode mode)
设置广告模式为 mode。
另请参阅mode。
void QLowEnergyAdvertisingParameters::setWhiteList(const QList<QLowEnergyAdvertisingParameters::AddressInfo> &whiteList, QLowEnergyAdvertisingParameters::FilterPolicy policy)
设置可能用于过滤扫描和连接请求的 Whitelist。参数 whiteList 是用于过滤的地址列表，policy 指定如何确切使用 whiteList。
BlueZ DBus 后端不支持 Whitelist，因为 BlueZ 不支持它们。
另请参阅whiteList。
[noexcept] void QLowEnergyAdvertisingParameters::swap(QLowEnergyAdvertisingParameters &other)
将此对象与 other 交换。
QList<QLowEnergyAdvertisingParameters::AddressInfo> QLowEnergyAdvertisingParameters::whiteList() const
返回用于过滤扫描和连接请求的 Whitelist。默认情况下，该列表为空。
另请参阅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。
© 2024 Qt公司有限公司。此处包含的文档贡献的版权归各自所有者所有。此处提供的文档是根据自由软件基金会发布的GNU自由文档许可版本1.3的条款许可的。Qt及其相关标志是芬兰的Qt公司及其在全球的子公司和分支机构的世界性商标。所有其他商标均属各自所有者所有。
