Класс QLowEnergyAdvertisingParameters
Класс QLowEnergyAdvertisingParameters представляет параметры, используемые для рекламы Bluetooth Low Energy. Подробнее...
| Заголовок: | #include <QLowEnergyAdvertisingParameters> |
| qmake: | QT += bluetooth |
| С момента: | Qt 5.7 |
Типы публичного доступа
| класс | AddressInfo |
| перечисление | FilterPolicy { IgnoreWhiteList, UseWhiteListForScanning, UseWhiteListForConnecting, UseWhiteListForScanningAndConnecting } |
| перечисление | Mode { AdvInd, AdvScanInd, AdvNonConnInd } |
Функции публичного доступа
| QLowEnergyAdvertisingParameters(const QLowEnergyAdvertisingParameters &other) | |
| QLowEnergyAdvertisingParameters() | |
| QLowEnergyAdvertisingParameters & | operator=(const QLowEnergyAdvertisingParameters &other) |
| ~QLowEnergyAdvertisingParameters() | |
| QLowEnergyAdvertisingParameters::FilterPolicy | filterPolicy() const |
| int | maximumInterval() const |
| int | minimumInterval() const |
| QLowEnergyAdvertisingParameters::Mode | mode() const |
| void | setInterval(quint16 minimum, quint16 maximum) |
| void | setMode(QLowEnergyAdvertisingParameters::Mode mode) |
| void | setWhiteList(const QList<QLowEnergyAdvertisingParameters::AddressInfo> &whiteList, QLowEnergyAdvertisingParameters::FilterPolicy policy) |
| void | swap(QLowEnergyAdvertisingParameters &other) |
| QList<QLowEnergyAdvertisingParameters::AddressInfo> | whiteList() const |
Связанные нечлены
| bool | operator!=(const QLowEnergyAdvertisingParameters &a, const QLowEnergyAdvertisingParameters &b) |
| bool | operator==(const QLowEnergyAdvertisingParameters &a, const QLowEnergyAdvertisingParameters &b) |
Подробное описание
При выполнении процедуры рекламы можно настроить ряд параметров, таких как скорость рекламы или список клиентов, которые могут подключиться к рекламируемому устройству. Эти параметры устанавливаются с помощью этого класса, и их значения будут использоваться при запуске рекламы вызовом QLowEnergyController::startAdvertising().
См. также QLowEnergyAdvertisingData и QLowEnergyController::startAdvertising().
Документация по типам членов
перечисление QLowEnergyAdvertisingParameters::FilterPolicy
Указывает семантику белого списка.
| Константа | Значение | Описание |
|---|---|---|
QLowEnergyAdvertisingParameters::IgnoreWhiteList |
0x00 |
Значение белого списка игнорируется, то есть никакой фильтрации не происходит ни для запросов сканирования, ни для запросов соединения при использовании нецелевого режима рекламы. |
QLowEnergyAdvertisingParameters::UseWhiteListForScanning |
0x01 |
Белый список используется при обработке запросов сканирования, но игнорируется при обработке запросов соединения. |
QLowEnergyAdvertisingParameters::UseWhiteListForConnecting |
0x02 |
Белый список используется при обработке запросов соединения, но игнорируется при обработке запросов сканирования. |
QLowEnergyAdvertisingParameters::UseWhiteListForScanningAndConnecting |
0x03 |
Белый список используется как для запросов соединения, так и для запросов сканирования. |
См. также QLowEnergyAdvertisingParameters::whiteList().
перечисление QLowEnergyAdvertisingParameters::Mode
Указывает способ рекламы.
| Константа | Значение | Описание |
|---|---|---|
QLowEnergyAdvertisingParameters::AdvInd |
0x0 |
Для нецелевой, подключаемой рекламы. Реклама не направлена на конкретное устройство, и устройство, увидевшее рекламу, может подключиться к рекламируемому устройству или отправить запрос на сканирование. |
QLowEnergyAdvertisingParameters::AdvScanInd |
0x2 |
Для нецелевой, сканируемой рекламы. Реклама не направлена на конкретное устройство, и устройство, увидевшее рекламу, может отправить запрос на сканирование рекламируемого устройства, но не может подключиться к нему. |
QLowEnergyAdvertisingParameters::AdvNonConnInd |
0x3 |
Для нецелевой, неподключаемой рекламы. Реклама не направлена на конкретное устройство. Устройство, увидевшее рекламу, не может подключиться к рекламируемому устройству и не может отправить запрос на сканирование. Этот режим подразумевает чистое вещание. |
Документация по функциям членов
QLowEnergyAdvertisingParameters::QLowEnergyAdvertisingParameters(const QLowEnergyAdvertisingParameters &other)
Создает новый объект этого класса, являющийся копией other.
QLowEnergyAdvertisingParameters::QLowEnergyAdvertisingParameters()
Создает новый объект этого класса. Все значения инициализируются значениями по умолчанию согласно спецификации Bluetooth Low Energy.
QLowEnergyAdvertisingParameters &QLowEnergyAdvertisingParameters::operator=(const QLowEnergyAdvertisingParameters &other)
Делает этот объект копией other и возвращает новое значение этого объекта.
QLowEnergyAdvertisingParameters::~QLowEnergyAdvertisingParameters()
Уничтожает этот объект.
QLowEnergyAdvertisingParameters::FilterPolicy QLowEnergyAdvertisingParameters::filterPolicy() const
Возвращает политику фильтрации, которая определяет, как используется белый список. По умолчанию используется QLowEnergyAdvertisingParameters::IgnoreWhiteList.
int QLowEnergyAdvertisingParameters::maximumInterval() const
Возвращает максимальный интервал рекламы в миллисекундах. По умолчанию значение равно 1280.
int QLowEnergyAdvertisingParameters::minimumInterval() const
Возвращает минимальный интервал рекламы в миллисекундах. По умолчанию значение равно 1280.
QLowEnergyAdvertisingParameters::Mode QLowEnergyAdvertisingParameters::mode() const
Возвращает режим рекламы. По умолчанию используется QLowEnergyAdvertisingParameters::AdvInd.
См. также setMode().
void QLowEnergyAdvertisingParameters::setInterval(quint16 minimum, quint16 maximum)
Устанавливает интервал обмена данными. Это диапазон, определяющий верхнюю и нижнюю границы частоты отправки данных обмена. minimum и maximum задаются в миллисекундах. Если maximum меньше minimum, он будет установлен в значение minimum.
Примечание: Существуют ограничения для минимального и максимального интервала; точные значения зависят от режима. Если они превышены, будет использовано соответственно минимально возможное или максимальное значение.
void QLowEnergyAdvertisingParameters::setMode(QLowEnergyAdvertisingParameters::Mode mode)
Устанавливает режим обмена данными в mode.
См. также mode().
void QLowEnergyAdvertisingParameters::setWhiteList(const QList<QLowEnergyAdvertisingParameters::AddressInfo> &whiteList, QLowEnergyAdvertisingParameters::FilterPolicy policy)
Устанавливает белый список, потенциально используемый для фильтрации запросов сканирования и подключения. Параметр whiteList — список адресов для фильтрации, а policy определяет, как именно использовать whiteList.
См. также whiteList().
void QLowEnergyAdvertisingParameters::swap(QLowEnergyAdvertisingParameters &other)
Меняет местами этот объект с other.
QList<QLowEnergyAdvertisingParameters::AddressInfo> QLowEnergyAdvertisingParameters::whiteList() const
Возвращает белый список, используемый для фильтрации запросов сканирования и подключения. По умолчанию этот список пуст.
См. также setWhiteList().
Связанные нечлены
bool operator!=(const QLowEnergyAdvertisingParameters &a, const QLowEnergyAdvertisingParameters &b)
Возвращает true если a и b не равны по общедоступному состоянию, в противном случае возвращает false.
bool operator==(const QLowEnergyAdvertisingParameters &a, const QLowEnergyAdvertisingParameters &b)
Возвращает true если a и b равны по общедоступному состоянию, в противном случае возвращает false.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qlowenergyadvertisingparameters.html
