QLowEnergyAdvertisingData Class
QLowEnergyAdvertisingData 클래스는 블루투스 저에너지 광고 중에 브로드캐스트할 데이터를 나타냅니다. 더 보기...
Header: | #include <QLowEnergyAdvertisingData> |
qmake: | QT += bluetooth |
- 상속된 멤버를 포함한 모든 멤버 목록
- QLowEnergyAdvertisingData는 암시적으로 공유되는 클래스의 일부입니다.
공용 유형
enum | Discoverability { DiscoverabilityNone, DiscoverabilityLimited, DiscoverabilityGeneral } |
공용 함수
QLowEnergyAdvertisingData() | |
QLowEnergyAdvertisingData(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) |
QLowEnergyAdvertisingData & | operator=(const QLowEnergyAdvertisingData &other) |
정적 공용 멤버
quint16 | invalidManufacturerId() |
관련 비회원
bool | operator!=(const QLowEnergyAdvertisingData &data1, const QLowEnergyAdvertisingData &data2) |
bool | operator==(const QLowEnergyAdvertisingData &data1, const QLowEnergyAdvertisingData &data2) |
상세 설명
이 데이터에는 디바이스 이름, 디바이스에서 제공하는 GATT 서비스 등이 포함될 수 있습니다. 이 클래스를 통해 설정된 데이터는 QLowEnergyController::startAdvertising()를 호출하여 광고가 시작될 때 사용됩니다. 이 클래스의 객체는 광고 데이터 패킷 또는 스캔 응답 패킷을 나타낼 수 있습니다.
참고: 광고 채널을 통해 전송되는 실제 데이터 패킷은 31바이트를 초과할 수 없습니다. 이 클래스를 통해 설정된 가변 길이 데이터가 이 제한을 초과하면 유형에 따라 패킷에서 제외되거나 잘립니다. 안드로이드에서는 광고 데이터가 31바이트보다 크면 광고가 실패합니다. 블루즈 DBus 백엔드에서 광고 길이 제한과 이를 초과할 때의 동작은 블루즈에 달려 있으며, 예를 들어 확장 광고를 지원할 수 있습니다. 가장 예측 가능한 동작을 위해 광고 데이터를 짧게 유지하세요.
QLowEnergyAdvertisingParameters 및 QLowEnergyController::startAdvertising()도 참조하세요 .
회원 유형 문서
enum QLowEnergyAdvertisingData::Discoverability
일반 액세스 프로필에 정의된 광고 디바이스의 검색 가능성입니다.
상수 | 값 | 설명 |
---|---|---|
QLowEnergyAdvertisingData::DiscoverabilityNone | 0 | 광고 디바이스가 스캔 디바이스에서 검색되지 않도록 설정합니다. |
QLowEnergyAdvertisingData::DiscoverabilityLimited | 1 | 광고 디바이스가 높은 우선순위로 검색되기를 원합니다. 이 모드는 화이트리스트 사용과 호환되지 않습니다. 제한된 검색 가능성을 사용하는 경우 QLowEnergyAdvertisingParameters::filterPolicy()의 값은 항상 QLowEnergyAdvertisingParameters::IgnoreWhiteList 으로 간주됩니다. |
QLowEnergyAdvertisingData::DiscoverabilityGeneral | 2 | 스캔 디바이스에서 광고 디바이스를 검색할 수 있도록 설정합니다. |
회원 기능 문서
QLowEnergyAdvertisingData::QLowEnergyAdvertisingData()
이 클래스의 새 객체를 생성합니다. 모든 값은 Bluetooth 저에너지 사양에 따라 기본값으로 초기화됩니다.
QLowEnergyAdvertisingData::QLowEnergyAdvertisingData(const QLowEnergyAdvertisingData &other)
other 의 복사본인 이 클래스의 새 객체를 생성합니다.
[noexcept]
QLowEnergyAdvertisingData::~QLowEnergyAdvertisingData()
이 개체를 파괴합니다.
QLowEnergyAdvertisingData::Discoverability QLowEnergyAdvertisingData::discoverability() const
광고 디바이스의 검색 가능성 모드를 반환합니다. 기본값은 DiscoverabilityNone 입니다.
setDiscoverability()도 참조하세요 .
bool QLowEnergyAdvertisingData::includePowerLevel() const
광고 데이터에 디바이스의 송신 전력 레벨을 포함할지 여부를 반환합니다. 기본값은 false
입니다.
setIncludePowerLevel()도 참조하세요 .
[static]
quint16 QLowEnergyAdvertisingData::invalidManufacturerId()
잘못된 제조사 ID를 반환합니다. 이 값이 제조업체 ID로 설정되어 있으면(기본적으로 설정되어 있음) 광고 데이터에 제조업체 데이터가 표시되지 않습니다.
QString QLowEnergyAdvertisingData::localName() const
광고할 로컬 디바이스의 이름을 반환합니다.
setLocalName()도 참조하세요 .
QByteArray QLowEnergyAdvertisingData::manufacturerData() const
제조업체 데이터를 반환합니다. 기본값은 빈 바이트 배열입니다.
setManufacturerData()도 참조하세요 .
quint16 QLowEnergyAdvertisingData::manufacturerId() const
제조사 ID를 반환합니다. 기본값은 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 저에너지 사양에 설명된 대로 축약된 이름이 전송됩니다.
Android에서는 로컬 이름을 변경할 수 없습니다. Android는 항상 디바이스 이름을 사용합니다. 이 로컬 이름이 비어 있지 않으면 Android 구현은 광고 패킷에 디바이스 이름을 포함하며, 그렇지 않으면 광고 패킷에서 디바이스 이름이 생략됩니다.
localName()도 참조하세요 .
void QLowEnergyAdvertisingData::setManufacturerData(quint16 id, const QByteArray &data)
제조업체 ID 및 데이터를 설정합니다. id 매개변수는 Bluetooth SIG에서 할당된 회사 식별자입니다. data 매개변수는 임의의 값입니다.
참고: macOS 및 iOS는 제조업체 ID 또는 데이터의 광고를 지원하지 않으므로 제공된 매개변수는 이러한 플랫폼에서 무시됩니다.
manufacturerData()도 참조하세요 .
void QLowEnergyAdvertisingData::setRawData(const QByteArray &data)
광고할 데이터를 data 으로 설정합니다. 값이 빈 바이트 배열이 아닌 경우 광고 데이터로 그대로 전송되며 이 객체의 다른 모든 데이터는 무시됩니다. 비표준 데이터를 전송하는 데 사용할 수 있습니다.
참고: data 이 31바이트보다 길면 잘립니다. data 이 제대로 형성되었는지 확인하는 것은 호출자의 책임입니다.
원시 광고 데이터 설정은 Linux Bluetooth 커널 API 백엔드에서만 지원됩니다. 다른 백엔드에서는 원시 광고 데이터를 전역 필드로 지정할 수 없습니다.
rawData()도 참조하세요 .
void QLowEnergyAdvertisingData::setServices(const QList<QBluetoothUuid> &services)
services 의 서비스 UUID를 알릴 것을 지정합니다. 전체 목록이 패킷에 맞지 않으면 Bluetooth 저에너지 사양에 지정된 대로 불완전한 목록이 전송됩니다.
services()도 참조하세요 .
[noexcept]
void QLowEnergyAdvertisingData::swap(QLowEnergyAdvertisingData &other)
이 개체를 other 로 바꿉니다.
QLowEnergyAdvertisingData &QLowEnergyAdvertisingData::operator=(const QLowEnergyAdvertisingData &other)
이 객체를 other 의 복사본으로 만들고 이 객체의 새 값을 반환합니다.
관련 비회원
bool operator!=(const QLowEnergyAdvertisingData &data1, const QLowEnergyAdvertisingData &data2)
data1 과 data2 이 공개 상태가 같지 않으면 true
을 반환하고, 그렇지 않으면 false
을 반환합니다.
bool operator==(const QLowEnergyAdvertisingData &data1, const QLowEnergyAdvertisingData &data2)
data1 과 data2 이 공개 상태와 동일하면 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.