QLowEnergyDescriptor Class
La clase QLowEnergyDescriptor almacena información sobre el descriptor de Bluetooth Low Energy. Más información...
| Cabecera: | #include <QLowEnergyDescriptor> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Bluetooth) target_link_libraries(mytarget PRIVATE Qt6::Bluetooth) |
| qmake: | QT += bluetooth |
Funciones públicas
| QLowEnergyDescriptor() | |
| QLowEnergyDescriptor(const QLowEnergyDescriptor &other) | |
| ~QLowEnergyDescriptor() | |
| bool | isValid() const |
| QString | name() const |
| QBluetoothUuid::DescriptorType | type() const |
| QBluetoothUuid | uuid() const |
| QByteArray | value() const |
| QLowEnergyDescriptor & | operator=(const QLowEnergyDescriptor &other) |
Elementos no miembros relacionados
| bool | operator!=(const QLowEnergyDescriptor &a, const QLowEnergyDescriptor &b) |
| bool | operator==(const QLowEnergyDescriptor &a, const QLowEnergyDescriptor &b) |
Descripción detallada
QLowEnergyDescriptor proporciona información sobre los métodos name(), uuid() y value() de un descriptor de Bluetooth Low Energy. Los descriptores están encapsulados por características de Bluetooth Low Energy y proporcionan información contextual adicional sobre la característica (formato de datos, activación de notificaciones, etc.).
El valor del descriptor puede escribirse a través de la instancia QLowEnergyService que gestiona el servicio al que pertenece este descriptor. La función QLowEnergyService::writeDescriptor() escribe el nuevo valor. La señal QLowEnergyService::descriptorWritten() se emite cuando la operación se realiza con éxito. El value() almacenado en caché de este objeto se actualiza en consecuencia.
Véase también QLowEnergyService y QLowEnergyCharacteristic.
Documentación de las funciones miembro
QLowEnergyDescriptor::QLowEnergyDescriptor()
Crea un nuevo objeto de clase `QLowEnergyDescriptor`. Una instancia de esta clase creada mediante el constructor por defecto siempre es inválida.
QLowEnergyDescriptor::QLowEnergyDescriptor(const QLowEnergyDescriptor &other)
Crea un nuevo QLowEnergyDescriptor que sea una copia de other.
Las dos copias siguen compartiendo los mismos datos subyacentes, que no se separan al escribir.
[noexcept] QLowEnergyDescriptor::~QLowEnergyDescriptor()
Elimina el objeto « QLowEnergyDescriptor ».
bool QLowEnergyDescriptor::isValid() const
Devuelve ` true ` si el objeto ` QLowEnergyDescriptor ` es válido; en caso contrario, devuelve ` false`.
Una instancia de descriptor no válida no está asociada a ningún servicio (construida por defecto) o el servicio asociado ya no es válido debido, por ejemplo, a una desconexión del dispositivo Bluetooth Low Energy subyacente. Una vez que el objeto deja de ser válido, ya no puede volver a serlo.
Nota: Si una instancia de ` QLowEnergyDescriptor ` deja de ser válida debido a una desconexión del dispositivo subyacente, la información encapsulada por la instancia actual permanece tal y como estaba en el momento de la desconexión. Por lo tanto, puede recuperarse tras el evento de desconexión.
QString QLowEnergyDescriptor::name() const
Devuelve el nombre legible para el usuario del descriptor.
El nombre se basa en la función type() del descriptor. La lista completa de tipos de descriptores se puede consultar en Bluetooth.org Descriptors.
La cadena devuelta estará vacía si se desconoce el valor de ` type()`.
Véanse también « type()» y « QBluetoothUuid::descriptorToString()».
QBluetoothUuid::DescriptorType QLowEnergyDescriptor::type() const
Devuelve el tipo del descriptor.
Véase también name().
QBluetoothUuid QLowEnergyDescriptor::uuid() const
Devuelve el UUID de este descriptor si ` isValid()` devuelve ` true`; en caso contrario, devuelve el UUID de ` null `.
QByteArray QLowEnergyDescriptor::value() const
Devuelve el valor almacenado en caché del descriptor.
El valor del descriptor almacenado en caché se puede actualizar mediante QLowEnergyService::writeDescriptor() o QLowEnergyService::readDescriptor().
QLowEnergyDescriptor &QLowEnergyDescriptor::operator=(const QLowEnergyDescriptor &other)
Crea una copia de other y la asigna a este objeto QLowEnergyDescriptor. Las dos copias siguen compartiendo los mismos datos de servicio y controlador.
Elementos relacionados que no son miembros
bool operator!=(const QLowEnergyDescriptor &a, const QLowEnergyDescriptor &b)
Devuelve ` true ` si ` a ` no es igual a ` b`; en caso contrario, devuelve ` false`.
Se considera que dos instancias de ` QLowEnergyDescriptor ` son iguales si hacen referencia al mismo descriptor en el mismo dispositivo Bluetooth Low Energy remoto o si ambas instancias se han construido de forma predeterminada.
bool operator==(const QLowEnergyDescriptor &a, const QLowEnergyDescriptor &b)
Devuelve ` true ` si ` a ` es igual a ` b`; en caso contrario, devuelve ` false`.
Se considera que dos instancias de ` QLowEnergyDescriptor ` son iguales si hacen referencia al mismo descriptor en el mismo dispositivo Bluetooth Low Energy remoto o si ambas instancias se han construido de forma predeterminada.
© 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.