QLowEnergyConnectionParameters Class
QLowEnergyConnectionParameters クラスは、Bluetooth LE 接続のパラメータの更新を要求したり、その更新状況を報告したりする際に使用されます。詳細...
| ヘッダー: | #include <QLowEnergyConnectionParameters> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Bluetooth) target_link_libraries(mytarget PRIVATE Qt6::Bluetooth) |
| 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) |
詳細な説明
接続パラメータは、マスターデバイスとスレーブデバイスが互いに同期する頻度に影響を与えます。一般的に、接続間隔とレイテンシが短いほど通信は高速になりますが、消費電力も高くなります。これらの基準をどのようにバランスさせるかは、具体的なユースケースに大きく依存します。
Androidでは、このパラメータセットの調整は間接的にしか許可されていません。プラットフォームは、接続パラメータを3つのカテゴリ（高優先度、低優先度、バランス優先度）に分類しています。各カテゴリには、minimumInterval()、maximumInterval()、latency() に対する事前定義された値のセットが割り当てられています。さらに、各カテゴリの値の範囲は、Androidデバイスごとに異なる場合があります。 Qtでは、minimumInterval() を使用して、次のように対象のカテゴリを決定します：
| minimumInterval() | Androidの優先度 |
|---|---|
| interval < 30 | CONNECTION_PRIORITY_HIGH |
| 30 <= 間隔 <= 100 | CONNECTION_PRIORITY_BALANCED |
| interval > 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` を返します。
© 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.
