class QLowEnergyConnectionParameters#

QLowEnergyConnectionParameters 类用于在请求或报告更新蓝牙 LE 连接参数时使用。更多…

摘要#

方法#

备注

此文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的捐助。如果您发现翻译中的问题，也可以通过在https:/bugreports.qt.io/projects/PYSIDE创建工单来告知我们

详细描述#

连接参数会影响主从设备之间同步的频率。一般来说，较短的连接间隔和延迟意味着更快的通信，但也会增加功耗。如何权衡这些标准取决于具体的使用案例。

Android仅允许间接调整此参数集。该平台将连接参数分为三类（高优先级、低优先级和平衡优先级）。每个类别都包含 minimumInterval() 、 maximumInterval() 和 latency() 的预定义值集合。此外，每个类别的值范围可以从一台Android设备变化到另一台。Qt使用 minimumInterval() 来确定目标类别，如下所示

minimumInterval()

Android优先级

间隔 < 30

CONNECTION_PRIORITY_HIGH

30 <= 间隔 <= 100

CONNECTION_PRIORITY_BALANCED

间隔 > 100

CONNECTION_PRIORITY_LOW_POWER

在Android上无法更改 supervisionTimeout() ，因此忽略该值。

__init__()#

创建此类的新对象。所有值都初始化为有效默认值。

__init__(other)
参数：

other – QLowEnergyConnectionParameters

创建此类的新对象，它是 other 的副本。

latency()#
返回类型：

int

返回连接的从属延迟。

另请参阅

setLatency()

maximumInterval()#
返回类型：

float

返回以毫秒为单位的最大连接间隔。默认值为 4000。

备注

如果此对象是通过 connectionUpdated() 触发的，则此值与 minimumInterval() 相同，并指实际连接间隔。

另请参阅

setIntervalRange()

minimumInterval()#
返回类型：

float

返回以毫秒为单位的最低连接间隔。默认值为 7.5。

备注

如果此对象是通过 connectionUpdated() 触发的，则此值与 maximumInterval() 相同，并指实际连接间隔。

另请参阅

setIntervalRange()

__ne__(b)#
参数：

b – QLowEnergyConnectionParameters

返回类型：

bool

如果 p1 和 p2 在其公共状态方面不相等，则返回 true，否则返回 false。

__eq__(b)#
参数：

b – QLowEnergyConnectionParameters

返回类型：

bool

当 p1 和 p2 的公共状态相等时，返回 true，否则返回 false。

setIntervalRange(minimum, maximum)#
参数：

  • minimum – float

  • maximum – float

设置连接间隔应所在的范围。实际值将由控制器决定。minimum 和 maximum 均以毫秒为单位给出。如果 maximum 小于 minimum，则将其设置为 minimum 的值。可能的最小连接间隔是 7.5 毫秒，最大的是 4000 毫秒。

setLatency(latency)#
参数：

latency – int

将连接的从机延迟（即从机设备被允许忽略的连接事件数）设置为 latency。最小值为 0，最大值为 499。

另请参阅

latency()

setSupervisionTimeout(timeout)#
参数：

timeout – int

将链路监督超时设置为 timeout 毫秒。该值有一些约束：必须在 [100,32000] 范围内，并且必须大于 (1 + latency() ) * 2 * maximumInterval() .

在 Android 上，此超时不可调整，因此被忽略。

另请参阅

supervisionTimeout()

supervisionTimeout()#
返回类型：

int

以毫秒为单位返回连接的链路监督超时。

swap(other)#
参数：

other – QLowEnergyConnectionParameters

与 其他对象 交换此对象。