QBluetoothLocalDevice Class

Dokumentation der Mitgliedsfunktionen

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

Erstellt ein `QBluetoothLocalDevice` mit ` parent`.

Siehe auch ` isValid()`.

[explicit] QBluetoothLocalDevice::QBluetoothLocalDevice(const QBluetoothAddress &address, QObject *parent = 0)

Erstellen Sie ein neues `QBluetoothLocalDevice` für ` address`. Wenn ` address ` mit der Standardkonstruktion initialisiert wird, wählt das resultierende lokale Gerät das lokale Standardgerät aus.

Siehe auch ` isValid()`.

[virtual noexcept] QBluetoothLocalDevice::~QBluetoothLocalDevice()

Zerstört die „ QBluetoothLocalDevice “.

QBluetoothAddress QBluetoothLocalDevice::address() const

Gibt die MAC-Adresse dieses Bluetooth-Geräts zurück.

[static] QList<QBluetoothHostInfo> QBluetoothLocalDevice::allDevices()

Gibt eine Liste aller verfügbaren lokalen Bluetooth-Geräte zurück. Unter macOS gibt es nur das „Standard“-Gerät.

QList<QBluetoothAddress> QBluetoothLocalDevice::connectedDevices() const

Gibt die Liste der verbundenen Geräte zurück. Diese Liste unterscheidet sich von der Liste der aktuell gekoppelten Geräte.

Unter Android und macOS ist es nicht möglich, eine Liste der verbundenen Geräte abzurufen. Es ist lediglich möglich, Änderungen bei der Verbindung bzw. Trennung zu überwachen. Der Einfachheit halber überwacht diese Klasse seit ihrer Instanziierung alle Verbindungs- und Trennungsereignisse und gibt beim Aufruf dieser Funktion die aktuelle Liste zurück. Daher ist es möglich, dass diese Funktion kurz nach der Erstellung einer Instanz eine leere Liste zurückgibt.

Siehe auch „ deviceConnected()“ und „ deviceDisconnected()“.

[signal] void QBluetoothLocalDevice::deviceConnected(const QBluetoothAddress &address)

Dieses Signal wird ausgegeben, wenn das lokale Gerät eine Verbindung zu einem entfernten Gerät mit der Funktion „ address “ herstellt.

Siehe auch „ deviceDisconnected()“ und „ connectedDevices()“.

[signal] void QBluetoothLocalDevice::deviceDisconnected(const QBluetoothAddress &address)

Dieses Signal wird ausgegeben, wenn das lokale Gerät die Verbindung zu einem entfernten Bluetooth-Gerät mit der Funktion „ address “ trennt.

Siehe auch „ deviceConnected()“ und „ connectedDevices()“.

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

Es wird ein Signal ausgelöst, wenn beim Koppeln ein Ausnahme error auftritt.

Diese Funktion wurde in Qt 6.2 eingeführt.

QBluetoothLocalDevice::HostMode QBluetoothLocalDevice::hostMode() const

Gibt den aktuellen Host-Modus dieses lokalen Bluetooth-Geräts zurück. Unter macOS ist dies entweder „ HostPoweredOff “ oder „ HostConnectable “.

Siehe auch „ setHostMode()“.

[signal] void QBluetoothLocalDevice::hostModeStateChanged(QBluetoothLocalDevice::HostMode state)

Die „ state “ des Betreibers ist nun unter einer anderen Adresse erreichbar: HostMode.

bool QBluetoothLocalDevice::isValid() const

Gibt „ true “ zurück, wenn „ QBluetoothLocalDevice “ ein verfügbares lokales Bluetooth-Gerät darstellt; andernfalls wird „false“ zurückgegeben.

Wird der durch eine Instanz dieser Klasse repräsentierte lokale Bluetooth-Adapter aus dem System entfernt (z. B. durch Entfernen des zugrunde liegenden Bluetooth-Dongles), wird diese Instanz ungültig. Eine bereits ungültige QBluetoothLocalDevice -Instanz bleibt auch dann ungültig, wenn derselbe Bluetooth-Adapter wieder an das System angeschlossen wird.

Siehe auch ` allDevices()`.

QString QBluetoothLocalDevice::name() const

Gibt den Namen zurück, den der Benutzer diesem Bluetooth-Gerät zugewiesen hat.

[signal] void QBluetoothLocalDevice::pairingFinished(const QBluetoothAddress &address, QBluetoothLocalDevice::Pairing pairing)

Die Kopplung bzw. das Aufheben der Kopplung wurde mit ` address` abgeschlossen. Der aktuelle Kopplungsstatus ist in ` pairing` zu finden. Wenn die Kopplungsanfrage nicht erfolgreich war, wird dieses Signal nicht ausgegeben. Das Signal ` errorOccurred()` wird ausgegeben, wenn die Kopplungsanfrage fehlgeschlagen ist. Das Signal wird ausschließlich für Kopplungsanfragen ausgegeben, die zuvor durch den Aufruf von ` requestPairing()` der aktuellen Objektinstanz angefordert wurden.

QBluetoothLocalDevice::Pairing QBluetoothLocalDevice::pairingStatus(const QBluetoothAddress &address) const

Gibt den aktuellen Bluetooth-Kopplungsstatus von „ address “ zurück: „nicht gekoppelt“, „gekoppelt“ oder „gekoppelt und autorisiert“.

void QBluetoothLocalDevice::powerOn()

Schaltet das Gerät ein, nachdem es in den Zustand „ hostMode “ () zurückversetzt wurde, sofern es ausgeschaltet war.

void QBluetoothLocalDevice::requestPairing(const QBluetoothAddress &address, QBluetoothLocalDevice::Pairing pairing)

Legen Sie den Status „ pairing “ mit „ address “ fest. Die Ergebnisse werden über das Signal „ pairingFinished()“ zurückgegeben.

Unter Android und macOS ist der Status „ AuthorizedPaired “ nicht möglich und verhält sich wie „Paired“. Unter Windows liegt die Entscheidung über den genauen Kopplungsmodus beim Betriebssystem.

Unter macOS ist es nicht möglich, die Kopplung eines Geräts aufzuheben. Wird „Unpaired“ angefordert, wird sofort „ pairingFinished()“ ausgelöst, obwohl das Gerät weiterhin gekoppelt bleibt. Es ist möglich, die Kopplung für ein zuvor entkoppeltes Gerät anzufordern. Zudem verhält sich „ AuthorizedPaired “ genauso wie „ Paired “.

Achtung: Das Herstellen einer Kopplung kann einige Minuten dauern und erfordert möglicherweise eine Bestätigung durch den Benutzer.

void QBluetoothLocalDevice::setHostMode(QBluetoothLocalDevice::HostMode mode)

Stellt den Host-Modus dieses lokalen Bluetooth-Geräts auf „ mode “ ein.

Bestimmte Vorgänge, wie das Ein- oder Ausschalten des Geräts, können einige Zeit in Anspruch nehmen. Daher sollten nachfolgende Aufrufe erst erfolgen, nachdem das Signal „ hostModeStateChanged()“ die vorherige Anfrage abgeschlossen hat. Wird dies ignoriert, ist das Ergebnis einer solchen Aufrufkette nicht eindeutig definiert.

Siehe auch ` hostMode()`.