Qt for Android系列之Qt对Android返回键的处理，以及Android各种Activity事件的获取与处理

2023-09-19 06:29:31

在 Qt for Android 中驾驭 Android 返回键和活动事件

前言

作为一名 Qt 开发者，在 Android 平台上构建应用程序时，响应 Android 系统事件至关重要。本文将深入探究如何在 Qt for Android 中监听 Android 返回键，并获取和处理各种 Activity 事件，从而提升您的应用程序的交互性和用户体验。

监听 Android 返回键

Android 的返回键是一个至关重要的导航控件，用于退出当前 Activity 或返回上一级 Activity。要监听返回键事件，Qt for Android 提供了一种便利的方式：

QAndroidJniEnvironment::registerNativeMethod(const char* className, const char* methodName, JNINativeMethod method, const char* signature);

此方法允许您将 Java 方法注册为本地方法，使 Qt 能够直接调用它。我们可以利用此方法注册一个监听返回键的 Java 方法，并在 Java 代码中实现该方法，从而调用 Qt 的槽函数来处理返回键事件。

示例代码：

// 注册返回键事件的监听器
QAndroidJniEnvironment jniEnv;
jniEnv.registerNativeMethod("org/qtproject/example/MainActivity", "onBackPressed", reinterpret_cast<JNINativeMethod>(&MainActivity::onBackPressed), "(I)V");

获取和处理 Activity 事件

除了返回键事件之外，Android 系统还提供了其他广泛的 Activity 事件，如 Activity 创建、销毁和暂停事件。Qt for Android 提供了以下方法来获取和处理这些事件：

QAndroidJniObject::callMethod<T>(const char* methodName, const char* signature, ...);

此方法可用于调用 Java 对象的方法并返回指定类型的值。我们可以使用此方法调用 Android Activity 对象的各种方法，从而获取和处理 Activity 事件。

示例代码：

// 获取 Activity 对象
QAndroidJniObject activity = QAndroidJniObject::callStaticObjectMethod("org/qtproject/example/MainActivity", "getCurrentActivity", "()Landroid/app/Activity;");

// 注册 Activity 创建事件的监听器
activity.callMethod<void>("addOnCreateCallback", "(Landroid/content/ComponentCallbacks;)V", this);

完整示例

以下是完整示例的代码，展示了如何在 Qt for Android 中监听 Android 返回键，并获取和处理各种 Activity 事件：

#include <QAndroidJniEnvironment>
#include <QAndroidJniObject>
#include <QObject>

class MainActivity : public QObject
{
    Q_OBJECT

public:
    MainActivity()
    {
        // 注册返回键事件的监听器
        QAndroidJniEnvironment jniEnv;
        jniEnv.registerNativeMethod("org/qtproject/example/MainActivity", "onBackPressed", reinterpret_cast<JNINativeMethod>(&MainActivity::onBackPressed), "(I)V");

        // 获取 Activity 对象
        QAndroidJniObject activity = QAndroidJniObject::callStaticObjectMethod("org/qtproject/example/MainActivity", "getCurrentActivity", "()Landroid/app/Activity;");

        // 注册 Activity 创建事件的监听器
        activity.callMethod<void>("addOnCreateCallback", "(Landroid/content/ComponentCallbacks;)V", this);

        // 注册 Activity 销毁事件的监听器
        activity.callMethod<void>("addOnDestroyCallback", "(Landroid/content/ComponentCallbacks;)V", this);

        // 注册 Activity 暂停事件的监听器
        activity.callMethod<void>("addOnPauseCallback", "(Landroid/content/ComponentCallbacks;)V", this);
    }

public slots:
    void onBackPressed(int keyCode)
    {
        // 处理返回键事件
    }

    void onCreate(QAndroidJniObject activity)
    {
        // 处理 Activity 创建事件
    }

    void onDestroy(QAndroidJniObject activity)
    {
        // 处理 Activity 销毁事件
    }

    void onPause(QAndroidJniObject activity)
    {
        // 处理 Activity 暂停事件
    }
};

JНИEXPORT jint JNICALL Java_org_qtproject_example_MainActivity_onBackPressed(JNIEnv *env, jobject thiz, jint keyCode)
{
    // 调用 Qt 的槽函数来处理返回键事件
    QAndroidJniEnvironment jniEnv(env);
    QObject *object = jniEnv.getObject<QObject>(thiz);
    QMetaObject::invokeMethod(object, "onBackPressed", Qt::QueuedConnection, Q_ARG(int, keyCode));

    return 0;
}