QLowEnergyCharacteristic Class

Documentación de las funciones miembro

QLowEnergyCharacteristic::QLowEnergyCharacteristic()

Construye un nuevo QLowEnergyCharacteristic. Una instancia de esta clase construida por defecto siempre es inválida.

Véase también isValid().

QLowEnergyCharacteristic::QLowEnergyCharacteristic(const QLowEnergyCharacteristic &other)

Construye una nueva QLowEnergyCharacteristic que es una copia de other.

Las dos copias siguen compartiendo los mismos datos subyacentes que no se separan al escribir.

[noexcept] QLowEnergyCharacteristic::~QLowEnergyCharacteristic()

Destruye el objeto QLowEnergyCharacteristic.

[since 6.2] QLowEnergyDescriptor QLowEnergyCharacteristic::clientCharacteristicConfiguration() const

Devuelve el Descriptor de Configuración de Características del Cliente o una instancia no válida de QLowEnergyDescriptor si no existe ningún Descriptor de Configuración de Características del Cliente.

Las características BTLE pueden admitir notificaciones y/o indicaciones. En ambos casos, el periférico informará a la central sobre cada cambio del valor de la característica. En el protocolo de atributos BTLE, los mensajes de notificación no son confirmados por la central, mientras que las indicaciones sí lo son. Las notificaciones se consideran más rápidas, pero poco fiables, mientras que las indicaciones son más lentas y fiables.

Si una característica admite notificaciones o indicaciones, éstas pueden habilitarse escribiendo patrones de bits especiales en el Descriptor de configuración de características del cliente. Para mayor comodidad, estos patrones de bits se proporcionan como QLowEnergyCharacteristic::CCCDDisable, QLowEnergyCharacteristic::CCCDEnableNotification, y QLowEnergyCharacteristic::CCCDEnableIndication.

La activación, por ejemplo, de la notificación de una característica denominada mycharacteristic en un servicio denominado myservice podría realizarse mediante el siguiente código.

auto cccd = mycharacteristic.clientCharacteristicConfiguration();
if (!cccd.isValid()) {
    // your error handling
    return error;
}
myservice->writeDescriptor(cccd, QLowEnergyCharacteristic::CCCDEnableNotification);

Esta función se introdujo en Qt 6.2.

Véase también descriptor().

QLowEnergyDescriptor QLowEnergyCharacteristic::descriptor(const QBluetoothUuid &uuid) const

Devuelve el descriptor de uuid o una instancia no válida de QLowEnergyDescriptor.

Véase también descriptors().

QList<QLowEnergyDescriptor> QLowEnergyCharacteristic::descriptors() const

Devuelve la lista de descriptores pertenecientes a esta característica; en caso contrario, una lista vacía.

Véase también descriptor().

bool QLowEnergyCharacteristic::isValid() const

Devuelve true si el objeto QLowEnergyCharacteristic es válido, en caso contrario devuelve false.

Un objeto característico no válido no está asociado a ningún servicio (construido por defecto) o el servicio asociado ya no es válido debido a una desconexión del dispositivo Bluetooth Low Energy subyacente, por ejemplo. Una vez que el objeto es inválido, ya no puede volver a ser válido.

QString QLowEnergyCharacteristic::name() const

Devuelve el nombre legible de la característica.

El nombre se basa en la dirección uuid() de la característica, que debe haber sido normalizada. La lista completa de tipos de características se encuentra en Bluetooth.org Characteristics.

La cadena devuelta está vacía si uuid() es desconocida.

Véase también QBluetoothUuid::characteristicToString().

QLowEnergyCharacteristic::PropertyTypes QLowEnergyCharacteristic::properties() const

Devuelve las propiedades de la característica.

Las propiedades definen los permisos de acceso para la característica.

QBluetoothUuid QLowEnergyCharacteristic::uuid() const

Devuelve el UUID de la característica si isValid() devuelve true; en caso contrario un UUID null.

QByteArray QLowEnergyCharacteristic::value() const

Devuelve el valor almacenado en caché de la característica.

Si properties() de la característica permite escribir nuevos valores, el valor puede actualizarse mediante QLowEnergyService::writeCharacteristic().

La caché se actualiza durante el servicio asociado detail discovery, una operación read/write realizada con éxito o cuando se recibe una notificación de actualización.

El QByteArray devuelto siempre permanece vacío si la característica no tiene el read permission. En tales casos, sólo el QLowEnergyService::characteristicChanged() o el QLowEnergyService::characteristicWritten() pueden proporcionar información sobre el valor de esta característica.

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

Hace una copia de other y la asigna a este objeto QLowEnergyCharacteristic. Las dos copias siguen compartiendo los mismos detalles de servicio y controlador.