En esta página

QLowEnergyConnectionParameters Class

La clase `QLowEnergyConnectionParameters` se utiliza para solicitar o notificar una actualización de los parámetros de una conexión Bluetooth LE. Más información...

Cabecera: #include <QLowEnergyConnectionParameters>
CMake: find_package(Qt6 REQUIRED COMPONENTS Bluetooth)
target_link_libraries(mytarget PRIVATE Qt6::Bluetooth)
qmake: QT += bluetooth

Funciones públicas

QLowEnergyConnectionParameters()
QLowEnergyConnectionParameters(const QLowEnergyConnectionParameters &other)
~QLowEnergyConnectionParameters()
int latency() const
double maximumInterval() const
double minimumInterval() const
void setIntervalRange(double minimum, double maximum)
void setLatency(int latency)
void setSupervisionTimeout(int timeout)
int supervisionTimeout() const
void swap(QLowEnergyConnectionParameters &other)
QLowEnergyConnectionParameters &operator=(const QLowEnergyConnectionParameters &other)
bool operator!=(const QLowEnergyConnectionParameters &p1, const QLowEnergyConnectionParameters &p2)
bool operator==(const QLowEnergyConnectionParameters &p1, const QLowEnergyConnectionParameters &p2)

Descripción detallada

Los parámetros de conexión influyen en la frecuencia con la que un dispositivo maestro y uno esclavo se sincronizan entre sí. En general, un intervalo de conexión y una latencia más bajos implican una comunicación más rápida, pero también un mayor consumo de energía. La forma en que deben sopesarse estos criterios depende en gran medida del caso de uso concreto.

Android solo permite ajustar este conjunto de parámetros de forma indirecta. La plataforma divide los parámetros de conexión en tres categorías (prioridad alta, baja y equilibrada). Cada categoría implica un conjunto predefinido de valores para minimumInterval(), maximumInterval() y latency(). Además, los rangos de valores de cada categoría pueden variar de un dispositivo Android a otro. Qt utiliza la función ` minimumInterval()` para determinar la categoría de destino de la siguiente manera:

minimumInterval()Prioridad de Android
intervalo < 30CONNECTION_PRIORITY_HIGH
30 <= intervalo <= 100CONNECTION_PRIORITY_BALANCED
intervalo > 100CONNECTION_PRIORITY_LOW_POWER

supervisionTimeout() no se puede modificar en Android, por lo que se ignora.

Véase también QLowEnergyController::requestConnectionUpdate y QLowEnergyController::connectionUpdated.

Documentación de funciones de miembro

QLowEnergyConnectionParameters::QLowEnergyConnectionParameters()

Crea un nuevo objeto de esta clase. Todos los valores se inicializan con los valores por defecto válidos.

QLowEnergyConnectionParameters::QLowEnergyConnectionParameters(const QLowEnergyConnectionParameters &other)

Crea un nuevo objeto de esta clase que es una copia de other.

[noexcept] QLowEnergyConnectionParameters::~QLowEnergyConnectionParameters()

Destruye este objeto.

int QLowEnergyConnectionParameters::latency() const

Devuelve la latencia del esclavo de la conexión.

Véase también setLatency().

double QLowEnergyConnectionParameters::maximumInterval() const

Devuelve el intervalo máximo de conexión en milisegundos. El valor por defecto es 4000.

Nota: Si este objeto se ha generado mediante QLowEnergyController::connectionUpdated(), este valor es el mismo que el de minimumInterval() y hace referencia al intervalo de conexión real.

Véase también setIntervalRange().

double QLowEnergyConnectionParameters::minimumInterval() const

Devuelve el intervalo mínimo de conexión en milisegundos. El valor por defecto es 7,5.

Nota: Si este objeto se ha generado mediante QLowEnergyController::connectionUpdated(), este valor es el mismo que el de maximumInterval() y hace referencia al intervalo de conexión real.

Véase también setIntervalRange().

void QLowEnergyConnectionParameters::setIntervalRange(double minimum, double maximum)

Establece el intervalo en el que debe situarse el intervalo de conexión. El valor real lo determinará el controlador. Tanto minimum como maximum se expresan en milisegundos. Si maximum es menor que minimum, se establecerá en el valor de minimum. El intervalo de conexión mínimo posible es de 7,5 milisegundos, y el máximo, de 4000 milisegundos.

Véase también minimumInterval() y maximumInterval().

void QLowEnergyConnectionParameters::setLatency(int latency)

Establece la latencia del esclavo de la conexión (es decir, el número de eventos de conexión que un dispositivo esclavo puede ignorar) en latency. El valor mínimo es 0 y el máximo, 499.

Véase también latency().

void QLowEnergyConnectionParameters::setSupervisionTimeout(int timeout)

Establece el tiempo de espera de supervisión del enlace en timeout milisegundos. Este valor está sujeto a varias restricciones: debe estar comprendido en el intervalo [100, 32 000] y debe ser mayor que (1 + latency()) * 2 * maximumInterval().

En Android, este tiempo de espera no se puede ajustar y, por lo tanto, se ignora.

Véase también supervisionTimeout().

int QLowEnergyConnectionParameters::supervisionTimeout() const

Devuelve el tiempo de espera de supervisión del enlace de la conexión en milisegundos.

Véase también ` setSupervisionTimeout()`.

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

Intercambia este objeto por other.

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

Convierte este objeto en una copia de ` other ` y devuelve el nuevo valor de este objeto.

Elementos no miembros relacionados

bool operator!=(const QLowEnergyConnectionParameters &p1, const QLowEnergyConnectionParameters &p2)

Devuelve « true » si « p1 » y « p2 » no son iguales en cuanto a su estado público; en caso contrario, devuelve « false ».

bool operator==(const QLowEnergyConnectionParameters &p1, const QLowEnergyConnectionParameters &p2)

Devuelve « true » si « p1 » y « p2 » son iguales en cuanto a su estado público; en caso contrario, devuelve « 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.