Класс QLowEnergyConnectionParameters

Класс QLowEnergyConnectionParameters используется при запросе или сообщении об обновлении параметров подключения Bluetooth LE. Подробнее...

• Список всех членов, включая унаследованные

Открытые функции

Подробное описание

Класс QLowEnergyConnectionParameters используется при запросе или сообщении об обновлении параметров подключения Bluetooth LE.

Параметры подключения влияют на частоту синхронизации устройств-мастера и устройства-ведомого. В общем случае, меньший интервал подключения и задержка означают более быструю коммуникацию, но также и более высокое энергопотребление. Как эти критерии следует взвешивать друг против друга, сильно зависит от конкретного случая использования.

Android позволяет только косвенно изменять этот набор параметров. Платформа разделяет параметры подключения на три категории (высокий, низкий и сбалансированный приоритет). Каждая категория подразумевает предопределенный набор значений для minimumInterval(), maximumInterval() и latency(). Кроме того, диапазоны значений каждой категории могут различаться на разных устройствах Android. Qt использует minimumInterval() для определения целевой категории следующим образом:

supervisionTimeout() на Android не может быть изменен и поэтому игнорируется.

См. также QLowEnergyController::requestConnectionUpdate и QLowEnergyController::connectionUpdated.

Документация по функциям-членам

QLowEnergyConnectionParameters::QLowEnergyConnectionParameters()

Создает новый объект этого класса. Все значения инициализируются по умолчанию.

QLowEnergyConnectionParameters::QLowEnergyConnectionParameters(const QLowEnergyConnectionParameters &other)

Создает новый объект этого класса, являющийся копией other.

QLowEnergyConnectionParameters::~QLowEnergyConnectionParameters()

Уничтожает этот объект.

int QLowEnergyConnectionParameters::latency() const

Возвращает задержку устройства-ведомого подключения.

См. также setLatency().

double QLowEnergyConnectionParameters::maximumInterval() const

Возвращает максимальный интервал подключения в миллисекундах. Значение по умолчанию равно 4000.

Примечание: Если этот объект был выдан через QLowEnergyController::connectionUpdated(), то это значение совпадает со значением minimumInterval() и относится к фактическому интервалу подключения.

См. также setIntervalRange().

double QLowEnergyConnectionParameters::minimumInterval() const

Возвращает минимальный интервал подключения в миллисекундах. Значение по умолчанию равно 7.5.

Примечание: Если этот объект был выдан через QLowEnergyController::connectionUpdated(), то это значение совпадает со значением maximumInterval() и относится к фактическому интервалу подключения.

См. также setIntervalRange().

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

Устанавливает диапазон, в котором должен находиться интервал подключения. Фактическое значение будет определено контроллером. И minimum, и maximum задаются в миллисекундах. Если maximum меньше minimum, он будет установлен равным minimum. Наименьший возможный интервал подключения составляет 7.5 миллисекунд, а наибольший — 4000 миллисекунд.

См. также minimumInterval() и maximumInterval().

void QLowEnergyConnectionParameters::setLatency(int latency)

Устанавливает задержку устройства-ведомого подключения (т. е. количество событий подключения, которые устройство-ведомое может пропустить) на latency. Минимальное значение равно 0, максимальное — 499.

См. также latency().

void QLowEnergyConnectionParameters::setSupervisionTimeout(int timeout)

Устанавливает таймаут контроля соединения на timeout миллисекунд. Существуют некоторые ограничения на это значение: оно должно находиться в диапазоне [100,32000] и должно быть больше, чем (1 + latency()) * 2 * maximumInterval().

В Android этот таймаут не настраивается и поэтому игнорируется.

См. также supervisionTimeout().

int QLowEnergyConnectionParameters::supervisionTimeout() const

Возвращает таймаут контроля соединения подключения в миллисекундах.

См. также setSupervisionTimeout().

void QLowEnergyConnectionParameters::swap(QLowEnergyConnectionParameters &other)

Меняет местами этот объект и other.

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

Делает этот объект копией other и возвращает новое значение этого объекта.