En esta página

Permisos de las aplicaciones

Muchas de las funciones de los dispositivos y sistemas operativos actuales pueden tener importantes repercusiones en materia de privacidad, seguridad y rendimiento si se utilizan de forma indebida. Por ello, es cada vez más habitual que las plataformas exijan el consentimiento explícito del usuario antes de acceder a dichas funciones.

Las API de permisos de Qt permiten a la aplicación comprobar o solicitar permisos para dichas funciones de forma multiplataforma.

Uso

Una función que suele requerir el consentimiento del usuario es el acceso al micrófono del dispositivo. Una aplicación para grabar notas de voz podría tener, en un principio, un aspecto similar al siguiente:

void VoiceMemoWidget::onRecordingInitiated()
{
    m_microphone->startRecording();
}

Para garantizar que esta aplicación funcione correctamente en plataformas que requieran el consentimiento del usuario para acceder al micrófono, la ampliaríamos de la siguiente manera:

void VoiceMemoWidget::onRecordingInitiated()
{
    QMicrophonePermission microphonePermission;
    switch (qApp->checkPermission(microphonePermission)) {
    case Qt::PermissionStatus::Undetermined:
        qApp->requestPermission(microphonePermission, this,
                   &VoiceMemoWidget::onRecordingInitiated);
        return;
    case Qt::PermissionStatus::Denied:
        m_permissionInstructionsDialog->show();
        return;
    case Qt::PermissionStatus::Granted:
        m_microphone->startRecording();
    }
}

En primer lugar, comprobamos si ya conocemos el estado del permiso del micrófono. Si no es así, iniciamos una solicitud de permiso para determinar el estado actual, lo que posiblemente implicará pedir el consentimiento del usuario. Conectamos el resultado de la solicitud a la ranura en la que ya nos encontramos, de modo que tengamos otra oportunidad de evaluar el estado del permiso.

Una vez conocido el estado del permiso, ya sea porque se nos había concedido o denegado anteriormente, o tras recibir el resultado de la solicitud que acabamos de iniciar, redirigimos al usuario a un cuadro de diálogo en el que se explica por qué no podemos grabar notas de voz en este momento (si se ha denegado el permiso), o bien procedemos a utilizar el micrófono (si se ha concedido el permiso).

Nota: En macOS e iOS, actualmente solo se pueden solicitar permisos para aplicaciones con interfaz gráfica de usuario (GUI).

Declaración de permisos

Algunas plataformas exigen que los permisos que se solicitan se declaren por adelantado en el momento de la compilación.

Plataformas de Apple

Cada permiso que se solicite debe ir acompañado de una cadena denominada «descripción de uso » en el archivo Info.plist , en la que se describa por qué la aplicación necesita acceder a ese permiso concreto. Por ejemplo:

<key>NSMicrophoneUsageDescription</key>
<string>The microphone is used to record voice memos.</string>

Las claves de descripción de uso pertinentes se describen en la documentación de cada tipo de permiso.

Para asegurarte de que el backend de permisos correspondiente se incluye en tu aplicación, indica al sistema de compilación que utilice tu Info.plist personalizado.

Android

Cada permiso que solicites debe ir acompañado de una entrada en uses-permission en el archivo AndroidManifest.xml de la aplicación. Por ejemplo:

<manifest ...>
    <uses-permission android:name="android.permission.RECORD_AUDIO"/>
</manifest>

Para asegurarte de que el backend de permisos correspondiente se incluye en tu aplicación, indica al sistema de compilación tu archivo ` AndroidManifest.xml ` personalizado o utiliza `qt_add_android_permission()`.

Los nombres de los permisos correspondientes se describen en la documentación de cada tipo de permiso.

Nota: Al utilizar esta API, la etiqueta <!-- %%INSERT_PERMISSIONS --> debe estar presente en el archivo AndroidManifest.xml. Para obtener más información sobre el uso de esta etiqueta, consulta «Permisos y funciones de Qt».

Permisos disponibles

Están disponibles los siguientes tipos de permisos:

QBluetoothPermission

Acceder a periféricos Bluetooth

QCalendarPermission

Acceder al calendario del usuario

QCameraPermission

Acceder a la cámara para hacer fotos o grabar vídeos

QContactsPermission

Acceder a los contactos del usuario

QLocationPermission

Acceder a la ubicación del usuario

QMicrophonePermission

Acceder al micrófono para escuchar o grabar sonido

Nota: Los tipos de permisos disponibles abarcan las funcionalidades básicas de los módulos de Qt, como Qt Multimedia y Qt Positioning, pero no incluyen todos los permisos específicos de cada plataforma. Actualmente no se admiten tipos de permisos personalizados.

Buenas prácticas

Para garantizar la mejor experiencia posible al usuario final, recomendamos adoptar las siguientes prácticas recomendadas para gestionar los permisos de las aplicaciones:

  • Solicita el conjunto mínimo de permisos necesarios. Por ejemplo, si solo necesitas acceso al micrófono, no solicites permiso para la cámara «por si acaso». Utiliza las propiedades de cada tipo de permiso para limitar aún más el alcance del mismo; por ejemplo, QContactsPermission::setAccessMode() para solicitar acceso de solo lectura.
  • Solicita los permisos en respuesta a acciones específicas del usuario. Por ejemplo, aplaza la solicitud del permiso de micrófono hasta que el usuario pulse el botón para grabar audio. Asociar la solicitud de permiso a una acción específica ofrece al usuario un contexto más claro de por qué se necesita dicho permiso. No solicites todos los permisos necesarios al iniciar la aplicación.
  • Proporciona contexto adicional y explicaciones si es necesario. A veces, la acción del usuario no ofrece suficiente contexto. Considera la posibilidad de mostrar un cuadro de diálogo explicativo después de que el usuario haya iniciado la acción, pero antes de solicitar el permiso, para que el usuario sea consciente de lo que va a suceder cuando aparezca posteriormente el cuadro de diálogo de permisos del sistema.
  • Sé transparente y explícito sobre por qué se necesitan los permisos. En los cuadros de diálogo explicativos y las descripciones de uso, explica con claridad por qué se necesita ese permiso concreto para que tu aplicación ofrezca una función específica, de modo que los usuarios puedan tomar decisiones informadas.
  • Ten en cuenta la posibilidad de que se denieguen los permisos. Los permisos que solicites pueden ser denegados por diversas razones. Debes tener siempre en cuenta esta situación, reduciendo de forma adecuada la experiencia de tu aplicación y ofreciendo al usuario explicaciones claras sobre lo que ocurre.
  • Nunca solicites permisos a través de una biblioteca. La solicitud de permisos debe realizarse lo más cerca posible del usuario, donde se dispone de la información necesaria para tomar decisiones acertadas sobre los puntos anteriores. Las bibliotecas pueden comprobar los permisos para asegurarse de que cuentan con los requisitos previos para realizar su trabajo, pero si el permiso es indeterminado o se deniega, esto debe reflejarse a través de la API de la biblioteca, de modo que la aplicación, a su vez, pueda solicitar los permisos necesarios.

Véase también «Archivos de lista de propiedades de información » y «Qt Creator: Edición de archivos de manifiesto».

© 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.