!20875 XComponent开发指导文档补充接口内容的使用方法

Merge pull request !20875 from WangJiazhen/master

zh-cn/application-dev/napi/xcomponent-guidelines.md

@@ -321,6 +321,94 @@ XComponent({ id: 'xcomponentId1', type: 'surface', libraryname: 'nativerender' }
    		render->OnKeyEvent(component, window);
    	}
    }
+   
+   // 定义一个OnSurfaceChanged()方法
+   void PluginRender::OnSurfaceChanged(OH_NativeXComponent* component, void* window)
+   {
+   	// ...
+       std::string id(idStr);
+       PluginRender* render = PluginRender::GetInstance(id);
+       double offsetX;
+       double offsetY;
+       // 获取XComponent持有的surface相对窗口左上角的偏移量
+       OH_NativeXComponent_GetXComponentOffset(component, window, &offsetX, &offsetY);
+       OH_LOG_Print(LOG_APP, LOG_INFO, LOG_PRINT_DOMAIN, "OH_NativeXComponent_GetXComponentOffset",
+           "offsetX = %{public}lf, offsetY = %{public}lf", offsetX, offsetY);
+       uint64_t width;
+       uint64_t height;
+       OH_NativeXComponent_GetXComponentSize(component, window, &width, &height);
+       if (render != nullptr) {
+           render->eglCore_->UpdateSize(width, height);
+       }
+   }
+   
+   // 定义一个OnTouchEvent()方法
+   void PluginRender::OnTouchEvent(OH_NativeXComponent* component, void* window)
+   {
+       // ...
+       OH_NativeXComponent_TouchEvent touchEvent;
+       // 获取由XComponent触发的触摸事件
+       OH_NativeXComponent_GetTouchEvent(component, window, &touchEvent);
+       std::string id(idStr);
+       PluginRender* render = PluginRender::GetInstance(id);
+       if (render != nullptr && touchEvent.type == OH_NativeXComponent_TouchEventType::OH_NATIVEXCOMPONENT_UP) {
+           render->eglCore_->ChangeColor();
+           hasChangeColor_ = 1;
+       }
+       float tiltX = 0.0f;
+       float tiltY = 0.0f;
+       OH_NativeXComponent_TouchPointToolType toolType =
+           OH_NativeXComponent_TouchPointToolType::OH_NATIVEXCOMPONENT_TOOL_TYPE_UNKNOWN;
+       // 获取XComponent触摸点的工具类型
+       OH_NativeXComponent_GetTouchPointToolType(component, 0, &toolType);
+       // 获取XComponent触摸点处相对X轴的倾斜角度
+       OH_NativeXComponent_GetTouchPointTiltX(component, 0, &tiltX);
+       // 获取XComponent触摸点处相对Y轴的倾斜角度
+       OH_NativeXComponent_GetTouchPointTiltY(component, 0, &tiltY);
+       OH_LOG_Print(LOG_APP, LOG_INFO, LOG_PRINT_DOMAIN, "OnTouchEvent",
+           "touch info: toolType = %{public}d, tiltX = %{public}lf, tiltY = %{public}lf", toolType, tiltX, tiltY);
+   }
+   
+   // 定义一个OnMouseEvent()方法
+   void PluginRender::OnMouseEvent(OH_NativeXComponent *component, void *window) {
+      OH_LOG_Print(LOG_APP, LOG_INFO, LOG_PRINT_DOMAIN, "PluginRender", "OnMouseEvent");
+      OH_NativeXComponent_MouseEvent mouseEvent;
+      // 获取由XComponent触发的鼠标事件
+      int32_t ret = OH_NativeXComponent_GetMouseEvent(component, window, &mouseEvent);
+      if (ret == OH_NATIVEXCOMPONENT_RESULT_SUCCESS) {
+   	   OH_LOG_Print(LOG_APP, LOG_INFO, LOG_PRINT_DOMAIN, "PluginRender", "MouseEvent Info: x = %{public}f, y = %{public}f, action = %{public}d, button = %{public}d", mouseEvent.x, mouseEvent.y, mouseEvent.action, mouseEvent.button);
+      } else {
+   	   OH_LOG_Print(LOG_APP, LOG_ERROR, LOG_PRINT_DOMAIN, "PluginRender", "GetMouseEvent error");
+      }
+   }
+   
+   // 定义一个OnMouseEvent()方法
+   void PluginRender::OnKeyEvent(OH_NativeXComponent *component, void *window) {
+      OH_LOG_Print(LOG_APP, LOG_INFO, LOG_PRINT_DOMAIN, "PluginRender", "OnKeyEvent");
+   
+      OH_NativeXComponent_KeyEvent *keyEvent = nullptr;
+      // 获取由XComponent触发的按键事件。
+      if (OH_NativeXComponent_GetKeyEvent(component, &keyEvent) >= 0) {
+   	   OH_NativeXComponent_KeyAction action;
+          // 获取按键事件的动作
+   	   OH_NativeXComponent_GetKeyEventAction(keyEvent, &action);
+   	   OH_NativeXComponent_KeyCode code;
+          // 获取按键事件的键码值
+   	   OH_NativeXComponent_GetKeyEventCode(keyEvent, &code);
+   	   OH_NativeXComponent_EventSourceType sourceType;
+          // 获取按键事件的输入源类型
+   	   OH_NativeXComponent_GetKeyEventSourceType(keyEvent, &sourceType);
+   	   int64_t deviceId;
+          // 获取按键事件的设备ID
+   	   OH_NativeXComponent_GetKeyEventDeviceId(keyEvent, &deviceId);
+   	   int64_t timeStamp;
+          // 获取按键事件的时间戳
+   	   OH_NativeXComponent_GetKeyEventTimestamp(keyEvent, &timeStamp);
+   	   OH_LOG_Print(LOG_APP, LOG_INFO, LOG_PRINT_DOMAIN, "PluginRender", "KeyEvent Info: action=%{public}d, code=%{public}d, sourceType=%{public}d, deviceId=%{public}ld, timeStamp=%{public}ld", action, code, sourceType, deviceId, timeStamp);
+      } else {
+   	   OH_LOG_Print(LOG_APP, LOG_ERROR, LOG_PRINT_DOMAIN, "PluginRender", "GetKeyEvent error");
+      }
+   }
    ```
 
    (2) 注册XComponent事件回调函数，在XComponent事件触发时调用3.1步骤中定义的方法。