QLowEnergyAdvertisingData Class

QLowEnergyAdvertisingData クラスは、Bluetooth Low Energy 広告中にブロードキャストされるデータを表します。詳細...

Header: #include <QLowEnergyAdvertisingData>
qmake: QT += bluetooth

パブリック・タイプ

enum Discoverability { DiscoverabilityNone, DiscoverabilityLimited, DiscoverabilityGeneral }

パブリック関数

QLowEnergyAdvertisingData()
QLowEnergyAdvertisingData(const QLowEnergyAdvertisingData &other)
~QLowEnergyAdvertisingData()
QLowEnergyAdvertisingData::Discoverability discoverability() const
bool includePowerLevel() const
QString localName() const
QByteArray manufacturerData() const
quint16 manufacturerId() const
QByteArray rawData() const
QList<QBluetoothUuid> services() const
void setDiscoverability(QLowEnergyAdvertisingData::Discoverability mode)
void setIncludePowerLevel(bool doInclude)
void setLocalName(const QString &name)
void setManufacturerData(quint16 id, const QByteArray &data)
void setRawData(const QByteArray &data)
void setServices(const QList<QBluetoothUuid> &services)
void swap(QLowEnergyAdvertisingData &other)
QLowEnergyAdvertisingData &operator=(const QLowEnergyAdvertisingData &other)

静的パブリック・メンバー

bool operator!=(const QLowEnergyAdvertisingData &data1, const QLowEnergyAdvertisingData &data2)
bool operator==(const QLowEnergyAdvertisingData &data1, const QLowEnergyAdvertisingData &data2)

詳細説明

このデータには、デバイス名、デバイスが提供するGATTサービスなどを含めることができる。このクラスによって設定されたデータは、QLowEnergyController::startAdvertising() を呼び出すことによって広告が開始されるときに使用されます。このクラスのオブジェクトは、広告データ・パケットまたはスキャン・レスポンス・パケットを表すことができる。

注意: アドバタイジング・チャンネルで送信される実際のデータ・パケットには、31 バイト以上を含めることはできません。このクラスを経由して設定された可変長データがこの制限を超えると、タイプに応じてパケットから除外されるか、切り捨てられます。Androidでは、広告データが31バイトを超えると広告が失敗します。Bluez DBusバックエンドでは、広告の長さの上限と、それを超えた場合の動作はBlueZ次第です。最も予測しやすい動作のために、広告データは短くしておきましょう。

QLowEnergyAdvertisingParameters およびQLowEnergyController::startAdvertising()も参照のこと

メンバ型ドキュメント

enum QLowEnergyAdvertisingData::Discoverability

Generic Access Profile で定義されている広告デバイスの発見可能性。

定数説明
QLowEnergyAdvertisingData::DiscoverabilityNone0広告デバイスはスキャンデバイスによって発見可能であることを望まない。
QLowEnergyAdvertisingData::DiscoverabilityLimited1広告デバイスは高い優先度で発見可能であることを望む。このモードはホワイトリストの使用と互換性がないことに注意。制限された検出可能性が使用されるとき、QLowEnergyAdvertisingParameters::filterPolicy()の値は常にQLowEnergyAdvertisingParameters::IgnoreWhiteList であると仮定される。
QLowEnergyAdvertisingData::DiscoverabilityGeneral2広告デバイスは、スキャンデバイスによって発見可能であることを望む。

メンバ関数ドキュメント

QLowEnergyAdvertisingData::QLowEnergyAdvertisingData()

このクラスの新しいオブジェクトを作成する。すべての値は、Bluetooth Low Energy 仕様に従ってデフォルトに初期化されます。

QLowEnergyAdvertisingData::QLowEnergyAdvertisingData(const QLowEnergyAdvertisingData &other)

other のコピーであるこのクラスの新しいオブジェクトを構築します。

[noexcept] QLowEnergyAdvertisingData::~QLowEnergyAdvertisingData()

このオブジェクトを破棄します。

QLowEnergyAdvertisingData::Discoverability QLowEnergyAdvertisingData::discoverability() const

広告デバイスの検出可能モードを返します。デフォルトはDiscoverabilityNone です。

setDiscoverability()も参照

bool QLowEnergyAdvertisingData::includePowerLevel() const

