QBluetoothServiceDiscoveryAgent Class

void MyClass::startServiceDiscovery() { // Erstellen Sie einen DiscoveryAgent und stellen Sie eine Verbindung zu seinen Signalen her  QBluetoothServiceDiscoveryAgent *discoveryAgent = new QBluetoothServiceDiscoveryAgent(this); connect(discoveryAgent, SIGNAL(serviceDiscovered(QBluetoothServiceInfo)), this, SLOT(serviceDiscovered(QBluetoothServiceInfo))); // Starten Sie eine Entdeckung discoveryAgent->start(); //...}// Lesen Sie in Ihrem lokalen Slot Informationen über die gefundenen Gerätevoid MyClass::serviceDiscovered(const QBluetoothServiceInfo &service){
    qDebug() << "Found new service:" << service.serviceName()
            << '('<< service.device().address().toString()<< ')'; }

Dokumentation der Mitgliedsfunktionen

[explicit] QBluetoothServiceDiscoveryAgent::QBluetoothServiceDiscoveryAgent(QObject *parent = nullptr)

Konstruiert einen neuen QBluetoothServiceDiscoveryAgent mit parent. Die Suche wird über den lokalen Standard-Bluetooth-Adapter durchgeführt.

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

Konstruiert einen neuen QBluetoothServiceDiscoveryAgent für deviceAdapter und mit parent.

Er verwendet deviceAdapter für die Dienstsuche. Wenn deviceAdapter standardmäßig konstruiert ist, verwendet das resultierende QBluetoothServiceDiscoveryAgent-Objekt den lokalen Standard-Bluetooth-Adapter.

Wenn ein deviceAdapter angegeben wird, der kein lokaler Adapter ist, wird error() auf InvalidBluetoothAdapterError gesetzt. Daher wird empfohlen, das Fehlerflag unmittelbar nach der Verwendung dieses Konstruktors zu testen.

Siehe auch error().

[virtual noexcept] QBluetoothServiceDiscoveryAgent::~QBluetoothServiceDiscoveryAgent()

Destruktor für QBluetoothServiceDiscoveryAgent

[signal] void QBluetoothServiceDiscoveryAgent::canceled()

Dieses Signal wird ausgelöst, wenn die Dienstsuche durch einen Aufruf von stop() abgebrochen wurde.

[slot] void QBluetoothServiceDiscoveryAgent::clear()

Löscht die Ergebnisse früherer Dienstermittlungen und setzt uuidFilter() zurück. Diese Funktion tut nichts während einer laufenden Dienstsuche (siehe isActive()).

Siehe auch discoveredServices().

QList<QBluetoothServiceInfo> QBluetoothServiceDiscoveryAgent::discoveredServices() const

Gibt die Liste aller entdeckten Dienste zurück.

Diese Liste der Dienste sammelt neu entdeckte Dienste aus mehreren Aufrufen von start(). Solange clear() nicht aufgerufen wird, kann die Liste nicht verkleinert werden. Das bedeutet, dass die Liste veraltete Einträge enthalten kann, wenn ein entferntes Bluetooth-Gerät zwischen zwei aufeinanderfolgenden Aufrufen von start() die Reichweite verlässt.

Siehe auch clear().

QBluetoothServiceDiscoveryAgent::Error QBluetoothServiceDiscoveryAgent::error() const

Gibt den Typ des zuletzt aufgetretenen Fehlers zurück. Wenn die Dienstsuche für ein einzelnes remoteAddress() durchgeführt wird, werden Fehler zurückgegeben, die beim Versuch, Dienste auf diesem Gerät zu finden, aufgetreten sind. Wenn remoteAddress() nicht gesetzt ist und Geräte durch einen Scan entdeckt werden, werden Fehler bei der Dienstsuche auf einzelnen Geräten nicht gespeichert und es werden keine Signale ausgegeben. In diesem Fall sind Fehler ziemlich normal, da einige Geräte möglicherweise nicht auf die Suche reagieren oder nicht mehr in Reichweite sind. Solche Fehler werden unterdrückt. Wenn keine Dienste zurückgegeben werden, kann davon ausgegangen werden, dass keine Dienste ermittelt werden konnten.

Eventuell vorher aufgetretene Fehler werden bei einem Neustart der Erkennung gelöscht.

[signal, since 6.2] void QBluetoothServiceDiscoveryAgent::errorOccurred(QBluetoothServiceDiscoveryAgent::Error error)

