PySide6.QtBluetooth.QLowEnergyConnectionParameters

class QLowEnergyConnectionParameters

QLowEnergyConnectionParameters 类用于请求或报告蓝牙低功耗连接参数的更新。更多

概要

方法

注意

本文档可能包含从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

supervisionTimeout() 在 Android 上无法更改,因此被忽略。

__init__()

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

__init__(other)
Parameters:

其他QLowEnergyConnectionParameters

构造此类的新对象,该对象是other的副本。

latency()
Return type:

整数

返回连接的从属延迟。

另请参阅

setLatency()

maximumInterval()
Return type:

浮点数

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

注意

如果此对象是通过connectionUpdated()发出的,那么此值与minimumInterval()相同,并指实际连接间隔。

另请参阅

setIntervalRange()

minimumInterval()
Return type:

浮点数

返回最小连接间隔,单位为毫秒。默认值为7.5。

注意

如果此对象是通过 connectionUpdated() 发出的,那么此值与 maximumInterval() 相同,并指实际连接间隔。

另请参阅

setIntervalRange()

__ne__(b)
Parameters:

bQLowEnergyConnectionParameters

Return type:

布尔

如果 p1p2 的公共状态不相等,则返回 true,否则返回 false

__eq__(b)
Parameters:

bQLowEnergyConnectionParameters

Return type:

布尔

如果 p1p2 的公共状态相等,则返回 true,否则返回 false

setIntervalRange(minimum, maximum)
Parameters:
  • 最小值 – float

  • maximum – 浮点数

设置连接间隔的范围。实际值将由控制器决定。minimummaximum 都以毫秒为单位给出。如果 maximum 小于 minimum,它将被设置为 minimum 的值。最小的连接间隔为7.5毫秒,最大的连接间隔为4000毫秒。

setLatency(latency)
Parameters:

延迟 – int

设置连接的从机延迟(即从设备允许忽略的连接事件数量)为latency。最小值为0,最大值为499。

另请参阅

latency()

setSupervisionTimeout(timeout)
Parameters:

timeout – int

将链路监督超时设置为timeout毫秒。此值有几个限制:它必须在[100,32000]范围内,并且必须大于(1 + latency()) * 2 * maximumInterval()

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

另请参阅

supervisionTimeout()

supervisionTimeout()
Return type:

整数

返回连接中的链路监控超时时间,单位为毫秒。

swap(other)
Parameters:

其他QLowEnergyConnectionParameters

将此对象与 other 交换。