class QLowEnergyAdvertisingParameters#

QLowEnergyAdvertisingParameters 类表示用于蓝牙低功耗广播的参数。 更多…

摘要#

方法#

注意

该文档可能包含从C++自动翻译到Python的片段。我们始终欢迎对片段翻译的贡献。如果您发现翻译有问题，也可以通过在https:/bugreports.qt.io/projects/PYSIDE创建ticket的方式来告诉我们。

详细描述#

在运行广告过程时，可以配置多个参数，例如广告速度或哪些客户端（如果有），可以连接到广告设备。这些参数将通过此类设置，其值将在通过调用startAdvertising() 启动广告时使用。

类 模式#

指定如何进行广告。

常数

描述

QLowEnergyAdvertisingParameters.AdvInd

用于非定向、可连接的广告。广告不是针对一个特定设备，看到广告的设备可以连接到广告设备或发送扫描请求。

QLowEnergyAdvertisingParameters.AdvScanInd

用于非定向、可扫描的广告。广告不是针对一个特定设备，看到广告的设备可以向广告设备发送扫描请求，但不能连接到它。

QLowEnergyAdvertisingParameters.AdvNonConnInd

适用于非定向、不可连接的广告。广告不对某一特定设备进行定向。看到广告的设备无法连接到广告设备，也无法发送扫描请求。因此，此模式意味着纯广播。
类 FilterPolicy#

指定白名单的语义。

常数

描述

QLowEnergyAdvertisingParameters.IgnoreWhiteList

忽略白名单的值，即在使用非定向广告时，扫描或连接请求不进行过滤。

QLowEnergyAdvertisingParameters.UseWhiteListForScanning

在处理扫描请求时使用白名单，但对于连接请求忽略白名单。

QLowEnergyAdvertisingParameters.UseWhiteListForConnecting

在处理连接请求时使用白名单，但对于扫描请求忽略白名单。

QLowEnergyAdvertisingParameters.UseWhiteListForScanningAndConnecting

对于连接和扫描请求都使用白名单。

另请参阅

whiteList()

__init__()#

创建此类的新对象。所有值都初始化为蓝牙低能耗规格的默认值。

__init__(other)
参数:

其他 – QLowEnergyAdvertisingParameters

创建此类的新对象，该对象的复制来自other。

filterPolicy()#
返回类型:

FilterPolicy

返回确定如何使用白名单的过滤策略。默认为 IgnoreWhiteList 。

maximumInterval()#
返回类型:

int

返回最大广告间隔（毫秒）。默认为1280。

minimumInterval()#
返回类型:

int

返回最小广告间隔（毫秒）。默认为1280。

mode()#
返回类型:

Mode

返回广告模式。默认为 AdvInd 。

另请参阅

setMode()

__ne__(b)#
参数:

b – QLowEnergyAdvertisingParameters

返回类型:

bool

如果a和b的公共状态不相等，则返回true，否则返回false。

__eq__(b)#
参数:

b – QLowEnergyAdvertisingParameters

返回类型:

bool

如果a和b的公共状态相等，则返回true，否则返回false。

setInterval(minimum, maximum)#
参数:

  • minimum - int

  • maximum - int

设置广告间隔。这是一个范围，给控制器提供了发送广告数据频率的上限和下限。这两个值minimum和maximum都是以毫秒为单位。如果maximum小于minimum，则将其设置为minimum的值。

注意

最小和最大间隔都有限制；具体的数值取决于模式。如果超过限制，将分别使用可能的最小或最大值。

在BlueZ DBus后端支持设置广告间隔，如果在其BlueZ之后的版本中将其实验状态更改（或者以实验模式运行）。

setMode(mode)#
参数:

mode - Mode

将广告模式设置为mode。

另请参阅

mode()

setWhiteList(whiteList, policy)#
参数:

  • whiteList - .list of QLowEnergyAdvertisingParameters.AddressInfo

  • policy - FilterPolicy

设置可能用于筛选扫描和连接请求的白名单。whiteList参数是要用于筛选的地址列表，而policy指定如何具体使用whiteList。

在BlueZ DBus后端不支持白名单，因为这些不在BlueZ中受支持。

另请参阅

whiteList()

swap(other)#
参数:

其他 – QLowEnergyAdvertisingParameters

与此对象交换 other。

whiteList()#
返回类型:

. QLowEnergyAdvertisingParameters.AddressInfo 列表

返回用于过滤扫描和连接请求的白名单。默认情况下，该列表为空。

另请参阅

setWhiteList()