QNativeInterface::QAndroidApplication Struct

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

[constexpr noexcept default] QAndroidApplication::QAndroidApplication()

QAndroidApplication のインスタンスをデフォルトコンストラクタで生成します。

[delete] QAndroidApplication::QAndroidApplication(const QNativeInterface::QAndroidApplication &)

QAndroidApplication のインスタンスをコピーして生成します。この関数は削除されています。

[delete] QAndroidApplication::QAndroidApplication(QNativeInterface::QAndroidApplication &&)

QAndroidApplication のインスタンスをMoveコンストラクタで生成します。この関数は削除されています。

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

AndroidコンテキストをQtJniTypes::Context として返します。直近で起動されたアクティビティオブジェクトが有効な場合、コンテキストは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)

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

この呼び出しは、同期および非同期の両方の呼び出しが可能で、あらゆる戻り値の型を処理できる `QFuture<QVariant>` を返します。ただし、`QFuture::result()` から結果を取得するには、`QVariant::value()` を使用する必要があります。

runnable の実行がtimeout の期間よりも長くかかった場合、ブロック型の呼び出しであるQFuture::waitForFinished() およびQFuture::result() は、timeout が経過すると終了します。ただし、runnable の実行がすでに開始されている場合は、キャンセルされません。

以下の例は、戻り値の型を指定する非同期呼び出しを実行する方法を示しています：

autotask= 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());

    returnQVariant::fromValue(surfaceView);
}).then([](QFuture<QVariant>future) {
    autosurfaceView=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 で導入されました。

[delete] QNativeInterface::QAndroidApplication &QAndroidApplication::operator=(QNativeInterface::QAndroidApplication &&)

other をこのQAndroidApplication インスタンスに移動・割り当てます。この関数は削除されます。

[delete] QNativeInterface::QAndroidApplication &QAndroidApplication::operator=(const QNativeInterface::QAndroidApplication &)

other をこのQAndroidApplication インスタンスにコピー代入します。この関数は削除されます。