class QBluetoothDeviceInfo

QBluetoothDeviceInfo类存储有关蓝牙设备的信息。

概要

方法

• def __init__()

• def address()

• def coreConfigurations()

• def deviceUuid()

• def isCached()

• def isValid()

• def majorDeviceClass()

• def manufacturerData()

• def manufacturerIds()

• def minorDeviceClass()

• def name()

• def __ne__()

• def __eq__()

• def rssi()

• def serviceClasses()

• def serviceData()

• def serviceIds()

• def serviceUuids()

• def setCached()

• def setCoreConfigurations()

• def setDeviceUuid()

• def setManufacturerData()

• def setName()

• def setRssi()

• def setServiceData()

• def setServiceUuids()

注意

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

详细说明

QBluetoothDeviceInfo 提供了关于蓝牙设备名称、地址和设备类别的信息。

class MajorDeviceClass

此枚举描述了蓝牙设备的major设备类别。

常量	描述
QBluetoothDeviceInfo.MiscellaneousDevice	一个杂项设备。
QBluetoothDeviceInfo.ComputerDevice	一个计算机设备或PDA。
QBluetoothDeviceInfo.PhoneDevice	一个电话设备。
QBluetoothDeviceInfo.NetworkDevice	一个提供对局域网接入的设备（自Qt 5.13起）。
QBluetoothDeviceInfo.AudioVideoDevice	一个能够播放或抓取音频和/或视频的设备。
QBluetoothDeviceInfo.PeripheralDevice	一个外围设备，如键盘、鼠标等。
QBluetoothDeviceInfo.ImagingDevice	一个成像设备，如显示器、打印机、扫描仪或照相机。
QBluetoothDeviceInfo.WearableDevice	一个可穿戴设备，如手表或寻呼机。
QBluetoothDeviceInfo.ToyDevice	一个玩具。
QBluetoothDeviceInfo.HealthDevice	一个与健康相关的设备，如心率或温度监测器。
QBluetoothDeviceInfo.UncategorizedDevice	一个不符合任何其他设备类别的设备。

class MinorMiscellaneousClass

此枚举描述了杂项蓝牙设备的次要设备类别。

常量	描述
QBluetoothDeviceInfo.UncategorizedMiscellaneous	一个未分类的杂项设备。

class MinorComputerClass

此枚举描述了计算机设备的次要设备类别。

常量	描述
QBluetoothDeviceInfo.UncategorizedComputer	一个未分类的计算机设备。
QBluetoothDeviceInfo.DesktopComputer	台式计算机。
QBluetoothDeviceInfo.ServerComputer	服务器计算机。
QBluetoothDeviceInfo.LaptopComputer	笔记本电脑。
QBluetoothDeviceInfo.HandheldClamShellComputer	翻盖手持式计算机或PDA。
QBluetoothDeviceInfo.HandheldComputer	手持式计算机或PDA。
QBluetoothDeviceInfo.WearableComputer	可穿戴计算机。

class MinorPhoneClass

此枚举描述了电话设备的次要设备类别。

常量	描述
QBluetoothDeviceInfo.UncategorizedPhone	一个未分类的电话设备。
QBluetoothDeviceInfo.CellularPhone	移动电话。
QBluetoothDeviceInfo.CordlessPhone	无绳电话。
QBluetoothDeviceInfo.SmartPhone	智能手机。
QBluetoothDeviceInfo.WiredModemOrVoiceGatewayPhone	有线调制解调器或语音网关。
QBluetoothDeviceInfo.CommonIsdnAccessPhone	提供ISDN接入的设备。

class MinorNetworkClass

该枚举描述了局域网接入设备的次要设备类别。局域网接入设备使用次要设备类别来指定当前网络利用率。

