From ff74461e4c4cd6b59d3725650a12d0c2489c517e Mon Sep 17 00:00:00 2001
From: DiaoYingHui <1778514960@qq.com>
Date: Wed, 9 Mar 2022 16:12:17 +0800
Subject: [PATCH 1/3] native_interface_xcomponent.h

Signed-off-by: DiaoYingHui <1778514960@qq.com>
---
 .../ace/native_interface_xcomponent.h         | 218 ++++++++++++++++++
 1 file changed, 218 insertions(+)
 create mode 100644 zh-cn/native_sdk/ace/native_interface_xcomponent.h

diff --git a/zh-cn/native_sdk/ace/native_interface_xcomponent.h b/zh-cn/native_sdk/ace/native_interface_xcomponent.h
new file mode 100644
index 00000000..8a215d2d
--- /dev/null
+++ b/zh-cn/native_sdk/ace/native_interface_xcomponent.h
@@ -0,0 +1,218 @@
+/*
+ * Copyright (c) 2021-2022 Huawei Device Co., Ltd.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * @addtogroup ACE
+ * @{
+ *
+ * @brief 提供设置和获取组件的数据与回调的功能
+ * @since 8
+ * @version 1.0
+ */
+
+/**
+ * @file native_interface_xcomponent.h
+ *
+ * @brief 声明APIs以此获得原生xcomponent的数据
+ *
+ * @since 8
+ * @version 1.0
+ */
+
+#ifndef _NATIVE_INTERFACE_XCOMPONENT_H_
+#define _NATIVE_INTERFACE_XCOMPONENT_H_
+
+#include <stdint.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @brief 枚举返回值类型
+ *
+ * @since 8
+ * @version 1.0
+ */
+enum {
+    /* 成功结果 */
+    OH_NATIVEXCOMPONENT_RESULT_SUCCESS = 0,
+    /* 失败的结果 */
+    OH_NATIVEXCOMPONENT_RESULT_FAILED = -1,
+    /* 无效参数 */
+    OH_NATIVEXCOMPONENT_RESULT_BAD_PARAMETER = -2,
+};
+
+enum OH_NativeXComponent_TouchEventType {
+    OH_NATIVEXCOMPONENT_DOWN = 0,
+    OH_NATIVEXCOMPONENT_UP,
+    OH_NATIVEXCOMPONENT_MOVE,
+    OH_NATIVEXCOMPONENT_CANCEL,
+    OH_NATIVEXCOMPONENT_UNKNOWN,
+};
+
+#define OH_NATIVE_XCOMPONENT_OBJ ("__NATIVE_XCOMPONENT_OBJ__")
+const uint32_t OH_XCOMPONENT_ID_LEN_MAX = 128;
+const uint32_t OH_MAX_TOUCH_POINTS_NUMBER = 10;
+
+struct OH_NativeXComponent_TouchPoint {
+    // 手指与屏幕间的接触点ID
+    int32_t id = 0;
+    // 触摸点相对于屏幕左上角的水平距离
+    float screenX = 0.0;
+    // 触摸点相对于屏幕左上角的垂直距离
+    float screenY = 0.0;
+    // 触摸点相对于被触摸的元素左上角的水平距离
+    float x = 0.0;
+    // 触摸点相对于被触摸的元素左上角的垂直距离
+    float y = 0.0;
+    // 触摸事件的触摸类型
+    OH_NativeXComponent_TouchEventType type = OH_NativeXComponent_TouchEventType::OH_NATIVEXCOMPONENT_UNKNOWN;
+    // 环绕用户与触摸屏的接触面尺寸
+    double size = 0.0;
+    // 手指按压触摸屏的压力
+    float force = 0.0;
+    // 触摸事件的时间戳
+    long long timeStamp = 0;
+    // 点是否被按下
+    bool isPressed = false;
+};
+
+// 活动改变点信息
+struct OH_NativeXComponent_TouchEvent {
+    // 手指与屏幕间的接触点ID
+    int32_t id = 0;
+    // 触摸点相对于屏幕左上角的水平距离
+    float screenX = 0.0;
+    // 触摸点相对于屏幕左上角的垂直距离
+    float screenY = 0.0;
+    // 触摸点相对于被触摸的元素左上角的水平距离
+    float x = 0.0;
+    // 触摸点相对于被触摸的元素左上角的垂直距离
+    float y = 0.0;
+    // 触摸事件的触摸类型
+    OH_NativeXComponent_TouchEventType type = OH_NativeXComponent_TouchEventType::OH_NATIVEXCOMPONENT_UNKNOWN;
+    // 环绕用户与触摸屏的接触面尺寸
+    double size = 0.0;
+    // 手指按压触摸屏的压力
+    float force = 0.0;
+    // 设备编号
+    int64_t deviceId = 0;
+    // 触摸事件的时间戳
+    long long timeStamp = 0;
+    // 触摸屏上所有的点
+    OH_NativeXComponent_TouchPoint touchPoints[OH_MAX_TOUCH_POINTS_NUMBER];
+    // 触摸指针的数量
+    uint32_t numPoints = 0;
+};
+
+/**
+ * @brief 定义NativeXComponent对象，通常通过指针访问
+ *
+ * @since 8
+ * @version 1.0
+ */
+typedef struct OH_NativeXComponent OH_NativeXComponent;
+
+/**
+ * @brief 定义NativeXComponentCallback结构体, 保持表面生命周期的回调
+ *
+ * @since 8
+ * @version 1.0
+ */
+typedef struct OH_NativeXComponent_Callback {
+    /* 在创建或重新创建原生surface时调用 */
+    void (*OnSurfaceCreated)(OH_NativeXComponent* component, void* window);
+    /* 在原生surface改变时调用 */
+    void (*OnSurfaceChanged)(OH_NativeXComponent* component, void* window);
+    /* 在原生surface被破坏时调用 */
+    void (*OnSurfaceDestroyed)(OH_NativeXComponent* component, void* window);
+    /* 在触摸事件触发时调用 */
+    void (*DispatchTouchEvent)(OH_NativeXComponent* component, void* window);
+} OH_NativeXComponent_Callback;
+
+/**
+ * @brief 获取xcomponent的id.
+ *
+ * @param component 表示指向NativeXComponent实例的指针
+ * @param id 表示保存xcomponent ID的字符缓冲区
+ *        请注意，空终止符将附加到字符缓冲区，因此字符缓冲区的大小应至少与真实id长度的大小加1一样大
+ *        字符缓冲区的大小建议为[OH_XCOMPONENT_ID_LEN_MAX + 1]
+ * @param size 是一个输入输出参数
+ *        [in] 表示id字符缓冲区的长度（包括空终止符）
+ *             size的引用值应在(0, OH_XCOMPONENT_ID_LEN_MAX + 1]范围内
+ *        [out] 接收id的长度（不包括空终止符）
+ * @return 返回执行结果
+ * @since 8
+ * @version 1.0
+ */
+int32_t OH_NativeXComponent_GetXComponentId(OH_NativeXComponent* component, char* id, uint64_t* size);
+
+/**
+ * @brief 获取xcomponent的大小
+ *
+ * @param component 表示指向NativeXComponent实例的指针
+ * @param window 表示本机窗口处理程序
+ * @param width 表示指向xcomponent宽度的指针.
+ * @param height 表示指向xcomponent高度的指针.
+ * @return 返回执行结果
+ * @since 8
+ * @version 1.0
+ */
+int32_t OH_NativeXComponent_GetXComponentSize(
+    OH_NativeXComponent* component, const void* window, uint64_t* width, uint64_t* height);
+
+/**
+ * @brief 获取xcomponent的偏移量
+ *
+ * @param component 表示指向NativeXComponent实例的指针
+ * @param window 表示本机窗口处理程序
+ * @param x 表示指向xcomponent相对于屏幕左上角的水平坐标的指针
+ * @param y 表示指向xcomponent相对于屏幕左上角的纵坐标的指针
+ * @return 返回执行结果
+ * @since 8
+ * @version 1.0
+ */
+int32_t OH_NativeXComponent_GetXComponentOffset(
+    OH_NativeXComponent* component, const void* window, double* x, double* y);
+
+/**
+ * @brief 获取触摸事件的信息
+ *
+ * @param component 表示指向NativeXComponent实例的指针
+ * @param window 表示本机窗口处理程序
+ * @param touchInfo 表示指向当前触摸信息的指针
+ * @return 返回执行结果
+ * @since 8
+ * @version 1.0
+ */
+int32_t OH_NativeXComponent_GetTouchEvent(
+    OH_NativeXComponent* component, const void* window, OH_NativeXComponent_TouchEvent* touchEvent);
+
+/**
+ * @brief 设置xcomponent的回调
+ *
+ * @param component 表示指向NativeXComponent实例的指针
+ * @param callback 表示本机表面生命周期的回调
+ * @return 返回执行结果
+ * @since 8
+ * @version 1.0
+ */
+int32_t OH_NativeXComponent_RegisterCallback(OH_NativeXComponent* component, OH_NativeXComponent_Callback* callback);
+
+#ifdef __cplusplus
+};
+#endif
+#endif // _NATIVE_INTERFACE_XCOMPONENT_H_
\ No newline at end of file
-- 
Gitee


