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() を連続して呼び出す間に、リモートの 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()も参照してください 。