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.
Acceso a los periféricos Bluetooth del usuario | |
Acceso al calendario del usuario | |
Acceso a la cámara del usuario | |
Acceso a los contactos del usuario | |
Acceso a la ubicación del usuario | |
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.