QLowEnergyCharacteristic Class

成员函数文档

QLowEnergyCharacteristic::QLowEnergyCharacteristic()

构造一个新的 QLowEnergyCharacteristic。该类默认构造的实例总是无效的。

另请参阅 isValid().

QLowEnergyCharacteristic::QLowEnergyCharacteristic(const QLowEnergyCharacteristic &other)

构建一个新的 QLowEnergyCharacteristic，它是other 的副本。

这两个副本继续共享相同的基础数据，写入时不会分离。

[noexcept] QLowEnergyCharacteristic::~QLowEnergyCharacteristic()

销毁QLowEnergyCharacteristic 对象。

[since 6.2] QLowEnergyDescriptor QLowEnergyCharacteristic::clientCharacteristicConfiguration() const

返回客户特性配置描述符，如果不存在客户特性配置描述符，则返回无效的QLowEnergyDescriptor 实例。

BTLE 特征可支持通知和/或指示。在这两种情况下，外设都会通知中心特性值的每次变化。在 BTLE 属性协议中，中心不会确认通知信息，而会确认指示信息。通知更快但不可靠，而指示更慢但更可靠。

如果某个特性支持通知或指示，则可以通过在客户端特性配置描述符中写入特殊的位模式来启用这些特性。为方便起见，这些位模式分别为QLowEnergyCharacteristic::CCCDDisable 、QLowEnergyCharacteristic::CCCDEnableNotification 和QLowEnergyCharacteristic::CCCDEnableIndication 。

例如，在名为myservice 的服务中启用名为mycharacteristic 的特性通知，可使用以下代码完成。

auto cccd = mycharacteristic.clientCharacteristicConfiguration();
if (!cccd.isValid()) {
    // your error handling
    return error;
}
myservice->writeDescriptor(cccd, QLowEnergyCharacteristic::CCCDEnableNotification);

此函数在 Qt 6.2 中引入。

另请参阅 descriptor()。

QLowEnergyDescriptor QLowEnergyCharacteristic::descriptor(const QBluetoothUuid &uuid) const

返回uuid 的描述符或无效的QLowEnergyDescriptor 实例。

另请参阅 descriptors()。

QList<QLowEnergyDescriptor> QLowEnergyCharacteristic::descriptors() const

返回属于此特征的描述符列表；否则返回空列表。

另请参阅 descriptor()。

bool QLowEnergyCharacteristic::isValid() const

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

无效特征对象与任何服务（默认构建）都不相关联，或者由于与底层蓝牙低功耗设备断开连接等原因导致相关服务不再有效。对象一旦失效，就不能再变为有效。

QString QLowEnergyCharacteristic::name() const

返回特征的人可读名称。

该名称基于特性的uuid() ，必须已标准化。特性类型的完整列表可在Bluetooth.org Characteristics 下找到。

如果uuid() 未知，返回的字符串为空。

另请参阅 QBluetoothUuid::characteristicToString()。

QLowEnergyCharacteristic::PropertyTypes QLowEnergyCharacteristic::properties() const

返回特性的属性。

属性定义了特性的访问权限。

QBluetoothUuid QLowEnergyCharacteristic::uuid() const

如果isValid() 返回true ，则返回特性的 UUID；否则返回null UUID。

QByteArray QLowEnergyCharacteristic::value() const

返回特性的缓存值。

如果特性的properties() 允许写入新值，则可使用QLowEnergyService::writeCharacteristic() 更新该值。

缓存会在相关服务的detail discovery 、成功的read/write 操作或收到更新通知时更新。

如果特性没有read permission ，则返回的QByteArray 始终为空。在这种情况下，只有QLowEnergyService::characteristicChanged() 或QLowEnergyService::characteristicWritten() 可以提供有关该特性值的信息。

QLowEnergyCharacteristic &QLowEnergyCharacteristic::operator=(const QLowEnergyCharacteristic &other)

复制other 并将其分配给QLowEnergyCharacteristic 对象。这两个副本继续共享相同的服务和控制器详细信息。