QLowEnergyAdvertisingParameters Class
The QLowEnergyAdvertisingParameters class represents the parameters used for Bluetooth Low Energy advertising. More...
| Header: | #include <QLowEnergyAdvertisingParameters> |
| qmake: | QT += bluetooth |
| Since: | Qt 5.7 |
This class was introduced in Qt 5.7.
Public Types
| struct | AddressInfo |
| enum | FilterPolicy { IgnoreWhiteList, UseWhiteListForScanning, UseWhiteListForConnecting, UseWhiteListForScanningAndConnecting } |
| enum | Mode { AdvInd, AdvScanInd, AdvNonConnInd } |
Detailed Description
When running the advertising procedure, a number of parameters can be configured, such as how fast to advertise or which clients, if any, can connect to the advertising device. These parameters are set via this class, and their values will be used when advertising is started by calling QLowEnergyController::startAdvertising().
See also QLowEnergyAdvertisingData and QLowEnergyController::startAdvertising().
Member Type Documentation
enum QLowEnergyAdvertisingParameters::FilterPolicy
Specifies the semantics of the white list.
| Constant | Value | Description |
|---|---|---|
QLowEnergyAdvertisingParameters::IgnoreWhiteList | 0x00 | The value of the white list is ignored, that is, no filtering takes place for either scan or connection requests when using undirected advertising. |
QLowEnergyAdvertisingParameters::UseWhiteListForScanning | 0x01 | The white list is used when handling scan requests, but is ignored for connection requests. |
QLowEnergyAdvertisingParameters::UseWhiteListForConnecting | 0x02 | The white list is used when handling connection requests, but is ignored for scan requests. |
QLowEnergyAdvertisingParameters::UseWhiteListForScanningAndConnecting | 0x03 | The white list is used for both connection and scan requests. |
See also QLowEnergyAdvertisingParameters::whiteList().
enum QLowEnergyAdvertisingParameters::Mode
Specifies in which way to advertise.
| Constant | Value | Description |
|---|---|---|
QLowEnergyAdvertisingParameters::AdvInd | 0x0 | For non-directed, connectable advertising. Advertising is not directed to one specific device and a device seeing the advertisement can connect to the advertising device or send scan requests. |
QLowEnergyAdvertisingParameters::AdvScanInd | 0x2 | For non-directed, scannable advertising. Advertising is not directed to one specific device and a device seeing the advertisement can send a scan request to the advertising device, but cannot connect to it. |
QLowEnergyAdvertisingParameters::AdvNonConnInd | 0x3 | For non-directed, non-connectable advertising. Advertising is not directed to one specific device. A device seeing the advertisement cannot connect to the advertising device, nor can it send a scan request. This mode thus implies pure broadcasting. |