Sur cette page

QtAndroidPrivate Namespace

L'espace de noms QtAndroidPrivate fournit diverses fonctions pour faciliter le développement d'Android. Plus d'informations...

En-tête : #include <QtCore/private/qandroidextras_p.h>
CMake : find_package(Qt6 REQUIRED COMPONENTS CorePrivate)
target_link_libraries(mytarget PRIVATE Qt6::CorePrivate)
qmake : QT += core-private
Depuis : Qt 6.2
Statut : Préliminaire

Cet espace de noms est en cours de développement et est susceptible d'être modifié.

Types de fonctions

(since 6.2) enum class BindFlag { None, AutoCreate, DebugUnbind, NotForeground, AboveClient, …, ExternalService }
flags BindFlags

Fonctions

(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)

Description détaillée

Documentation des types

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

Cette énumération est utilisée avec QtAndroidPrivate::bindService pour décrire le mode dans lequel la liaison est effectuée.

ConstanteValeurDescription
QtAndroidPrivate::BindFlag::None0x00000000Pas d'options.
QtAndroidPrivate::BindFlag::AutoCreate0x00000001Crée automatiquement le service tant que la liaison existe. Voir la documentation BIND_AUTO_CREATE pour plus de détails.
QtAndroidPrivate::BindFlag::DebugUnbind0x00000002Inclut une aide au débogage pour les appels non concordants à unbind. Voir la documentation BIND_DEBUG_UNBIND pour plus de détails.
QtAndroidPrivate::BindFlag::NotForeground0x00000004Ne pas permettre à cette liaison d'élever le processus du service cible à la priorité d'ordonnancement de premier plan. Voir la documentation BIND_NOT_FOREGROUND pour plus de détails.
QtAndroidPrivate::BindFlag::AboveClient0x00000008Indique que l'application cliente qui se lie à ce service considère que le service est plus important que l'application elle-même. Voir la documentation BIND_ABOVE_CLIENT pour plus de détails.
QtAndroidPrivate::BindFlag::AllowOomManagement0x00000010Permet au processus hébergeant le service lié de procéder à une gestion normale de la mémoire. Voir la documentation BIND_ALLOW_OOM_MANAGEMENT pour plus de détails.
QtAndroidPrivate::BindFlag::WaivePriority0x00000020Ne pas impacter la priorité d'ordonnancement ou de gestion de la mémoire du processus hébergeant le service cible. Voir la documentation BIND_WAIVE_PRIORITY pour plus de détails.
QtAndroidPrivate::BindFlag::Important0x00000040Une priorité plus élevée est attribuée à ce service afin qu'il soit disponible pour le client lorsqu'il en a besoin. Voir la documentation BIND_IMPORTANT pour plus de détails.
QtAndroidPrivate::BindFlag::AdjustWithActivity0x00000080Si la liaison se fait à partir d'une activité, l'importance du processus du service cible peut être augmentée en fonction de la visibilité de l'activité par l'utilisateur. Voir la documentation BIND_ADJUST_WITH_ACTIVITY pour plus de détails.
QtAndroidPrivate::BindFlag::ExternalService-2147483648Le service lié est un service externe isolé. Voir la documentation BIND_EXTERNAL_SERVICE pour plus de détails.

Cette énumération a été introduite dans Qt 6.2.

Le type BindFlags est un typedef pour QFlags<BindFlag>. Il stocke une combinaison OR de valeurs BindFlag.

Documentation des fonctions

[since 6.2] bool QtAndroidPrivate::bindService(const QAndroidIntent &serviceIntent, const QAndroidServiceConnection &serviceConnection, QtAndroidPrivate::BindFlags flags = BindFlag::None)

Lie le service indiqué par serviceIntent, serviceConnection et flags. L'objet serviceIntent identifie le service auquel se connecter. L'objet serviceConnection est un auditeur qui reçoit les informations relatives au démarrage et à l'arrêt du service.

Retourne true en cas de succès

Voir la documentation Android pour plus de détails.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi QAndroidIntent, QAndroidServiceConnection, et BindFlag.

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

Cette fonction est en cours de développement et peut être modifiée.

Vérifie si ce processus possède le nom permission et renvoie un QFuture représentant le résultat de la vérification.

Remarque : QPermission est l'API recommandée pour demander des autorisations. Si QPermission ne couvre pas une autorisation Android que vous souhaitez demander, cette API préliminaire peut toujours être utilisée à la place.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi requestPermission().

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

Cette fonction est en cours de développement et peut être modifiée.

Demande l'adresse permission et renvoie une adresse QFuture représentant le résultat de la demande.

Remarque : QPermission est l'API recommandée pour demander des autorisations. Si QPermission ne couvre pas une autorisation Android que vous souhaitez demander, cette API préliminaire peut toujours être utilisée à la place.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi checkPermission().

[since 6.2] void QtAndroidPrivate::startActivity(const QAndroidIntent &intent, int receiverRequestCode, QAndroidActivityResultReceiver *resultReceiver = nullptr)

Démarre l'activité donnée par intent et fournit le résultat de manière asynchrone par l'intermédiaire de resultReceiver si celui-ci n'est pas nul.

Si resultReceiver est nul, la méthode startActivity() de QNativeInterface::QAndroidApplication::context() sera appelée. Dans le cas contraire, c'est la méthode startActivityForResult() qui est appelée.

Le code receiverRequestCode est un code de requête unique à resultReceiver, et sera renvoyé avec le résultat, ce qui permet d'utiliser le même récepteur pour plus d'une intention.

Cette fonction a été introduite dans Qt 6.2.

[since 6.2] void QtAndroidPrivate::startActivity(const QJniObject &intent, int receiverRequestCode, QAndroidActivityResultReceiver *resultReceiver = nullptr)

Démarre l'activité donnée par intent et fournit le résultat de manière asynchrone par l'intermédiaire de resultReceiver si celui-ci n'est pas nul.

Si resultReceiver est nul, la méthode startActivity() de QNativeInterface::QAndroidApplication::context() sera appelée. Dans le cas contraire, c'est la méthode startActivityForResult() qui est appelée.

Le code receiverRequestCode est un code de requête unique à resultReceiver, et sera renvoyé avec le résultat, ce qui permet d'utiliser le même récepteur pour plus d'une intention.

Cette fonction a été introduite dans Qt 6.2.

[since 6.2] void QtAndroidPrivate::startActivity(const QJniObject &intent, int receiverRequestCode, std::function<void (int, int, const QJniObject &)> callbackFunc)

Démarre l'activité donnée par intent, en utilisant le code de requête receiverRequestCode, et fournit le résultat en appelant callbackFunc.

Cette fonction a été introduite dans Qt 6.2.

[since 6.2] void QtAndroidPrivate::startIntentSender(const QJniObject &intentSender, int receiverRequestCode, QAndroidActivityResultReceiver *resultReceiver = nullptr)

Démarre l'activité donnée par intentSender et fournit le résultat de manière asynchrone par l'intermédiaire de resultReceiver si celui-ci n'est pas nul.

Si resultReceiver est nul, la méthode startIntentSender() de QNativeInterface::QAndroidApplication::context() sera appelée. Dans le cas contraire, c'est la méthode startIntentSenderForResult() qui est appelée.

Le code receiverRequestCode est un code de requête unique à resultReceiver, et sera renvoyé avec le résultat, ce qui permet d'utiliser le même récepteur pour plus d'une intention.

Cette fonction a été introduite dans 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.