鸿蒙OpenHarmony【XComponent】渲染绘制

最新推荐文章于 2025-06-11 14:30:24 发布

AK搓背80一位

最新推荐文章于 2025-06-11 14:30:24 发布

阅读量1.4k

点赞数 19

CC 4.0 BY-SA版权

分类专栏： dd 文章标签： harmonyos 华为鸿蒙鸿蒙系统 ui 渲染

本文链接：https://blog.csdn.net/asfn123123/article/details/143857804

提供用于图形绘制和媒体数据写入的Surface，XComponent负责将其嵌入到视图中，支持应用自定义Surface位置和大小。

说明

该组件从API Version 8 开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。

子组件

无

接口

XComponent12+

XComponent(options: XComponentOptions)

元服务API： 从API version 12开始，该接口支持在元服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数:

参数名	类型	必填	说明
options	[XComponentOptions]	是	定义XComponent的具体配置参数。

XComponent10+

XComponent(value: {id: string, type: XComponentType, libraryname?: string, controller?: XComponentController})

该接口从API version 12开始不再演进，推荐使用[XComponent(options: XComponentOptions)]。

元服务API： 从API version 12开始，该接口支持在元服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数:

参数名	类型	必填	说明
id	string	是	组件的唯一标识，支持最大的字符串长度128。
type	[XComponentType]	是	用于指定XComponent组件类型。
libraryname	string	否	用Native层编译输出动态库名称（对应的动态库不支持跨模块加载），仅类型为SURFACE或TEXTURE时有效。
controller	[XComponentController]	否	给组件绑定一个控制器，通过控制器调用组件方法，仅类型为SURFACE或TEXTURE时有效。

XComponent(deprecated)

XComponent(value: {id: string, type: string, libraryname?: string, controller?: XComponentController})

说明：

从API version 12开始废弃，建议使用[XComponent(options: XComponentOptions)]替代。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数:

参数名	类型	必填	说明
id	string	是	组件的唯一标识，支持最大的字符串长度128。
type	string	是	用于指定XComponent组件类型，可选值仅有两个为：-“surface”：用于EGL/OpenGLES和媒体数据写入，开发者定制的绘制内容单独展示到屏幕上。-"component"9+ ：XComponent将变成一个容器组件，并可在其中执行非UI逻辑以动态加载显示内容。其他值均会被视为"surface"类型
libraryname	string	否	应用Native层编译输出动态库名称（对应的动态库不支持跨模块加载），仅XComponent类型为"surface"时有效。
controller	[XComponentcontroller]	否	给组件绑定一个控制器，通过控制器调用组件方法，仅XComponent类型为"surface"时有效。

XComponentOptions12+

定义XComponent的具体配置参数。

元服务API： 从API version 12开始，该接口支持在元服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

名称	类型	必填	说明
type	[XComponentType]	是	用于指定XComponent组件类型。
controller	[XComponentController]	是	给组件绑定一个控制器，通过控制器调用组件方法，仅类型为SURFACE或TEXTURE时有效。
imageAIOptions	[ImageAIOptions]	否	给组件设置一个AI分析选项，通过此项可配置分析类型或绑定一个分析控制器。

属性

除支持通用属性外，还支持以下属性：

说明

不支持foregroundColor、obscured和pixelStretchEffect属性，并且type为SURFACE类型时也不支持动态属性设置、自定义绘制、背景设置(backgroundColor除外)、图像效果(shadow除外)、maskShape和foregroundEffect属性。</