QLowEnergyConnectionParameters Class
QLowEnergyConnectionParameters クラスは、Bluetooth LE 接続のパラメータの更新を要求または報告する際に使用します。詳細...
| Header: | #include <QLowEnergyConnectionParameters> |
| qmake: | QT += bluetooth |
- 継承されたメンバーを含む全メンバーのリスト
- QLowEnergyConnectionParameters は暗黙の共有クラスに属しています。
パブリック関数
| QLowEnergyConnectionParameters() | |
| QLowEnergyConnectionParameters(const QLowEnergyConnectionParameters &other) | |
| ~QLowEnergyConnectionParameters() | |
| int | latency() const |
| double | maximumInterval() const |
| double | minimumInterval() const |
| void | setIntervalRange(double minimum, double maximum) |
| void | setLatency(int latency) |
| void | setSupervisionTimeout(int timeout) |
| int | supervisionTimeout() const |
| void | swap(QLowEnergyConnectionParameters &other) |
| QLowEnergyConnectionParameters & | operator=(const QLowEnergyConnectionParameters &other) |
関連する非メンバー
| bool | operator!=(const QLowEnergyConnectionParameters &p1, const QLowEnergyConnectionParameters &p2) |
| bool | operator==(const QLowEnergyConnectionParameters &p1, const QLowEnergyConnectionParameters &p2) |
詳細説明
接続パラメータは、マスターとスレーブデバイスが互いに同期する頻度に影響します。一般的に、接続間隔とレイテンシが低いほど通信は速くなりますが、消費電力も高くなります。これらの基準をどのように天秤にかけるべきかは、具体的なユースケースに大きく依存する。
アンドロイドは、このパラメーターセットの調整を間接的にしか許可していない。プラットフォームは、接続パラメーターを3つのカテゴリー（高優先度、低優先度、バランス優先度）に分けている。各カテゴリは、minimumInterval （）、maximumInterval （）、latency （）の値の事前定義セットを意味します。さらに、各カテゴリの値の範囲は、Android デバイスによって異なります。Qtは、minimumInterval （）を使用して、以下のようにターゲット・カテゴリーを決定します：
| minimumInterval() | Androidの優先度 |
|---|---|
| インターバル < 30 | connection_priority_high |
| 30 <= 間隔 <= 100 | コネクション・プライオリティ・バランス |
| インターバル > 100 | connection_priority_low_power |
supervisionTimeout() はAndroidでは変更できないため、無視される。
QLowEnergyController::requestConnectionUpdate およびQLowEnergyController::connectionUpdatedも参照のこと 。
メンバ関数ドキュメント
QLowEnergyConnectionParameters::QLowEnergyConnectionParameters()
このクラスの新しいオブジェクトを構築する。すべての値は有効なデフォルト値に初期化されます。
QLowEnergyConnectionParameters::QLowEnergyConnectionParameters(const QLowEnergyConnectionParameters &other)
other のコピーであるこのクラスの新しいオブジェクトを構築します。
[noexcept] QLowEnergyConnectionParameters::~QLowEnergyConnectionParameters()
このオブジェクトを破棄します。
int QLowEnergyConnectionParameters::latency() const
接続のスレーブ待ち時間を返します。
setLatency()も参照してください 。
double QLowEnergyConnectionParameters::maximumInterval() const
最大接続間隔をミリ秒単位で返します。デフォルトは 4000 です。
注意: このオブジェクトがQLowEnergyController::connectionUpdated() 経由で発行された場合、この値はminimumInterval() と同じであり、実際の接続間隔を指します。
setIntervalRange()も参照 。
double QLowEnergyConnectionParameters::minimumInterval() const
最小接続間隔をミリ秒単位で返します。デフォルトは 7.5。
注意: このオブジェクトがQLowEnergyController::connectionUpdated() 経由で発行された場合、この値はmaximumInterval() と同じで、実際の接続間隔を指します。
setIntervalRange()も参照してください 。
void QLowEnergyConnectionParameters::setIntervalRange(double minimum, double maximum)
接続間隔の範囲を設定します。実際の値は、コントローラが決定します。minimum 、maximum ともにミリ秒単位で指定する。maximum がminimum より小さい場合、minimum の値が設定される。 可能な接続間隔は、最小で 7.5 ミリ秒、最大で 4000 ミリ秒である。
minimumInterval() およびmaximumInterval()も参照の こと。
void QLowEnergyConnectionParameters::setLatency(int latency)
接続のスレーブ・レイテンシ（つまり、スレーブ・デバイスが無視することを許される接続イベントの数）をlatency に設定する。 最小値は 0 で、最大値は 499 である。
latency()も参照のこと 。
void QLowEnergyConnectionParameters::setSupervisionTimeout(int timeout)
リンク監視タイムアウトをtimeout ミリ秒に設定する。この値にはいくつかの制約がある：100,32000]の範囲でなければならず、(1 +latency()) * 2 *maximumInterval() よりも大きくなければならない。
Androidでは、このタイムアウトは調整できないため、無視される。
supervisionTimeout()も参照のこと 。
int QLowEnergyConnectionParameters::supervisionTimeout() const
接続のリンク監視タイムアウトをミリ秒単位で返します。
setSupervisionTimeout() も参照 。
[noexcept] void QLowEnergyConnectionParameters::swap(QLowEnergyConnectionParameters &other)
このオブジェクトをother と入れ替えます。
QLowEnergyConnectionParameters &QLowEnergyConnectionParameters::operator=(const QLowEnergyConnectionParameters &other)
このオブジェクトをother のコピーとし、このオブジェクトの新しい値を返します。
関連する非会員
bool operator!=(const QLowEnergyConnectionParameters &p1, const QLowEnergyConnectionParameters &p2)
p1 とp2 が公開状態に関して等しくない場合はtrue を返し、そうでない場合はfalse を返す。
bool operator==(const QLowEnergyConnectionParameters &p1, const QLowEnergyConnectionParameters &p2)
p1 とp2 が公開状態に関して等しい場合はtrue を返し、そうでない場合はfalse を返します。
©2024 The Qt Company Ltd. 本書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
