NativeWindow是本地平台化窗口，表示图形队列的生产者端。开发者可以通过NativeWindow接口进行申请和提交Buffer，配置Buffer属性信息，用于实现图形内容的生成和显示。

常见开发场景包括通过NativeWindow提供的Native API接口申请图形Buffer，并将生成的图形内容写入图形Buffer，最终提交Buffer到图形队列；以及在适配EGL层的eglswapbuffer接口时，进行申请和提交Buffer。

OH_NativeWindow_NativeWindowRequestBuffer接口用于通过OHNativeWindow对象申请一块OHNativeWindowBuffer，用以内容生产。使用时，需传入OHNativeWindow对象、用于接收申请的Buffer的指针以及用于接收栅栏文件描述符的指针，调用该接口即可申请Buffer。

OH_NativeWindow_NativeWindowFlushBuffer接口用于通过OHNativeWindow将生产好内容的OHNativeWindowBuffer放回到Buffer队列中，用以内容消费。使用时，需传入OHNativeWindow对象、要提交的Buffer、栅栏文件描述符以及区域信息，调用该接口即可将Buffer提交到图形队列。

OH_NativeWindow_NativeWindowHandleOpt接口用于设置/获取OHNativeWindow的属性，包括设置/获取宽高、内容格式等。使用时，需传入OHNativeWindow对象、操作代码以及相应的参数，调用该接口即可对OHNativeWindow的属性进行设置或获取

使用NativeWindow进行开发的步骤包括：在CMakeLists.txt中添加libace_ndk.z.so和libnative_window.so；包含必要的头文件；获取OHNativeWindow实例，可通过OH_NativeXComponent_Callback接口获取；定义OH_NativeXComponent_Callback并设置相关回调函数；将OH_NativeXC...

可通过OH_NativeXComponent_Callback接口获取OHNativeWindow。例如在XComponent组件加载时，通过nativeWindowContext获取NativeWindowContext，再在native c++层通过OH_NativeXComponent_GetXComponentId获取XComponent ID，进而获取OHNativeWindow实例。

使用OH_NativeWindow_NativeWindowHandleOpt设置OHNativeWindowBuffer的属性。例如，通过传入设置属性的操作代码（如SET_BUFFER_GEOMETRY）、缓冲区宽度和高度等参数，调用该接口即可设置OHNativeWindowBuffer的属性。

首先需要进行内存映射mmap，将OHNativeWindowBuffer映射到用户空间。然后等待releaseFenceFd可用（如果releaseFenceFd不为 -1），以确保消费者进程已消费完buffer，生产者可以开始填充buffer内容。之后，通过映射后的地址将生产的内容写入OHNativeWindowBuffer。

使用OH_NativeWindow_NativeWindowFlushBuffer接口将OHNativeWindowBuffer提交到图形队列。调用该接口时，需传入OHNativeWindow对象、要提交的Buffer、栅栏文件描述符以及区域信息，将生产好内容的Buffer放回到Buffer队列中，用以内容消费。

XComponent组件是一种渲染组件，可用于EGL/OpenGLES和媒体数据写入，通过使用其持有的“NativeWindow”渲染画面，满足开发需要实现高级自定义渲染的需求，例如相机预览流的显示和游戏画面的渲染。

XComponent组件有XComponentType.SURFACE和XComponentType.TEXTURE两种类型。SURFACE类型将定制的绘制内容单独展示到屏幕上，TEXTURE类型将定制的绘制内容和XComponent组件的内容合成后展示到屏幕上。

XComponent主要用于两类场景，分别是高性能渲染（如游戏画面、3D图形、复杂动画等）和媒体数据处理（如相机预览、视频播放、图像处理等）。

当XComponent传输的绘制内容包含透明元素时，Surface区域的显示效果会与下方内容进行合成展示。例如，若传输的内容完全透明，且XComponent的背景色被设置为黑色，同时Surface保持默认的大小与位置，则最终显示的将是一片黑色区域。

XComponent持有一个Surface，开发者能通过调用NativeWindow等接口，申请并提交Buffer至图形队列，以此方式将自绘制内容传送至该Surface，其主体流程如下：应用RequestBuffer获取空闲帧 → 应用生产帧数据 → 应用调用FlushBuffer提交到BufferQueue → 系统渲染侧通过Acq...

目前ArkUI提供了三种UI组件的创建方式，分别是使用ArkTS声明式UI描述创建、使用ArkTS自定义组件节点创建以及使用NDK接口创建。通用UI界面开发场景下，建议使用ArkTS声明式UI描述创建XComponent组件。

可以使用XComponentController管理Surface生命周期。其生命周期的触发时机如下：onSurfaceCreated回调在XComponent创建完成且创建好Surface后触发；onSurfaceChanged回调在Surface大小变化触发重新布局之后触发；onSurfaceDestroyed回调在XComponent组件被销毁时触发...

可以使用OH_ArkUI_SurfaceHolder管理Surface生命周期。其生命周期触发时机如下：OnSurfaceCreated回调在当XComponent创建完成且创建好Surface后，满足组件上树且autoInitialize = true或调用OH_ArkUI_XComponent_Initialize时触发；OnSurfaceChanged回调在OnSurfaceC...

除使用NDK接口创建的XComponent无法在ArkTS侧使用XComponentController来管理Surface生命周期外，目前共有五种XComponent开发范式，分别是通过ArkTS声明式UI描述来创建组件并结合XComponentController实现对Surface生命周期的管理；通过ArkTS声明式UI描述来创建组件...

组件创建：使用OH_NativeXComponent需要传入id和libraryname属性以支持在Native侧获取对应的OH_NativeXComponent实例；而使用OH_ArkUI_SurfaceHolder管理Surface生命周期的XComponent不再需要在XComponent的构造参数中传入id和libraryname属性，而是直接将组件对应的...