1# 注入事件开发指导
2
3## 场景介绍
4
5注入事件提供注入输入事件功能，比如注入鼠标点击事件、键盘组合键等。使用场景例如：当用户需要验证应用的组合键功能时，开发者可以通过注入组合键事件判断功能是否生效。
6
7## 导入模块
8
9```js
10import { inputEventClient } from '@kit.InputKit';
11```
12
13## 接口说明
14
15事件注入常用接口如下表所示，接口详细介绍请参考[ohos.multimodalInput.inputEventClient文档](../../reference/apis-input-kit/js-apis-inputeventclient-sys.md)。
16
17| 接口名称  | 描述 |
18| -------------------------------------------- | -------------------------- |
19| injectEvent({KeyEvent: KeyEvent}): void |按键(包括单个按键和组合键)注入。 |
20| injectMouseEvent(mouseEvent: MouseEventData): void |鼠标/触摸板事件注入。 |
21| injectTouchEvent(touchEvent: TouchEventData): void |触摸屏事件注入。|
22
23## 开发步骤
24
25应用调用Home键返回桌面，调用[injectEvent](../../reference/apis-input-kit/js-apis-inputeventclient-sys.md#inputeventclientinjectevent)注入Home按键，查看应用中Home按键功能是否生效。
26
27```js
28try {
29  let backKeyDown: inputEventClient.KeyEvent = {
30    isPressed: true,
31    keyCode: 2,
32    keyDownDuration: 0,
33    isIntercepted: false
34  }//Home按键按下事件
35
36  class EventDown {
37    KeyEvent: inputEventClient.KeyEvent | null = null
38  }
39
40  let eventDown: EventDown = { KeyEvent: backKeyDown }
41  inputEventClient.injectEvent(eventDown);//注入Home按键按下事件
42
43  let backKeyUp: inputEventClient.KeyEvent = {
44    isPressed: false,
45    keyCode: 2,
46    keyDownDuration: 0,
47    isIntercepted: false
48  };//Home按键抬起事件
49
50  class EventUp {
51    KeyEvent: inputEventClient.KeyEvent | null = null
52  }
53
54  let eventUp: EventUp = { KeyEvent: backKeyUp }
55  inputEventClient.injectEvent(eventUp);//注入Home按键抬起事件,查看Home键功能是否生效，应用是否返回桌面
56} catch (error) {
57  console.log(`Failed to inject KeyEvent, error: ${JSON.stringify(error, [`code`, `message`])}`);
58}
59```
60
61