QLowEnergyAdvertisingParameters Class
QLowEnergyAdvertisingParameters 클래스는 블루투스 저에너지(Bluetooth Low Energy) 광고에 사용되는 매개변수를 나타냅니다. 더 보기...
| 헤더: | #include <QLowEnergyAdvertisingParameters> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Bluetooth) target_link_libraries(mytarget PRIVATE Qt6::Bluetooth) |
| 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
화이트리스트의 의미를 명시합니다.
| 상수 | 값 | 설명 |
|---|---|---|
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 Low Energy 사양에 따라 기본값으로 초기화됩니다.
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 를 반환합니다.
© 2026 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.
