Member Function Documentation

[explicit] QActivityView::QActivityView(QObject *parent = nullptr)

Creates a wrapper for the ActivityView Java class and sets parent as the parent object.

[virtual noexcept] QActivityView::~QActivityView()

Destroys the wrapper object, releasing the underlying Java object of ActivityView class.

QString QActivityView::activityClassName() const

Returns the class name of the activity.

See also setActivityName().

QString QActivityView::activityPackageName() const

Returns the package name of the activity.

See also setActivityName().

float QActivityView::cornerRadius() const

Returns the corner radius of the managed Activity expressed in pixels.

[since QtAndroidAutomotive 6.7] const QMatrix4x4 &QActivityView::currentFrameTextureTransformation() const

Returns the transformation matrix that will be applied to the texture during rendering.

This function was introduced in QtAndroidAutomotive 6.7.

See also updateCurrentFrame().

[since QtAndroidAutomotive 6.7] qint64 QActivityView::currentFrameTimestamp() const

Returns the timestamp of the current frame.

This function was introduced in QtAndroidAutomotive 6.7.

See also updateCurrentFrame().

[since QtAndroidAutomotive 6.7] void QActivityView::forwardInputEvent(const QJniObject &inputEvent)

Forwards the inputEvent to the underlaying activity.

This function was introduced in QtAndroidAutomotive 6.7.

QRect QActivityView::geometry() const

Returns the position and size of the managed Activity expressed in the global coordinate system.

See also setGeometry().

void QActivityView::initialize()

Initializes underlying Java resources, such as creating a Surface. It requires setGeometry to be called first. Subsequent calls have no effect.

[since QtAndroidAutomotive 6.7] bool QActivityView::isNewFrameAvailable() const

Queries and returns true if a new frame is available to be rendered. Otherwise returns false.

This function was introduced in QtAndroidAutomotive 6.7.

See also updateCurrentFrame().

bool QActivityView::isRestoreOnAppResumeEnabled() const

Returns whether an activity lost during app's inactive state should be restored.

See also setRestoreOnAppResume().

bool QActivityView::isVisible() const

Returns whether the managed Activity is visible. By default this is true.

See also setVisible().

void QActivityView::restore()

Reloads the embedded activity if it was removed externally from the ActivityView.

[since QtAndroidAutomotive 6.7] void QActivityView::sendKeyClick(int keyCode)

Sends a key click with keyCode to the underlaying activity.

This function was introduced in QtAndroidAutomotive 6.7.

[since QtAndroidAutomotive 6.7] void QActivityView::sendTouchEvent(const QTouchEvent &touchEvent, const QTransform &transform = {})

Sends touchEvent to the running Android activity. It applies the optional transform to the touch coordinates.

This function was introduced in QtAndroidAutomotive 6.7.

void QActivityView::setActivityName(const QString &packageName, const QString &className = QString())

Sets the package name and the class name of the activity to be launched. The packageName must be specified using the full package name. The className is an optional argument specifying the name of a class inside of the application package. When the class name is not provided the default class is the one that is appropriate to launch a main activity in a package:

activityView.setActivityName("com.android.deskclock");

The class name can be specified using its full name:

activityView.setActivityName("com.android.deskclock",
                             "com.android.deskclock.settings.SettingsActivity);

However, if the first character in the className property value is a period, the packageName is prefixed to the className. The snippet above can be shortened to the following form:

activityView.setActivityName("com.android.deskclock",
                             ".settings.SettingsActivity);

If the component is initialized, the activity starts immediately. Otherwise, startup is postponed until initialization.

The Activity resolved by the provided packageName and className must meet certain criteria. Check out Known issues and limitations section for details.

See also activityPackageName(), activityClassName(), and initialize().

void QActivityView::setGeometry(const QRect &geometry)

Sets the position and size of the component on the screen. The x and y coordinates of geometry are in the global coordinate system. This first call to this method must be done before initialization in order to determine initial location and size of underlying resources. When invoked later, it changes the activity geometry immediately.

See also geometry().

void QActivityView::setRestoreOnAppResume(bool restore)

Turns on/off, depending on restore value, the possibility of restoring the embedded activity after it is lost during inactive state of the app. Restoring takes place when the app goes back to the active state.

See also isRestoreOnAppResumeEnabled().

void QActivityView::setVisible(bool visible)

Sets the visibility to the value of visible.

See also isVisible().

[since QtAndroidAutomotive 6.7] std::unique_ptr<QRhiTexture> QActivityView::startRendering(QRhi *rhi, int textureWidth, int textureHeight)

Starts rendering the activity by creating a QRhiTexture instance using the given rhi and textureWidth and textureHeight. Returns a unique pointer of the created QRhiTexture or nullptr in case of failure. The calling function takes the ownership of the returned value.

This function was introduced in QtAndroidAutomotive 6.7.

See also stopRendering().

QActivityView::Status QActivityView::status() const

Returns the current status of the activity.

See also statusChanged().

[signal] void QActivityView::statusChanged(QActivityView::Status status)

This signal is emitted when the status of ActivityView changes. The status indicates the new value of the status.

[since QtAndroidAutomotive 6.7] void QActivityView::stopRendering()

Stops rendering and detaches the underlaying texture that is managed by QRhiTexture. It is the user's responsibility to delete the QRhiTexture instance that has been previously returned by calling startRendering(), after calling this function.

This function was introduced in QtAndroidAutomotive 6.7.

See also stopRendering().

[since QtAndroidAutomotive 6.7] void QActivityView::updateCurrentFrame()

Updates the QRhiTexture returned by startRendering() with current available frame.

This function was introduced in QtAndroidAutomotive 6.7.

See also updateCurrentFrame(), currentFrameTimestamp(), and isNewFrameAvailable().