QAndroidApplication 结构体

成员函数文档

[静态, 自 6.2] QJniObject QAndroidApplication::context()

返回 Android 上下文作为 QJniObject。如果是最近启动的活动对象有效，上下文是一个 Activity。否则，上下文是一个 Service。

此函数自 Qt 6.2 起引入。

[静态, 自 6.2] void QAndroidApplication::hideSplashScreen(int duration = 0)

通过给定 duration 的淡入淡出效果隐藏启动画面。如果没有提供 duration（默认为 0），则在应用启动后立即隐藏启动画面。

此函数自 Qt 6.2 起引入。

[静态, 自 6.2] bool QAndroidApplication::isActivityContext()

如果 QAndroidApplication::context() 提供了一个 Activity 上下文，则返回 true。

此函数自 Qt 6.2 起引入。

[静态，自 6.2 版起] QFuture<QVariant> QAndroidApplication::runOnAndroidMainThread(const std::function<QVariant ()> &runnable, const QDeadlineTimer timeout = QDeadlineTimer::Forever)

将函数 runnable 投递到 Android 线程。该函数将被排队并在 Android UI 线程上执行。如果在 Android UI 线程上调用，runnable 将立即执行。如果 Android 应用已暂停或主 Activity 为空，runnable 将被添加到 Android 主线程队列。

此调用返回一个 QFuture<QVariant>，允许进行同步和异步调用，并可以处理任何返回类型。但是，要从 QFuture::result() 获取结果，应使用 QVariant::value()。

如果 runnable 执行时间超过 timeout 的时间段，当 timeout 到来时，阻塞调用 QFuture::waitForFinished() 和 QFuture::result() 将结束。但是，如果 runnable 已经开始执行，它不会被取消。

以下示例显示了如何执行期望有返回类型的异步调用

auto task = QNativeInterface::QAndroidApplication::runOnAndroidMainThread([=]() {
    QJniObject surfaceView;
    if (!surfaceView.isValid())
        qDebug() << "SurfaceView object is not valid yet";

    surfaceView = QJniObject("android/view/SurfaceView",
                             "(Landroid/content/Context;)V",
                             QNativeInterface::QAndroidApplication::context());

    return QVariant::fromValue(surfaceView);
}).then([](QFuture<QVariant> future) {
    auto surfaceView = future.result().value<QJniObject>();
    if (surfaceView.isValid())
        qDebug() << "Retrieved SurfaceView object is valid";
});

以下示例显示了如何执行具有 void 返回类型的同步调用

QNativeInterface::QAndroidApplication::runOnAndroidMainThread([]() {
   QJniObject activity = QNativeInterface::QAndroidApplication::context();
   // Hide system ui elements or go full screen
   activity.callObjectMethod("getWindow", "()Landroid/view/Window;")
           .callObjectMethod("getDecorView", "()Landroid/view/View;")
           .callMethod<void>("setSystemUiVisibility", "(I)V", 0xffffffff);
}).waitForFinished();

此函数自 Qt 6.2 起引入。

[静态，自 6.2 版起] int QAndroidApplication::sdkVersion()

返回 Android SDK 版本。这也称为 API 级别。

此函数自 Qt 6.2 起引入。