QLowEnergyCharacteristicData Class
QLowEnergyCharacteristicData 类用于配置 GATT 服务数据。更多内容...
| 头文件: | #include <QLowEnergyCharacteristicData> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Bluetooth) target_link_libraries(mytarget PRIVATE Qt6::Bluetooth) |
| qmake: | QT += bluetooth |
- 所有成员的列表,包括继承的成员
- QLowEnergyCharacteristicData 属于“隐式共享类”的一部分。
公共函数
| 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 对象中。
另请参阅 QLowEnergyServiceData 和QLowEnergyController::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)
指定minimum 和maximum 分别作为该特征值可能具有的最小和最大长度。单位为字节。如果minimum 和maximum 相等,则该特征的值具有固定长度。
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::Write 、QLowEnergyCharacteristic::WriteNoResponse 和QLowEnergyCharacteristic::WriteSigned 中的任何一项,则此值无关紧要。默认情况下,不存在写入约束。
另请参阅 setWriteConstraints()。
QLowEnergyCharacteristicData &QLowEnergyCharacteristicData::operator=(const QLowEnergyCharacteristicData &other)
将该对象复制为 `other ` 的副本,并返回该对象的新值。
相关的非成员
bool operator!=(const QLowEnergyCharacteristicData &a, const QLowEnergyCharacteristicData &b)
如果 `a ` 和 `b ` 的公共状态不相同,则返回 `true `;否则返回 `false`。
bool operator==(const QLowEnergyCharacteristicData &a, const QLowEnergyCharacteristicData &b)
如果a 和b 的公共状态相等,则返回true ;否则返回false 。
© 2026 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.