QBluetoothDeviceInfo Class

Dokumentation der Mitgliedsfunktionen

QBluetoothDeviceInfo::QBluetoothDeviceInfo()

Erstellt ein ungültiges „QBluetoothDeviceInfo“-Objekt.

QBluetoothDeviceInfo::QBluetoothDeviceInfo(const QBluetoothAddress &address, const QString &name, quint32 classOfDevice)

Erstellt ein „QBluetoothDeviceInfo“-Objekt mit der Bluetooth-Adresse address, dem Gerätenamen name und der kodierten Geräteklasse classOfDevice.

Der Parameter ` classOfDevice ` ist im folgenden Format kodiert

QBluetoothDeviceInfo::QBluetoothDeviceInfo(const QBluetoothUuid &uuid, const QString &name, quint32 classOfDevice)

Erstellt ein „QBluetoothDeviceInfo“-Objekt mit der eindeutigen „ uuid “, dem Gerätenamen „ name “ und der kodierten Geräteklasse „ classOfDevice “.

Dieser Konstruktor ist für Low-Energy-Geräte unter macOS und iOS erforderlich. Die CoreBluetooth-API verbirgt Adressen und stellt eindeutige UUIDs zur Identifizierung eines Geräts bereit. Diese UUID ist nicht mit einer Dienst-UUID identisch und wird benötigt, um später mit der CoreBluetooth-API und erkannten Geräten arbeiten zu können.

QBluetoothDeviceInfo::QBluetoothDeviceInfo(const QBluetoothDeviceInfo &other)

Erstellt ein `QBluetoothDeviceInfo`-Objekt, das eine Kopie von ` other` ist.

[noexcept] QBluetoothDeviceInfo::~QBluetoothDeviceInfo()

Zerstört die „ QBluetoothDeviceInfo “.

QBluetoothAddress QBluetoothDeviceInfo::address() const

Gibt die Adresse des Geräts zurück.

Siehe auch deviceUuid().

QBluetoothDeviceInfo::CoreConfigurations QBluetoothDeviceInfo::coreConfigurations() const

Gibt die Konfiguration des Geräts zurück. Ist keine Gerätekonfiguration festgelegt, wird die Standardkonfiguration des Geräts zurückgegeben.

Siehe auch setCoreConfigurations().

QBluetoothUuid QBluetoothDeviceInfo::deviceUuid() const

Gibt eine eindeutige Kennung für ein Bluetooth-Gerät ohne Adresse zurück.

Im Allgemeinen ist diese UUID auf allen Plattformen außer macOS und iOS ungültig. Sie wird als Workaround für diese beiden Plattformen verwendet, da diese keine Bluetooth-Adressen für gefundene Bluetooth-Low-Energy-Geräte bereitstellen. Alle anderen Plattformen verwenden stattdessen ` address()`.

Siehe auch ` setDeviceUuid()`.

bool QBluetoothDeviceInfo::isCached() const

Gibt „true“ zurück, wenn das „ QBluetoothDeviceInfo “-Objekt aus zwischengespeicherten Daten erstellt wurde.

bool QBluetoothDeviceInfo::isValid() const

Gibt „true“ zurück, wenn das „ QBluetoothDeviceInfo “-Objekt gültig ist, andernfalls „false“.

QBluetoothDeviceInfo::MajorDeviceClass QBluetoothDeviceInfo::majorDeviceClass() const

Gibt die Hauptgeräteklasse des Geräts zurück.

QMultiHash<quint16, QByteArray> QBluetoothDeviceInfo::manufacturerData() const

Gibt den vollständigen Satz aller Herstellerdaten aus Advertisement-Paketen zurück.

Einige Geräte stellen möglicherweise mehrere Herstellerdateneinträge pro Hersteller-ID bereit. Ein Beispiel hierfür wäre ein Bluetooth-Low-Energy-Gerät, das über Advertisement-Pakete und Scan-Antwortpakete jeweils unterschiedliche Herstellerdaten sendet. Daher kann die zurückgegebene Hash-Tabelle mehrere Einträge pro Hersteller-ID oder Hash-Schlüssel enthalten.

Siehe auch setManufacturerData.

QByteArray QBluetoothDeviceInfo::manufacturerData(quint16 manufacturerId) const

Gibt die Daten zurück, die dem angegebenen „ manufacturerId “ zugeordnet sind.

Herstellerdaten sind in der Ergänzung zur Bluetooth-Kernspezifikation definiert und bestehen aus zwei Segmenten:

• Herstellerspezifischer Identifikationscode aus dem Dokument „Assigned Numbers Company Identifiers“
• Eine Folge beliebiger Datenoktette

Die Interpretation der Datenoktette wird vom Hersteller festgelegt, der durch die Unternehmenskennung angegeben wird.

Siehe auch „ manufacturerIds()“ und „ setManufacturerData()“.

QList<quint16> QBluetoothDeviceInfo::manufacturerIds() const

Gibt alle Hersteller-IDs aus den Werbe-Paketen zurück, die diesen Geräteinformationen beigefügt sind.

Siehe auch manufacturerData() und setManufacturerData().

quint8 QBluetoothDeviceInfo::minorDeviceClass() const

Gibt die Minor-Gerätekategorie des Geräts zurück. Die tatsächlichen Informationen hängen kontextabhängig vom Wert von ` majorDeviceClass()` ab.

Siehe auch MinorAudioVideoClass, MinorComputerClass, MinorHealthClass, MinorImagingClass, MinorMiscellaneousClass, MinorNetworkClass, MinorPeripheralClass, MinorPhoneClass, MinorToyClass und MinorWearableClass.

QString QBluetoothDeviceInfo::name() const

Gibt den dem Gerät zugewiesenen Namen zurück.

