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。搜索通过本地默认的蓝牙适配器进行。

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

为deviceAdapter 构建一个新的QBluetoothServiceDiscoveryAgent，并使用parent 。

该对象使用deviceAdapter 进行服务搜索。如果deviceAdapter 采用默认构造，生成的QBluetoothServiceDiscoveryAgent对象将使用本地默认蓝牙适配器。

如果指定的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()之间，远程蓝牙设备移出了覆盖范围，则该列表中可能会包含过时的条目。

另请参阅 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()

当蓝牙服务发现完成时，会发出此信号。

与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 所描述的蓝牙服务时，将发出此信号。

另请参阅 QBluetoothDeviceInfo::coreConfigurations()。

bool QBluetoothServiceDiscoveryAgent::setRemoteAddress(const QBluetoothAddress &address)

将远程设备地址设置为address 。如果使用默认构造的address ，则将在所有可连接的蓝牙设备上进行服务发现。只有在没有正在进行的服务发现时，才能设置新的远程地址；否则，该函数将返回 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()。