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つのコピーは、引き続き同じサービスおよびコントローラーの詳細情報を共有します。