En esta página

QtAndroidPrivate Namespace

El espacio de nombres QtAndroidPrivate ofrece diversas funciones que facilitan el desarrollo para Android. Más información...

Encabezado: #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: Versión preliminar

Este espacio de nombres se encuentra en fase de vista previa tecnológica 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)
(technology preview) QFuture<QtAndroidPrivate::PermissionResult> checkPermission(const QString &permission)
(technology preview) 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)

Descripción detallada

Documentación de tipos

[since 6.2] enum class QtAndroidPrivate::BindFlag
flags QtAndroidPrivate::BindFlags

Esta enumeración se utiliza junto con ` QtAndroidPrivate::bindService ` para describir el modo en el que se lleva a cabo el enlace.

ConstanteValorDescripción
QtAndroidPrivate::BindFlag::None0x00000000Sin opciones.
QtAndroidPrivate::BindFlag::AutoCreate0x00000001Crea automáticamente el servicio siempre que exista el enlace. Consulta la documentación de BIND_AUTO_CREATE para obtener más detalles.
QtAndroidPrivate::BindFlag::DebugUnbind0x00000002Incluye ayuda de depuración para llamadas no coincidentes a «unbind». Consulte la documentación de BIND_DEBUG_UNBIND para obtener más detalles.
QtAndroidPrivate::BindFlag::NotForeground0x00000004No permite que este enlace eleve el proceso del servicio de destino a la prioridad de programación en primer plano. Consulte la documentación de BIND_NOT_FOREGROUND para obtener más detalles.
QtAndroidPrivate::BindFlag::AboveClient0x00000008Indica que la aplicación cliente que se vincula a este servicio considera que el servicio es más importante que la propia aplicación. Consulte la documentación de BIND_ABOVE_CLIENT para obtener más detalles.
QtAndroidPrivate::BindFlag::AllowOomManagement0x00000010Permite que el proceso que aloja el servicio vinculado siga su gestión normal de la memoria. Consulta la documentación de BIND_ALLOW_OOM_MANAGEMENT para obtener más detalles.
QtAndroidPrivate::BindFlag::WaivePriority0x00000020No afecta a la prioridad de programación ni a la gestión de memoria del proceso que aloja el servicio de destino. Consulte la documentación de BIND_WAIVE_PRIORITY para obtener más detalles.
QtAndroidPrivate::BindFlag::Important0x00000040A este servicio se le asigna una prioridad más alta para que esté disponible para el cliente cuando sea necesario. Consulte la documentación de BIND_IMPORTANT para obtener más detalles.
QtAndroidPrivate::BindFlag::AdjustWithActivity0x00000080Si el enlace se realiza desde una actividad, permite que se aumente la importancia del proceso del servicio de destino en función de si la actividad es visible para el usuario. Consulte la documentación de BIND_ADJUST_WITH_ACTIVITY para obtener más detalles.
QtAndroidPrivate::BindFlag::ExternalService-2147483648El servicio al que se está vinculando es un servicio externo aislado. Consulte la documentación de BIND_EXTERNAL_SERVICE para obtener más detalles.

Esta enumeración se introdujo en Qt 6.2.

El tipo `BindFlags` es una definición de tipo para ` QFlags<BindFlag>`. Almacena una combinación OR de valores de `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 proporcionado por serviceIntent, serviceConnection y flags. El objeto serviceIntent identifica el servicio al que conectarse. El objeto serviceConnection es un listener que recibe la información cuando el servicio se inicia y se detiene.

Devuelve «true» si se realiza correctamente

Consulte la documentación de Android para obtener más detalles.

Esta función se introdujo en Qt 6.2.

Véase también QAndroidIntent, QAndroidServiceConnection y BindFlag.

[technology preview] QFuture<QtAndroidPrivate::PermissionResult> QtAndroidPrivate::checkPermission(const QString &permission)

Esta función se encuentra en fase de vista previa tecnológica y está sujeta a cambios.

Comprueba si este proceso dispone del permiso « permission » y devuelve un objeto ` QFuture ` que representa el resultado de la comprobación.

Nota: « QPermission » es la API recomendada para solicitar permisos. Si « QPermission » no cubre algún permiso de Android que desees solicitar, puedes seguir utilizando esta API preliminar en su lugar.

Esta función se introdujo en Qt 6.2.

Véase también requestPermission().

[technology preview] QFuture<QtAndroidPrivate::PermissionResult> QtAndroidPrivate::requestPermission(const QString &permission)

Esta función se encuentra en fase de vista previa tecnológica y está sujeta a cambios.

Solicita el objeto ` permission ` y devuelve un objeto ` QFuture ` que representa el resultado de la solicitud.

Nota: « QPermission » es la API recomendada para solicitar permisos. Si « QPermission » no incluye un permiso de Android que desees solicitar, puedes seguir utilizando esta API preliminar 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 especificada por ` intent ` y devuelve 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(). De lo contrario, se llamará a startActivityForResult().

receiverRequestCode es un código de solicitud exclusivo de resultReceiver y se devolverá junto con el resultado, lo que permite 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 indicada 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().

receiverRequestCode es un código de solicitud exclusivo de resultReceiver y se devolverá junto con el resultado, lo que permite 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 indicada en intent, utilizando el código de solicitud receiverRequestCode, y devuelve 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 indicada 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().

receiverRequestCode es un código de solicitud exclusivo de resultReceiver y se devolverá junto con el resultado, lo que permite 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.