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 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 がサポートしていないため、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 を返します。
©2024 The Qt Company Ltd. 本書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
