QAndroidApplication Struct

メンバー関数ドキュメント

[static, since 6.2] QJniObject QAndroidApplication::context()

AndroidコンテキストをQJniObject 。 直近に開始したアクティビティオブジェクトが有効な場合、コンテキストはActivity 。そうでない場合、コンテキストはService です。

この関数は Qt 6.2 で導入されました。

[static, since 6.2] void QAndroidApplication::hideSplashScreen(int duration = 0)

与えられたduration のフェード効果を使用して、スプラッシュ画面を隠します。duration が提供されない場合（デフォルトは 0）、スプラッシュスクリーンはアプリの開始直後に非表示になります。

この関数は Qt 6.2 で導入されました。

[static, since 6.2] bool QAndroidApplication::isActivityContext()

QAndroidApplication::context() がActivity コンテキストを提供する場合、true を返します。

この関数は Qt 6.2 で導入されました。

[static, since 6.2] QFuture<QVariant> QAndroidApplication::runOnAndroidMainThread(const std::function<QVariant ()> &runnable, const QDeadlineTimer timeout = QDeadlineTimer::Forever)

Android スレッドに関数runnable をポストします。この関数はキューに入れられ、Android UIスレッドで実行されます。呼び出しがAndroid UIスレッドで行われた場合、runnable 、直ちに実行されます。Androidアプリが一時停止しているか、メイン・アクティビティがNULLの場合、runnable 、Androidメイン・スレッドのキューに追加されます。

この呼び出しは、QFuture<QVariant>を返すので、同期呼び出しと非同期呼び出しの両方が可能で、どんな戻り値の型も扱える。ただし、QFuture::result （）から結果を返すには、QVariant::value （）を使用する必要がある。

runnable の実行がtimeout の期間よりも長い場合、QFuture::waitForFinished （）とQFuture::result （）のブロッキング呼び出しは、timeout が経過した時点で終了する。ただし、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で導入されました。

[static, since 6.2] int QAndroidApplication::sdkVersion()

Android SDKのバージョンを返します。これは API レベルとしても知られています。

この関数は Qt 6.2 で導入されました。