QBluetoothServiceDiscoveryAgent Class

void MyClass::startServiceDiscovery()
{

    // Einen Discovery-Agent erstellen und eine Verbindung zu dessen Signalen herstellen
    QBluetoothServiceDiscoveryAgent*discoveryAgent = new QBluetoothServiceDiscoveryAgent(this);
    connect(discoveryAgent, SIGNAL(serviceDiscovered(QBluetoothServiceInfo)),
            this, SLOT(serviceDiscovered(QBluetoothServiceInfo)));

    // Eine Erkennung starten
    discoveryAgent->start();

    //...
}

// In deinem lokalen Slot Informationen über die gefundenen Geräte auslesen
void MyClass::serviceDiscovered(const QBluetoothServiceInfo&service)
{
    qDebug() << "Found new service:" << service.serviceName()
            << '(' << service.device().address().toString() << ')';
}

Dokumentation der Member-Funktionen

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

Erstellt einen neuen `QBluetoothServiceDiscoveryAgent` mit dem Parameter ` parent`. Die Suche erfolgt über den lokalen Standard-Bluetooth-Adapter.

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

Erstellt einen neuen `QBluetoothServiceDiscoveryAgent` für ` deviceAdapter ` und mit ` parent`.

Für die Dienstsuche wird ` deviceAdapter ` verwendet. Wird ` deviceAdapter ` standardmäßig initialisiert, verwendet das resultierende `QBluetoothServiceDiscoveryAgent`-Objekt den lokalen Standard-Bluetooth-Adapter.

Wird ein „ deviceAdapter “ angegeben, der kein lokaler Adapter ist, wird „ error()“ auf „ InvalidBluetoothAdapterError “ gesetzt. Daher wird empfohlen, das Fehlerflag unmittelbar nach der Verwendung dieses Konstruktors zu prüfen.

Siehe auch ` error()`.

[virtual noexcept] QBluetoothServiceDiscoveryAgent::~QBluetoothServiceDiscoveryAgent()

Destruktor für QBluetoothServiceDiscoveryAgent

[signal] void QBluetoothServiceDiscoveryAgent::canceled()

Dieses Signal wird ausgelöst, wenn die Service-Erkennung durch einen Aufruf von ` stop()` abgebrochen wurde.

[slot] void QBluetoothServiceDiscoveryAgent::clear()

Löscht die Ergebnisse früherer Diensterkennungen und setzt „ uuidFilter “ () zurück. Diese Funktion hat keine Auswirkung auf eine laufende Diensterkennung (siehe „ isActive “ ()).

Siehe auch discoveredServices().

QList<QBluetoothServiceInfo> QBluetoothServiceDiscoveryAgent::discoveredServices() const

Gibt die Liste aller erkannten Dienste zurück.

Diese Liste von Diensten sammelt neu erkannte Dienste aus mehreren Aufrufen von ` start()` an. Solange ` clear()` nicht aufgerufen wird, kann die Liste nicht kleiner werden. Das bedeutet, dass die Liste veraltete Einträge enthalten kann, wenn sich ein entferntes Bluetooth-Gerät zwischen zwei aufeinanderfolgenden Aufrufen von ` start()` außerhalb der Reichweite bewegt.

Siehe auch clear().

QBluetoothServiceDiscoveryAgent::Error QBluetoothServiceDiscoveryAgent::error() const

Gibt den Typ des zuletzt aufgetretenen Fehlers zurück. Wenn die Dienstermittlung für ein einzelnes Gerät mit ` remoteAddress()` durchgeführt wird, werden Fehler zurückgegeben, die beim Versuch der Dienstermittlung auf diesem Gerät aufgetreten sind. Ist ` remoteAddress()` nicht gesetzt und werden Geräte durch einen Scan ermittelt, werden Fehler während der Dienstermittlung auf einzelnen Geräten nicht gespeichert und es werden keine Signale ausgegeben. In diesem Fall sind Fehler durchaus normal, da einige Geräte möglicherweise nicht auf die Erkennung reagieren oder sich nicht mehr in Reichweite befinden. Solche Fehler werden unterdrückt. Werden keine Dienste zurückgegeben, kann davon ausgegangen werden, dass keine Dienste erkannt werden konnten.

