diff --git a/zh-cn/application-dev/reference/apis-arkui/_o_h___native_x_component.md b/zh-cn/application-dev/reference/apis-arkui/_o_h___native_x_component.md
index 496f1cf364d0d101ac438e3e10eaed0de03f9764..91bc10832dff43cdbbeafb21c867024d245157a9 100644
--- a/zh-cn/application-dev/reference/apis-arkui/_o_h___native_x_component.md
+++ b/zh-cn/application-dev/reference/apis-arkui/_o_h___native_x_component.md
@@ -218,6 +218,10 @@ typedef struct OH_NativeXComponent_KeyEvent OH_NativeXComponent_KeyEvent
 
 提供封装的OH_NativeXComponent_KeyEvent实例。
 
+> **说明：**
+>
+> 此结构体可通过[OH_NativeXComponent_GetKeyEventAction](#oh_nativexcomponent_getkeyeventaction)，[OH_NativeXComponent_GetKeyEventCode](#oh_nativexcomponent_getkeyeventcode)，[OH_NativeXComponent_GetKeyEventDeviceId](#oh_nativexcomponent_getkeyeventdeviceid)，[OH_NativeXComponent_GetKeyEventSourceType](#oh_nativexcomponent_getkeyeventsourcetype)，[OH_NativeXComponent_GetKeyEventTimestamp](#oh_nativexcomponent_getkeyeventtimestamp)等接口获取结构体内的参数。
+
 **起始版本：**
 
 10
@@ -2920,7 +2924,7 @@ uint32_t OH_NativeXComponent_TouchEvent::numPoints = 0
 
 **描述:**
 
-当前接触点的数量。
+当前接触点的数量，值为1时为单指触摸，大于1时为多指触摸。
 
 **起始版本：**
 
diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-xcomponent.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-xcomponent.md
index 3da387d0af4f5c513e5eef91ea7d8cb5480280bf..952f9ffa096630267c227f6c72306ebcaa79672a 100755
--- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-xcomponent.md
+++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-xcomponent.md
@@ -332,7 +332,7 @@ getXComponentContext(): Object
 
 setXComponentSurfaceRect(rect: SurfaceRect): void
 
-设置XComponent持有Surface的显示区域，仅XComponent类型为SURFACE("surface")或TEXTURE时有效。
+设置XComponent持有Surface的显示区域，包括宽高和相对于组件左上角的位置坐标，仅XComponent类型为SURFACE("surface")或TEXTURE时有效。
 
 **原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。
 
@@ -356,7 +356,7 @@ setXComponentSurfaceRect(rect: SurfaceRect): void
 
 getXComponentSurfaceRect(): SurfaceRect
 
-获取XComponent持有Surface的显示区域，仅XComponent类型为SURFACE("surface")或TEXTURE时有效。
+获取XComponent持有Surface的显示区域，包括宽高和相对于组件左上角的位置坐标，仅XComponent类型为SURFACE("surface")或TEXTURE时有效。
 
 **原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。
 
@@ -609,6 +609,8 @@ unlockCanvasAndPost(canvas: DrawingCanvas): void
 > surfaceWidth和surfaceHeight属性在未调用[setXComponentSurfaceRect](ts-basic-components-xcomponent.md#setxcomponentsurfacerect12)也未设置[border](ts-universal-attributes-border.md#border)和[padding](ts-universal-attributes-size.md#padding)等属性时，其取值大小为XComponent组件的大小。
 > 
 > surfaceWidth和surfaceHeight属性的取值都不可超过8192px，否则会导致渲染异常。
+>
+> 沉浸式场景下，默认布局的SurfaceRect不包括安全区，需调用[setXComponentSurfaceRect](ts-basic-components-xcomponent.md#setxcomponentsurfacerect12)接口主动设置Surface显示区域达到沉浸式效果。
 
 ## DrawingCanvas<sup>12+</sup>对象说明
 
diff --git a/zh-cn/application-dev/ui/napi-xcomponent-guidelines.md b/zh-cn/application-dev/ui/napi-xcomponent-guidelines.md
index fc50b1448a8959417cd35775eef939273a654a23..7aa798e2f0567d43a10c1c62496c61321c483475 100644
--- a/zh-cn/application-dev/ui/napi-xcomponent-guidelines.md
+++ b/zh-cn/application-dev/ui/napi-xcomponent-guidelines.md
@@ -13,6 +13,8 @@ XComponent组件作为一种渲染组件，可用于EGL/OpenGLES和媒体数据
 
 XComponent持有一个Surface，开发者能通过调用[NativeWindow](../graphics/native-window-guidelines.md)等接口，申请并提交Buffer至图形队列，以此方式将自绘制内容传送至该Surface。XComponent负责将此Surface整合进UI界面，其中展示的内容正是开发者传送的自绘制内容。Surface的默认位置与大小与XComponent组件一致，开发者可利用[setXComponentSurfaceRect](../reference/apis-arkui/arkui-ts/ts-basic-components-xcomponent.md#setxcomponentsurfacerect12)接口自定义调整Surface的位置和大小。
 
+XComponent组件负责创建Surface，并通过回调将Surface的相关信息告知应用。应用可以通过一系列接口设定Surface的属性。该组件本身不对所绘制的内容进行感知，亦不提供渲染绘制的接口。
+
 > **说明：** 
 >
 > 当开发者传输的绘制内容包含透明元素时，Surface区域的显示效果会与下方内容进行合成展示。例如，若传输的内容完全透明，且XComponent的背景色被设置为黑色，同时Surface保持默认的大小与位置，则最终显示的将是一片黑色区域。