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的“特征”部分中找到。

如果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 对象。这两个副本继续共享相同的服务和控制器详细信息。