From e2043d2cd782578bc15f20e217cad3eaf1aac773 Mon Sep 17 00:00:00 2001
From: diaoyinghui <diaoyinghui@huawei.com>
Date: Thu, 10 Mar 2022 07:20:42 +0000
Subject: [PATCH 2/3] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20zh-c?=
 =?UTF-8?q?n/native=5Fsdk/ace/native=5Finterface=5Fxcomponent.h?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../ace/native_interface_xcomponent.h         | 218 ------------------
 1 file changed, 218 deletions(-)
 delete mode 100644 zh-cn/native_sdk/ace/native_interface_xcomponent.h

diff --git a/zh-cn/native_sdk/ace/native_interface_xcomponent.h b/zh-cn/native_sdk/ace/native_interface_xcomponent.h
deleted file mode 100644
index 8a215d2d..00000000
--- a/zh-cn/native_sdk/ace/native_interface_xcomponent.h
+++ /dev/null
@@ -1,218 +0,0 @@
-/*
- * Copyright (c) 2021-2022 Huawei Device Co., Ltd.
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-/**
- * @addtogroup ACE
- * @{
- *
- * @brief 提供设置和获取组件的数据与回调的功能
- * @since 8
- * @version 1.0
- */
-
-/**
- * @file native_interface_xcomponent.h
- *
- * @brief 声明APIs以此获得原生xcomponent的数据
- *
- * @since 8
- * @version 1.0
- */
-
-#ifndef _NATIVE_INTERFACE_XCOMPONENT_H_
-#define _NATIVE_INTERFACE_XCOMPONENT_H_
-
-#include <stdint.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * @brief 枚举返回值类型
- *
- * @since 8
- * @version 1.0
- */
-enum {
-    /* 成功结果 */
-    OH_NATIVEXCOMPONENT_RESULT_SUCCESS = 0,
-    /* 失败的结果 */
-    OH_NATIVEXCOMPONENT_RESULT_FAILED = -1,
-    /* 无效参数 */
-    OH_NATIVEXCOMPONENT_RESULT_BAD_PARAMETER = -2,
-};
-
-enum OH_NativeXComponent_TouchEventType {
-    OH_NATIVEXCOMPONENT_DOWN = 0,
-    OH_NATIVEXCOMPONENT_UP,
-    OH_NATIVEXCOMPONENT_MOVE,
-    OH_NATIVEXCOMPONENT_CANCEL,
-    OH_NATIVEXCOMPONENT_UNKNOWN,
-};
-
-#define OH_NATIVE_XCOMPONENT_OBJ ("__NATIVE_XCOMPONENT_OBJ__")
-const uint32_t OH_XCOMPONENT_ID_LEN_MAX = 128;
-const uint32_t OH_MAX_TOUCH_POINTS_NUMBER = 10;
-
-struct OH_NativeXComponent_TouchPoint {
-    // 手指与屏幕间的接触点ID
-    int32_t id = 0;
-    // 触摸点相对于屏幕左上角的水平距离
-    float screenX = 0.0;
-    // 触摸点相对于屏幕左上角的垂直距离
-    float screenY = 0.0;
-    // 触摸点相对于被触摸的元素左上角的水平距离
-    float x = 0.0;
-    // 触摸点相对于被触摸的元素左上角的垂直距离
-    float y = 0.0;
-    // 触摸事件的触摸类型
-    OH_NativeXComponent_TouchEventType type = OH_NativeXComponent_TouchEventType::OH_NATIVEXCOMPONENT_UNKNOWN;
-    // 环绕用户与触摸屏的接触面尺寸
-    double size = 0.0;
-    // 手指按压触摸屏的压力
-    float force = 0.0;
-    // 触摸事件的时间戳
-    long long timeStamp = 0;
-    // 点是否被按下
-    bool isPressed = false;
-};
-
-// 活动改变点信息
-struct OH_NativeXComponent_TouchEvent {
-    // 手指与屏幕间的接触点ID
-    int32_t id = 0;
-    // 触摸点相对于屏幕左上角的水平距离
-    float screenX = 0.0;
-    // 触摸点相对于屏幕左上角的垂直距离
-    float screenY = 0.0;
-    // 触摸点相对于被触摸的元素左上角的水平距离
-    float x = 0.0;
-    // 触摸点相对于被触摸的元素左上角的垂直距离
-    float y = 0.0;
-    // 触摸事件的触摸类型
-    OH_NativeXComponent_TouchEventType type = OH_NativeXComponent_TouchEventType::OH_NATIVEXCOMPONENT_UNKNOWN;
-    // 环绕用户与触摸屏的接触面尺寸
-    double size = 0.0;
-    // 手指按压触摸屏的压力
-    float force = 0.0;
-    // 设备编号
-    int64_t deviceId = 0;
-    // 触摸事件的时间戳
-    long long timeStamp = 0;
-    // 触摸屏上所有的点
-    OH_NativeXComponent_TouchPoint touchPoints[OH_MAX_TOUCH_POINTS_NUMBER];
-    // 触摸指针的数量
-    uint32_t numPoints = 0;
-};
-
-/**
- * @brief 定义NativeXComponent对象，通常通过指针访问
- *
- * @since 8
- * @version 1.0
- */
-typedef struct OH_NativeXComponent OH_NativeXComponent;
-
-/**
- * @brief 定义NativeXComponentCallback结构体, 保持表面生命周期的回调
- *
- * @since 8
- * @version 1.0
- */
-typedef struct OH_NativeXComponent_Callback {
-    /* 在创建或重新创建原生surface时调用 */
-    void (*OnSurfaceCreated)(OH_NativeXComponent* component, void* window);
-    /* 在原生surface改变时调用 */
-    void (*OnSurfaceChanged)(OH_NativeXComponent* component, void* window);
-    /* 在原生surface被破坏时调用 */
-    void (*OnSurfaceDestroyed)(OH_NativeXComponent* component, void* window);
-    /* 在触摸事件触发时调用 */
-    void (*DispatchTouchEvent)(OH_NativeXComponent* component, void* window);
-} OH_NativeXComponent_Callback;
-
-/**
- * @brief 获取xcomponent的id.
- *
- * @param component 表示指向NativeXComponent实例的指针
- * @param id 表示保存xcomponent ID的字符缓冲区
- *        请注意，空终止符将附加到字符缓冲区，因此字符缓冲区的大小应至少与真实id长度的大小加1一样大
- *        字符缓冲区的大小建议为[OH_XCOMPONENT_ID_LEN_MAX + 1]
- * @param size 是一个输入输出参数
- *        [in] 表示id字符缓冲区的长度（包括空终止符）
- *             size的引用值应在(0, OH_XCOMPONENT_ID_LEN_MAX + 1]范围内
- *        [out] 接收id的长度（不包括空终止符）
- * @return 返回执行结果
- * @since 8
- * @version 1.0
- */
-int32_t OH_NativeXComponent_GetXComponentId(OH_NativeXComponent* component, char* id, uint64_t* size);
-
-/**
- * @brief 获取xcomponent的大小
- *
- * @param component 表示指向NativeXComponent实例的指针
- * @param window 表示本机窗口处理程序
- * @param width 表示指向xcomponent宽度的指针.
- * @param height 表示指向xcomponent高度的指针.
- * @return 返回执行结果
- * @since 8
- * @version 1.0
- */
-int32_t OH_NativeXComponent_GetXComponentSize(
-    OH_NativeXComponent* component, const void* window, uint64_t* width, uint64_t* height);
-
-/**
- * @brief 获取xcomponent的偏移量
- *
- * @param component 表示指向NativeXComponent实例的指针
- * @param window 表示本机窗口处理程序
- * @param x 表示指向xcomponent相对于屏幕左上角的水平坐标的指针
- * @param y 表示指向xcomponent相对于屏幕左上角的纵坐标的指针
- * @return 返回执行结果
- * @since 8
- * @version 1.0
- */
-int32_t OH_NativeXComponent_GetXComponentOffset(
-    OH_NativeXComponent* component, const void* window, double* x, double* y);
-
-/**
- * @brief 获取触摸事件的信息
- *
- * @param component 表示指向NativeXComponent实例的指针
- * @param window 表示本机窗口处理程序
- * @param touchInfo 表示指向当前触摸信息的指针
- * @return 返回执行结果
- * @since 8
- * @version 1.0
- */
-int32_t OH_NativeXComponent_GetTouchEvent(
-    OH_NativeXComponent* component, const void* window, OH_NativeXComponent_TouchEvent* touchEvent);
-
-/**
- * @brief 设置xcomponent的回调
- *
- * @param component 表示指向NativeXComponent实例的指针
- * @param callback 表示本机表面生命周期的回调
- * @return 返回执行结果
- * @since 8
- * @version 1.0
- */
-int32_t OH_NativeXComponent_RegisterCallback(OH_NativeXComponent* component, OH_NativeXComponent_Callback* callback);
-
-#ifdef __cplusplus
-};
-#endif
-#endif // _NATIVE_INTERFACE_XCOMPONENT_H_
\ No newline at end of file
-- 
Gitee


