PySide6.QtBluetooth.QLowEnergyAdvertisingData¶

class QLowEnergyAdvertisingData¶

QLowEnergyAdvertisingData 类表示在蓝牙低功耗广播期间要广播的数据。更多…

概要¶

方法¶

• def __init__()

• def discoverability()

• def includePowerLevel()

• def localName()

• def manufacturerData()

• def manufacturerId()

• def __ne__()

• def __eq__()

• def rawData()

• def services()

• def setDiscoverability()

• def setIncludePowerLevel()

• def setLocalName()

• def setManufacturerData()

• def setRawData()

• def setServices()

• def swap()

静态函数¶

• def invalidManufacturerId()

注意

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

详细描述¶

这些数据可以包括设备名称、设备提供的GATT服务等。通过此类设置的数据将在通过调用startAdvertising()开始广告时使用。此类的对象可以表示广告数据包或扫描响应包。

注意

通过广告通道发送的实际数据包不能超过31字节。如果通过此类设置的可变长度数据超过该限制，则根据类型，数据将被省略或截断。在Android上，如果广告数据超过31字节，广告将失败。在Bluez DBus后端，广告长度限制以及超出限制时的行为由BlueZ决定；例如，它可能支持扩展广告。为了获得最可预测的行为，请保持广告数据简短。

另请参阅

QLowEnergyAdvertisingParameters startAdvertising()

class Discoverability¶

广告设备的可发现性，如通用访问配置文件所定义。

常量	描述
QLowEnergyAdvertisingData.DiscoverabilityNone	广告设备不希望被扫描设备发现。
QLowEnergyAdvertisingData.DiscoverabilityLimited	广告设备希望以高优先级被发现。请注意，此模式与使用白名单不兼容。当使用有限发现性时，filterPolicy()的值始终假定为IgnoreWhiteList。
QLowEnergyAdvertisingData.DiscoverabilityGeneral	广告设备希望被扫描设备发现。

__init__()¶

创建此类的新对象。所有值都根据蓝牙低功耗规范初始化为其默认值。

__init__(other)

Parameters:

其他 – QLowEnergyAdvertisingData

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

discoverability()¶

Return type:

可发现性

返回广告设备的可发现性模式。默认是 DiscoverabilityNone 。

另请参阅

setDiscoverability()

includePowerLevel()¶

Return type:

布尔

返回是否在广告数据中包含设备的传输功率级别。默认值为false。

另请参阅

setIncludePowerLevel()

static invalidManufacturerId()¶

Return type:

整数

返回一个无效的制造商ID。如果将此值设置为制造商ID（默认情况下如此），则广告数据中将不会包含制造商数据。

localName()¶

Return type:

字符串

返回要广告的本地设备的名称。

另请参阅

setLocalName()

manufacturerData()¶

Return type:

QByteArray

返回制造商数据。默认是一个空的字节数组。

另请参阅

setManufacturerData()

manufacturerId()¶

Return type:

整数

返回制造商ID。默认值为invalidManufacturerId()，这意味着数据将不会被广告。

__ne__(b)¶

Parameters:

b – QLowEnergyAdvertisingData

Return type:

布尔

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

__eq__(b)¶

Parameters:

b – QLowEnergyAdvertisingData

Return type:

布尔

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

rawData()¶

Return type:

QByteArray

返回用户提供的原始数据以进行广告。默认值为空字节数组。

另请参阅

setRawData()

services()¶

Return type:

QBluetoothUuid的列表

返回要广播的服务UUID列表。默认情况下，此列表为空。

另请参阅

setServices()

setDiscoverability(mode)¶

Parameters:

mode – 可发现性

将广告设备的可发现性类型设置为 mode。

注意

可发现性信息只能出现在实际的广告数据包中。如果此对象作为扫描响应数据，调用此函数对发送的扫描响应没有影响。

另请参阅

discoverability()

setIncludePowerLevel(doInclude)¶

Parameters:

doInclude – 布尔值

指定是否在广告数据中包含设备的发射功率级别。如果 doInclude 是 true，则数据将被包含，否则将不包含。

另请参阅

includePowerLevel()

setLocalName(name)¶

Parameters:

name – str

指定name应作为设备名称广播。如果完整名称不适合放入广告数据包中，则会发送缩写名称，如蓝牙低功耗规范所述。

在Android上，本地名称无法更改。Android始终使用设备名称。如果此本地名称不为空，Android实现会在广告包中包含设备名称；否则，设备名称将从广告包中省略。

另请参阅

localName()

setManufacturerData(id, data)¶

Parameters:

• id – int

• data – QByteArray

设置制造商ID和数据。id参数是由蓝牙SIG分配的公司标识符。data参数是一个任意值。

另请参阅

manufacturerData()

setRawData(data)¶

Parameters:

数据 – QByteArray

设置要广播的数据为data。如果该值不是空的字节数组，它将作为广播数据原样发送，并且此对象中的所有其他数据将被忽略。这可以用于发送非标准数据。

注意

如果 data 超过 31 字节，它将被截断。调用者有责任确保 data 格式正确。

设置原始广告数据仅在Linux Bluetooth Kernel API后端支持。其他后端不允许将原始广告数据指定为全局字段。

另请参阅

rawData()

setServices(services)¶

Parameters:

services – QBluetoothUuid 的列表

指定应广告services中的服务UUID。如果整个列表无法放入数据包中，则按照蓝牙低功耗规范发送不完整的列表。

另请参阅

services()

swap(other)¶

Parameters:

其他 – QLowEnergyAdvertisingData

将此对象与 other 交换。