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

Client Characteristic Configuration Descriptor を返すか、 Client Characteristic Configuration Descriptor が存在しない場合は無効な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つのコピーは、同じサービスとコントローラの詳細を共有し続ける。