ActivityView QML Type

QML wrapper for Qt Android Activity View. More...

• List of all members, including inherited members

Properties

• className : QString
• packageName : QString
• placeholder : Item
• radius : float
• restoreOnAppResume : bool
• status : enumeration
• usePlaceholder : bool

Methods

• void restore()

Detailed Description

ActivityView allows embedding and handling Android apps and activities from a QML component.

Example Usage

The following snippet shows the simplest usage of the ActivityView type.

import QtAndroidAutomotive.ActivityView

ActivityView {
    anchors.fill: parent

    packageName: "com.android.deskclock"
}

Activity View Known issues and limitations

Only Android 10, 11 and 12 are supported.

Since ActivityView relies on private Android APIs, apps that use it must be signed with a platform key.

An ActivityView component is always rendered on top. It can be freely changed in size and position. However, the standard z-order rules do not apply. It is always rendered above all components rendered by QML. Additionally, it is also not possible to apply transformations such as rotation or scaling, changing the opacity or offscreen rendering using layers.

The Activity resolved by the provided packageName and className must have the resizeableActivity attribute set to true in order to be launched correctly as an embedded activity. Also, if the activity is not owned by the owner of this app, it must allow embedding. This rule also applies to activities launched from within embedded activities. Otherwise, new activities may not behave correctly, e.g. be launched in fullscreen.

Android 10 and 11

In case of Android 11 platform only one ActivityView can get touch events at a time. When working with multiple ActivityViews, the user will have to make an 'initial tap' on the activity to give it focus for receiving touch events.

When an activity is running in ActivityView, an attempt to run the same activity with Context.startActivity() may not show the activity on the screen. To overcome this problem, use the two parameter version of this function, so you can specify the displayId for the activity to show up.

Android 12

Only one app can successfully use ActivityViews

Due to the limitations in the underlying Android 12 API, only one app can successfully use ActivityViews for embedding other apps. If another app with ActivityView is launched, the previously launched app's activity embedding may not work as expected anymore.

Activity that is embedded may not show outside the host app

When an Activity has been embedded into an ActivityView in Android 12, trying to start the same Activity outside of it, in fullscreen mode, may not show the Activity on the screen. If you want to start the embedded Activity in fullscreen, you need to remove it from the ActivityView first by clearing its packageName.

Keyboard input not working

Soft and physical keyboard input in apps with embedded ActivityViews does not work, no text can be entered and a virtual keyboard does not appear.

Property Documentation

ActivityView {
    anchors.fill: parent

    packageName: "com.android.contacts"
    className: "com.android.contacts.activities.LicenseActivity"
}

ActivityView {
    anchors.fill: parent

    packageName: "com.android.contacts"
    className: ".activities.LicenseActivity"
}

Rectangle {
    width: 400
    height: 600
    border.width: 1

    MouseArea {
        id: dragMouseArea

        anchors.fill: parent
        drag.target: parent
    }

    ActivityView {
        id: activityView

        anchors.fill: parent
        anchors.margins: 30

        packageName: "com.android.deskclock"
        usePlaceholder: dragMouseArea.pressed

        placeholder: Item {
            Image {
                anchors.centerIn: parent
                source: "icon.png"
                width: 50
                height: 50
            }
        }
    }
}

Rectangle {
    anchors.fill: parent
    radius: 20

    ActivityView {
        anchors.fill: parent
        anchors.margins: 1
        radius: 20

        packageName: "com.android.contacts"
    }
}

BusyIndicator {
    running: activityView.status !== ActivityView.Started
}

Method Documentation

Available under certain Qt licenses.
Find out more.