• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1CommonEvent开发指南
2
3#### 基本概念
4
5OpenHarmony通过CES(Common Event Service,公共事件服务)为应用程序提供订阅、发布、退订公共事件的能力。
6
7公共事件可分为系统公共事件和自定义公共事件。
8
9- 系统公共事件:系统将收集到的事件信息,根据系统策略发送给订阅该事件的用户程序。 例如:系统关键服务发布的系统事件(例如:hap安装,更新,卸载等)。
10
11- 自定义公共事件:应用自定义一些公共事件用来实现跨应用的事件通信能力。
12
13每个应用都可以按需订阅公共事件,订阅成功且公共事件发布,系统会把其发送给应用。这些公共事件可能来自系统、其他应用和应用自身。
14
15
16
17#### 接口列表
18
19| API                                                          | 手机 | 平板 | 智慧屏 | 智能穿戴 | 轻量级智能穿戴 |
20| ------------------------------------------------------------ | ---- | ---- | ------ | -------- | -------------- |
21| CommonEvent.publish(event: string, callback: AsyncCallback<void>) | 支持 | 支持 | 支持   | 支持     | 不支持         |
22| CommonEvent.publish(event: string, options: CommonEventPublishData, callback: AsyncCallback<void>) | 支持 | 支持 | 支持   | 支持     | 不支持         |
23| CommonEvent.createSubscriber(subscribeInfo: CommonEventSubscribeInfo, callback: AsyncCallback<CommonEventSubscriber>) | 支持 | 支持 | 支持   | 支持     | 不支持         |
24| CommonEvent.createSubscriber(subscribeInfo: CommonEventSubscribeInfo) | 支持 | 支持 | 支持   | 支持     | 不支持         |
25| CommonEvent.subscribe(subscriber: CommonEventSubscriber, callback: AsyncCallback<CommonEventData>) | 支持 | 支持 | 支持   | 支持     | 不支持         |
26| CommonEvent.unsubscribe(subscriber: CommonEventSubscriber, callback?: AsyncCallback<void>) | 支持 | 支持 | 支持   | 支持     | 不支持         |
27
28
29
30#### 导入模块
31
32```js
33import CommonEvent from '@ohos.commonevent';
34```
35
36
37
38#### 创建公共事件订阅者
39
40根据开发者设定的公共事件订阅相关信息(比如准备订阅的公共事件集等)创建公共事件订阅者对象。
41
42- CommonEventSubscribeInfo类型说明
43
44  CommonEventSubscribeInfo封装公共事件订阅相关信息,比如准备订阅的公共事件集、发布者必须具备的权限、发布者的设备ID、发布者的用户ID、优先级等。
45
46  | 名称                | 读写属性 | 类型          | 必填 | 描述                                                         |
47  | ------------------- | -------- | ------------- | ---- | ------------------------------------------------------------ |
48  | events              | 只读     | Array<string> | 是   | 表示要订阅的公共事件集。                                     |
49  | publisherPermission | 只读     | string        | 否   | 表示发布者的权限。                                           |
50  | publisherDeviceId   | 只读     | int           | 否   | 表示发布者的设备ID,该值必须是同一ohos网络上的现有设备ID。   |
51  | userId              | 只读     | int           | 否   | 表示发布者的用户ID。默认值当前用户的ID。如果指定了此参数,则该值必须是系统中现有的用户ID。 |
52  | priority            | 只读     | int           | 否   | 表示订阅者的优先级,范围为-100~1000,用于有序公共事件。      |
53
54- CommonEventSubscriber 类说明
55
56  CommonEventSubscriber封装公共事件订阅者及相关参数,主要接口如下。
57
58  | 名称                  | 参数                                                      | 返回值                            | 描述                                                         |
59  | --------------------- | --------------------------------------------------------- | --------------------------------- | ------------------------------------------------------------ |
60  | getCode               | callback: AsyncCallback<number>                           | void                              | 获取公共事件的结果代码(callback形式)                       |
61  | getCode               | void                                                      | Promise<number>                   | 获取公共事件的结果代码(Promise形式)                        |
62  | setCode               | code: number, callback: AsyncCallback<void>               | void                              | 设置有序公共事件的结果代码(callback形式)                   |
63  | setCode               | code: number                                              | Promise<void>                     | 设置有序公共事件的结果代码(Promise形式)                    |
64  | getData               | callback: AsyncCallback<string>                           | void                              | 获取公共事件的结果数据(callback形式)                       |
65  | getData               | void                                                      | Promise<string>                   | 获取公共事件的结果数据(Promise形式)                        |
66  | setData               | data: string, callback: AsyncCallback<void>               | void                              | 设置有序公共事件的结果数据(callback形式)                   |
67  | setData               | data: string                                              | Promise<void>                     | 设置有序公共事件的结果数据(Promise形式)                    |
68  | setCodeAndData        | code: number, data: string, callback: AsyncCallback<void> | void                              | 设置有序公共事件的结果代码和结果数据(callback形式)         |
69  | setCodeAndData        | code: number, data: string                                | Promise<void>                     | 设置有序公共事件的结果代码和结果数据(Promise形式)          |
70  | isOrderedCommonEvent  | callback: AsyncCallback<boolean>                          | void                              | 查询当前公共事件的是否为有序公共事件,返回true代表是有序公共事件,false代表不是有序公共事件(callback形式) |
71  | isOrderedCommonEvent  | void                                                      | Promise<bool>                     | 查询当前公共事件的是否为有序公共事件,返回true代表是有序公共事件,false代表不是有序公共事件(Promise形式) |
72  | abortCommonEvent      | callback: AsyncCallback<void>                             | void                              | 取消当前的公共事件,仅对有序公共事件有效,取消后,公共事件不再向下一个订阅者传递(callback形式) |
73  | abortCommonEvent      | void                                                      | Promise<void>                     | 取消当前的公共事件,仅对有序公共事件有效,取消后,公共事件不再向下一个订阅者传递(Promise形式) |
74  | clearAbortCommonEvent | callback: AsyncCallback<void>                             | void                              | 清除当前有序公共事件abort状态(callback形式)                |
75  | clearAbortCommonEvent | void                                                      | Promise<void>                     | 清除当前有序公共事件abort状态(Promise形式)                 |
76  | getAbortCommonEvent   | callback: AsyncCallback<boolean>                          | void                              | 获取当前有序公共事件是否取消的状态(callback形式)           |
77  | getAbortCommonEvent   | void                                                      | Promise<boolean>                  | 获取当前有序公共事件是否取消的状态Promise形式)              |
78  | getSubscribeInfo      | callback: AsyncCallback<CommonEventSubscribeInfo>         | void                              | 获取订阅者的订阅信息(callback形式)                         |
79  | getSubscribeInfo      | void                                                      | Promise<CommonEventSubscribeInfo> | 获取订阅者的订阅信息(Promise形式)                          |
80
81
82
83- 创建订阅者接口(callback形式)
84
85  CommonEvent.createSubscriber(subscribeInfo: CommonEventSubscribeInfo, callback: AsyncCallback<CommonEventSubscriber>)
86
87  - 接口参数描述
88
89
90  | 名称          | 读写属性 | 类型                                 | 必填 | 描述                     |
91  | ------------- | -------- | ------------------------------------ | ---- | ------------------------ |
92  | subscribeInfo | 只读     | CommonEventSubscribeInfo             | 是   | 表示公共事件订阅信息     |
93  | callback      | 只读     | AsyncCallback<CommonEventSubscriber> | 是   | 表示创建订阅者的回调方法 |
94
95  - 返回值
96
97    void
98
99  - 示例代码
100
101  ```js
102  var subscriber; //用于保存创建成功的订阅者对象,后续使用其完成订阅及退订的动作
103  //订阅者信息
104  var subscribeInfo = {
105  	events: ["event"]
106  };
107  //创建订阅者回调
108  function CreateSubscriberCallBack(err, data) {
109      console.info("==========================>CreateSubscriberCallBack=======================>");
110      subscriber = data;
111  }
112  //创建订阅者
113  CommonEvent.createSubscriber(subscribeInfo, CreateSubscriberCallBack);
114  ```
115
116- 创建订阅者接口(Promise形式)
117
118  CommonEvent.createSubscriber(subscribeInfo: CommonEventSubscribeInfo)
119
120  - 接口参数描述
121
122  | 名称          | 读写属性 | 类型                     | 必填 | 描述         |
123  | ------------- | -------- | ------------------------ | ---- | ------------ |
124  | subscribeInfo | 只读     | CommonEventSubscribeInfo | 是   | 表示订阅信息 |
125
126  - 返回值
127
128    Promise<CommonEventSubscriber>
129
130  - 示例代码
131
132  ```js
133  var subscriber; //用于保存创建成功的订阅者对象,后续使用其完成订阅及退订的动作
134  //订阅者信息
135  var subscribeInfo = {
136  	events: ["event"]
137  };
138  //创建订阅者
139  CommonEvent.createSubscriber(subscribeInfo).then((data) => {
140		console.info("==========================>createSubscriberPromise=======================>");
141      subscriber = data;
142  });
143  ```
144
145
146
147#### 订阅公共事件
148
149订阅公共事件,并指定公共事件订阅者对象和接收公共事件的回调函数。
150
151- CommonEventData类型说明
152
153  CommonEventData封装公共事件相关信息。用于在接收时处理数据。
154
155  | 名称       | 读写属性 | 类型                 | 必填 | 描述                                                    |
156  | ---------- | -------- | -------------------- | ---- | ------------------------------------------------------- |
157  | event      | 只读     | string               | 是   | 表示当前接收的公共事件名称                              |
158  | bundleName | 只读     | string               | 否   | 表示包名称                                              |
159  | code       | 只读     | int                  | 否   | 表示公共事件的结果代码,用于传递int类型的数据           |
160  | data       | 只读     | string               | 否   | 表示公共事件的自定义结果数据,用于传递string 类型的数据 |
161  | parameters | 只读     | {[key: string]: any} | 否   | 表示公共事件的附加信息                                  |
162
163- 订阅公共事件接口(callback形式)
164
165  CommonEvent.subscribe(subscriber: CommonEventSubscriber, callback: AsyncCallback<CommonEventData>)
166
167  - 接口参数描述
168
169  | 名称       | 读写属性 | 类型                           | 必填 | 描述                           |
170  | ---------- | -------- | ------------------------------ | ---- | ------------------------------ |
171  | subscriber | 只读     | CommonEventSubscriber          | 是   | 表示订阅者对象                 |
172  | callback   | 只读     | AsyncCallback<CommonEventData> | 是   | 表示接收公共事件数据的回调函数 |
173
174  - 返回值
175
176    void
177
178  - 示例代码
179
180    **无序事件:**
181
182    ```js
183    var subscriber; //用于保存创建成功的订阅者对象,后续使用其完成订阅及退订的动作
184    //订阅者信息
185    var subscribeInfo = {
186    	events: ["event"]
187    };
188    //订阅公共事件回调
189    function SubscribeCallBack(err, data) {
190        console.info("==========================>SubscribeCallBack=======================>");
191    }
192    //创建订阅者回调
193    function CreateSubscriberCallBack(err, data) {
194    	console.info("==========================>CreateSubscriberCallBack=======================>");
195    	subscriber = data;
196    	//订阅公共事件
197    	CommonEvent.subscribe(subscriber, SubscribeCallBack);
198    }
199    //创建订阅者
200    CommonEvent.createSubscriber(subscribeInfo, CreateSubscriberCallBack);
201    ```
202
203    **有序事件:**
204
205    ```js
206    var subscriber; //用于保存创建成功的订阅者对象,后续使用其完成订阅及退订的动作
207    //订阅者信息
208    var subscribeInfo = {
209    	events: ["event"]
210    };
211
212    //设置有序公共事件的结果代码回调
213    function SetCodeCallBack(err) {
214        console.info("==========================>SetCodeCallBack=======================>");
215    }
216    //设置有序公共事件的结果数据回调
217    function SetDataCallBack(err) {
218        console.info("==========================>SetDataCallBack=======================>");
219    }
220    //完成本次有序公共事件处理回调
221    function FinishCommonEventCallBack(err) {
222    	console.info("==========================>FinishCommonEventCallBack=======================>");
223    }
224    //订阅公共事件回调
225    function SubscribeCallBack(err, data) {
226        console.info("==========================>SubscribeCallBack=======================>");
227        //设置有序公共事件的结果代码
228        subscriber.setCode(0, SetCodeCallBack);
229        //设置有序公共事件的结果数据
230        subscriber.setData("publish_data_changed", SetDataCallBack);
231        //完成本次有序公共事件处理
232        subscriber.finishCommonEvent(FinishCommonEventCallBack)
233    }
234
235    //创建订阅者回调
236    function CreateSubscriberCallBack(err, data) {
237    	console.info("==========================>CreateSubscriberCallBack=======================>");
238    	subscriber = data;
239        //订阅公共事件
240    	CommonEvent.subscribe(subscriber, SubscribeCallBack);
241    }
242
243    //创建订阅者
244    CommonEvent.createSubscriber(subscribeInfo, CreateSubscriberCallBack);
245    ```
246
247
248
249#### 发布公共事件
250
251发布指定事件名称的公共事件,并可携带事件相关数据、属性、限制等信息。
252
253- CommonEventPublishData类型说明
254
255  CommonEventPublishData封装公共事件发布相关数据、属性及限制等信息,包括公共事件类型(有序或无序)、订阅者所需权限等。
256
257  | 名称                  | 读写属性 | 类型                 | 必填 | 描述                         |
258  | --------------------- | -------- | -------------------- | ---- | ---------------------------- |
259  | bundleName            | 只读     | string               | 否   | 表示包名称                   |
260  | code                  | 只读     | int                  | 否   | 表示公共事件的结果代码       |
261  | data                  | 只读     | string               | 否   | 表示公共事件的自定义结果数据 |
262  | subscriberPermissions | 只读     | Array<string>        | 否   | 表示订阅者所需的权限         |
263  | isOrdered             | 只读     | bool                 | 否   | 表示是否是有序事件           |
264  | parameters            | 只读     | {[key: string]: any} | 否   | 表示公共事件的附加信息       |
265
266- 发布公共事件接口(callback形式)
267
268  CommonEvent.publish(event: string, callback: AsyncCallback<void>)
269
270  - 接口参数描述
271
272  | 名称     | 读写属性 | 类型                | 必填 | 描述                     |
273  | -------- | -------- | ------------------- | ---- | ------------------------ |
274  | event    | 只读     | string              | 是   | 表示要发送的公共事件名称 |
275  | callback | 只读     | AsyncCallback<void> | 是   | 表示被指定的回调方法     |
276
277  - 返回值
278
279    void
280
281  - 示例代码
282
283  ```js
284  //发布公共事件回调
285  function PublishCallBack(err) {
286  	console.info("==========================>PublishCallBack=======================>");
287      console.info("==========================>err:=======================>", err.code);
288  }
289  //发布公共事件
290  CommonEvent.publish("publish_event", PublishCallBack);
291  ```
292
293- 发布公共事件指定发布信息接口(callback形式)
294
295  CommonEvent.publish(event: string, options: CommonEventPublishData, callback: AsyncCallback<void>)
296
297  - 接口参数描述
298
299  | 名称     | 读写属性 | 类型                   | 必填 | 描述                     |
300  | -------- | -------- | ---------------------- | ---- | ------------------------ |
301  | event    | 只读     | string                 | 是   | 表示要发布的公共事件名称 |
302  | options  | 只读     | CommonEventPublishData | 是   | 表示发布公共事件的属性   |
303  | callback | 只读     | AsyncCallback<void>    | 是   | 表示被指定的回调方法     |
304
305  - 返回值
306
307    void
308
309  - 示例代码
310
311  ```js
312  //公共事件相关信息
313  var options = {
314    	code: 0;				//公共事件的初始代码
315    	data: "initial data";	//公共事件的初始数据
316    	isOrdered: true;		//有序公共事件
317  }
318  //发布公共事件回调
319  function PublishCallBack(err) {
320    	console.info("==========================>PublishCallBack=======================>");
321  }
322  //发布公共事件
323  CommonEvent.publish("publish_event", options, PublishCallBack);
324  ```
325
326
327
328
329#### 取消订阅公共事件
330
331- 取消订阅公共事件接口(callback形式)
332
333  CommonEvent.unsubscribe(subscriber: CommonEventSubscriber, callback?: AsyncCallback<void>)
334
335  - 接口参数描述
336
337  | 名称       | 读写属性 | 类型                  | 必填 | 描述                   |
338  | ---------- | -------- | --------------------- | ---- | ---------------------- |
339  | subscriber | 只读     | CommonEventSubscriber | 是   | 表示订阅者对象         |
340  | callback   | 只读     | AsyncCallback<void>   | 是   | 表示取消订阅的回调方法 |
341
342  - 返回值
343
344    void
345
346  - 示例代码
347
348  ```js
349  var subscriber;	//用于保存创建成功的订阅者对象,后续使用其完成订阅及退订的动作
350  //订阅者信息
351  var subscribeInfo = {
352  	events: ["event"]
353  };
354  //订阅公共事件回调
355  function SubscribeCallBack(err, data) {
356  	console.info("==========================>SubscribeCallBack=======================>");
357  }
358  //创建订阅者回调
359  function CreateSubscriberCallBack(err, data) {
360  	console.info("==========================>CreateSubscriberCallBack=======================>");
361  	subscriber = data;
362  	//订阅公共事件
363  	CommonEvent.subscribe(subscriber, SubscribeCallBack);
364  }
365  //取消订阅公共事件回调
366  function UnsubscribeCallBack(err) {
367  	console.info("==========================>UnsubscribeCallBack=======================>");
368  }
369  //创建订阅者
370  CommonEvent.createSubscriber(subscribeInfo, CreateSubscriberCallBack);
371  //取消订阅公共事件
372  CommonEvent.unsubscribe(subscriber, UnsubscribeCallBack);
373  ```
374
375
376
377
378#### 系统公共事件列表
379
380| 系统公共事件宏                                               | 系统公共事件名称                                            | 订阅者所需权限                                               |
381| ------------------------------------------------------------ | ----------------------------------------------------------- | ------------------------------------------------------------ |
382| COMMON_EVENT_BOOT_COMPLETED                                  | usual.event.BOOT_COMPLETED                                  | ohos.permission.RECEIVER_STARTUP_COMPLETED                   |
383| COMMON_EVENT_LOCKED_BOOT_COMPLETED                           | usual.event.LOCKED_BOOT_COMPLETED                           | ohos.permission.RECEIVER_STARTUP_COMPLETED                   |
384| COMMON_EVENT_SHUTDOWN                                        | usual.event.SHUTDOWN                                        | 无                                                           |
385| COMMON_EVENT_BATTERY_CHANGED                                 | usual.event.BATTERY_CHANGED                                 | 无                                                           |
386| COMMON_EVENT_BATTERY_LOW                                     | usual.event.BATTERY_LOW                                     | 无                                                           |
387| COMMON_EVENT_BATTERY_OKAY                                    | usual.event.BATTERY_OKAY                                    | 无                                                           |
388| COMMON_EVENT_POWER_CONNECTED                                 | usual.event.POWER_CONNECTED                                 | 无                                                           |
389| COMMON_EVENT_POWER_DISCONNECTED                              | usual.event.POWER_DISCONNECTED                              | 无                                                           |
390| COMMON_EVENT_SCREEN_OFF                                      | usual.event.SCREEN_OFF                                      | 无                                                           |
391| COMMON_EVENT_SCREEN_ON                                       | usual.event.SCREEN_ON                                       | 无                                                           |
392| COMMON_EVENT_USER_PRESENT                                    | usual.event.USER_PRESENT                                    | 无                                                           |
393| COMMON_EVENT_TIME_TICK                                       | usual.event.TIME_TICK                                       | 无                                                           |
394| COMMON_EVENT_TIME_CHANGED                                    | usual.event.TIME_CHANGED                                    | 无                                                           |
395| COMMON_EVENT_DATE_CHANGED                                    | usual.event.DATE_CHANGED                                    | 无                                                           |
396| COMMON_EVENT_TIMEZONE_CHANGED                                | usual.event.TIMEZONE_CHANGED                                | 无                                                           |
397| COMMON_EVENT_CLOSE_SYSTEM_DIALOGS                            | usual.event.CLOSE_SYSTEM_DIALOGS                            | 无                                                           |
398| COMMON_EVENT_PACKAGE_ADDED                                   | usual.event.PACKAGE_ADDED                                   | 无                                                           |
399| COMMON_EVENT_PACKAGE_REPLACED                                | usual.event.PACKAGE_REPLACED                                | 无                                                           |
400| COMMON_EVENT_MY_PACKAGE_REPLACED                             | usual.event.MY_PACKAGE_REPLACED                             | 无                                                           |
401| COMMON_EVENT_PACKAGE_REMOVED                                 | usual.event.PACKAGE_REMOVED                                 | 无                                                           |
402| COMMON_EVENT_PACKAGE_FULLY_REMOVED                           | usual.event.PACKAGE_FULLY_REMOVED                           | 无                                                           |
403| COMMON_EVENT_PACKAGE_CHANGED                                 | usual.event.PACKAGE_CHANGED                                 | 无                                                           |
404| COMMON_EVENT_PACKAGE_RESTARTED                               | usual.event.PACKAGE_RESTARTED                               | 无                                                           |
405| COMMON_EVENT_PACKAGE_DATA_CLEARED                            | usual.event.PACKAGE_DATA_CLEARED                            | 无                                                           |
406| COMMON_EVENT_PACKAGES_SUSPENDED                              | usual.event.PACKAGES_SUSPENDED                              | 无                                                           |
407| COMMON_EVENT_PACKAGES_UNSUSPENDED                            | usual.event.PACKAGES_UNSUSPENDED                            | 无                                                           |
408| COMMON_EVENT_MY_PACKAGE_SUSPENDED                            | usual.event.MY_PACKAGE_SUSPENDED                            | 无                                                           |
409| COMMON_EVENT_MY_PACKAGE_UNSUSPENDED                          | usual.event.MY_PACKAGE_UNSUSPENDED                          | 无                                                           |
410| COMMON_EVENT_UID_REMOVED                                     | usual.event.UID_REMOVED                                     | 无                                                           |
411| COMMON_EVENT_PACKAGE_FIRST_LAUNCH                            | usual.event.PACKAGE_FIRST_LAUNCH                            | 无                                                           |
412| COMMON_EVENT_PACKAGE_NEEDS_VERIFICATION                      | usual.event.PACKAGE_NEEDS_VERIFICATION                      | 无                                                           |
413| COMMON_EVENT_PACKAGE_VERIFIED                                | usual.event.PACKAGE_VERIFIED                                | 无                                                           |
414| COMMON_EVENT_EXTERNAL_APPLICATIONS_AVAILABLE                 | usual.event.EXTERNAL_APPLICATIONS_AVAILABLE                 | 无                                                           |
415| COMMON_EVENT_EXTERNAL_APPLICATIONS_UNAVAILABLE               | usual.event.EXTERNAL_APPLICATIONS_UNAVAILABLE               | 无                                                           |
416| COMMON_EVENT_CONFIGURATION_CHANGED                           | usual.event.CONFIGURATION_CHANGED                           | 无                                                           |
417| COMMON_EVENT_LOCALE_CHANGED                                  | usual.event.LOCALE_CHANGED                                  | 无                                                           |
418| COMMON_EVENT_MANAGE_PACKAGE_STORAGE                          | usual.event.MANAGE_PACKAGE_STORAGE                          | 无                                                           |
419| COMMON_EVENT_DRIVE_MODE                                      | common.event.DRIVE_MODE                                     | 无                                                           |
420| COMMON_EVENT_HOME_MODE                                       | common.event.HOME_MODE                                      | 无                                                           |
421| COMMON_EVENT_OFFICE_MODE                                     | common.event.OFFICE_MODE                                    | 无                                                           |
422| COMMON_EVENT_USER_STARTED                                    | usual.event.USER_STARTED                                    | 无                                                           |
423| COMMON_EVENT_USER_BACKGROUND                                 | usual.event.USER_BACKGROUND                                 | 无                                                           |
424| COMMON_EVENT_USER_FOREGROUND                                 | usual.event.USER_FOREGROUND                                 | 无                                                           |
425| COMMON_EVENT_USER_SWITCHED                                   | usual.event.USER_SWITCHED                                   | ohos.permission.MANAGE_USERS                                 |
426| COMMON_EVENT_USER_STARTING                                   | usual.event.USER_STARTING                                   | ohos.permission.INTERACT_ACROSS_USERS                        |
427| COMMON_EVENT_USER_UNLOCKED                                   | usual.event.USER_UNLOCKED                                   | 无                                                           |
428| COMMON_EVENT_USER_STOPPING                                   | usual.event.USER_STOPPING                                   | ohos.permission.INTERACT_ACROSS_USERS                        |
429| COMMON_EVENT_USER_STOPPED                                    | usual.event.USER_STOPPED                                    | 无                                                           |
430| COMMON_EVENT_HWID_LOGIN                                      | common.event.HWID_LOGIN                                     | 无                                                           |
431| COMMON_EVENT_HWID_LOGOUT                                     | common.event.HWID_LOGOUT                                    | 无                                                           |
432| COMMON_EVENT_HWID_TOKEN_INVALID                              | common.event.HWID_TOKEN_INVALID                             | 无                                                           |
433| COMMON_EVENT_HWID_LOGOFF                                     | common.event.HWID_LOGOFF                                    | 无                                                           |
434| COMMON_EVENT_WIFI_POWER_STATE                                | usual.event.wifi.POWER_STATE                                | 无                                                           |
435| COMMON_EVENT_WIFI_SCAN_FINISHED                              | usual.event.wifi.SCAN_FINISHED                              | ohos.permission.LOCATION                                     |
436| COMMON_EVENT_WIFI_RSSI_VALUE                                 | usual.event.wifi.RSSI_VALUE                                 | ohos.permission.GET_WIFI_INFO                                |
437| COMMON_EVENT_WIFI_CONN_STATE                                 | usual.event.wifi.CONN_STATE                                 | 无                                                           |
438| COMMON_EVENT_WIFI_HOTSPOT_STATE                              | usual.event.wifi.HOTSPOT_STATE                              | 无                                                           |
439| COMMON_EVENT_WIFI_AP_STA_JOIN                                | usual.event.wifi.WIFI_HS_STA_JOIN                           | ohos.permission.GET_WIFI_INFO                                |
440| COMMON_EVENT_WIFI_AP_STA_LEAVE                               | usual.event.wifi.WIFI_HS_STA_LEAVE                          | ohos.permission.GET_WIFI_INFO                                |
441| COMMON_EVENT_WIFI_MPLINK_STATE_CHANGE                        | usual.event.wifi.mplink.STATE_CHANGE                        | ohos.permission.MPLINK_CHANGE_STATE                          |
442| COMMON_EVENT_WIFI_P2P_CONN_STATE                             | usual.event.wifi.p2p.CONN_STATE_CHANGE                      | ohos.permission.GET_WIFI_INFO and ohos.permission.LOCATION   |
443| COMMON_EVENT_WIFI_P2P_STATE_CHANGED                          | usual.event.wifi.p2p.STATE_CHANGE                           | ohos.permission.GET_WIFI_INFO                                |
444| COMMON_EVENT_WIFI_P2P_PEERS_STATE_CHANGED                    | usual.event.wifi.p2p.DEVICES_CHANGE                         | ohos.permission.GET_WIFI_INFO                                |
445| COMMON_EVENT_WIFI_P2P_PEERS_DISCOVERY_STATE_CHANGED          | usual.event.wifi.p2p.PEER_DISCOVERY_STATE_CHANGE            | ohos.permission.GET_WIFI_INFO                                |
446| COMMON_EVENT_WIFI_P2P_CURRENT_DEVICE_STATE_CHANGED           | usual.event.wifi.p2p.CURRENT_DEVICE_CHANGE                  | ohos.permission.GET_WIFI_INFO                                |
447| COMMON_EVENT_WIFI_P2P_GROUP_STATE_CHANGED                    | usual.event.wifi.p2p.GROUP_STATE_CHANGED                    | ohos.permission.GET_WIFI_INFO                                |
448| COMMON_EVENT_BLUETOOTH_HANDSFREE_AG_CONNECT_STATE_UPDATE     | usual.event.bluetooth.handsfree.ag.CONNECT_STATE_UPDATE     | ohos.permission.USE_BLUETOOTH                                |
449| COMMON_EVENT_BLUETOOTH_HANDSFREE_AG_CURRENT_DEVICE_UPDATE    | usual.event.bluetooth.handsfree.ag.CURRENT_DEVICE_UPDATE    | ohos.permission.USE_BLUETOOTH                                |
450| COMMON_EVENT_BLUETOOTH_HANDSFREE_AG_AUDIO_STATE_UPDATE       | usual.event.bluetooth.handsfree.ag.AUDIO_STATE_UPDATE       | ohos.permission.USE_BLUETOOTH                                |
451| COMMON_EVENT_BLUETOOTH_A2DPSOURCE_CONNECT_STATE_UPDATE       | usual.event.bluetooth.a2dpsource.CONNECT_STATE_UPDATE       | ohos.permission.USE_BLUETOOTH                                |
452| COMMON_EVENT_BLUETOOTH_A2DPSOURCE_CURRENT_DEVICE_UPDATE      | usual.event.bluetooth.a2dpsource.CURRENT_DEVICE_UPDATE      | ohos.permission.USE_BLUETOOTH                                |
453| COMMON_EVENT_BLUETOOTH_A2DPSOURCE_PLAYING_STATE_UPDATE       | usual.event.bluetooth.a2dpsource.PLAYING_STATE_UPDATE"      | ohos.permission.USE_BLUETOOTH                                |
454| COMMON_EVENT_BLUETOOTH_A2DPSOURCE_AVRCP_CONNECT_STATE_UPDATE | usual.event.bluetooth.a2dpsource.AVRCP_CONNECT_STATE_UPDATE | ohos.permission.USE_BLUETOOTH                                |
455| COMMON_EVENT_BLUETOOTH_A2DPSOURCE_CODEC_VALUE_UPDATE         | usual.event.bluetooth.a2dpsource.CODEC_VALUE_UPDATE         | ohos.permission.USE_BLUETOOTH                                |
456| COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_DISCOVERED               | usual.event.bluetooth.remotedevice.DISCOVERED               | ohos.permission.USE_BLUETOOTH and ohos.permission.LOCATION   |
457| COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_CLASS_VALUE_UPDATE       | usual.event.bluetooth.remotedevice.CLASS_VALUE_UPDATE       | ohos.permission.USE_BLUETOOTH                                |
458| COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_ACL_CONNECTED            | usual.event.bluetooth.remotedevice.ACL_CONNECTED            | ohos.permission.USE_BLUETOOTH                                |
459| COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_ACL_DISCONNECTED         | usual.event.bluetooth.remotedevice.ACL_DISCONNECTED         | ohos.permission.USE_BLUETOOTH                                |
460| COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_NAME_UPDATE              | usual.event.bluetooth.remotedevice.NAME_UPDATE              | ohos.permission.USE_BLUETOOTH                                |
461| COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_PAIR_STATE               | usual.event.bluetooth.remotedevice.PAIR_STATE               | ohos.permission.USE_BLUETOOTH                                |
462| COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_BATTERY_VALUE_UPDATE     | usual.event.bluetooth.remotedevice.BATTERY_VALUE_UPDATE     | ohos.permission.USE_BLUETOOTH                                |
463| COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_SDP_RESULT               | usual.event.bluetooth.remotedevice.SDP_RESULT               | 无                                                           |
464| COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_UUID_VALUE               | usual.event.bluetooth.remotedevice.UUID_VALUE               | ohos.permission.DISCOVER_BLUETOOTH                           |
465| COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_PAIRING_REQ              | usual.event.bluetooth.remotedevice.PAIRING_REQ              | ohos.permission.DISCOVER_BLUETOOTH                           |
466| COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_PAIRING_CANCEL           | usual.event.bluetooth.remotedevice.PAIRING_CANCEL           | 无                                                           |
467| COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_CONNECT_REQ              | usual.event.bluetooth.remotedevice.CONNECT_REQ              | 无                                                           |
468| COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_CONNECT_REPLY            | usual.event.bluetooth.remotedevice.CONNECT_REPLY            | 无                                                           |
469| COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_CONNECT_CANCEL           | usual.event.bluetooth.remotedevice.CONNECT_CANCEL           | 无                                                           |
470| COMMON_EVENT_BLUETOOTH_HANDSFREEUNIT_CONNECT_STATE_UPDATE    | usual.event.bluetooth.handsfreeunit.CONNECT_STATE_UPDATE    | 无                                                           |
471| COMMON_EVENT_BLUETOOTH_HANDSFREEUNIT_AUDIO_STATE_UPDATE      | usual.event.bluetooth.handsfreeunit.AUDIO_STATE_UPDATE      | 无                                                           |
472| COMMON_EVENT_BLUETOOTH_HANDSFREEUNIT_AG_COMMON_EVENT         | usual.event.bluetooth.handsfreeunit.AG_COMMON_EVENT         | 无                                                           |
473| COMMON_EVENT_BLUETOOTH_HANDSFREEUNIT_AG_CALL_STATE_UPDATE    | usual.event.bluetooth.handsfreeunit.AG_CALL_STATE_UPDATE    | 无                                                           |
474| COMMON_EVENT_BLUETOOTH_HOST_STATE_UPDATE                     | usual.event.bluetooth.host.STATE_UPDATE                     | 无                                                           |
475| COMMON_EVENT_BLUETOOTH_HOST_REQ_DISCOVERABLE                 | usual.event.bluetooth.host.REQ_DISCOVERABLE                 | 无                                                           |
476| COMMON_EVENT_BLUETOOTH_HOST_REQ_ENABLE                       | usual.event.bluetooth.host.REQ_ENABLE                       | ohos.permission.USE_BLUETOOTH                                |
477| COMMON_EVENT_BLUETOOTH_HOST_REQ_DISABLE                      | usual.event.bluetooth.host.REQ_DISABLE                      | ohos.permission.USE_BLUETOOTH                                |
478| COMMON_EVENT_BLUETOOTH_HOST_SCAN_MODE_UPDATE                 | usual.event.bluetooth.host.SCAN_MODE_UPDATE                 | ohos.permission.USE_BLUETOOTH                                |
479| COMMON_EVENT_BLUETOOTH_HOST_DISCOVERY_STARTED                | usual.event.bluetooth.host.DISCOVERY_STARTED                | ohos.permission.USE_BLUETOOTH                                |
480| COMMON_EVENT_BLUETOOTH_HOST_DISCOVERY_FINISHED               | usual.event.bluetooth.host.DISCOVERY_FINISHED               | ohos.permission.USE_BLUETOOTH                                |
481| COMMON_EVENT_BLUETOOTH_HOST_NAME_UPDATE                      | usual.event.bluetooth.host.NAME_UPDATE                      | ohos.permission.USE_BLUETOOTH                                |
482| COMMON_EVENT_BLUETOOTH_A2DPSINK_CONNECT_STATE_UPDATE         | usual.event.bluetooth.a2dpsink.CONNECT_STATE_UPDATE         | ohos.permission.USE_BLUETOOTH                                |
483| COMMON_EVENT_BLUETOOTH_A2DPSINK_PLAYING_STATE_UPDATE         | usual.event.bluetooth.a2dpsink.PLAYING_STATE_UPDATE         | ohos.permission.USE_BLUETOOTH                                |
484| COMMON_EVENT_BLUETOOTH_A2DPSINK_AUDIO_STATE_UPDATE           | usual.event.bluetooth.a2dpsink.AUDIO_STATE_UPDATE           | ohos.permission.USE_BLUETOOTH                                |
485| COMMON_EVENT_NFC_ACTION_ADAPTER_STATE_CHANGED                | usual.event.nfc.action.ADAPTER_STATE_CHANGED                | 无                                                           |
486| COMMON_EVENT_NFC_ACTION_RF_FIELD_ON_DETECTED                 | usual.event.nfc.action.RF_FIELD_ON_DETECTED                 | ohos.permission.MANAGE_SECURE_SETTINGS                       |
487| COMMON_EVENT_NFC_ACTION_RF_FIELD_OFF_DETECTED                | usual.event.nfc.action.RF_FIELD_OFF_DETECTED                | ohos.permission.MANAGE_SECURE_SETTINGS                       |
488| COMMON_EVENT_DISCHARGING                                     | usual.event.DISCHARGING                                     | 无                                                           |
489| COMMON_EVENT_CHARGING                                        | usual.event.CHARGING                                        | 无                                                           |
490| COMMON_EVENT_DEVICE_IDLE_MODE_CHANGED                        | usual.event.DEVICE_IDLE_MODE_CHANGED                        | 无                                                           |
491| COMMON_EVENT_POWER_SAVE_MODE_CHANGED                         | usual.event.POWER_SAVE_MODE_CHANGED                         | 无                                                           |
492| COMMON_EVENT_USER_ADDED                                      | usual.event.USER_ADDED                                      | ohos.permission.MANAGE_USERS                                 |
493| COMMON_EVENT_USER_REMOVED                                    | usual.event.USER_REMOVED                                    | ohos.permission.MANAGE_USERS                                 |
494| COMMON_EVENT_ABILITY_ADDED                                   | common.event.ABILITY_ADDED                                  | ohos.permission.LISTEN_BUNDLE_CHANGE                         |
495| COMMON_EVENT_ABILITY_REMOVED                                 | common.event.ABILITY_REMOVED                                | ohos.permission.LISTEN_BUNDLE_CHANGE                         |
496| COMMON_EVENT_ABILITY_UPDATED                                 | common.event.ABILITY_UPDATED                                | ohos.permission.LISTEN_BUNDLE_CHANGE                         |
497| COMMON_EVENT_LOCATION_MODE_STATE_CHANGED                     | usual.event.location.MODE_STATE_CHANGED                     | 无                                                           |
498| COMMON_EVENT_IVI_SLEEP                                       | common.event.IVI_SLEEP                                      | 无                                                           |
499| COMMON_EVENT_IVI_PAUSE                                       | common.event.IVI_PAUSE                                      | 无                                                           |
500| COMMON_EVENT_IVI_STANDBY                                     | common.event.IVI_STANDBY                                    | 无                                                           |
501| COMMON_EVENT_IVI_LASTMODE_SAVE                               | common.event.IVI_LASTMODE_SAVE                              | 无                                                           |
502| COMMON_EVENT_IVI_VOLTAGE_ABNORMAL                            | common.event.IVI_VOLTAGE_ABNORMAL                           | 无                                                           |
503| COMMON_EVENT_IVI_HIGH_TEMPERATURE                            | common.event.IVI_HIGH_TEMPERATURE                           | 无                                                           |
504| COMMON_EVENT_IVI_EXTREME_TEMPERATURE                         | common.event.IVI_EXTREME_TEMPERATURE                        | 无                                                           |
505| COMMON_EVENT_IVI_TEMPERATURE_ABNORMAL                        | common.event.IVI_TEMPERATURE_ABNORMAL                       | 无                                                           |
506| COMMON_EVENT_IVI_VOLTAGE_RECOVERY                            | common.event.IVI_VOLTAGE_RECOVERY                           | 无                                                           |
507| COMMON_EVENT_IVI_TEMPERATURE_RECOVERY                        | common.event.IVI_TEMPERATURE_RECOVERY                       | 无                                                           |
508| COMMON_EVENT_IVI_ACTIVE                                      | common.event.IVI_ACTIVE                                     | 无                                                           |
509| COMMON_EVENT_USB_DEVICE_ATTACHED                             | usual.event.hardware.usb.action.USB_DEVICE_ATTACHED         | 无                                                           |
510| COMMON_EVENT_USB_DEVICE_DETACHED                             | usual.event.hardware.usb.action.USB_DEVICE_DETACHED         | 无                                                           |
511| COMMON_EVENT_USB_ACCESSORY_ATTACHED                          | usual.event.hardware.usb.action.USB_ACCESSORY_ATTACHED      | 无                                                           |
512| COMMON_EVENT_USB_ACCESSORY_DETACHED                          | usual.event.hardware.usb.action.USB_ACCESSORY_DETACHED      | 无                                                           |
513| COMMON_EVENT_DISK_REMOVED                                    | usual.event.data.DISK_REMOVED                               | ohos.permission.WRITE_USER_STORAGE or ohos.permission.READ_USER_STORAGE |
514| COMMON_EVENT_DISK_UNMOUNTED                                  | usual.event.data.DISK_UNMOUNTED                             | ohos.permission.WRITE_USER_STORAGEor ohos.permission.READ_USER_STORAGE |
515| COMMON_EVENT_DISK_MOUNTED                                    | usual.event.data.DISK_MOUNTED                               | ohos.permission.WRITE_USER_STORAGEor ohos.permission.READ_USER_STORAGE |
516| COMMON_EVENT_DISK_BAD_REMOVAL                                | usual.event.data.DISK_BAD_REMOVAL                           | ohos.permission.WRITE_USER_STORAGEor ohos.permission.READ_USER_STORAGE |
517| COMMON_EVENT_DISK_UNMOUNTABLE                                | usual.event.data.DISK_UNMOUNTABLE                           | ohos.permission.WRITE_USER_STORAGEor ohos.permission.READ_USER_STORAGE |
518| COMMON_EVENT_DISK_EJECT                                      | usual.event.data.DISK_EJECT                                 | ohos.permission.WRITE_USER_STORAGEor ohos.permission.READ_USER_STORAGE |
519| COMMON_EVENT_VISIBLE_ACCOUNTS_UPDATED                        | usual.event.data.VISIBLE_ACCOUNTS_UPDATED                   | ohos.permission.GET_APP_ACCOUNTS                             |
520| COMMON_EVENT_ACCOUNT_DELETED                                 | usual.event.data.ACCOUNT_DELETED                            | ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS               |
521| COMMON_EVENT_FOUNDATION_READY                                | common.event.FOUNDATION_READY                               | ohos.permission.RECEIVER_STARTUP_COMPLETED                   |
522| COMMON_EVENT_AIRPLANE_MODE_CHANGED                           | usual.event.AIRPLANE_MODE                                   | 无                                                           |
523