Siehe auch „ setName()“.

qint16 QBluetoothDeviceInfo::rssi() const

Gibt die Signalstärke zum Zeitpunkt der letzten Erfassung des Geräts zurück

Siehe auch „ setRssi()“.

QBluetoothDeviceInfo::ServiceClasses QBluetoothDeviceInfo::serviceClasses() const

Gibt die Serviceklasse des Geräts zurück.

[since 6.3] QMultiHash<QBluetoothUuid, QByteArray> QBluetoothDeviceInfo::serviceData() const

Gibt den vollständigen Satz aller Dienstdaten aus Advertisement-Paketen zurück.

Einige Geräte stellen möglicherweise mehrere Dienstdateneinträge pro Dienstdaten-ID bereit. Ein Beispiel hierfür wäre ein Bluetooth-Low-Energy-Gerät, das über Advertisement-Pakete und Scan-Antwortpakete jeweils unterschiedliche Dienstdaten sendet. Daher kann die zurückgegebene Hash-Tabelle mehrere Einträge pro Dienstdaten-ID oder Hash-Schlüssel enthalten.

Diese Funktion wurde in Qt 6.3 eingeführt.

Siehe auch „ setServiceData “.

[since 6.3] QByteArray QBluetoothDeviceInfo::serviceData(const QBluetoothUuid &serviceId) const

Gibt die Daten zurück, die dem angegebenen „ serviceId “ zugeordnet sind.

Die Dienstdaten sind in der Ergänzung zur Bluetooth-Kernspezifikation definiert und bestehen aus zwei Segmenten:

• Dienst-UUID
• Folge beliebiger Datenoktette

Diese Funktion wurde in Qt 6.3 eingeführt.

Siehe auch ` serviceIds()` und ` setServiceData()`.

[since 6.3] QList<QBluetoothUuid> QBluetoothDeviceInfo::serviceIds() const

Gibt alle Service-Daten-IDs aus den Advertisement-Paketen zurück, die diesen Geräteinformationen zugeordnet sind.

Diese Funktion wurde in Qt 6.3 eingeführt.

Siehe auch „ serviceData()“ und „ setServiceData()“.

[since 6.0] QList<QBluetoothUuid> QBluetoothDeviceInfo::serviceUuids() const

Gibt die Liste der vom Gerät unterstützten Dienst-UUIDs zurück. In der Regel enthält diese Liste benutzerdefinierte Dienst-UUIDs oder einen Dienst-UUID-Wert, der über QBluetoothUuid::ServiceClassUuid festgelegt wurde.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch ` setServiceUuids()` und `serviceUuids()`.

void QBluetoothDeviceInfo::setCached(bool cached)

Wird vom System verwendet, um das Flag „ cached “ zu setzen, wenn die „ QBluetoothDeviceInfo “ aus zwischengespeicherten Daten erstellt wird. Zwischengespeicherte Informationen sind möglicherweise nicht so genau wie Daten, die von einem aktiven Gerät gelesen werden.

Siehe auch „ isCached()“.

void QBluetoothDeviceInfo::setCoreConfigurations(QBluetoothDeviceInfo::CoreConfigurations coreConfigs)

Setzt den „ CoreConfigurations “ des Geräts auf „ coreConfigs “. Dies hilft dabei, zwischen normalen und Low-Energy-Geräten zu unterscheiden.

Siehe auch coreConfigurations().

void QBluetoothDeviceInfo::setDeviceUuid(const QBluetoothUuid &uuid)

Legt die eindeutige Kennung uuid für Bluetooth-Geräte fest, die keine Adressen haben. Dies ist unter macOS und iOS der Fall, wo die CoreBluetooth-API Adressen verbirgt, aber UUIDs zur Identifizierung von Geräten/Peripheriegeräten bereitstellt.

Diese UUID ist auf allen anderen Plattformen ungültig.

Siehe auch deviceUuid().

bool QBluetoothDeviceInfo::setManufacturerData(quint16 manufacturerId, const QByteArray &data)

Legt die vom Hersteller angegebene data für die angegebene manufacturerId fest. Gibt true zurück, wenn sie eingefügt wurde, und false, wenn sie bereits bekannt war.

Seit Qt 5.14 ersetzen unterschiedliche Werte für ` data ` und denselben ` manufacturerId ` einander nicht mehr, sondern werden für die Dauer eines Gerätescans kumuliert.

Siehe auch „ manufacturerData “.

[since 6.2] void QBluetoothDeviceInfo::setName(const QString &name)

Legt die Funktion „ name “ des Geräts fest.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch ` name()`.

void QBluetoothDeviceInfo::setRssi(qint16 signal)

Legen Sie den Wert für die Stärke von „ signal “ fest, der intern verwendet wird.

Siehe auch ` rssi()`.

[since 6.3] bool QBluetoothDeviceInfo::setServiceData(const QBluetoothUuid &serviceId, const QByteArray &data)

Legt die angegebene Dienst- data für die angegebene serviceId fest. Gibt „ true “ zurück, wenn sie hinzugefügt wurde, und „ false “, wenn sie bereits bekannt war.

Diese Funktion wurde in Qt 6.3 eingeführt.

Siehe auch „ serviceData “.

void QBluetoothDeviceInfo::setServiceUuids(const QList<QBluetoothUuid> &uuids)

Setzt die Liste der Dienst-UUIDs auf „ uuids “.

Siehe auch serviceUuids().

QBluetoothDeviceInfo &QBluetoothDeviceInfo::operator=(const QBluetoothDeviceInfo &other)

Erstellt eine Kopie des Objekts „ other “ und weist sie diesem Objekt „ QBluetoothDeviceInfo “ zu.