常量	描述
QBluetoothDeviceInfo.NetworkFullService	总带宽的100%可用。
QBluetoothDeviceInfo.NetworkLoadFactorOne	目前使用总带宽的0 - 17%。
QBluetoothDeviceInfo.NetworkLoadFactorTwo	目前使用总带宽的17 - 33%。
QBluetoothDeviceInfo.NetworkLoadFactorThree	目前使用总带宽的33 - 50%。
QBluetoothDeviceInfo.NetworkLoadFactorFour	目前使用总带宽的50 - 67%。
QBluetoothDeviceInfo.NetworkLoadFactorFive	目前使用总带宽的67 - 83%。
QBluetoothDeviceInfo.NetworkLoadFactorSix	目前使用总带宽的83 - 99%。
QBluetoothDeviceInfo.NetworkNoService	没有可用的网络服务。

class MinorAudioVideoClass

该枚举描述了音频/视频设备的次要设备类别。

常量	描述
QBluetoothDeviceInfo.UncategorizedAudioVideoDevice	一个未分类的音频/视频设备。
QBluetoothDeviceInfo.WearableHeadsetDevice	一个可穿戴的头戴式设备。
QBluetoothDeviceInfo.HandsFreeDevice	一个免提设备。
QBluetoothDeviceInfo.Microphone	一个麦克风。
QBluetoothDeviceInfo.Loudspeaker	一个扬声器。
QBluetoothDeviceInfo.Headphones	耳机。
QBluetoothDeviceInfo.PortableAudioDevice	一个便携式音频设备。
QBluetoothDeviceInfo.CarAudio	一个车载音频设备。
QBluetoothDeviceInfo.SetTopBox	一个机顶盒。
QBluetoothDeviceInfo.HiFiAudioDevice	一个HiFi音频设备。
QBluetoothDeviceInfo.Vcr	一个录像机。
QBluetoothDeviceInfo.VideoCamera	一个摄像机。
QBluetoothDeviceInfo.Camcorder	一个摄像机。
QBluetoothDeviceInfo.VideoMonitor	一个视频监控器。
QBluetoothDeviceInfo.VideoDisplayAndLoudspeaker	一个带内置扬声器的视频显示器。
QBluetoothDeviceInfo.VideoConferencing	一个视频会议设备。
QBluetoothDeviceInfo.GamingDevice	一个游戏设备。

class MinorPeripheralClass

该枚举描述了外围设备的次要设备类别。

常量	描述
QBluetoothDeviceInfo.UncategorizedPeripheral	一个未分类的外围设备。
QBluetoothDeviceInfo.KeyboardPeripheral	一个键盘。
QBluetoothDeviceInfo.PointingDevicePeripheral	一个指示设备，例如鼠标。
QBluetoothDeviceInfo.KeyboardWithPointingDevicePeripheral	一个带内置指示设备的键盘。
QBluetoothDeviceInfo.JoystickPeripheral	一个摇杆。
QBluetoothDeviceInfo.GamepadPeripheral	一个游戏手柄。
QBluetoothDeviceInfo.RemoteControlPeripheral	一个遥控器。
QBluetoothDeviceInfo.SensingDevicePeripheral	一个感应设备。
QBluetoothDeviceInfo.DigitizerTabletPeripheral	一个数字化仪平板外围设备。
QBluetoothDeviceInfo.CardReaderPeripheral	一个卡片读卡器外围设备。

class MinorImagingClass

该枚举描述了成像设备的次要设备类别。

常量	描述
QBluetoothDeviceInfo.UncategorizedImagingDevice	一个未分类的成像设备。
QBluetoothDeviceInfo.ImageDisplay	一个能够显示图像的设备。
QBluetoothDeviceInfo.ImageCamera	一个相机。
QBluetoothDeviceInfo.ImageScanner	一个图像扫描仪。
QBluetoothDeviceInfo.ImagePrinter	一个打印机。

class MinorWearableClass

此枚举描述了可穿戴设备的次要设备类别。

