QBluetoothServiceDiscoveryAgent Class

void MyClass::startServiceDiscovery()
{

    // Create a discovery agent and connect to its signals
    QBluetoothServiceDiscoveryAgent *discoveryAgent = new QBluetoothServiceDiscoveryAgent(this);
    connect(discoveryAgent, SIGNAL(serviceDiscovered(QBluetoothServiceInfo)),
            this, SLOT(serviceDiscovered(QBluetoothServiceInfo)));

    // Start a discovery
    discoveryAgent->start();

    //...
}

// In your local slot, read information about the found devices
void MyClass::serviceDiscovered(const QBluetoothServiceInfo &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()も参照してください 。