Etwaige zuvor aufgetretene Fehler werden beim Neustart der Erkennung zurückgesetzt.

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

Dieses Signal wird ausgelöst, 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 für Menschen lesbare Beschreibung des letzten Fehlers zurück, der während der Service-Erkennung 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 ausgelöst, wenn während der Dienstsuche ein Fehler aufgetreten ist. Daher wird empfohlen, das Signal „ errorOccurred()“ zu überprüfen, um den Erfolg der Dienstsuche zu bewerten.

bool QBluetoothServiceDiscoveryAgent::isActive() const

Gibt „ true “ zurück, wenn die Diensterkennung derzeit aktiv ist; andernfalls wird „ false “ zurückgegeben. Eine aktive Diensterkennung kann durch den Aufruf von „ stop()“ gestoppt werden.

QBluetoothAddress QBluetoothServiceDiscoveryAgent::remoteAddress() const

Gibt die Adresse des Remote-Geräts zurück. Wird setRemoteAddress() nicht aufgerufen, gibt die Funktion ein standardmäßig initialisiertes QBluetoothAddress zurück.

Siehe auch setRemoteAddress().

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

Dieses Signal wird ausgesendet, wenn der unter info beschriebene Bluetooth-Dienst erkannt wird.

Siehe auch QBluetoothDeviceInfo::coreConfigurations().

bool QBluetoothServiceDiscoveryAgent::setRemoteAddress(const QBluetoothAddress &address)

Setzt die Adresse des Remote-Geräts auf address. Wenn address standardmäßig erstellt wird, werden Dienste auf allen erreichbaren Bluetooth-Geräten erkannt. Eine neue Remote-Adresse kann nur festgelegt werden, solange keine Dienstermittlung läuft; andernfalls gibt diese Funktion „false“ zurück.

Auf einigen Plattformen kann die Dienstermittlung zu Kopplungsanfragen führen. Daher wird davon abgeraten, eine Dienstermittlung auf allen Geräten durchzuführen. Mit dieser Funktion lässt sich die Dienstermittlung auf ein bestimmtes Gerät beschränken.

Siehe auch ` remoteAddress()`.

void QBluetoothServiceDiscoveryAgent::setUuidFilter(const QBluetoothUuid &uuid)

Dies ist eine überladene Member-Funktion, die aus Gründen der Benutzerfreundlichkeit bereitgestellt wird.

Setzt den UUID-Filter auf eine Liste, die das einzelne Element „ uuid “ enthält. Die Übereinstimmungsprüfung bezieht sich auf die Attribute „ ServiceId “ und „ ServiceClassIds “ des Dienstes.

Siehe auch ` uuidFilter()`.

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

Setzt den UUID-Filter auf uuids. Es werden nur Dienste zurückgegeben, deren UUIDs mit denen unter uuids übereinstimmen. Die Übereinstimmung bezieht sich auf die Attribute „ ServiceId “ und „ ServiceClassIds “ des Dienstes.

Eine leere UUID-Liste entspricht einer Liste, die ausschließlich QBluetoothUuid::ServiceClassUuid::PublicBrowseGroup enthält.

Siehe auch uuidFilter().

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

Startet die Dienstermittlung. Mit „ mode “ wird die Art der durchzuführenden Dienstermittlung festgelegt.

Auf einigen Plattformen kann die Geräteerkennung zu Kopplungsanfragen führen.

Siehe auch DiscoveryMode.

[slot] void QBluetoothServiceDiscoveryAgent::stop()

Beendet den Prozess der Dienstermittlung. Sobald die Suche beendet ist, wird das Signal „ canceled()“ ausgesendet.

QList<QBluetoothUuid> QBluetoothServiceDiscoveryAgent::uuidFilter() const

Gibt den UUID-Filter zurück.

Siehe auch setUuidFilter().