QBluetoothPermission Class
Auf Bluetooth-Peripheriegeräte zugreifen. Mehr...
| Überschrift: | #include <QPermissions> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
| Seit: | Qt 6.5 |
Öffentliche Typen
(since 6.6) enum | CommunicationMode { Access, Advertise, Default } |
| flags | CommunicationModes |
Öffentliche Funktionen
(since 6.6) QBluetoothPermission::CommunicationModes | communicationModes() const |
(since 6.6) void | setCommunicationModes(QBluetoothPermission::CommunicationModes modes) |
Ausführliche Beschreibung
Voraussetzungen
Um diese Berechtigung zur Laufzeit anzufordern, müssen bei der Erstellung die folgenden plattformspezifischen Verwendungsdeklarationen vorgenommen werden:
| Plattform | Typ | |
|---|---|---|
| Apple | Verwendungsbeschreibung | NSBluetoothAlwaysUsageDescription |
| Android | uses-permission | Bis Android 11 (API-Level < 31):
Ab Android 12 (API-Level >= 31):
|
Informationen dazu, wie Sie die einzelnen Arten von Nutzungserklärungen zu Ihrem Projekt hinzufügen können, finden Sie in den jeweiligen Beschreibungen.
Hinweis: Seit Qt 6.8.1 wird die Berechtigung „ACCESS_FINE_LOCATION“ bei einer API-Stufe >= 31 nicht mehr angefordert. Dies kann zu Einschränkungen bei einigen Bluetooth-Scan-Ergebnissen führen. Benutzer, die diese Ergebnisse benötigen, müssen die Standortberechtigung separat anfordern (siehe precise location) und sicherstellen, dass für die Berechtigung „ BLUETOOTH_SCAN “ das Attribut „ android:usesPermissionFlags="neverForLocation" “ nicht gesetzt ist. Informationen zum Festlegen und Anpassen von Berechtigungen im Anwendungsmanifest finden Sie in dieser Anleitung.
Siehe auch QPermission, QCoreApplication::requestPermission(), QCoreApplication::checkPermission() und Anwendungsberechtigungen.
Dokumentation zu Mitgliedstypen
[since 6.6] enum QBluetoothPermission::CommunicationMode
flags QBluetoothPermission::CommunicationModes
Diese Enumeration dient zur Steuerung der zulässigen Bluetooth-Kommunikationsmodi.
| Konstante | Wert | Beschreibung |
|---|---|---|
QBluetoothPermission::Access | 0x01 | Erlaubt diesem Gerät den Zugriff auf andere Bluetooth-Geräte. Dazu gehören das Suchen nach Geräten in der Nähe und das Herstellen einer Verbindung zu diesen. |
QBluetoothPermission::Advertise | 0x02 | Ermöglicht anderen Bluetooth-Geräten, dieses Gerät zu erkennen. |
QBluetoothPermission::Default | Access | Advertise | Diese Konfiguration ist standardmäßig aktiviert. Hinweis: Die detaillierten Berechtigungen werden derzeit nur unter Android 12 und neuer unterstützt. Bei älteren Android-Versionen sowie auf Apple-Betriebssystemen führt jeder Modus zu uneingeschränktem Bluetooth-Zugriff. |
Diese Enumeration wurde in Qt 6.6 eingeführt.
Der Typ „CommunicationModes“ ist ein typedef für QFlags<CommunicationMode>. Er speichert eine ODER-Kombination von CommunicationMode-Werten.
Dokumentation der Mitgliedsfunktionen
[since 6.6] QBluetoothPermission::CommunicationModes QBluetoothPermission::communicationModes() const
Gibt die zulässigen Bluetooth-Kommunikationsmodi zurück.
Diese Funktion wurde in Qt 6.6 eingeführt.
Siehe auch ` setCommunicationModes()`.
[since 6.6] void QBluetoothPermission::setCommunicationModes(QBluetoothPermission::CommunicationModes modes)
Legt die zulässigen Bluetooth-Kommunikationsmodi auf „ modes “ fest.
Hinweis: Eine standardmäßig konstruierte Instanz von „ CommunicationModes “ ist nicht sinnvoll, daher löst der Versuch, einen solchen Modus festzulegen, eine „ qWarning() “ aus und es wird auf den Modus „ Default “ zurückgegriffen.
Diese Funktion wurde in Qt 6.6 eingeführt.
Siehe auch ` communicationModes()`.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
