QBluetoothPermission Class
Zugriff auf Bluetooth-Peripheriegeräte. Mehr...
| Header: | #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) |
Detaillierte Beschreibung
Anforderungen
Um diese Berechtigung zur Laufzeit anzufordern, müssen die folgenden plattformspezifischen Verwendungsdeklarationen zur Erstellungszeit vorgenommen werden:
| Plattform | Typ | |
|---|---|---|
| Apple | Beschreibung der Verwendung | NSBluetoothAlwaysUsageDescription |
| Android | uses-permission | Bis zu Android 11 (API Level < 31):
Ab Android 12 (API Level >= 31):
|
Bitte lesen Sie in den einzelnen Verwendungsdeklarationsarten nach, wie Sie diese zu Ihrem Projekt hinzufügen können.
Hinweis: Seit Qt 6.8.1 wird die Berechtigung ACCESS_FINE_LOCATION nicht mehr angefordert, wenn der API Level >= 31 ist. Dies kann einige Bluetooth-Scanergebnisse einschränken. Benutzer, die diese Ergebnisse benötigen, müssen die Standortberechtigung separat anfordern (siehe precise location) und sicherstellen, dass für die Berechtigung BLUETOOTH_SCAN nicht das Attribut android:usesPermissionFlags="neverForLocation" 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.
Mitgliedstyp Dokumentation
[since 6.6] enum QBluetoothPermission::CommunicationMode
flags QBluetoothPermission::CommunicationModes
Diese Aufzählung wird verwendet, um die zulässigen Bluetooth-Kommunikationsmodi zu steuern.
| Konstante | Wert | Beschreibung |
|---|---|---|
QBluetoothPermission::Access | 0x01 | Erlaubt diesem Gerät, auf andere Bluetooth-Geräte zuzugreifen. Dazu gehört das Scannen nach Geräten in der Nähe und das Herstellen einer Verbindung mit ihnen. |
QBluetoothPermission::Advertise | 0x02 | Erlaubt anderen Bluetooth-Geräten, dieses Gerät zu erkennen. |
QBluetoothPermission::Default | Access | Advertise | Diese Konfiguration wird standardmäßig verwendet. |
Hinweis: Die fein abgestuften Berechtigungen werden derzeit nur von Android 12 und neueren Versionen unterstützt. Auf älteren Android-Versionen sowie auf Apple-Betriebssystemen führt jeder Modus zu vollem Bluetooth-Zugriff.
Diese Aufzählung 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 erlaubten 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)
Setzt die zulässigen Bluetooth-Kommunikationsmodi auf modes.
Hinweis: Eine standardmäßig erstellte Instanz von CommunicationModes hat keinen Sinn, so dass ein Versuch, einen solchen Modus zu setzen, einen qWarning() auslöst und auf den Default Modus zurückfällt.
Diese Funktion wurde in Qt 6.6 eingeführt.
Siehe auch communicationModes().
© 2025 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.