常量	描述
QBluetoothDeviceInfo.UncategorizedWearableDevice	未分类的可穿戴设备。
QBluetoothDeviceInfo.WearableWristWatch	手表。
QBluetoothDeviceInfo.WearablePager	便签机。
QBluetoothDeviceInfo.WearableJacket	夹克。
QBluetoothDeviceInfo.WearableHelmet	头盔。
QBluetoothDeviceInfo.WearableGlasses	一副眼镜。

class MinorToyClass

此枚举描述了玩具设备的次要设备类别。

常量	描述
QBluetoothDeviceInfo.UncategorizedToy	未分类的玩具。
QBluetoothDeviceInfo.ToyRobot	玩具机器人。
QBluetoothDeviceInfo.ToyVehicle	玩具车辆。
QBluetoothDeviceInfo.ToyDoll	玩具娃娃或动作人偶。
QBluetoothDeviceInfo.ToyController	控制器。
QBluetoothDeviceInfo.ToyGame	游戏。

class MinorHealthClass

此枚举描述了健康设备的次要设备类别。

常量	描述
QBluetoothDeviceInfo.UncategorizedHealthDevice	未分类的健康设备。
QBluetoothDeviceInfo.HealthBloodPressureMonitor	血压计。
QBluetoothDeviceInfo.HealthThermometer	体温计。
QBluetoothDeviceInfo.HealthWeightScale	体重秤。
QBluetoothDeviceInfo.HealthGlucoseMeter	血糖仪。
QBluetoothDeviceInfo.HealthPulseOximeter	血氧饱和度计。
QBluetoothDeviceInfo.HealthDataDisplay	数据显示器。
QBluetoothDeviceInfo.HealthStepCounter	计步器。

class ServiceClass

(继承自 enum.Flag) 此枚举描述了蓝牙设备的服务类别。服务类别用作一种基本的服务发现形式。它旨在提供设备可能提供的服务类型的列表。

常量	描述
QBluetoothDeviceInfo.NoService	设备不提供任何服务。
QBluetoothDeviceInfo.PositioningService	设备提供定位服务。
QBluetoothDeviceInfo.NetworkingService	设备提供网络服务。
QBluetoothDeviceInfo.RenderingService	设备提供渲染服务。
QBluetoothDeviceInfo.CapturingService	设备提供捕获服务。
QBluetoothDeviceInfo.ObjectTransferService	设备提供对象传输服务。
QBluetoothDeviceInfo.AudioService	设备提供音频服务。
QBluetoothDeviceInfo.TelephonyService	设备提供电话服务。
QBluetoothDeviceInfo.InformationService	设备提供信息服务。
QBluetoothDeviceInfo.AllServices	设备提供所有类型的服务。

class Field

(继承自 enum.Flag) 此枚举与 deviceUpdated() 信号一起使用，表示已更改的字段。

常量	描述
QBluetoothDeviceInfo.Field.None	没有值已更改。
QBluetoothDeviceInfo.Field.RSSI	设备的 rssi() 值已更改。
QBluetoothDeviceInfo.Field.ManufacturerData	manufacturerData() 字段已更改
QBluetoothDeviceInfo.Field.ServiceData	serviceData() 字段已更改
QBluetoothDeviceInfo.Field.All	匹配所有可能的字段。

class CoreConfiguration

(继承 enum.Flag) 此枚举描述了设备的配置。

常量	描述
QBluetoothDeviceInfo.UnknownCoreConfiguration	无法确定蓝牙设备类型。
QBluetoothDeviceInfo.BaseRateCoreConfiguration	该设备是一个标准蓝牙设备。
QBluetoothDeviceInfo.BaseRateAndLowEnergyCoreConfiguration	该设备支持标准蓝牙和低功耗蓝牙的蓝牙智能设备。
QBluetoothDeviceInfo.LowEnergyCoreConfiguration	该设备是蓝牙低功耗设备。

__init__(address, name, classOfDevice)

参数：:

• address – QBluetoothAddress

• name – str

• classOfDevice – int

使用蓝牙地址 address，设备名称 name 和编码的设备类别 classOfDevice 创建一个 QBluetoothDeviceInfo 对象。

