QBluetoothServiceDiscoveryAgent Class

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

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

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

parent を持つ新しい QBluetoothServiceDiscoveryAgent を構築します。検索は、ローカルのデフォルト Bluetooth アダプタを介して実行されます。

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

deviceAdapter およびparent 用の新しい QBluetoothServiceDiscoveryAgent を構築します。

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

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

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

[virtual noexcept] QBluetoothServiceDiscoveryAgent::~QBluetoothServiceDiscoveryAgent()

のデストラクタ。QBluetoothServiceDiscoveryAgent

[signal] void QBluetoothServiceDiscoveryAgent::canceled()

このシグナルは、stop （）の呼び出しによってサービス発見がキャンセルされたときにトリガーされる。

[slot] void QBluetoothServiceDiscoveryAgent::clear()

以前のサービス発見の結果をクリアし、uuidFilter()をリセットする。この関数は、進行中のサービス発見中(isActive()を参照)には何もしない。

discoveredServices()も参照 。

QList<QBluetoothServiceInfo> QBluetoothServiceDiscoveryAgent::discoveredServices() const

発見されたすべてのサービスのリストを返す。

このサービス・リストは、start （）を複数回呼び出すことで、新たに検出されたサービスを蓄積したものである。clear() が呼び出されない限り、リストのサイズが小さくなることはない。つまり、start() を 2 回呼び出す間にリモートの Bluetooth 機器が圏外に移動した場合、リストに古いエントリが含まれる可能性があります。

clear()も参照の こと。

QBluetoothServiceDiscoveryAgent::Error QBluetoothServiceDiscoveryAgent::error() const

最後に発生したエラーのタイプを返す。サービス検出が単一のremoteAddress() に対して行われた場合、そのデバイスのサービスを検出しようとして発生したエラーが返される。remoteAddress() が設定されず、スキャンによってデバイスが発見された場合、個々のデバイスのサービス発見中のエラーは保存されず、シグナルは発せられない。この場合、一部のデバイスが検出に応答しなかったり、検出範囲外になったりすることがあるため、エラーはごく正常なものである。このようなエラーは抑制される。サービスが返されない場合、サービスは発見されなかったと考えることができる。

可能性のある以前のエラーは、発見を再開するときに消去される。

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

このシグナルはerror 。error パラメータには、発生したエラーが記述されています。

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

QString QBluetoothServiceDiscoveryAgent::errorString() const

サービス検出中に発生した最後のエラーについて、人間が読める説明を返します。

error() およびerrorOccurred()も参照ください 。

[signal] void QBluetoothServiceDiscoveryAgent::finished()

このシグナルは、Bluetoothのサービス検出が完了したときに発行されます。

QBluetoothDeviceDiscoveryAgent::finished() シグナルとは異なり、このシグナルはサービス検出中にエラーが発生した場合にも発せられます。そのため、サービス・ディスカバリーの成功を評価するには、errorOccurred() シグナルをチェックすることをお勧めします。

bool QBluetoothServiceDiscoveryAgent::isActive() const

サービス探索が現在アクティブな場合はtrue を返し、そうでない場合はfalse を返す。アクティブなディスカバリーは、stop()をコールすることで停止できる。

QBluetoothAddress QBluetoothServiceDiscoveryAgent::remoteAddress() const

リモート・デバイス・アドレスを返す。setRemoteAddress() が呼び出されなかった場合、この関数はデフォルトで構築されたQBluetoothAddress を返す。

setRemoteAddress()も参照 。

[signal] void QBluetoothServiceDiscoveryAgent::serviceDiscovered(const QBluetoothServiceInfo &info)

このシグナルは、info に記述されているBluetoothサービスが検出されたときに発行される。

QBluetoothDeviceInfo::coreConfigurations()も参照してください 。

bool QBluetoothServiceDiscoveryAgent::setRemoteAddress(const QBluetoothAddress &address)

リモートデバイスアドレスをaddress に設定します。address がデフォルトで構築されている場合、接触可能なすべての Bluetooth デバイスでサービスが検出されます。新しいリモートアドレスは、サービス検出が進行中でない場合にのみ設定できます。

そうでない場合、この関数はfalseを返します。プラットフォームによっては、サービス検出がペアリング要求につながる場合があります。そのため、すべてのデバイスでサービス検出を行うことは推奨されません。この関数を使用すると、サービス検出を特定のデバイスに制限することができます。

remoteAddress()も参照のこと 。

void QBluetoothServiceDiscoveryAgent::setUuidFilter(const QBluetoothUuid &uuid)

これはオーバーロードされたメンバ関数で、便宜上提供されている。

単一の要素uuid を含むリストにUUIDフィルターを設定します。マッチングはサービスのServiceId とServiceClassIds 属性に適用されます。

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

void QBluetoothServiceDiscoveryAgent::setUuidFilter(const QList<QBluetoothUuid> &uuids)

UUID フィルタをuuids に設定します。uuids の UUID に一致するサービスだけが返されます。マッチングはサービスのServiceId とServiceClassIds 属性に適用されます。

空のUUIDリストは、QBluetoothUuid::ServiceClassUuid::PublicBrowseGroup のみを含むリストと同じです。

uuidFilter()も参照 。

[slot] void QBluetoothServiceDiscoveryAgent::start(QBluetoothServiceDiscoveryAgent::DiscoveryMode mode = MinimalDiscovery)

mode 実行するサービス発見のタイプを指定する。

プラットフォームによっては、デバイス発見がペアリング要求につながるかもしれない。

DiscoveryModeも参照のこと 。

[slot] void QBluetoothServiceDiscoveryAgent::stop()

サービス検索プロセスを停止します。検索が停止すると、canceled() シグナルが発行されます。

QList<QBluetoothUuid> QBluetoothServiceDiscoveryAgent::uuidFilter() const

UUID フィルタを返します。

setUuidFilter()も参照ください 。