QLowEnergyCharacteristic Class

メンバ関数ドキュメント

QLowEnergyCharacteristic::QLowEnergyCharacteristic()

新しい QLowEnergyCharacteristic を構築します。このクラスのデフォルトのインスタンスは常に無効です。

isValid()も参照してください 。

QLowEnergyCharacteristic::QLowEnergyCharacteristic(const QLowEnergyCharacteristic &other)

other のコピーである新しい QLowEnergyCharacteristic を構築する。

2つのコピーは、書き込み時に切り離されない同じ基礎データを共有し続けます。

[noexcept] QLowEnergyCharacteristic::~QLowEnergyCharacteristic()

QLowEnergyCharacteristic オブジェクトを破棄する。

[since 6.2] QLowEnergyDescriptor QLowEnergyCharacteristic::clientCharacteristicConfiguration() const

クライアント特性構成記述子、またはクライアント特性構成記述子が存在しない場合は無効なQLowEnergyDescriptor インスタンスを返す。

BTLE特性は、通知または表示をサポートすることができる。どちらの場合も、周辺は特性値の各変更をセントラルに通知する。BTLE属性プロトコルでは、通知メッセージはセントラルによって確認されないが、指示は確認される。通知はより速いが信頼性が低く、指示はより遅いが信頼性が高い。

特性が通知または指示をサポートする場合、これらは、特別なビットパターンをクライアント特性構成記述子に書き込むことによって有効にすることができる。便宜上、これらのビットパターンをQLowEnergyCharacteristic::CCCDDisable 、QLowEnergyCharacteristic::CCCDEnableNotification 、QLowEnergyCharacteristic::CCCDEnableIndication として提供する。

例えば、myservice と呼ばれるサービスにおいて、mycharacteristic という名前の特性に対する通知を有効にするには、以下のコードを使用します。

auto cccd = mycharacteristic.clientCharacteristicConfiguration();
if (!cccd.isValid()) {
    // your error handling
    return error;
}
myservice->writeDescriptor(cccd, QLowEnergyCharacteristic::CCCDEnableNotification);

この関数は Qt 6.2 で導入されました。

descriptor()も参照してください 。

QLowEnergyDescriptor QLowEnergyCharacteristic::descriptor(const QBluetoothUuid &uuid) const

uuid または無効なQLowEnergyDescriptor インスタンスの記述子を返す。

descriptors()も参照のこと 。

QList<QLowEnergyDescriptor> QLowEnergyCharacteristic::descriptors() const

この特性に属するディスクリプタのリストを返す。

descriptor()も参照してください 。

bool QLowEnergyCharacteristic::isValid() const

QLowEnergyCharacteristic オブジェクトが有効な場合はtrue を返し、そうでない場合はfalse を返す。

無効な特性オブジェクトは、どのサービスとも関連付けられていないか（デフォルトで構築されている）、または関連付けられたサービスが、例えば基礎となる Bluetooth Low Energy デバイスからの接続が切断されたために有効でなくなっている。オブジェクトが無効になると、それ以上有効になることはない。

QString QLowEnergyCharacteristic::name() const

特性の人間が読める名前を返す。

この名前は、標準化されていなければならない特性のuuid() に基づいている。特性タイプの完全なリストは、Bluetooth.org Characteristicsにあります。

uuid() が不明な場合、返される文字列は空である。

QBluetoothUuid::characteristicToString()も参照してください 。

QLowEnergyCharacteristic::PropertyTypes QLowEnergyCharacteristic::properties() const

特性のプロパティを返します。

プロパティは、特性のアクセス許可を定義します。

QBluetoothUuid QLowEnergyCharacteristic::uuid() const

isValid() がtrue を返す場合、その特性の UUID を返す。そうでない場合、null の UUID を返す。

QByteArray QLowEnergyCharacteristic::value() const

特性のキャッシュ値を返す。

特性のproperties() が新しい値の書き込みを許可している場合、値はQLowEnergyService::writeCharacteristic() を使用して更新できる。

キャッシュは、関連するサービスのdetail discovery 、read/write 操作が成功したとき、または更新通知を受け取ったときに更新される。

特性がread permission を持たない場合、返されるQByteArray は常に空のままである。このような場合、QLowEnergyService::characteristicChanged() またはQLowEnergyService::characteristicWritten() だけが、この特性の値に関する情報を提供することができる。

QLowEnergyCharacteristic &QLowEnergyCharacteristic::operator=(const QLowEnergyCharacteristic &other)

other のコピーを作成し、このQLowEnergyCharacteristic オブジェクトに割り当てる。2つのコピーは、同じサービスとコントローラの詳細を共有し続けます。