QLowEnergyAdvertisingParameters Class
QLowEnergyAdvertisingParameters 클래스는 Bluetooth 저에너지 광고에 사용되는 매개 변수를 나타냅니다. 더 보기...
| Header: | #include <QLowEnergyAdvertisingParameters> |
| qmake: | QT += bluetooth |
- 상속된 멤버를 포함한 모든 멤버 목록
- QLowEnergyAdvertisingParameters는 암시적으로 공유되는 클래스의 일부입니다.
공용 유형
| class | AddressInfo |
| enum | FilterPolicy { IgnoreWhiteList, UseWhiteListForScanning, UseWhiteListForConnecting, UseWhiteListForScanningAndConnecting } |
| enum | Mode { AdvInd, AdvScanInd, AdvNonConnInd } |
공용 함수
| QLowEnergyAdvertisingParameters() | |
| QLowEnergyAdvertisingParameters(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 |
| QLowEnergyAdvertisingParameters & | operator=(const QLowEnergyAdvertisingParameters &other) |
관련 비회원
| bool | operator!=(const QLowEnergyAdvertisingParameters &a, const QLowEnergyAdvertisingParameters &b) |
| bool | operator==(const QLowEnergyAdvertisingParameters &a, const QLowEnergyAdvertisingParameters &b) |
상세 설명
광고 프로시저를 실행할 때 광고 속도 또는 광고 장치에 연결할 수 있는 클라이언트(있는 경우)와 같은 여러 파라미터를 구성할 수 있습니다. 이러한 매개변수는 이 클래스를 통해 설정되며, 해당 값은 QLowEnergyController::startAdvertising()를 호출하여 광고를 시작할 때 사용됩니다.
QLowEnergyAdvertisingData 및 QLowEnergyController::startAdvertising()도 참조하세요 .
멤버 유형 문서
enum QLowEnergyAdvertisingParameters::FilterPolicy
화이트리스트의 의미를 지정합니다.
| Constant | 값 | 설명 |
|---|---|---|
QLowEnergyAdvertisingParameters::IgnoreWhiteList | 0x00 | 화이트리스트의 값이 무시됩니다. 즉, 비지시적 광고를 사용할 때 스캔 또는 연결 요청에 대해 필터링이 수행되지 않습니다. |
QLowEnergyAdvertisingParameters::UseWhiteListForScanning | 0x01 | 화이트리스트는 스캔 요청을 처리할 때 사용되지만 연결 요청에는 무시됩니다. |
QLowEnergyAdvertisingParameters::UseWhiteListForConnecting | 0x02 | 화이트리스트는 연결 요청을 처리할 때는 사용되지만 스캔 요청에는 무시됩니다. |
QLowEnergyAdvertisingParameters::UseWhiteListForScanningAndConnecting | 0x03 | 화이트리스트는 연결 요청과 스캔 요청 모두에 사용됩니다. |
QLowEnergyAdvertisingParameters::whiteList()도 참조하세요 .
enum QLowEnergyAdvertisingParameters::Mode
광고할 방법을 지정합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QLowEnergyAdvertisingParameters::AdvInd | 0x0 | 비지시형, 연결형 광고의 경우. 광고가 특정 디바이스로 전달되지 않으며 광고를 보는 디바이스가 광고 디바이스에 연결하거나 스캔 요청을 보낼 수 있습니다. |
QLowEnergyAdvertisingParameters::AdvScanInd | 0x2 | 비방향성, 스캔 가능 광고의 경우. 광고가 특정 디바이스를 대상으로 하지 않으며 광고를 보는 디바이스가 광고 디바이스에 스캔 요청을 보낼 수는 있지만 연결할 수는 없습니다. |
QLowEnergyAdvertisingParameters::AdvNonConnInd | 0x3 | 비방향성, 비연결성 광고의 경우. 광고가 특정 디바이스로 전달되지 않습니다. 광고를 보는 디바이스는 광고 디바이스에 연결할 수 없으며 스캔 요청을 보낼 수도 없습니다. 따라서 이 모드는 순수 방송을 의미합니다. |
회원 기능 문서
QLowEnergyAdvertisingParameters::QLowEnergyAdvertisingParameters()
이 클래스의 새 객체를 생성합니다. 모든 값은 Bluetooth 저에너지 사양에 따라 기본값으로 초기화됩니다.
QLowEnergyAdvertisingParameters::QLowEnergyAdvertisingParameters(const QLowEnergyAdvertisingParameters &other)
other 의 복사본인 이 클래스의 새 객체를 생성합니다.
[noexcept] 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 의 값으로 설정됩니다.
참고: 최소 및 최대 간격에 대한 제한이 있으며 정확한 값은 모드에 따라 다릅니다. 이를 초과하면 각각 가능한 가장 낮은 값 또는 가장 높은 값이 사용됩니다.
광고 간격 설정은 이후 버전의 BlueZ에서 실험 상태로 변경되거나 실험 모드로 실행되는 경우 BlueZ DBus 백엔드에서 지원됩니다.
void QLowEnergyAdvertisingParameters::setMode(QLowEnergyAdvertisingParameters::Mode mode)
광고 모드를 mode 로 설정합니다.
mode()도 참조하세요 .
void QLowEnergyAdvertisingParameters::setWhiteList(const QList<QLowEnergyAdvertisingParameters::AddressInfo> &whiteList, QLowEnergyAdvertisingParameters::FilterPolicy policy)
스캔 및 연결 요청을 필터링하는 데 잠재적으로 사용될 수 있는 화이트리스트를 설정합니다. whiteList 매개변수는 필터링에 사용할 주소 목록이며, policy 은 whiteList 을 정확히 사용하는 방법을 지정합니다.
화이트리스트는 BlueZ에서 지원하지 않으므로 BlueZ DBus 백엔드에서는 지원되지 않습니다.
whiteList()도 참조하세요 .
[noexcept] void QLowEnergyAdvertisingParameters::swap(QLowEnergyAdvertisingParameters &other)
이 개체를 other 로 바꿉니다.
QList<QLowEnergyAdvertisingParameters::AddressInfo> QLowEnergyAdvertisingParameters::whiteList() const
스캔 및 연결 요청을 필터링하는 데 사용되는 화이트리스트를 반환합니다. 기본적으로 이 목록은 비어 있습니다.
setWhiteList()도 참조하세요 .
QLowEnergyAdvertisingParameters &QLowEnergyAdvertisingParameters::operator=(const QLowEnergyAdvertisingParameters &other)
이 객체를 other 의 복사본으로 만들고 이 객체의 새 값을 반환합니다.
관련 비회원
bool operator!=(const QLowEnergyAdvertisingParameters &a, const QLowEnergyAdvertisingParameters &b)
a 과 b 이 공개 상태가 같지 않으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.
bool operator==(const QLowEnergyAdvertisingParameters &a, const QLowEnergyAdvertisingParameters &b)
a 과 b 이 공개 상태와 동일하면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
