QLowEnergyCharacteristicData Class

QLowEnergyCharacteristicData 类用于设置 GATT 服务数据。更多

Header: #include <QLowEnergyCharacteristicData>
qmake: QT += bluetooth

公共函数

QLowEnergyCharacteristicData()
QLowEnergyCharacteristicData(const QLowEnergyCharacteristicData &other)
~QLowEnergyCharacteristicData()
void addDescriptor(const QLowEnergyDescriptorData &descriptor)
QList<QLowEnergyDescriptorData> descriptors() const
bool isValid() const
int maximumValueLength() const
int minimumValueLength() const
QLowEnergyCharacteristic::PropertyTypes properties() const
QBluetooth::AttAccessConstraints readConstraints() const
void setDescriptors(const QList<QLowEnergyDescriptorData> &descriptors)
void setProperties(QLowEnergyCharacteristic::PropertyTypes properties)
void setReadConstraints(QBluetooth::AttAccessConstraints constraints)
void setUuid(const QBluetoothUuid &uuid)
void setValue(const QByteArray &value)
void setValueLength(int minimum, int maximum)
void setWriteConstraints(QBluetooth::AttAccessConstraints constraints)
void swap(QLowEnergyCharacteristicData &other)
QBluetoothUuid uuid() const
QByteArray value() const
QBluetooth::AttAccessConstraints writeConstraints() const
QLowEnergyCharacteristicData &operator=(const QLowEnergyCharacteristicData &other)
bool operator!=(const QLowEnergyCharacteristicData &a, const QLowEnergyCharacteristicData &b)
bool operator==(const QLowEnergyCharacteristicData &a, const QLowEnergyCharacteristicData &b)

详细描述

该类的一个对象提供了一个特性,可通过QLowEnergyServiceData::addCharacteristic() 添加到QLowEnergyServiceData 对象中。

另请参阅 QLowEnergyServiceDataQLowEnergyController::addService

成员函数文档

QLowEnergyCharacteristicData::QLowEnergyCharacteristicData()

创建本类的新无效对象。

QLowEnergyCharacteristicData::QLowEnergyCharacteristicData(const QLowEnergyCharacteristicData &other)

构造一个本类的新对象,它是other 的副本。

[noexcept] QLowEnergyCharacteristicData::~QLowEnergyCharacteristicData()

销毁该对象。

void QLowEnergyCharacteristicData::addDescriptor(const QLowEnergyDescriptorData &descriptor)

如果descriptor 有效,则将其添加到此特征的描述符列表中。

另请参阅 setDescriptors()。

QList<QLowEnergyDescriptorData> QLowEnergyCharacteristicData::descriptors() const

返回此特征的描述符。

另请参阅 setDescriptors()。

bool QLowEnergyCharacteristicData::isValid() const

如果且仅当该特性有效(即 UUID 不为空)时,才返回 true。

int QLowEnergyCharacteristicData::maximumValueLength() const

返回该特征值的最大长度(以字节为单位)。默认情况下,除了数据类型的限制外没有其他限制。

int QLowEnergyCharacteristicData::minimumValueLength() const

返回此特性值的最小长度(以字节为单位)。默认值为零。

QLowEnergyCharacteristic::PropertyTypes QLowEnergyCharacteristicData::properties() const

返回此特征的属性。

另请参阅 setProperties()。

QBluetooth::AttAccessConstraints QLowEnergyCharacteristicData::readConstraints() const

返回客户端读取该特性值所需的限制条件。如果properties() 不包括QLowEnergyCharacteristic::Read ,则此值无关。默认情况下,没有读取限制。

另请参阅 setReadConstraints()。

void QLowEnergyCharacteristicData::setDescriptors(const QList<QLowEnergyDescriptorData> &descriptors)

将此特性的描述符设置为descriptors 。只考虑有效的描述符。

另请参阅 descriptors() 和addDescriptor()。

void QLowEnergyCharacteristicData::setProperties(QLowEnergyCharacteristic::PropertyTypes properties)

将此特性的属性设置为properties

另请参阅 properties() 。

void QLowEnergyCharacteristicData::setReadConstraints(QBluetooth::AttAccessConstraints constraints)

指定客户端需要满足constraints 才能读取该特性的值。

另请参阅 readConstraints()。

void QLowEnergyCharacteristicData::setUuid(const QBluetoothUuid &uuid)

将此特性的 UUID 设置为uuid

另请参阅 uuid() 。

void QLowEnergyCharacteristicData::setValue(const QByteArray &value)

将此特性的值设置为value

另请参阅 value() 。

void QLowEnergyCharacteristicData::setValueLength(int minimum, int maximum)

分别指定minimummaximum 为该特性值的最小长度和最大长度。单位为字节。如果minimummaximum 相等,则特性值为固定长度。

void QLowEnergyCharacteristicData::setWriteConstraints(QBluetooth::AttAccessConstraints constraints)

指定客户端需要满足constraints 才能写入该特性的值。

另请参阅 writeConstraints()。

[noexcept] void QLowEnergyCharacteristicData::swap(QLowEnergyCharacteristicData &other)

将此对象与other 互换。

QBluetoothUuid QLowEnergyCharacteristicData::uuid() const

返回此特征的 UUID。

另请参阅 setUuid()。

QByteArray QLowEnergyCharacteristicData::value() const

返回此特征的值。

另请参阅 setValue()。

QBluetooth::AttAccessConstraints QLowEnergyCharacteristicData::writeConstraints() const

返回客户端写入此特性值所需的限制条件。如果properties() 不包括QLowEnergyCharacteristic::WriteQLowEnergyCharacteristic::WriteNoResponseQLowEnergyCharacteristic::WriteSigned 中的任何一个,则此值无关。默认情况下,没有写入限制。

另请参阅 setWriteConstraints()。

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

使该对象成为other 的副本,并返回该对象的新值。

相关非成员

bool operator!=(const QLowEnergyCharacteristicData &a, const QLowEnergyCharacteristicData &b)

如果ab 的公共状态不相等,则返回true ,否则返回false

bool operator==(const QLowEnergyCharacteristicData &a, const QLowEnergyCharacteristicData &b)

如果ab 的公共状态相等,则返回true ,否则返回false

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.