QBluetoothServiceDiscoveryAgent Class

voidMyClass::startServiceDiscovery() {// 创建一个发现代理并连接其信号   QBluetoothServiceDiscoveryAgent*discoveryAgent = newQBluetoothServiceDiscoveryAgent(this); connect(discoveryAgent,SIGNAL(serviceDiscovered(QBluetoothServiceInfo)), this,SLOT(serviceDiscovered(QBluetoothServiceInfo)));// 启动发现 discoveryAgent->start();//...}// 在本地槽中，读取发现设备的信息voidMyClass::serviceDiscovered(constQBluetoothServiceInfo服务）{
    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 和parent 构建一个新的 QBluetoothServiceDiscoveryAgent。

它使用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()。