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