QBluetoothDeviceDiscoveryAgent Class

voidMyClass::startDeviceDiscovery() {// ディスカバリー・エージェントを作成し、そのシグナルに接続します。    QBluetoothDeviceDiscoveryAgent*discoveryAgent = newQBluetoothDeviceDiscoveryAgent(this); connect(discoveryAgent,SIGNAL(deviceDiscovered(QBluetoothDeviceInfo)), this,SLOT(deviceDiscovered(QBluetoothDeviceInfo));// discoveryAgent->start();//...}// ローカルスロットで、見つかったデバイスに関する情報を読み込むvoidMyClass::deviceDiscovered(constQBluetoothDeviceInfoデバイス){
    qDebug() << "Found new device:" << device.name() << '(' << device.address().toString() << ')';
}

メンバー関数ドキュメント

[explicit] QBluetoothDeviceDiscoveryAgent::QBluetoothDeviceDiscoveryAgent(QObject *parent = nullptr)

親を持つ新しいBluetoothデバイス発見エージェントを構築するparent 。

[explicit] QBluetoothDeviceDiscoveryAgent::QBluetoothDeviceDiscoveryAgent(const QBluetoothAddress &deviceAdapter, QObject *parent = nullptr)

新しいBluetoothデバイス発見エージェントをparent で構築する。

デバイス検索にはdeviceAdapter を使用します。deviceAdapter がデフォルトで構築された場合、結果の QBluetoothDeviceDiscoveryAgent オブジェクトはローカルのデフォルト Bluetooth アダプタを使用します。

ローカル・アダプタではないdeviceAdapter が指定された場合、error() はInvalidBluetoothAdapterError に設定されます。 したがって、このコンストラクタを使用した直後にエラー・フラグをテストすることをお勧めします。

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

[virtual noexcept] QBluetoothDeviceDiscoveryAgent::~QBluetoothDeviceDiscoveryAgent()

のデストラクタQBluetoothDeviceDiscoveryAgent()

[signal] void QBluetoothDeviceDiscoveryAgent::canceled()

このシグナルは、stop （）のコールによってデバイス発見が中止されたときに発せられる。

[signal] void QBluetoothDeviceDiscoveryAgent::deviceDiscovered(const QBluetoothDeviceInfo &info)

この信号は、info で記述されたBluetoothデバイスが発見されたときに発せられる。

このシグナルは、最も重要なデバイス情報が収集されるとすぐに発せられます。ただし、finished （）信号が発せられない限り、すでに検出されたデバイスであっても情報収集は継続されます。これは特に、信号強度情報（RSSI）と製造元データの更新に当てはまります。製造元データまたはRSSIの継続的な更新が必要なユースケースの場合、検出が終了したらdiscoveredDevices() を介してデバイス情報を取得するか、deviceUpdated() 信号をリッスンすることを推奨する。

lowEnergyDiscoveryTimeout()が0より大きい場合、シグナルは、info の少なくとも1つの属性が変更されたときのみ発信される。これは、より正確な情報が利用可能になったときに更新を受け取りたいという要望を反映している。この動作の例外は、lowEnergyDiscoveryTimeout が0 に設定されている場合である。0 のタイムアウトは、時間の経過とともに低エネルギー機器の出現と消滅を監視したいことを表し ている。この条件では、info が最後のシグナル発信から変化していなくても、 deviceDiscovered()シグナルが発信される。

QBluetoothDeviceInfo::rssi() およびlowEnergyDiscoveryTimeout()も参照のこと 。

[signal] void QBluetoothDeviceDiscoveryAgent::deviceUpdated(const QBluetoothDeviceInfo &info, QBluetoothDeviceInfo::Fields updatedFields)

このシグナルは、info によって記述された Bluetooth デバイスに関する追加情報をエージェントが受信したときに発行される。updatedFields フラグは、どの情報が更新されたかを示します。

検出中、signal strength やmanufacturerData のように、いくつかの情報は動的に変更されることがあります。このシグナルは、アプリケーションがこのデータを表示している場合、ディスカバリーが終了するまで待つのではなく、更新できることを通知します。

QBluetoothDeviceInfo::rssi() およびlowEnergyDiscoveryTimeout()も参照の こと。

QList<QBluetoothDeviceInfo> QBluetoothDeviceDiscoveryAgent::discoveredDevices() const

