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 | 非指向性で、接続可能なアドバタイジング用。アドバタイジングは特定の 1 台のデバイスに向けられたものではなく、アドバタイジングを検知したデバイスは、アドバタイジングデバイスに接続したり、スキャン要求を送信したりできます。 |
QLowEnergyAdvertisingParameters::AdvScanInd | 0x2 | 非指向性でスキャン可能なアドバタイジング用。アドバタイジングは特定の 1 つのデバイスに向けられたものではなく、アドバタイジングを受信したデバイスは、アドバタイジングデバイスにスキャン要求を送信することはできますが、接続することはできません。 |
QLowEnergyAdvertisingParameters::AdvNonConnInd | 0x3 | 非指向型で接続不可のアドバタイジング用。アドバタイジングは特定の1つのデバイスを対象としていません。アドバタイジングを検知したデバイスは、アドバタイジングデバイスに接続することも、スキャン要求を送信することもできません。したがって、このモードは純粋なブロードキャストを意味します。 |
メンバ関数のドキュメント
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のDBusバックエンドでは、今後のBlueZのバージョンで実験的ステータスが変更された場合（または実験モードで実行された場合）、アドバタイズ間隔の設定がサポートされます。
void QLowEnergyAdvertisingParameters::setMode(QLowEnergyAdvertisingParameters::Mode mode)
広告モードを「mode 」に設定します。
mode()も参照してください 。
void QLowEnergyAdvertisingParameters::setWhiteList(const QList<QLowEnergyAdvertisingParameters::AddressInfo> &whiteList, QLowEnergyAdvertisingParameters::FilterPolicy policy)
スキャンおよび接続リクエストのフィルタリングに使用される可能性のあるホワイトリストを設定します。whiteList パラメータはフィルタリングに使用するアドレスのリストであり、policy はwhiteList の具体的な使用方法を指定します。
BlueZ DBus バックエンドでは、BlueZ 自体がホワイトリストをサポートしていないため、ホワイトリストはサポートされていません。
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.
