QtAndroidPrivate Namespace
El espacio de nombres QtAndroidPrivate proporciona funciones diversas para ayudar al desarrollo de Android. Más...
| Cabecera: | #include <QtCore/private/qandroidextras_p.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS CorePrivate)target_link_libraries(mytarget PRIVATE Qt6::CorePrivate) |
| qmake: | QT += core-private |
| Desde: | Qt 6.2 |
| Estado: | Preliminar |
Este espacio de nombres está en desarrollo y está sujeto a cambios.
Tipos
(since 6.2) enum class | BindFlag { None, AutoCreate, DebugUnbind, NotForeground, AboveClient, …, ExternalService } |
| flags | BindFlags |
Funciones
(since 6.2) bool | bindService(const QAndroidIntent &serviceIntent, const QAndroidServiceConnection &serviceConnection, QtAndroidPrivate::BindFlags flags = BindFlag::None) |
(preliminary) QFuture<QtAndroidPrivate::PermissionResult> | checkPermission(const QString &permission) |
(preliminary) QFuture<QtAndroidPrivate::PermissionResult> | requestPermission(const QString &permission) |
(since 6.2) void | startActivity(const QAndroidIntent &intent, int receiverRequestCode, QAndroidActivityResultReceiver *resultReceiver = nullptr) |
(since 6.2) void | startActivity(const QJniObject &intent, int receiverRequestCode, QAndroidActivityResultReceiver *resultReceiver = nullptr) |
(since 6.2) void | startActivity(const QJniObject &intent, int receiverRequestCode, std::function<void (int, int, const QJniObject &)> callbackFunc) |
(since 6.2) void | startIntentSender(const QJniObject &intentSender, int receiverRequestCode, QAndroidActivityResultReceiver *resultReceiver = nullptr) |
Documentación de tipos
[since 6.2] clase enum QtAndroidPrivate::BindFlag
flags QtAndroidPrivate::BindFlags
Esta enum se utiliza con QtAndroidPrivate::bindService para describir el modo en que se realiza el enlace.
| Constante | Valor | Descripción |
|---|---|---|
QtAndroidPrivate::BindFlag::None | 0x00000000 | Sin opciones. |
QtAndroidPrivate::BindFlag::AutoCreate | 0x00000001 | Crea automáticamente el servicio mientras exista la vinculación. Consulte la documentación de BIND_AUTO_CREATE para más detalles. |
QtAndroidPrivate::BindFlag::DebugUnbind | 0x00000002 | Incluye ayuda de depuración para las llamadas a unbind que no coincidan. Consulte la documentación BIND_DEBUG_UNBIND para obtener más detalles. |
QtAndroidPrivate::BindFlag::NotForeground | 0x00000004 | No permitir que esta vinculación eleve el proceso del servicio de destino a la prioridad de programación en primer plano. Consulte la documentación BIND_NOT_FOREGROUND para obtener más información. |
QtAndroidPrivate::BindFlag::AboveClient | 0x00000008 | Indica que la aplicación cliente vinculada a este servicio considera que el servicio es más importante que la propia aplicación. Véase la documentación BIND_ABOVE_CLIENT para más detalles. |
QtAndroidPrivate::BindFlag::AllowOomManagement | 0x00000010 | Permite que el proceso que aloja el servicio vinculado realice su gestión de memoria normal. Consulte la documentación BIND_ALLOW_OOM_MANAGEMENT para obtener más información. |
QtAndroidPrivate::BindFlag::WaivePriority | 0x00000020 | No afecta a la prioridad de programación o gestión de memoria del proceso que aloja el servicio de destino. Consulte la documentación BIND_WAIVE_PRIORITY para obtener más detalles. |
QtAndroidPrivate::BindFlag::Important | 0x00000040 | A este servicio se le asigna una prioridad más alta para que esté disponible para el cliente cuando lo necesite. Consulte la documentación BIND_IMPORTANT para obtener más detalles. |
QtAndroidPrivate::BindFlag::AdjustWithActivity | 0x00000080 | Si se vincula desde una actividad, permite que la importancia del proceso del servicio de destino se eleve en función de si la actividad es visible para el usuario. Para más información, consulte la documentación BIND_ADJUST_WITH_ACTIVITY. |
QtAndroidPrivate::BindFlag::ExternalService | -2147483648 | El servicio vinculado es un servicio externo aislado. Véase la documentación BIND_EXTERNAL_SERVICE para más detalles. |
Este enum se introdujo en Qt 6.2.
El tipo BindFlags es un typedef para QFlags<BindFlag>. Almacena una combinación OR de valores BindFlag.
Documentación de la función
[since 6.2] bool QtAndroidPrivate::bindService(const QAndroidIntent &serviceIntent, const QAndroidServiceConnection &serviceConnection, QtAndroidPrivate::BindFlags flags = BindFlag::None)
Vincula el servicio dado por serviceIntent, serviceConnection y flags. El objeto serviceIntent identifica el servicio al que hay que conectarse. El objeto serviceConnection es un oyente que recibe la información a medida que el servicio se inicia y se detiene.
Devuelve true en caso de éxito
Consulte la documentación de Android para más detalles.
Esta función se introdujo en Qt 6.2.
Véase también QAndroidIntent, QAndroidServiceConnection, y BindFlag.
[preliminary] QFuture<QtAndroidPrivate::PermissionResult> QtAndroidPrivate::checkPermission(const QString &permission)
Esta función está en desarrollo y está sujeta a cambios.
Comprueba si este proceso tiene el nombre permission y devuelve un QFuture que representa el resultado de la comprobación.
Nota: QPermission es la API recomendada para solicitar permisos. Si QPermission no cubre un permiso de Android que desea solicitar, esta API preliminar todavía se puede utilizar en su lugar.
Esta función se introdujo en Qt 6.2.
Véase también requestPermission().
[preliminary] QFuture<QtAndroidPrivate::PermissionResult> QtAndroidPrivate::requestPermission(const QString &permission)
Esta función está en desarrollo y está sujeta a cambios.
Solicita el permission y devuelve un QFuture que representa el resultado de la solicitud.
Nota: QPermission es la API recomendada para solicitar permisos. Si QPermission no cubre un permiso de Android que desea solicitar, esta API preliminar todavía se puede utilizar en su lugar.
Esta función se introdujo en Qt 6.2.
Véase también checkPermission().
[since 6.2] void QtAndroidPrivate::startActivity(const QAndroidIntent &intent, int receiverRequestCode, QAndroidActivityResultReceiver *resultReceiver = nullptr)
Inicia la actividad dada por intent y proporciona el resultado de forma asíncrona a través de resultReceiver si este no es nulo.
Si resultReceiver es nulo, se llamará al método startActivity() de QNativeInterface::QAndroidApplication::context(). En caso contrario, se llamará a startActivityForResult().
El receiverRequestCode es un código de petición único para el resultReceiver, y será devuelto junto con el resultado, haciendo posible utilizar el mismo receptor para más de una intención.
Esta función se introdujo en Qt 6.2.
[since 6.2] void QtAndroidPrivate::startActivity(const QJniObject &intent, int receiverRequestCode, QAndroidActivityResultReceiver *resultReceiver = nullptr)
Inicia la actividad dada por intent y proporciona el resultado de forma asíncrona a través de resultReceiver si este no es nulo.
Si resultReceiver es nulo, se llamará al método startActivity() de QNativeInterface::QAndroidApplication::context(). En caso contrario, se llamará a startActivityForResult().
El receiverRequestCode es un código de petición único para el resultReceiver, y será devuelto junto con el resultado, haciendo posible utilizar el mismo receptor para más de una intención.
Esta función se introdujo en Qt 6.2.
[since 6.2] void QtAndroidPrivate::startActivity(const QJniObject &intent, int receiverRequestCode, std::function<void (int, int, const QJniObject &)> callbackFunc)
Inicia la actividad dada por intent, utilizando el código de petición receiverRequestCode, y proporciona el resultado llamando a callbackFunc.
Esta función se introdujo en Qt 6.2.
[since 6.2] void QtAndroidPrivate::startIntentSender(const QJniObject &intentSender, int receiverRequestCode, QAndroidActivityResultReceiver *resultReceiver = nullptr)
Inicia la actividad dada por intentSender y proporciona el resultado de forma asíncrona a través de resultReceiver si este no es nulo.
Si resultReceiver es nulo, se llamará al método startIntentSender() de QNativeInterface::QAndroidApplication::context(). En caso contrario, se llamará a startIntentSenderForResult().
El receiverRequestCode es un código de petición único para el resultReceiver, y será devuelto junto con el resultado, haciendo posible utilizar el mismo receptor para más de una intención.
Esta función se introdujo en Qt 6.2.
© 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.
