QLowEnergyAdvertisingParameters Class
QLowEnergyAdvertisingParameters クラスは、Bluetooth Low Energy 広告に使用するパラメータを表します。詳細...
| 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
ホワイトリストのセマンティクスを指定する。
| 定数 | 値 | 説明 |
|---|---|---|
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 を返す。
© 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.