デバイスの送信電力レベルを広告データに含めるかどうかを返す。デフォルトはfalse である。

setIncludePowerLevel()も参照

[static] quint16 QLowEnergyAdvertisingData::invalidManufacturerId()

無効な製造元 ID を返す。この値が製造者 ID として設定されている場合(デフォルト)、広告データに製造者データは含まれない。

QString QLowEnergyAdvertisingData::localName() const

広告されるローカル・デバイスの名前を返す。

setLocalName()も参照

QByteArray QLowEnergyAdvertisingData::manufacturerData() const

製造者データを返す。デフォルトは空のバイト配列である。

setManufacturerData()も参照

quint16 QLowEnergyAdvertisingData::manufacturerId() const

製造元 ID を返す。デフォルトはQLowEnergyAdvertisingData::invalidManufacturerId() で、これはデータがアドバタイズされないことを意味する。

QByteArray QLowEnergyAdvertisingData::rawData() const

ユーザが指定した、広告される生データを返します。デフォルトは空のバイト配列。

setRawData()も参照

QList<QBluetoothUuid> QLowEnergyAdvertisingData::services() const

広告するサービスUUIDのリストを返す。デフォルトでは、このリストは空である。

setServices()も参照

void QLowEnergyAdvertisingData::setDiscoverability(QLowEnergyAdvertisingData::Discoverability mode)

広告デバイスの検出可能性タイプをmode に設定する。

注意: 発見可能性情報は実際の広告データパケットにのみ現れる。このオブジェクトがスキャン応答データとして動作する場合、 この関数の呼び出しは、送信されるスキャン応答には影響しない。

discoverability()も参照のこと

void QLowEnergyAdvertisingData::setIncludePowerLevel(bool doInclude)

広告データにデバイスの送信電力レベルを含めるかどうかを指定する。doIncludetrue の場合、データは含まれるが、そうでない場合は含まれない。

includePowerLevel()も参照

void QLowEnergyAdvertisingData::setLocalName(const QString &name)

デバイス名としてname を放送することを指定する。完全な名前が広告データパケットに収まらない場合は、Bluetooth Low Energy仕様で記述されているように、省略した名前が送信されます。

Androidでは、ローカル名は変更できません。Androidは常にデバイス名を使用します。このローカル名が空でない場合、Androidの実装は広告パケットにデバイス名を含め、そうでない場合は広告パケットからデバイス名を省略します。

localName()も参照のこと

void QLowEnergyAdvertisingData::setManufacturerData(quint16 id, const QByteArray &data)

製造者IDとデータを設定する。id パラメータは、Bluetooth SIG によって割り当てられた会社識別子である。data パラメータは任意の値である。

manufacturerData() も参照

void QLowEnergyAdvertisingData::setRawData(const QByteArray &data)

data に広告するデータを設定します。値が空のバイト配列でない場合、広告データとしてそのまま送信され、このオブジェクト内の他のデータはすべて無視されます。これは、非標準データを送信するために使用できる。

注: data が31バイトより長い場合、切り捨てられる。data が整形式であることを確認するのは、呼び出し側の責任である。

生の広告データの提供は、BlueZ がサポートしていないため、BlueZ DBus バックエンドではサポートされていません。これは将来のリリースで変更される可能性があります。

rawData()も参照してください

void QLowEnergyAdvertisingData::setServices(const QList<QBluetoothUuid> &services)

services のサービス UUID を広告することを指定します。リスト全体がパケットに収まらない場合は、Bluetooth Low Energyの仕様に従って不完全なリストが送信されます。

services()も参照

[noexcept] void QLowEnergyAdvertisingData::swap(QLowEnergyAdvertisingData &other)

このオブジェクトをother と入れ替えます。

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

このオブジェクトをother のコピーにし、このオブジェクトの新しい値を返します。

関連する非会員

bool operator!=(const QLowEnergyAdvertisingData &data1, const QLowEnergyAdvertisingData &data2)

data1data2 が公開状態に関して等しくない場合はtrue を返し、そうでない場合はfalse を返す。

bool operator==(const QLowEnergyAdvertisingData &data1, const QLowEnergyAdvertisingData &data2)

data1data2 が公開状態に関して等しい場合はtrue を返し、そうでない場合はfalse を返します。

©2024 The Qt Company Ltd. 本書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。