Класс QLowEnergyAdvertisingData
Класс QLowEnergyAdvertisingData представляет данные, которые будут транслироваться во время рекламы Bluetooth Low Energy. Подробнее...
| Заголовок: | #include <QLowEnergyAdvertisingData> |
| qmake: | QT += bluetooth |
| С момента: | Qt 5.7 |
Типы публичного доступа
| Перечисление | Discoverability { DiscoverabilityNone, DiscoverabilityLimited, DiscoverabilityGeneral } |
Функции публичного доступа
| QLowEnergyAdvertisingData(const QLowEnergyAdvertisingData &other) | |
| QLowEnergyAdvertisingData() | |
| QLowEnergyAdvertisingData & | operator=(const QLowEnergyAdvertisingData &other) |
| ~QLowEnergyAdvertisingData() | |
| QLowEnergyAdvertisingData::Discoverability | discoverability() const |
| bool | includePowerLevel() const |
| QString | localName() const |
| QByteArray | manufacturerData() const |
| quint16 | manufacturerId() const |
| QByteArray | rawData() const |
| QList<QBluetoothUuid> | services() const |
| void | setDiscoverability(QLowEnergyAdvertisingData::Discoverability mode) |
| void | setIncludePowerLevel(bool doInclude) |
| void | setLocalName(const QString &name) |
| void | setManufacturerData(quint16 id, const QByteArray &data) |
| void | setRawData(const QByteArray &data) |
| void | setServices(const QList<QBluetoothUuid> &services) |
| void | swap(QLowEnergyAdvertisingData &other) |
Статические публичные члены
| quint16 | invalidManufacturerId() |
Связанные нечлены
| bool | operator!=(const QLowEnergyAdvertisingData &data1, const QLowEnergyAdvertisingData &data2) |
| bool | operator==(const QLowEnergyAdvertisingData &data1, const QLowEnergyAdvertisingData &data2) |
Подробное описание
Эти данные могут включать имя устройства, предлагаемые устройством службы GATT и так далее. Набор данных через этот класс будет использоваться при запуске рекламы вызовом QLowEnergyController::startAdvertising(). Объекты этого класса могут представлять пакет данных рекламы или пакет ответа на сканирование.
Примечание: Фактические пакеты данных, отправляемые по каналу рекламы, не могут содержать более 31 байта. Если набор данных переменной длины, установленный через этот класс, превышает этот предел, он будет исключен из пакета или усечен в зависимости от типа.
См. также QLowEnergyAdvertisingParameters и QLowEnergyController::startAdvertising().
Документация по типу членов
Перечисление QLowEnergyAdvertisingData::Discoverability
Уровень обнаружения рекламируемого устройства, определённый профилем общего доступа.
| Постоянная | Значение | Описание |
|---|---|---|
QLowEnergyAdvertisingData::DiscoverabilityNone |
0 |
Рекламируемое устройство не желает быть обнаруживаемым сканирующими устройствами. |
QLowEnergyAdvertisingData::DiscoverabilityLimited |
1 |
Рекламируемое устройство желает быть обнаруживаемым с высоким приоритетом. Обратите внимание, что этот режим несовместим с использованием белого списка. Значение QLowEnergyAdvertisingParameters::filterPolicy() всегда предполагается равным QLowEnergyAdvertisingParameters::IgnoreWhiteList, когда используется ограниченное обнаружение. |
QLowEnergyAdvertisingData::DiscoverabilityGeneral |
2 |
Рекламируемое устройство желает быть обнаруживаемым сканирующими устройствами. |
Документация по функциям-членам
QLowEnergyAdvertisingData::QLowEnergyAdvertisingData(const QLowEnergyAdvertisingData &other)
Создаёт новый объект этого класса, являющийся копией other.
QLowEnergyAdvertisingData::QLowEnergyAdvertisingData()
Создаёт новый объект этого класса. Все значения инициализированы значениями по умолчанию в соответствии со спецификацией Bluetooth Low Energy.
QLowEnergyAdvertisingData &QLowEnergyAdvertisingData::operator=(const QLowEnergyAdvertisingData &other)
Преобразует текущий объект в копию other и возвращает новое значение этого объекта.
QLowEnergyAdvertisingData::~QLowEnergyAdvertisingData()
Удаляет этот объект.
QLowEnergyAdvertisingData::Discoverability QLowEnergyAdvertisingData::discoverability() const
Возвращает режим обнаружения рекламируемого устройства. По умолчанию — DiscoverabilityNone.
См. также setDiscoverability().
bool QLowEnergyAdvertisingData::includePowerLevel() const
Возвращает, следует ли включать уровень мощности передачи устройства в данные рекламы. По умолчанию — false.
См. также setIncludePowerLevel().
[static] quint16 QLowEnergyAdvertisingData::invalidManufacturerId()
Возвращает недопустимый идентификатор производителя. Если это значение установлено как идентификатор производителя (что и является значением по умолчанию), данные производителя не будут присутствовать в данных рекламы.
QString QLowEnergyAdvertisingData::localName() const
Возвращает имя локального устройства, которое будет рекламироваться.
См. также setLocalName().
QByteArray QLowEnergyAdvertisingData::manufacturerData() const
Возвращает данные производителя. По умолчанию — пустой массив байтов.
См. также setManufacturerData().
quint16 QLowEnergyAdvertisingData::manufacturerId() const
Возвращает идентификатор производителя. По умолчанию используется QLowEnergyAdvertisingData::invalidManufacturerId(), что означает, что данные не будут рекламироваться.
QByteArray QLowEnergyAdvertisingData::rawData() const
Возвращает предоставленные пользователем исходные данные для рекламы. По умолчанию — пустой массив байтов.
См. также setRawData().
QList<QBluetoothUuid> QLowEnergyAdvertisingData::services() const
Возвращает список UUID служб для рекламы. По умолчанию этот список пуст.
См. также setServices().
void QLowEnergyAdvertisingData::setDiscoverability(QLowEnergyAdvertisingData::Discoverability mode)
Устанавливает тип обнаружимости рекламируемого устройства на mode.
Примечание: Информация об обнаружимости может отображаться только в реальном пакете рекламных данных. Если этот объект действует как данные ответа на сканирование, вызов этой функции не повлияет на отправляемый ответ на сканирование.
См. также discoverability().
void QLowEnergyAdvertisingData::setIncludePowerLevel(bool doInclude)
Указывает, следует ли включать уровень мощности передачи устройства в рекламные данные. Если doInclude равно true, данные будут включены, в противном случае — нет.
См. также includePowerLevel().
void QLowEnergyAdvertisingData::setLocalName(const QString &name)
Указывает, что name должно транслироваться как имя устройства. Если полное имя не помещается в пакет рекламных данных, отправляется сокращенное имя, как описано в спецификации Bluetooth Low Energy.
В Android имя устройства нельзя изменить. Android всегда использует имя устройства. Если это имя не пустое, Android-реализация включает имя устройства в пакет рекламы; в противном случае имя устройства исключается из пакета рекламы.
См. также localName().
void QLowEnergyAdvertisingData::setManufacturerData(quint16 id, const QByteArray &data)
Устанавливает идентификатор и данные производителя. Параметр id — это идентификатор компании, назначенный Bluetooth SIG. Параметр data — произвольное значение.
См. также manufacturerData().
void QLowEnergyAdvertisingData::setRawData(const QByteArray &data)
Устанавливает данные для рекламы на data. Если значение не пустой массив байтов, оно будет отправлено как есть в качестве рекламных данных, и все другие данные в этом объекте будут проигнорированы. Это можно использовать для отправки нестандартных данных.
Примечание: Если data длиннее 31 байта, оно будет усечено. Ответственность за правильность data лежит на вызывающей стороне.
См. также rawData().
void QLowEnergyAdvertisingData::setServices(const QList<QBluetoothUuid> &services)
Указывает, что UUID служб в services должны рекламироваться. Если весь список не помещается в пакет, отправляется неполный список, как указано в спецификации Bluetooth Low Energy.
См. также services().
void QLowEnergyAdvertisingData::swap(QLowEnergyAdvertisingData &other)
Меняет местами этот объект с other.
Связанные нечленные функции
bool operator!=(const QLowEnergyAdvertisingData &data1, const QLowEnergyAdvertisingData &data2)
Возвращает true если data1 и data2 не равны по отношению к своему общедоступному состоянию, в противном случае возвращает false.
bool operator==(const QLowEnergyAdvertisingData &data1, const QLowEnergyAdvertisingData &data2)
Возвращает true если data1 и data2 равны по отношению к своему общедоступному состоянию, в противном случае возвращает false.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qlowenergyadvertisingdata.html
