• Home
Name Date Size #Lines LOC

..--

figures/12-May-2024-

frameworks/12-May-2024-5,9173,393

interfaces/12-May-2024-7,4423,849

sa_profile/12-May-2024-4928

services/12-May-2024-15,46110,514

test/systemtest/12-May-2024-19,33214,820

tools/12-May-2024-3,1922,004

.gitattributesD12-May-2024631 1615

BUILD.gnD12-May-2024617 1513

LICENSED12-May-202410.1 KiB177150

OAT.xmlD12-May-20243.9 KiB6915

README_zh.mdD12-May-202444.7 KiB580461

bundle.jsonD12-May-20245 KiB139138

event.gniD12-May-20241.2 KiB3724

README_zh.md

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