From 5bd1372b77cc1e6a9e429cc5e14787c4f28eab74 Mon Sep 17 00:00:00 2001
From: DiaoYingHui <1778514960@qq.com>
Date: Thu, 10 Mar 2022 15:22:23 +0800
Subject: [PATCH 3/3] add Chinese explanation

Signed-off-by: DiaoYingHui <1778514960@qq.com>
---
 .../ace/native_interface_xcomponent.h         | 218 ++++++++++++++++++
 1 file changed, 218 insertions(+)
 create mode 100644 zh-cn/native_sdk/ace/native_interface_xcomponent.h

diff --git a/zh-cn/native_sdk/ace/native_interface_xcomponent.h b/zh-cn/native_sdk/ace/native_interface_xcomponent.h
new file mode 100644
index 00000000..8a215d2d
--- /dev/null
+++ b/zh-cn/native_sdk/ace/native_interface_xcomponent.h
@@ -0,0 +1,218 @@
+/*
+ * Copyright (c) 2021-2022 Huawei Device Co., Ltd.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * @addtogroup ACE
+ * @{
+ *
+ * @brief 提供设置和获取组件的数据与回调的功能
+ * @since 8
+ * @version 1.0
+ */
+
+/**
+ * @file native_interface_xcomponent.h
+ *
+ * @brief 声明APIs以此获得原生xcomponent的数据
+ *
+ * @since 8
+ * @version 1.0
+ */
+
+#ifndef _NATIVE_INTERFACE_XCOMPONENT_H_
+#define _NATIVE_INTERFACE_XCOMPONENT_H_
+
+#include <stdint.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @brief 枚举返回值类型
+ *
+ * @since 8
+ * @version 1.0
+ */
+enum {
+    /* 成功结果 */
+    OH_NATIVEXCOMPONENT_RESULT_SUCCESS = 0,
+    /* 失败的结果 */
+    OH_NATIVEXCOMPONENT_RESULT_FAILED = -1,
+    /* 无效参数 */
+    OH_NATIVEXCOMPONENT_RESULT_BAD_PARAMETER = -2,
+};
+
+enum OH_NativeXComponent_TouchEventType {
+    OH_NATIVEXCOMPONENT_DOWN = 0,
+    OH_NATIVEXCOMPONENT_UP,
+    OH_NATIVEXCOMPONENT_MOVE,
+    OH_NATIVEXCOMPONENT_CANCEL,
+    OH_NATIVEXCOMPONENT_UNKNOWN,
+};
+
+#define OH_NATIVE_XCOMPONENT_OBJ ("__NATIVE_XCOMPONENT_OBJ__")
+const uint32_t OH_XCOMPONENT_ID_LEN_MAX = 128;
+const uint32_t OH_MAX_TOUCH_POINTS_NUMBER = 10;
+
+struct OH_NativeXComponent_TouchPoint {
+    // 手指与屏幕间的接触点ID
+    int32_t id = 0;
+    // 触摸点相对于屏幕左上角的水平距离
+    float screenX = 0.0;
+    // 触摸点相对于屏幕左上角的垂直距离
+    float screenY = 0.0;
+    // 触摸点相对于被触摸的元素左上角的水平距离
+    float x = 0.0;
+    // 触摸点相对于被触摸的元素左上角的垂直距离
+    float y = 0.0;
+    // 触摸事件的触摸类型
+    OH_NativeXComponent_TouchEventType type = OH_NativeXComponent_TouchEventType::OH_NATIVEXCOMPONENT_UNKNOWN;
+    // 环绕用户与触摸屏的接触面尺寸
+    double size = 0.0;
+    // 手指按压触摸屏的压力
+    float force = 0.0;
+    // 触摸事件的时间戳
+    long long timeStamp = 0;
+    // 点是否被按下
+    bool isPressed = false;
+};
+
+// 活动改变点信息
+struct OH_NativeXComponent_TouchEvent {
+    // 手指与屏幕间的接触点ID
+    int32_t id = 0;
+    // 触摸点相对于屏幕左上角的水平距离
+    float screenX = 0.0;
+    // 触摸点相对于屏幕左上角的垂直距离
+    float screenY = 0.0;
+    // 触摸点相对于被触摸的元素左上角的水平距离
+    float x = 0.0;
+    // 触摸点相对于被触摸的元素左上角的垂直距离
+    float y = 0.0;
+    // 触摸事件的触摸类型
+    OH_NativeXComponent_TouchEventType type = OH_NativeXComponent_TouchEventType::OH_NATIVEXCOMPONENT_UNKNOWN;
+    // 环绕用户与触摸屏的接触面尺寸
+    double size = 0.0;
+    // 手指按压触摸屏的压力
+    float force = 0.0;
+    // 设备编号
+    int64_t deviceId = 0;
+    // 触摸事件的时间戳
+    long long timeStamp = 0;
+    // 触摸屏上所有的点
+    OH_NativeXComponent_TouchPoint touchPoints[OH_MAX_TOUCH_POINTS_NUMBER];
+    // 触摸指针的数量
+    uint32_t numPoints = 0;
+};
+
+/**
+ * @brief 定义NativeXComponent对象，通常通过指针访问
+ *
+ * @since 8
+ * @version 1.0
+ */
+typedef struct OH_NativeXComponent OH_NativeXComponent;
+
+/**
+ * @brief 定义NativeXComponentCallback结构体, 保持表面生命周期的回调
+ *
+ * @since 8
+ * @version 1.0
+ */
+typedef struct OH_NativeXComponent_Callback {
+    /* 在创建或重新创建原生surface时调用 */
+    void (*OnSurfaceCreated)(OH_NativeXComponent* component, void* window);
+    /* 在原生surface改变时调用 */
+    void (*OnSurfaceChanged)(OH_NativeXComponent* component, void* window);
+    /* 在原生surface被破坏时调用 */
+    void (*OnSurfaceDestroyed)(OH_NativeXComponent* component, void* window);
+    /* 在触摸事件触发时调用 */
+    void (*DispatchTouchEvent)(OH_NativeXComponent* component, void* window);
+} OH_NativeXComponent_Callback;
+
+/**
+ * @brief 获取xcomponent的id.
+ *
+ * @param component 表示指向NativeXComponent实例的指针
+ * @param id 表示保存xcomponent ID的字符缓冲区
+ *        请注意，空终止符将附加到字符缓冲区，因此字符缓冲区的大小应至少与真实id长度的大小加1一样大
+ *        字符缓冲区的大小建议为[OH_XCOMPONENT_ID_LEN_MAX + 1]
+ * @param size 是一个输入输出参数
+ *        [in] 表示id字符缓冲区的长度（包括空终止符）
+ *             size的引用值应在(0, OH_XCOMPONENT_ID_LEN_MAX + 1]范围内
+ *        [out] 接收id的长度（不包括空终止符）
+ * @return 返回执行结果
+ * @since 8
+ * @version 1.0
+ */
+int32_t OH_NativeXComponent_GetXComponentId(OH_NativeXComponent* component, char* id, uint64_t* size);
+
+/**
+ * @brief 获取xcomponent的大小
+ *
+ * @param component 表示指向NativeXComponent实例的指针
+ * @param window 表示本机窗口处理程序
+ * @param width 表示指向xcomponent宽度的指针.
+ * @param height 表示指向xcomponent高度的指针.
+ * @return 返回执行结果
+ * @since 8
+ * @version 1.0
+ */
+int32_t OH_NativeXComponent_GetXComponentSize(
+    OH_NativeXComponent* component, const void* window, uint64_t* width, uint64_t* height);
+
+/**
+ * @brief 获取xcomponent的偏移量
+ *
+ * @param component 表示指向NativeXComponent实例的指针
+ * @param window 表示本机窗口处理程序
+ * @param x 表示指向xcomponent相对于屏幕左上角的水平坐标的指针
+ * @param y 表示指向xcomponent相对于屏幕左上角的纵坐标的指针
+ * @return 返回执行结果
+ * @since 8
+ * @version 1.0
+ */
+int32_t OH_NativeXComponent_GetXComponentOffset(
+    OH_NativeXComponent* component, const void* window, double* x, double* y);
+
+/**
+ * @brief 获取触摸事件的信息
+ *
+ * @param component 表示指向NativeXComponent实例的指针
+ * @param window 表示本机窗口处理程序
+ * @param touchInfo 表示指向当前触摸信息的指针
+ * @return 返回执行结果
+ * @since 8
+ * @version 1.0
+ */
+int32_t OH_NativeXComponent_GetTouchEvent(
+    OH_NativeXComponent* component, const void* window, OH_NativeXComponent_TouchEvent* touchEvent);
+
+/**
+ * @brief 设置xcomponent的回调
+ *
+ * @param component 表示指向NativeXComponent实例的指针
+ * @param callback 表示本机表面生命周期的回调
+ * @return 返回执行结果
+ * @since 8
+ * @version 1.0
+ */
+int32_t OH_NativeXComponent_RegisterCallback(OH_NativeXComponent* component, OH_NativeXComponent_Callback* callback);
+
+#ifdef __cplusplus
+};
+#endif
+#endif // _NATIVE_INTERFACE_XCOMPONENT_H_
\ No newline at end of file
-- 
Gitee