classOfDevice 参数编码的格式如下

位	大小	描述
0 - 1	2	未使用，设置为 0。
2 - 7	6	次要设备类别。
8 - 12	5	主设备类别。
13 - 23	11	服务类别。

__init__(other)

参数：:

other – QBluetoothDeviceInfo

通过复制 other 创建一个 QBluetoothDeviceInfo。

__init__(uuid, name, classOfDevice)

参数：:

• uuid – QBluetoothUuid

• name – str

• classOfDevice – int

构建一个具有唯一 uuid，设备名称 name 和编码设备类 classOfDevice 的 QBluetoothDeviceInfo 对象。

此构造函数对于 macOS 和 iOS 上的低功耗设备是必需的。CoreBluetooth API 隐藏地址并提供唯一 UUID 以识别设备。此 UUID 与服务 UUID 不同，它对于以后使用 CoreBluetooth API 和已发现设备是必需的。

__init__()

构建无效的 QBluetoothDeviceInfo 对象。

address()

返回类型：

QBluetoothAddress

返回设备的地址。

注意

在 iOS 和 macOS 上，此地址无效。相反，应使用 deviceUuid()。在这两个平台上，不会公开已找到的蓝牙设备的地址，而是使用唯一设备标识符。

另请参阅

deviceUuid()

coreConfigurations()

返回类型：

CoreConfiguration 的组合

返回设备配置。如果未设置设备配置，将返回基本速率设备配置。

另请参阅

setCoreConfigurations()

deviceUuid()

返回类型：

QBluetoothUuid

返回一个无地址的蓝牙设备的唯一标识符。

通常，此 uuid 在每个平台上都无效，但在 macOS 和 iOS 上使用。它用作这两个平台的替代方案，因为它们不提供已找到的蓝牙低功耗设备的蓝牙地址。其他每个平台使用 address() 代替。

另请参阅

setDeviceUuid()

isCached()

返回类型：

bool

如果 QBluetoothDeviceInfo 对象是从缓存数据创建的，则返回 true。

isValid()

返回类型：

bool

如果 QBluetoothDeviceInfo 对象有效，则返回 true，否则返回 false。

majorDeviceClass()

返回类型：

主设备类

返回设备的主体设备类。

manufacturerData()

返回类型：

.QMultiHashquint16,QByteArray

返回从广告数据包中得到的所有制造商数据的完整集合。

某些设备可以针对每个制造商ID提供多个制造商数据条目。例如，一个蓝牙低能耗设备可能分别通过广告数据包和扫描应答回复数据包发送不同的制造商数据。因此，返回的哈希表可能针对每个制造商ID或哈希键有多个条目。

另请参阅

setManufacturerData

manufacturerData(manufacturerId)

参数：:

manufacturerId - int

返回类型：

QByteArray

返回与给定 manufacturerId 相关的数据。

制造商数据由蓝牙核心规范增补定义，包括两个部分：

• 来自 指定编号 公司标识符文档的制造商特定标识符代码

• 任意数据八位组的序列

数据八位组的解释由公司标识符指定的制造商 定义。

注意

远程设备可能为每个 manufacturerId 提供多个数据条目。此函数只返回第一个条目。如需所有条目，请使用 manufacturerData()，它返回多哈希。

另请参阅

manufacturerIds() setManufacturerData()

manufacturerIds()

返回类型：

.quint16 列表

返回附加到此设备信息的广告数据包中的所有制造商ID。

另请参阅

manufacturerData() setManufacturerData()

minorDeviceClass()

返回类型：

int

返回设备的次要设备类别。实际的详细信息取决于 majorDeviceClass() 的值。

另请参阅

MinorAudioVideoClass MinorComputerClass MinorHealthClass MinorImagingClass MinorMiscellaneousClass MinorNetworkClass MinorPeripheralClass MinorPhoneClass MinorToyClass MinorWearableClass

name()

返回类型：

str

返回分配给设备的名称。