検出されたすべてのBluetoothデバイスのリストを返します。

QBluetoothDeviceDiscoveryAgent::Error QBluetoothDeviceDiscoveryAgent::error() const

最後のエラーを返します。

ディスカバリを再開すると、以前のエラーはクリアされます。

[signal, since 6.2] void QBluetoothDeviceDiscoveryAgent::errorOccurred(QBluetoothDeviceDiscoveryAgent::Error error)

このシグナルは、Bluetoothデバイス検出中にerror 。error パラメータには、発生したエラーが記述されています。

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

error() およびerrorString()も参照してください 。

QString QBluetoothDeviceDiscoveryAgent::errorString() const

最後のエラーについて、人間が読める説明を返す。

error() およびerrorOccurred()も参照 。

[signal] void QBluetoothDeviceDiscoveryAgent::finished()

このシグナルはBluetoothデバイスの検出が完了したときに発行される。デバイス検出がエラーで終了した場合は、このシグナルは発行されません。

bool QBluetoothDeviceDiscoveryAgent::isActive() const

エージェントが現在Bluetoothデバイスを検出している場合はtrueを返し、そうでない場合はfalseを返します。

int QBluetoothDeviceDiscoveryAgent::lowEnergyDiscoveryTimeout() const

Bluetooth Low Energy デバイス検索に適用されるタイムアウトをミリ秒単位で返します。値が-1 の場合、プラットフォームがこのプロパティをサポートしておらず、デバイス検索のタイムアウトを調整できないことを意味する。戻り値が0 の場合、検索が終了しないことを意味し、stop() を使用して手動で停止する必要がある。

setLowEnergyDiscoveryTimeout()も参照のこと 。

void QBluetoothDeviceDiscoveryAgent::setLowEnergyDiscoveryTimeout(int timeout)

Bluetooth Low Energy デバイス検索の最大検索時間をミリ秒単位でtimeout に設定する。timeout が0 の場合、検索はstop() が呼び出されるまで実行される。

これは、Bluetooth Low Energyデバイスの検出プロセスがほとんどオープンエンドであることを反映しています。検索が手動で停止されるまで、プラットフォームはさらにデバイスを探し続けます。タイムアウトにより、timeout ミリ秒後に検索が中止されます。もちろん、stop （）を呼び出すことで、手動で探索を中止することも可能である。

新しいタイムアウト値は、デバイス検索が再開されるまで有効にならない。また、タイムアウトはクラシックなBluetoothデバイス検索には影響しません。プラットフォームによっては、古典的な検索がtimeout を超えて全体の検出プロセスに時間を追加する場合があります。

信頼性の高いBluetooth Low Energy探索を行うには、少なくとも40000ミリ秒を使用してください。

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

[slot] void QBluetoothDeviceDiscoveryAgent::start()

まだ開始されていなければ、Bluetooth デバイス検出を開始する。

各デバイスが検出されるとdeviceDiscovered() シグナルが発せられる。finished() シグナルは、デバイスの検出が完了すると発行される。検出は、プラットフォーム上でサポートされている検出方法の最大セットを利用します。

supportedDiscoveryMethods()も参照のこと 。

[slot] void QBluetoothDeviceDiscoveryAgent::start(QBluetoothDeviceDiscoveryAgent::DiscoveryMethods methods)

Bluetoothデバイス探索がまだ開始されておらず、提供されたmethods がサポートされている場合、それを開始する。ディスカバリーmethods は、デバイス検索の範囲を制限する。たとえば、対象のサービスまたはデバイスがBluetooth Low Energyデバイスの場合、この関数を使用して検索をBluetooth Low Energyデバイスに限定することで、検出時間を大幅に短縮できます。

[slot] void QBluetoothDeviceDiscoveryAgent::stop()

Bluetoothデバイス検出を停止します。デバイス検出がキャンセルされると cancel() シグナルが発信されます。startcancel()は、cancelシグナルを受信する前に呼び出されることがあります。start() が呼び出されると、前のディスカバリーからのキャンセルシグナルは破棄されます。

[static] QBluetoothDeviceDiscoveryAgent::DiscoveryMethods QBluetoothDeviceDiscoveryAgent::supportedDiscoveryMethods()

この関数は、現在のプラットフォームでサポートされている発見方法を返す。これは、デバイス発見の範囲を制限するために使用することができます。