En esta página

Permisos de las aplicaciones QML

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.

El Qt Qml Core módulo expone la funcionalidad de permisos de aplicación de Qt C++ a Qml a través de un conjunto de tipos de permiso que pueden utilizarse para comprobar o solicitar permisos de forma multiplataforma.

BluetoothPermission

Acceso a los periféricos Bluetooth del usuario

CalendarPermission

Acceso al calendario del usuario

CameraPermission

Acceso a la cámara del usuario

ContactsPermission

Acceso a los contactos del usuario

LocationPermission

Acceso a la ubicación del usuario

MicrophonePermission

Acceso al micrófono del usuario

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

Uso

Para comprobar y solicitar un permiso específico en tu aplicación, incluye una instancia del tipo de permiso adecuado y configura cualquiera de sus propiedades si es necesario:

CalendarPermission {
    id: calendarPermission
    accessMode: CalendarPermission.ReadWrite
}

El tipo se puede utilizar para comprobar el estado actual de los permisos, por ejemplo, para controlar una interfaz de usuario basada en el estado:

states: [
    State {
        name: "waitingForPermission"
        when: calendarPermission.status == Qt.PermissionStatus.Undetermined
        PropertyChanges { target: permissionRequestItem; visible: true }
    },
    State {
        name: "permissionDenied"
        when: calendarPermission.status == Qt.PermissionStatus.Denied
        PropertyChanges { target: permissionDeniedItem; visible: true }
    }
]

En el ejemplo anterior, se superpondrán dos elementos específicos del permiso si el estado del permiso es «denegado». La interfaz de usuario de solicitud podría tener un aspecto similar al siguiente:

Rectangle {
    id: permissionRequestItem
    anchors.fill: parent
    visible: false

    Text {
        anchors.centerIn: parent
        text: qsTr("We need your permission to access the calendar."
            + "Please tap this screen to request permission.")

    }

    MouseArea {
        anchors.fill: parent
        onClicked: calendarPermission.request()
    }
}

Con la correspondiente interfaz de usuario de denegación:

Rectangle {
    id: permissionDeniedItem
    anchors.fill: parent
    color: "red"
    visible: false
    Text {
        anchors.centerIn: parent
        text: qsTr("We need your permission to access the calendar,"
            + "but permission was not granted. Please resolve.")
    }
}

Modificación de las propiedades de los permisos

Las propiedades de un permiso se pueden modificar, incluso después de haber iniciado una solicitud mediante la llamada a `request()`. Esto actualizará el estado, si este cambia como resultado de los nuevos valores de las propiedades, pero no dará lugar a una solicitud automática con el nuevo conjunto de propiedades.

Por ejemplo, si se actualiza un permiso de calendario ya concedido para el modo de acceso Qt.CalendarPermission.ReadOnly a Qt.CalendarPermission.ReadWrite, la plataforma responderá de una de estas tres formas:

  • Concediendo implícitamente el permiso ampliado, por ejemplo, porque la plataforma no distingue entre los dos modos de acceso, lo que no provocará ningún cambio de estado.
  • Devolviendo el estado a «Indeterminado», de modo que se pueda consultar de nuevo al usuario sobre el acceso al permiso ahora ampliado.
  • Cambiando el estado a « Denied », por ejemplo, si los permisos no pueden ampliarse una vez solicitados inicialmente.

Todos estos estados deberían, a continuación, hacer que la interfaz de usuario de la aplicación pase al estado adecuado, en el que se informe al usuario del nuevo estado, con la posibilidad de solicitar el nuevo permiso si es posible, o de volver a un permiso menos amplio.

Interacción entre los elementos de permiso

Aunque el estado de los permisos está vinculado en última instancia a la aplicación subyacente, cada elemento de permiso informa de su propio estado independientemente de todos los demás elementos, y debe solicitarse de forma independiente si es necesario.

Por ejemplo, solicitar acceso al calendario para un elemento no actualizará el estado de otro elemento CalendarPermission, aunque ambos tengan exactamente las mismas propiedades.

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