另请参阅

setName()

__ne__(b)

参数：:

b – QBluetoothDeviceInfo

返回类型：

bool

如果两个 QBluetoothDeviceInfo 对象 a 和 b 不相等，则返回 true。

__eq__(b)

参数：:

b – QBluetoothDeviceInfo

返回类型：

bool

如果两个 QBluetoothDeviceInfo 对象 a 和 b 相等，则返回 true。

rssi()

返回类型：

int

返回设备上次扫描时的信号强度。

另请参阅

setRssi()

serviceClasses()

返回类型：

由 ServiceClass 组合而成。

返回设备的 服务类别。

serviceData()

返回类型：

.QMultiHashQBluetoothUuid, QByteArray

返回广告包中的所有服务数据的完整集合。

某些设备可能为每个服务数据ID提供多个服务数据条目。一个例子可能是一个通过广告包和扫描响应包分别发送不同服务数据的低功耗蓝牙设备。因此返回的哈希表可能会有多个条目，每个服务数据ID或哈希键。

另请参阅

setServiceData

serviceData(serviceId)

参数：:

serviceId – QBluetoothUuid

返回类型：

QByteArray

返回与给定 serviceId 关联的数据。

服务数据由蓝牙核心规范的第2部分补充定义，包括两个部分

• 服务UUID

• 任意数据八位组的序列

注意

远程设备可能为每个 serviceId 提供多个数据条目。此函数仅返回第一个条目。如果需要所有条目，请使用 serviceData()，它返回一个多哈希。

另请参阅

serviceIds() setServiceData()

serviceIds()

返回类型：

. QBluetoothUuid 列表

返回此设备信息附加的广告包中的所有服务数据ID。

另请参阅

serviceData() setServiceData()

serviceUuids()

返回类型：

. QBluetoothUuid 列表

返回设备支持的服务UUID列表。通常此UUID列表表示自定义服务UUID或由 ServiceClassUuid 指定服务UUID值。

另请参阅

setServiceUuids() serviceUuids()

setCached(cached)

参数：:

cached – bool

当从缓存的 数据创建 QBluetoothDeviceInfo 对象时，系统使用它来设置 cached 标志。缓存信息可能不如从活动设备读取的数据准确。

另请参阅

isCached()

setCoreConfigurations(coreConfigs)

参数：:

coreConfigs – CoreConfiguration 的组合

将设备的 CoreConfigurations 设置为 coreConfigs。这将有助于区分常规设备和低功耗设备。

另请参阅

coreConfigurations()

setDeviceUuid(uuid)

参数：:

uuid – QBluetoothUuid

设置没有地址的蓝牙设备的唯一标识符 uuid。在 macOS 和 iOS 上，CoreBluetooth API隐藏地址，但提供 UUID 来识别设备/外围设备。

此 UUID 在其他平台上无效。

另请参阅

deviceUuid()

setManufacturerData(manufacturerId, data)

参数：:

• manufacturerId - int

• 数据 – QByteArray

返回类型：

bool

为指定的 manufacturerId 设置广告的 data。如果成功插入，则返回 true，如果已经存在，则返回 false。

从 Qt 5.14 开始，对于相同的 data 和相同的 manufacturerId，不再互相替换，而是将在设备扫描期间进行累计。

另请参阅

manufacturerData

setName(name)

参数：:

name – str

设置设备的 name。

另请参阅

name()

setRssi(signal)

参数：:

信号 – int

设置内部使用的 signal 信号强度值。

另请参阅

rssi()

setServiceData(serviceId, data)

参数：:

• serviceId – QBluetoothUuid

• 数据 – QByteArray

返回类型：

bool

为指定的 serviceId 设置广告的 data。如果成功插入，则返回 true，如果已经存在，则返回 false。

另请参阅

serviceData

setServiceUuids(uuids)

参数：:

uuids – .的 QBluetoothUuid 列表

将服务 UUID 列表设置为 uuids。

另请参阅

serviceUuids()