Dieses Signal wird ausgegeben, wenn ein error auftritt. Der Parameter error beschreibt den aufgetretenen Fehler.

Diese Funktion wurde in Qt 6.2 eingeführt.

QString QBluetoothServiceDiscoveryAgent::errorString() const

Gibt eine von Menschen lesbare Beschreibung des letzten Fehlers zurück, der während der Dienstsuche aufgetreten ist.

Siehe auch error() und errorOccurred().

[signal] void QBluetoothServiceDiscoveryAgent::finished()

Dieses Signal wird ausgegeben, wenn die Bluetooth-Dienstsuche abgeschlossen ist.

Im Gegensatz zum Signal QBluetoothDeviceDiscoveryAgent::finished() wird dieses Signal auch dann ausgegeben, wenn während der Dienstsuche ein Fehler aufgetreten ist. Es wird daher empfohlen, das Signal errorOccurred() zu überprüfen, um den Erfolg der Dienstsuche zu bewerten.

bool QBluetoothServiceDiscoveryAgent::isActive() const

Gibt true zurück, wenn die Dienstermittlung gerade aktiv ist; andernfalls wird false zurückgegeben. Eine aktive Ermittlung kann durch den Aufruf von stop() beendet werden.

QBluetoothAddress QBluetoothServiceDiscoveryAgent::remoteAddress() const

Gibt die Adresse des entfernten Geräts zurück. Wenn setRemoteAddress() nicht aufgerufen wird, gibt die Funktion eine Standardkonstruktion QBluetoothAddress zurück.

Siehe auch setRemoteAddress().

[signal] void QBluetoothServiceDiscoveryAgent::serviceDiscovered(const QBluetoothServiceInfo &info)

Dieses Signal wird ausgesendet, wenn der durch info beschriebene Bluetooth-Dienst entdeckt wird.

Siehe auch QBluetoothDeviceInfo::coreConfigurations().

bool QBluetoothServiceDiscoveryAgent::setRemoteAddress(const QBluetoothAddress &address)

Setzt die Adresse des entfernten Geräts auf address. Wenn address standardmäßig eingerichtet ist, werden die Dienste auf allen kontaktierbaren Bluetooth-Geräten ermittelt. Eine neue entfernte Adresse kann nur eingestellt werden, wenn keine Dienstsuche läuft; andernfalls gibt diese Funktion false zurück.

Auf einigen Plattformen kann die Dienstsuche zu Pairing-Anfragen führen. Daher ist es nicht empfehlenswert, die Dienstsuche auf allen Geräten durchzuführen. Diese Funktion kann verwendet werden, um die Dienstsuche auf ein bestimmtes Gerät zu beschränken.

Siehe auch remoteAddress().

void QBluetoothServiceDiscoveryAgent::setUuidFilter(const QBluetoothUuid &uuid)

Dies ist eine überladene Funktion, die der Einfachheit halber bereitgestellt wird.

Setzt den UUID-Filter auf eine Liste, die das einzelne Element uuid enthält. Der Abgleich gilt für die Attribute ServiceId und ServiceClassIds des Dienstes.

Siehe auch uuidFilter().

void QBluetoothServiceDiscoveryAgent::setUuidFilter(const QList<QBluetoothUuid> &uuids)

Setzt den UUID-Filter auf uuids. Nur Dienste, die mit den UUIDs in uuids übereinstimmen, werden zurückgegeben. Der Abgleich gilt für die Attribute ServiceId und ServiceClassIds des Dienstes.

Eine leere UUID-Liste ist gleichbedeutend mit einer Liste, die nur QBluetoothUuid::ServiceClassUuid::PublicBrowseGroup enthält.

Siehe auch uuidFilter().

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

Startet die Diensteerkennung. mode gibt die Art der durchzuführenden Diensteerkennung an.

Auf einigen Plattformen kann die Geräteerkennung zu Pairing-Anfragen führen.

Siehe auch DiscoveryMode.

[slot] void QBluetoothServiceDiscoveryAgent::stop()

Hält den Prozess der Dienstsuche an. Das Signal canceled() wird ausgegeben, sobald die Suche beendet ist.

QList<QBluetoothUuid> QBluetoothServiceDiscoveryAgent::uuidFilter() const

Gibt den UUID-Filter zurück.

Siehe auch setUuidFilter().