QLowEnergyCharacteristic 类

成员函数文档

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。

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

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()，该 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 对象。两个副本继续共享相同的服务和控制细节。