成员函数文档

[显式] QActivityView::QActivityView(QObject *parent = nullptr)

为 ActivityView Java 类创建一个包装器，并将 parent 设置为父对象。

[虚函数 noexcept] QActivityView::~QActivityView()

销毁包装器对象，释放 ActivityView 类的底层 Java 对象。

QString QActivityView::activityClassName() const

返回活动的类名。

另请参阅 setActivityName。

QString QActivityView::activityPackageName() const

返回活动的包名。

另请参阅 setActivityName。

float QActivityView::cornerRadius() const

返回管理活动的圆角半径，单位为像素。

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

返回在渲染期间应用于纹理的变换矩阵。

此功能从 QtAndroidAutomotive 6.7 开始引入。

另请参阅 updateCurrentFrame。

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

返回当前帧的时间戳。

此功能从 QtAndroidAutomotive 6.7 开始引入。

另请参阅 updateCurrentFrame。

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

将inputEvent事件转发给底层活动。

此功能从 QtAndroidAutomotive 6.7 开始引入。

QRect QActivityView::geometry() const

返回以全局坐标系表示的管理活动的位置和大小。

另请参阅 setGeometry。

void QActivityView::initialize()

初始化底层Java资源，例如创建Surface对象。要求首先调用setGeometry。后续调用无效果。

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

查询并返回如果可绘制新帧则返回true，否则返回false。

此功能从 QtAndroidAutomotive 6.7 开始引入。

另请参阅 updateCurrentFrame。

bool QActivityView::isRestoreOnAppResumeEnabled() const

返回是否在应用非活动状态下恢复丢失的活动。

另请参阅 setRestoreOnAppResume。

bool QActivityView::isVisible() const

返回管理活动是否可见。默认情况下为true。

另请参阅 setVisible。

void QActivityView::restore()

如果活动已被从ActivityView外部移除，则重新加载嵌入式活动。

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

将带keyCode键点击发送到底层活动。

此功能从 QtAndroidAutomotive 6.7 开始引入。

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

将 touchEvent 发送到正在运行的 Android 活动中。它将可选的 transform 应用到触摸坐标。

此功能从 QtAndroidAutomotive 6.7 开始引入。

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

设置要启动的活动包名和类名。必须使用完整的包名指定 packageName。className 是一个可选参数，用于指定应用包内的类名。当没有指定类名时，默认类用于启动包中的主活动。

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

可以使用完整的类名来指定类名。

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

但是，如果 className 属性值中的第一个字符是点号，则将包名前缀到类名前。上面的代码片段可以缩短为以下形式

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

如果组件已初始化，则活动立即启动。否则，启动将延迟到初始化。

通过提供的包名和类名解析的活动必须满足某些条件。有关详细信息，请查阅 已知问题和限制 部分。

另请参阅activityPackageName()，activityClassName()，以及 initialize()。

void QActivityView::setGeometry(const QRect &geometry)

设置组件在屏幕上的位置和大小。geometry 的 x 和 y 坐标位于全局坐标系中。必须在进行初始化之前调用此方法，以便确定底层资源的初始位置和大小。稍后调用时，它将立即更改活动的几何形状。

另请参阅geometry()。

void QActivityView::setRestoreOnAppResume(bool restore)

根据 restore 的值，打开/关闭在应用非活动状态下丢失后恢复嵌入式活动的功能。恢复发生在应用返回活动状态时。

另请参阅isRestoreOnAppResumeEnabled()。

void QActivityView::setVisible(bool visible)

设置可见性为 visible 的值。

另请参阅isVisible()。

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

通过使用给定的 rhi 和 textureWidth 以及 textureHeight 创建 QRhiTexture 实例来启动活动的渲染。在失败的情况下返回创建的 QRhiTexture 的唯一指针或 nullptr。调用函数负责管理返回的值。

此功能从 QtAndroidAutomotive 6.7 开始引入。

另请参阅stopRendering()。

QActivityView::Status QActivityView::status() const

返回活动的当前状态。

另请参阅statusChanged()。

[信号] void QActivityView::statusChanged(QActivityView::Status 状态)

当ActivityView的状态变化时，会发出此信号。状态状态表示状态的新值。

[从QtAndroidAutomotive 6.7开始] void QActivityView::stopRendering()

停止渲染并解绑由QRhiTexture管理的底层纹理。在调用此函数后，用户负责删除之前通过调用startRendering()返回的QRhiTexture实例。

此功能从 QtAndroidAutomotive 6.7 开始引入。

另请参阅stopRendering().

[从QtAndroidAutomotive 6.7开始] void QActivityView::updateCurrentFrame()

使用当前可用的帧更新由startRendering()返回的QRhiTexture。

此功能从 QtAndroidAutomotive 6.7 开始引入。

另请参阅updateCurrentFrame(), currentFrameTimestamp(), 和 isNewFrameAvailable().