QBluetoothPermission Class
Acceder a los dispositivos periféricos Bluetooth. Más...
| Encabezado: | #include <QPermissions> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
| Desde: | Qt 6.5 |
Tipos públicos
(since 6.6) enum | CommunicationMode { Access, Advertise, Default } |
| flags | CommunicationModes |
Funciones públicas
(since 6.6) QBluetoothPermission::CommunicationModes | communicationModes() const |
(since 6.6) void | setCommunicationModes(QBluetoothPermission::CommunicationModes modes) |
Descripción detallada
Requisitos
Para solicitar este permiso en tiempo de ejecución, deben realizarse las siguientes declaraciones de uso específicas de la plataforma en el momento de la compilación:
| Plataforma | Tipo | |
|---|---|---|
| Apple | Descripción del uso | NSBluetoothAlwaysUsageDescription |
| Android | uses-permission | Hasta Android 11 (nivel de API < 31):
A partir de Android 12 (nivel de API >= 31):
|
Consulta los tipos de declaración de uso individuales para saber cómo añadirlos a tu proyecto.
Nota: A partir de Qt 6.8.1, ya no se solicita el permiso ACCESS_FINE_LOCATION si el nivel de API es ≥ 31. Esto puede limitar algunos resultados de la búsqueda por Bluetooth. Los usuarios que necesiten estos resultados deben solicitar el permiso de ubicación por separado (véase precise location) y asegurarse de que el permiso « BLUETOOTH_SCAN » no tenga establecido el atributo « android:usesPermissionFlags="neverForLocation" ». Para configurar y personalizar los permisos en el manifiesto de la aplicación, consulta esta guía.
Véase también QPermission, QCoreApplication::requestPermission(), QCoreApplication::checkPermission() y Permisos de la aplicación.
Documentación sobre tipos de miembros
[since 6.6] enum QBluetoothPermission::CommunicationMode
flags QBluetoothPermission::CommunicationModes
Esta enumeración se utiliza para controlar los modos de comunicación Bluetooth permitidos.
| Constante | Valor | Descripción |
|---|---|---|
QBluetoothPermission::Access | 0x01 | Permite que este dispositivo acceda a otros dispositivos Bluetooth. Esto incluye la búsqueda de dispositivos cercanos y la conexión con ellos. |
QBluetoothPermission::Advertise | 0x02 | Permite que otros dispositivos Bluetooth detecten este dispositivo. |
QBluetoothPermission::Default | Access | Advertise | Esta configuración se utiliza de forma predeterminada. Nota: Los permisos detallados solo son compatibles actualmente con Android 12 y versiones posteriores. En versiones anteriores de Android, así como en los sistemas operativos de Apple, cualquier modo da lugar a un acceso completo a Bluetooth. |
Esta enumeración se introdujo en Qt 6.6.
El tipo CommunicationModes es un typedef de QFlags<CommunicationMode>. Almacena una combinación OR de valores de CommunicationMode.
Documentación de las funciones de miembro
[since 6.6] QBluetoothPermission::CommunicationModes QBluetoothPermission::communicationModes() const
Devuelve los modos de comunicación Bluetooth permitidos.
Esta función se introdujo en Qt 6.6.
Véase también setCommunicationModes().
[since 6.6] void QBluetoothPermission::setCommunicationModes(QBluetoothPermission::CommunicationModes modes)
Establece los modos de comunicación Bluetooth permitidos en « modes ».
Nota: Una instancia de CommunicationModes creada de forma predeterminada no tiene sentido, por lo que cualquier intento de establecer dicho modo provocará una excepción de tipo « qWarning() » y se recurrirá al modo Default.
Esta función se introdujo en Qt 6.6.
Véase también ` 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.