QLowEnergyDescriptor 类
QLowEnergyDescriptor 类存储有关蓝牙低功耗描述符的信息。更多信息...
头文件 | #include <QLowEnergyDescriptor> |
qmake | QT += bluetooth |
公共函数
QLowEnergyDescriptor() | |
QLowEnergyDescriptor(const QLowEnergyDescriptor &other) | |
~QLowEnergyDescriptor() | |
bool | isValid() const |
QString | name() const |
QBluetoothUuid::DescriptorType | type() const |
QBluetoothUuid | uuid() const |
QByteArray | value() const |
QLowEnergyDescriptor & | operator=(const QLowEnergyDescriptor &other) |
相关非成员
bool | operator!=(const QLowEnergyDescriptor &a, const QLowEnergyDescriptor &b) |
bool | operator==(const QLowEnergyDescriptor &a, const QLowEnergyDescriptor &b) |
详细描述
QLowEnergyDescriptor 提供有关蓝牙低功耗描述符的 name()、uuid() 和 value() 的信息。描述符被蓝牙低功耗特征封装,并提供有关特征的附加上下文信息(数据格式、通知激活等)。
描述符值可以通过管理此描述符所属服务的 QLowEnergyService 实例写入。使用 QLowEnergyService::writeDescriptor() 函数写入新值。成功时发出 QLowEnergyService::descriptorWritten() 信号。相应地更新此对象的缓存的 value()。
另见 QLowEnergyService 和 QLowEnergyCharacteristic。
成员函数文档
QLowEnergyDescriptor::QLowEnergyDescriptor()
构造新的 QLowEnergyDescriptor。此类的默认构造实例始终无效。
QLowEnergyDescriptor::QLowEnergyDescriptor(const QLowEnergyDescriptor &other)
构造一个新实例的 QLowEnergyDescriptor,它是 other 的副本。
两个副本继续共享相同的基本数据,写入时不会分离。
[noexcept]
QLowEnergyDescriptor::~QLowEnergyDescriptor()
销毁 QLowEnergyDescriptor 对象。
bool QLowEnergyDescriptor::isValid() const
如果 QLowEnergyDescriptor 对象有效,则返回 true
,否则返回 false
。
无效的描述符实例不与任何服务(默认构造)关联,或关联的服务由于与底层低功耗蓝牙设备的断开连接而不再有效,例如。一旦对象无效,它将无法再次变得有效。
注意:如果 QLowEnergyDescriptor 实例因与底层设备的断开连接而变成无效,则该实例封装的信息将保持断开连接时的情况。因此可以在断开事件之后检索。
QString QLowEnergyDescriptor::name() const
返回描述符的易读名称。
该名称基于描述符的 type()。描述符类型的完整列表可在 Bluetooth.org 描述符下找到。
如果 type() 是未知的,则返回的字符串为空。
另请参阅type() 和 QBluetoothUuid::descriptorToString。
QBluetoothUuid::DescriptorType QLowEnergyDescriptor::type() const
返回描述符的类型。
另请参阅name。
QBluetoothUuid QLowEnergyDescriptor::uuid() const
如果 isValid() 返回 true
,则返回此描述符的 UUID;否则返回一个 null UUID。
QByteArray QLowEnergyDescriptor::value() const
返回描述符的缓存值。
可以使用 QLowEnergyService::writeDescriptor() 或 QLowEnergyService::readDescriptor() 更新缓存的描述符值。
QLowEnergyDescriptor &QLowEnergyDescriptor::operator=(const QLowEnergyDescriptor &other)
复制 other 并将其分配给此 QLowEnergyDescriptor 对象。两个副本将继续共享相同的服务和控制细节。
相关非成员函数
bool operator!=(const QLowEnergyDescriptor &a, const QLowEnergyDescriptor &b)
如果 a 不等于 b,则返回 true
;否则返回 false
。
如果两个 QLowEnergyDescriptor 实例都引用同一远程蓝牙低能耗设备上的同一描述符或都为默认构造,则认为它们相等。
bool operator==(const QLowEnergyDescriptor &a, const QLowEnergyDescriptor &b)
如果 a 等于 b,则返回 true
;否则返回 false
。
如果两个 QLowEnergyDescriptor 实例都引用同一远程蓝牙低能耗设备上的同一描述符或都为默认构造,则认为它们相等。
© 2024 Qt 公司有限公司。此处包含的文档贡献者的版权属于各自所有者。所提供的文档受自由软件基金会发布的 GNU 自由文档许可证版本 1.3 条款的约束。Qt 及相关商标是芬兰 Qt 公司和/或其他国家的商标。所有其他商标均为其所有者的财产。