advertising
¶
广告是设备可以广播的 BLE 的第一阶段
-
to_hex
(seq)¶ Pretty 将字节序列打印为十六进制值。
-
to_bytes_literal
(seq)¶ 将字节序列打印为仅使用十六进制编码的 Python 字节文字。
-
decode_data
(data, *, key_encoding='B')¶ 使用给定键编码将长度编码结构解码为字典的助手。
-
compute_length
(data_dict, *, key_encoding='B')¶ 计算编码数据字典的长度。
-
encode_data
(data_dict, *, key_encoding='B')¶ 使用给定密钥编码将字典编码为长度编码结构的助手。
-
class
AdvertisingDataField
¶ 位于广告或其子类中的任何描述符类的顶级类。
-
class
AdvertisingFlag
(bit_position)¶ AdvertisingFlags 对象中的单个位标志。
-
class
AdvertisingFlags
(advertisement, advertising_data_type)¶ 标准广告旗
-
limited_discovery
¶ 只能在有限的时间内发现。
-
general_discovery
¶ 将广告直到发现。
-
le_only
¶ 不支持 BR/EDR。
-
-
class
String
(*, advertising_data_type)¶ 广告中的 UTF-8 编码字符串。
编码后非空终止,因为长度总是被传输。
-
class
LazyObjectField
(cls, attribute_name, *, advertising_data_type, **kwargs)¶ 用于将复杂对象延迟绑定到广告对象的非数据描述符。
-
advertising_data_type
¶ 返回用于指示此字段的数据类型值。
-
-
class
Advertisement
(*, entry=None)¶ 核心广告类型。
match_prefixes
如果不是None
,则类属性是字节串前缀的元组,以匹配广告中的多个数据结构。-
short_name
¶ 简短的本地设备名称(缩短以适应)。
-
complete_name
¶ 完整的本地设备名称。
-
tx_power
¶ 发射功率电平
-
appearance
¶ 外貌。
-
rssi
¶ 扫描广告的信号强度。仅适用于从 返回的广告
BLERadio.start_scan()
。(只读)
-
classmethod
get_prefix_bytes
()¶ 将 match_prefixes 的合并版本作为单个字节对象返回,并带有长度标头。
-
classmethod
matches
(entry)¶ 返回
True
给定的_bleio.ScanEntry
广告字段是否与match_prefixes
元组属性中的所有给定前缀匹配。子类可以覆盖它以匹配任何而不是全部。
-
classmethod
matches_prefixes
(entry, *, all_)¶ 返回
True
给定的_bleio.ScanEntry
广告字段是否与match_prefixes
元组属性中的任何或所有给定前缀匹配。如果all_
是True
,则所有前缀必须匹配。如果all_
是False
,True
如果至少有一个前缀匹配,则返回。
-
standard
¶
该模块提供 BLE 标准定义的广告。广告是单一用途的,即使多个用途实际上可能存在于单个数据包中。
-
class
BoundServiceList
(advertisement, *, standard_services, vendor_services)¶ 服务 UUID 对象的类序列对象。它存储标准和供应商 UUID。
-
append
(service)¶ 将服务附加到列表中。
-
extend
(services)¶ 将 iterable 中的所有服务附加到列表中。
-
-
class
ServiceList
(*, standard_services, vendor_services)¶ 延迟绑定相应 BoundServiceList 的服务 UUID 列表的描述符。
-
class
ProvideServicesAdvertisement
(*services, entry=None)¶ 通告设备在连接时提供哪些服务。
-
services
¶ 设备可以提供的服务列表。
-
classmethod
matches
(entry)¶ 在 ProvideServicesAdvertisement 中只需要存在一种服务列表,因此覆盖默认行为并匹配任何前缀,而不是全部。
-
-
class
SolicitServicesAdvertisement
(*services, entry=None)¶ 通告设备希望通过连接使用哪些服务。
-
solicited_services
¶ 设备想要使用的服务列表。
-
-
class
ManufacturerData
(obj, *, advertising_data_type=255, company_id, key_encoding='B')¶ 封装制造商特定的键控数据字节。制造商由 company_id 标识,数据的结构类似于具有可配置密钥格式的广告。序列化的数据的顺序由顺序所确定的
ManufacturerDataField
这可能是有用的-属性在设置match_prefixes
在一个Advertisement
子类。
-
class
ManufacturerDataField
(key, value_format, field_names=None)¶ 制造商特定数据中的单个数据。格式可以重复。
-
class
ServiceData
(service)¶ 封装服务数据。它被读取为内存视图,可以操作或设置为字节数组以更改大小。