QBluetoothServiceDiscoveryAgent 类

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() << ')';
}

成员函数文档

[显式] QBluetoothServiceDiscoveryAgent::QBluetoothServiceDiscoveryAgent(QObject *parent = nullptr)

使用parent构建一个新的QBluetoothServiceDiscoveryAgent。搜索通过本地默认蓝牙适配器执行。

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

构造一个用于deviceAdapter的新的QBluetoothServiceDiscoveryAgent实例，并具有parent。

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

如果指定了不是本地适配器的deviceAdapter，则error()将设置为InvalidBluetoothAdapterError。因此，建议在使用此构造函数后立即测试错误标志。

另见：error().

[虚函数 noexcept] QBluetoothServiceDiscoveryAgent::~QBluetoothServiceDiscoveryAgent()

QBluetoothServiceDiscoveryAgent的析构函数

[信号] void QBluetoothServiceDiscoveryAgent::canceled()

当通过调用stop()取消服务发现时，该信号被触发。

[槽（函数）] void QBluetoothServiceDiscoveryAgent::clear()

清除之前服务搜索的结果，并重置uuidFilter。在正在进行的搜索期间（请参阅isActive），此函数不执行任何操作。

另见：discoveredServices().

QList<QBluetoothServiceInfo> QBluetoothServiceDiscoveryAgent::discoveredServices() const

返回所有发现服务的列表。

该服务列表累积来自start()的多次调用中新发现的服务的列表。除非调用clear()，否则列表大小不能减小。这意味着如果远程蓝牙设备在两次连续调用start()之间移出范围，则列表可能会包含过时的条目。

另见：clear().

QBluetoothServiceDiscoveryAgent::Error QBluetoothServiceDiscoveryAgent::error() const

返回最后一次发生的错误类型。如果为单个远程地址执行服务发现，将返回在尝试在设备上发现服务时发生的错误。如果未设置remoteAddress()，并且通过扫描发现设备，则在单个设备上的服务发现期间的错误不会被保存，也不会发出信号。在这种情况下，由于某些设备可能不会响应该发现或不再在范围内，此类错误是正常的。这些错误会受到抑制。如果没有返回服务，则可以假设无法发现服务。

重新启动发现时，将清除任何可能的先前错误。

[signal, since 6.2] void QBluetoothServiceDiscoveryAgent::errorOccurred(QBluetoothServiceDiscoveryAgent::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 QList<QBluetoothUuid> &uuids)

设置 UUID 筛选器为 uuids。仅返回与 uuids 中的 UUID 匹配的服务。匹配适用于服务的 ServiceId 和 ServiceClassIds 属性。

空的 UUID 列表与仅包含 QBluetoothUuid::ServiceClassUuid::PublicBrowseGroup 的列表等价。

另请参阅 uuidFilter。

void QBluetoothServiceDiscoveryAgent::setUuidFilter(const QBluetoothUuid &uuid)

这是一个提供便利的重载成员函数。

设置 UUID 筛选器为包含单个元素 uuid 的列表。匹配适用于服务的 ServiceId 和 ServiceClassIds 属性。

另请参阅 uuidFilter。

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

启动服务发现。 mode 指定要执行的服务发现类型。

在某些平台中，设备发现可能会引发配对请求。

另请参阅 DiscoveryMode。

[slot] void QBluetoothServiceDiscoveryAgent::stop()

停止服务发现过程。一旦搜索停止，将发出 canceled() 信号。

QList<QBluetoothUuid> QBluetoothServiceDiscoveryAgent::uuidFilter() const

返回 UUID 筛选器。

另请参阅 setUuidFilter。