QLowEnergyConnectionParameters 类
QLowEnergyConnectionParameters 类用于请求或报告蓝牙 LE 连接参数的更新。 更多...
| 头文件 | #include <QLowEnergyConnectionParameters> |
| qmake | QT += bluetooth |
- 成员列表，包括继承的成员
- QLowEnergyConnectionParameters 是 隐式共享类 的一部分。
公共函数
| QLowEnergyConnectionParameters() | |
| QLowEnergyConnectionParameters(const QLowEnergyConnectionParameters &other) | |
| ~QLowEnergyConnectionParameters() | |
| int | latency() const |
| double | maximumInterval() const |
| double | minimumInterval() const |
| void | setIntervalRange(double minimum, double maximum) |
| void | setLatency(int latency) |
| void | setSupervisionTimeout(int timeout) |
| int | supervisionTimeout() const |
| void | swap(QLowEnergyConnectionParameters &other) |
| QLowEnergyConnectionParameters & | operator=(const QLowEnergyConnectionParameters &other) |
相关非成员
| bool | operator!=(const QLowEnergyConnectionParameters &p1, const QLowEnergyConnectionParameters &p2) |
| bool | operator==(const QLowEnergyConnectionParameters &p1, const QLowEnergyConnectionParameters &p2) |
详细描述
连接参数会影响主从设备之间同步的频率。一般来说，较短的连接间隔和延迟意味着更快的通信，但也意味着更高的功耗。如何权衡这些标准取决于具体的用例。
Android 只允许间接调整此参数集。该平台将连接参数分为三类（高、低 & 平衡优先级）。每一类别都对应着预定义的 minimumInterval()、maximumInterval() 和 latency() 值集合。此外，每个类别中的值范围可能因 Android 设备而异。Qt 使用 minimumInterval() 确定目标类别，如下所示
| minimumInterval() | Android 优先级 |
|---|---|
| interval < 30 | CONNECTION_PRIORITY_HIGH |
| 30 <= interval <= 100 | CONNECTION_PRIORITY_BALANCED |
| interval > 100 | CONNECTION_PRIORITY_LOW_POWER |
在Android上无法更改supervisionTimeout()，因此将其忽略。
另请参阅QLowEnergyController::requestConnectionUpdate和QLowEnergyController::connectionUpdated。
成员函数文档
QLowEnergyConnectionParameters::QLowEnergyConnectionParameters()
构建此类的新对象。所有值都初始化为有效默认值。
QLowEnergyConnectionParameters::QLowEnergyConnectionParameters(const QLowEnergyConnectionParameters &other)
构建一个新对象，该对象为此类的副本。
[noexcept] QLowEnergyConnectionParameters::~QLowEnergyConnectionParameters()
销毁此对象。
int QLowEnergyConnectionParameters::latency() const
返回连接的从机延迟。
另请参阅setLatency。
double QLowEnergyConnectionParameters::maximumInterval() const
返回以毫秒为单位的最大连接间隔。默认值是4000。
注意：如果此对象通过QLowEnergyController::connectionUpdated发出，则此值与minimumInterval()相同，并指实际连接间隔。
另请参阅setIntervalRange。
double QLowEnergyConnectionParameters::minimumInterval() const
返回以毫秒为单位的最低连接间隔。默认值是7.5。
注意：如果此对象通过QLowEnergyController::connectionUpdated发出，则此值与maximumInterval()相同，并指实际连接间隔。
另请参阅setIntervalRange。
void QLowEnergyConnectionParameters::setIntervalRange(double minimum, double maximum)
设置连接间隔应在其范围内的值。实际值将由控制器决定。其中minimum和maximum均以毫秒为单位。如果maximum小于minimum，则将其设置为minimum的值。可能的最小连接间隔是7.5毫秒，最大的是4000毫秒。
另请参阅minimumInterval和maximumInterval。
void QLowEnergyConnectionParameters::setLatency(int latency)
将连接从机的延迟（即从机设备允许忽略的连接事件数）设置为latency。最小值为0，最大值为499。
另请参阅latency。
void QLowEnergyConnectionParameters::setSupervisionTimeout(int timeout)
将连接监督超时设置为timeout毫秒。对此值有一些限制：它必须在[100，32000]范围内，并且必须大于(1 + latency()) * 2 * maximumInterval。
在Android上，此超时不可调整，因此被忽略。
另见supervisionTimeout()。
int QLowEnergyConnectionParameters::supervisionTimeout() const
返回连接的超时链接（毫秒）。
[noexcept] void QLowEnergyConnectionParameters::swap(QLowEnergyConnectionParameters &other)
与此对象交换other。
QLowEnergyConnectionParameters &QLowEnergyConnectionParameters::operator=(const QLowEnergyConnectionParameters &other)
将此对象复制为other，并返回此对象的新值。
相关非成员
bool operator!=(const QLowEnergyConnectionParameters &p1, const QLowEnergyConnectionParameters &p2)
如果p1和p2在公共状态方面不相等，则返回true，否则返回false。
bool operator==(const QLowEnergyConnectionParameters &p1, const QLowEnergyConnectionParameters &p2)
如果p1和p2在公共状态方面相等，则返回true，否则返回false。
© 2024 Qt公司有限公司。本文件中包含的文档贡献的版权为其各自所有者的版权。本文件提供的文档根据自由软件基金会的版本1.3 GNU自由文档许可协议进行许可。Qt及其相关标志是芬兰Qt公司及其在世界其它国家的商标。所有其他商标均为其各自所有者的财产。
