QBluetoothLocalDevice Class

Dokumentation der Mitgliederfunktionen

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

Konstruiert ein QBluetoothLocalDevice mit parent.

Siehe auch isValid().

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

Konstruieren Sie ein neues QBluetoothLocalDevice für address. Wenn address standardmäßig konstruiert ist, 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"-Lokalgerä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 nur möglich, auf Änderungen beim (Trennen) der Verbindung zu hören. Der Einfachheit halber überwacht diese Klasse alle Verbindungs- und Trennungsereignisse seit ihrer Instanzierung 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 ausgesendet, wenn das lokale Gerät eine Verbindung zu einem entfernten Gerät mit address herstellt.

Siehe auch deviceDisconnected() und connectedDevices().

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

Dieses Signal wird ausgesendet, wenn das lokale Gerät die Verbindung zu einem entfernten Bluetooth-Gerät mit address trennt.

Siehe auch deviceConnected() und connectedDevices().

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

Signal, das ausgegeben wird, wenn beim Pairing ein außergewöhnliches 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 Gastgebers ist auf eine andere HostMode umgezogen.

bool QBluetoothLocalDevice::isValid() const

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

Wenn der lokale Bluetooth-Adapter, der durch eine Instanz dieser Klasse repräsentiert wird, aus dem System entfernt wird (z. B. durch Entfernen des zugrundeliegenden Bluetooth-Dongles), wird diese Instanz ungültig. Eine bereits ungültige QBluetoothLocalDevice Instanz bleibt ungültig, auch wenn derselbe Bluetooth-Adapter zum System zurückgebracht 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)

Das Pairing oder Unpairing wurde mit address abgeschlossen. Der aktuelle Pairing-Status steht in pairing. Wenn die Pairing-Anforderung nicht erfolgreich war, wird dieses Signal nicht ausgegeben. Das Signal errorOccurred() wird ausgegeben, wenn die Pairing-Anforderung fehlgeschlagen ist. Das Signal wird immer nur für Paarungsanforderungen ausgegeben, die zuvor durch den Aufruf requestPairing() der aktuellen Objektinstanz angefordert wurden.

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

Gibt den aktuellen Bluetooth-Pairing-Status von address zurück, d. h. ob es ungepaart, gepaart oder gepaart und autorisiert ist.

void QBluetoothLocalDevice::powerOn()

Schaltet das Gerät ein, nachdem es in den Zustand hostMode() zurückgekehrt ist, wenn es ausgeschaltet war.

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

Setzen Sie den Status pairing mit address. Die Ergebnisse werden durch das Signal pairingFinished() zurückgegeben.

Unter Android und macOS ist AuthorizedPaired nicht möglich und hat das gleiche Verhalten wie Paired. Unter Windows hängt die genaue Entscheidung über den Kopplungsmodus vom Betriebssystem ab.

Unter macOS ist es nicht möglich, ein Gerät zu entpaaren. Wenn Unpaired angefordert wird, wird sofort pairingFinished() ausgegeben, obwohl das Gerät gepaart bleibt. Es ist möglich, das Pairing für ein zuvor ungepaartes Gerät anzufordern. Außerdem hat AuthorizedPaired das gleiche Verhalten wie Paired.

Achtung: Das Erstellen eines Pairings kann einige Minuten dauern und erfordert möglicherweise eine Bestätigung durch den Benutzer.

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

Setzt den Host-Modus dieses lokalen Bluetooth-Geräts auf mode.

Einige Vorgänge wie das Ein- oder Ausschalten des Geräts können einige Zeit dauern. Daher sollten nachfolgende Anrufe erst erfolgen, wenn das Signal hostModeStateChanged() die vorherige Anfrage abgeschlossen hat. Wenn dies ignoriert wird, ist das Ergebnis einer solchen Reihe von Aufrufen nicht eindeutig.

Siehe auch hostMode().