QLowEnergyConnectionParameters Class
La clase QLowEnergyConnectionParameters se utiliza cuando se solicita o informa de una actualización de los parámetros de una conexión Bluetooth LE. Más...
| Cabecera: | #include <QLowEnergyConnectionParameters> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Bluetooth)target_link_libraries(mytarget PRIVATE Qt6::Bluetooth) |
| qmake: | QT += bluetooth |
- Lista de todos los miembros, incluyendo los heredados
- QLowEnergyConnectionParameters es parte de Implicitly Shared Classes.
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) |
No miembros relacionados
| 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 menores implican una comunicación más rápida, pero también un mayor consumo de energía. La forma de sopesar estos criterios depende en gran medida del caso de uso concreto.
Android sólo permite ajustar este conjunto de parámetros de forma indirecta. La plataforma separa 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 minimumInterval() para determinar la categoría de destino de la siguiente manera:
| minimumInterval() | Prioridad Android |
|---|---|
| intervalo < 30 | PRIORIDAD_DE_CONEXIÓN_ALTA |
| 30 <= intervalo <= 100 | PRIORIDAD_DE_CONEXIÓN_EQUILIBRADA |
| intervalo > 100 | CONNECTION_PRIORITY_LOW_POWER |
El supervisionTimeout() no se puede cambiar en Android y por lo tanto se ignora.
Véase también QLowEnergyController::requestConnectionUpdate y QLowEnergyController::connectionUpdated.
Documentación de las funciones miembro
QLowEnergyConnectionParameters::QLowEnergyConnectionParameters()
Construye un nuevo objeto de esta clase. Todos los valores se inicializan a los valores predeterminados válidos.
QLowEnergyConnectionParameters::QLowEnergyConnectionParameters(const QLowEnergyConnectionParameters &other)
Construye 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 esclava 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 fue emitido a través de QLowEnergyController::connectionUpdated(), entonces este valor es el mismo que minimumInterval() y se refiere 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 fue emitido a través de QLowEnergyController::connectionUpdated(), entonces este valor es el mismo que maximumInterval() y se refiere al intervalo de conexión real.
Véase también setIntervalRange().
void QLowEnergyConnectionParameters::setIntervalRange(double minimum, double maximum)
Establece el rango en el que debe estar el intervalo de conexión. El valor real lo decidirá el controlador. Tanto minimum como maximum se indican en milisegundos. Si maximum es menor que minimum, se establecerá el valor de minimum. El menor intervalo de conexión posible es de 7,5 milisegundos, el mayor es de 4000 milisegundos.
Véase también minimumInterval() y maximumInterval().
void QLowEnergyConnectionParameters::setLatency(int latency)
Establece la latencia esclava 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, el máximo es 499.
Véase también latency().
void QLowEnergyConnectionParameters::setSupervisionTimeout(int timeout)
Establece el tiempo de espera de supervisión del enlace en timeout milisegundos. Existen varias restricciones para este valor: Debe estar en el rango [100,32000] y debe ser mayor que (1 + latency()) * 2 * maximumInterval().
En Android, este tiempo de espera no es ajustable y por lo tanto se ignora.
Véase también supervisionTimeout().
int QLowEnergyConnectionParameters::supervisionTimeout() const
Devuelve el tiempo de espera de supervisión de enlace de la conexión en milisegundos.
Véase también setSupervisionTimeout().
[noexcept] void QLowEnergyConnectionParameters::swap(QLowEnergyConnectionParameters &other)
Intercambia este objeto con other.
QLowEnergyConnectionParameters &QLowEnergyConnectionParameters::operator=(const QLowEnergyConnectionParameters &other)
Hace de este objeto una copia de other y devuelve el nuevo valor de este objeto.
No miembros relacionados
bool operator!=(const QLowEnergyConnectionParameters &p1, const QLowEnergyConnectionParameters &p2)
Devuelve true si p1 y p2 no son iguales con respecto 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 con respecto 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.
