1# System Common Events
2
3This document provides a list of common events defined by the system.
4Common event types are defined in [Support enumeration of the ohos.commonEventManager module](../js-apis-commonEventManager.md#support).
5
6## Ability Kit
7
8
9### COMMON_EVENT_PACKAGE_RESTARTED
10
11Indicates that the user has restarted the application package and killed all its processes.
12
13When the specified user restarts the application and kills all its processes, the event notification service is triggered to publish this event.
14
15**System capability**: SystemCapability.Notification.CommonEvent
16
17**Required subscriber permissions**: none
18
19**Value**: "usual.event.PACKAGE_RESTARTED"
20
21### COMMON_EVENT_PACKAGE_DATA_CLEARED
22
23Indicates the common event that the user has cleared the application package data.
24
25When the specified user clears the application package data on the device, the event notification service is triggered to publish this event.
26
27**System capability**: SystemCapability.Notification.CommonEvent
28
29**Required subscriber permissions**: none
30
31**Value**: "usual.event.PACKAGE_DATA_CLEARED"
32
33
34### COMMON_EVENT_QUICK_FIX_APPLY_RESULT
35
36Indicates the result of applying a quick fix to the application.
37
38When the specified user applies a quick fix to the application on the device, the event notification service is triggered to publish this event.
39
40**System capability**: SystemCapability.Notification.CommonEvent
41
42**Required subscriber permissions**: none
43
44**Value**: "usual.event.QUICK_FIX_APPLY_RESULT"
45
46### COMMON_EVENT_QUICK_FIX_REVOKE_RESULT<sup>10+</sup>
47
48Indicates the result of revoking a quick fix to the application.
49
50When a quick fix to the application is revoked on the device, the event notification service is triggered to publish this event.
51
52**System capability**: SystemCapability.Notification.CommonEvent
53
54**Required subscriber permissions**: none
55
56**Value**: "usual.event.QUICK_FIX_REVOKE_RESULT"
57
58### COMMON_EVENT_PACKAGE_ADDED
59
60Indicates that a new application package has been installed on the device.
61
62When a new application is installed by a specified user on the device, the event notification service is triggered to publish this event.
63
64**System capability**: SystemCapability.Notification.CommonEvent
65
66**Required subscriber permissions**: none
67
68**Value**: "usual.event.PACKAGE_ADDED"
69
70
71### COMMON_EVENT_PACKAGE_REMOVED
72
73Indicates the common event that an installed application has been uninstalled from the device with the application data retained.
74
75When a specified application package is removed by a specified user on the device, the event notification service is triggered to publish this event.
76
77**System capability**: SystemCapability.Notification.CommonEvent
78
79**Required subscriber permissions**: none
80
81**Value**: "usual.event.PACKAGE_REMOVED"
82
83
84### COMMON_EVENT_BUNDLE_REMOVED
85
86Indicates the common event that an installed bundle has been uninstalled from the device.
87
88**System capability**: SystemCapability.Notification.CommonEvent
89
90**Required subscriber permissions**: none
91
92**Value**: "usual.event.BUNDLE_REMOVED"
93
94
95### COMMON_EVENT_PACKAGE_FULLY_REMOVED
96
97Indicates the common event that an installed application has been completely uninstalled from the device.
98
99**System capability**: SystemCapability.Notification.CommonEvent
100
101**Required subscriber permissions**: none
102
103**Value**: "usual.event.PACKAGE_FULLY_REMOVED"
104
105
106### COMMON_EVENT_PACKAGE_CHANGED
107
108Indicates that an application package has been changed (for example, an ability in the package has been enabled or disabled).
109
110When an application package installed on the device is updated or an ability in the package is enabled or disabled, the event notification service is triggered to publish this event.
111
112**System capability**: SystemCapability.Notification.CommonEvent
113
114**Required subscriber permissions**: none
115
116**Value**: "usual.event.PACKAGE_CHANGED"
117
118
119### COMMON_EVENT_PACKAGE_CACHE_CLEARED
120
121Indicates that the user cleared the application package cache.
122
123When the cache of an application package installed on the device is cleared, the event notification service is triggered to publish this event.
124
125**System capability**: SystemCapability.Notification.CommonEvent
126
127**Required subscriber permissions**: none
128
129**Value**: "usual.event.PACKAGE_CACHE_CLEARED"
130
131
132### COMMON_EVENT_PACKAGES_SUSPENDED
133
134Indicates the common event that application packages have been suspended.
135
136**System capability**: SystemCapability.Notification.CommonEvent
137
138**Required subscriber permissions**: none
139
140**Value**: "usual.event.PACKAGES_SUSPENDED"
141
142
143
144### COMMON_EVENT_MY_PACKAGE_SUSPENDED
145
146Sent to a package that has been suspended by the system.
147
148**System capability**: SystemCapability.Notification.CommonEvent
149
150**Required subscriber permissions**: none
151
152**Value**: "usual.event.MY_PACKAGE_SUSPENDED"
153
154
155### COMMON_EVENT_MY_PACKAGE_UNSUSPENDED
156
157Sent to a package that has been unsuspended by the system.
158
159**System capability**: SystemCapability.Notification.CommonEvent
160
161**Required subscriber permissions**: none
162
163**Value**: "usual.event.MY_PACKAGE_UNSUSPENDED"
164
165### COMMON_EVENT_MANAGE_PACKAGE_STORAGE
166
167Notifies the low memory state and package management should be started.
168
169**System capability**: SystemCapability.Notification.CommonEvent
170
171**Required subscriber permissions**: none
172
173**Value**: "usual.event.MANAGE_PACKAGE_STORAGE"
174
175
176
177## Account Kit
178
179### COMMON_EVENT_MINORSMODE_ON<sup>12+</sup>
180
181Indicates that the minor mode is enabled.
182
183When the minor mode is enabled on the device, the event notification service is triggered to publish this event.
184
185**System capability**: SystemCapability.Notification.CommonEvent
186
187**Required subscriber permissions**: none
188
189**Atomic service API**: This API can be used in atomic services since API version 12.
190
191**Value**: "usual.event.MINORSMODE_ON"
192
193### COMMON_EVENT_MINORSMODE_OFF<sup>12+</sup>
194
195Indicates that the minor mode is disabled.
196
197When the minor mode is disabled on the device, the event notification service is triggered to publish this event.
198
199**System capability**: SystemCapability.Notification.CommonEvent
200
201**Required subscriber permissions**: none
202
203**Atomic service API**: This API can be used in atomic services since API version 12.
204
205**Value**: "usual.event.MINORSMODE_OFF"
206
207
208
209## ArkUI
210
211### COMMON_EVENT_SPLIT_SCREEN
212
213Indicates a screen splitting action.
214
215When any of the following actions is performed, the event notification service is triggered to publish this event: accessing the recent tasks screen, creating a split-screen bar, and destroying a split-screen bar.
216
217**System capability**: SystemCapability.Notification.CommonEvent
218
219**Required subscriber permissions:** ohos.permission.RECEIVER_SPLIT_SCREEN
220
221**Atomic service API**: This API can be used in atomic services since API version 11.
222
223**Value**: usual.event.SPLIT_SCREEN"
224
225
226
227## Notification Kit
228
229### COMMON_EVENT_SLOT_CHANGE
230
231  Indicates that the notification slot or notification switch settings have changed.
232
233  When the notification slot settings (including the switch) change or the notification feature is enabled or disabled, the notification service is triggered to publish this event.
234
235**System capability**: SystemCapability.Notification.CommonEvent
236
237**Required subscriber permissions:** ohos.permission.NOTIFICATION_CONTROLLER
238
239**System capability**: SystemCapability.Notification.CommonEvent
240
241**Value**: "usual.event.SLOT_CHANGE"
242
243
244
245
246## Background Tasks Kit
247
248
249### COMMON_EVENT_DEVICE_IDLE_MODE_CHANGED
250Indicates that the system idle mode has changed.
251
252When the user does not use the device for the specified period of time and the screen is turned off, the system delays the CPU and network access by background applications, and the event notification service is triggered to publish this event.
253
254**System capability**: SystemCapability.Notification.CommonEvent
255
256**Required subscriber permissions**: none
257
258**Value**: "usual.event.DEVICE_IDLE_MODE_CHANGED"
259
260
261
262
263## Basic Services Kit
264
265### COMMON_EVENT_USB_STATE
266
267Indicates that the USB device state has changed.
268
269When a USB device is connected to or disconnected from the device, the event notification service is triggered to publish this event.
270
271**System capability**: SystemCapability.Notification.CommonEvent
272
273**Required subscriber permissions**: none
274
275**Value**: "usual.event.hardware.usb.action.USB_STATE"
276
277
278### COMMON_EVENT_USB_PORT_CHANGED
279
280Indicates that the USB port state of the device has changed.
281
282When the USB port state changes, the event notification service is triggered to publish this event.
283
284**System capability**: SystemCapability.Notification.CommonEvent
285
286**Required subscriber permissions**: none
287
288**Value**: "usual.event.hardware.usb.action.USB_PORT_CHANGED"
289
290
291### COMMON_EVENT_USB_DEVICE_ATTACHED
292
293Indicates that a USB device has been attached to the device functioning as a USB host.
294
295When a USB device is attached, the event notification service is triggered to publish this event.
296
297**System capability**: SystemCapability.Notification.CommonEvent
298
299**Required subscriber permissions**: none
300
301**Value**: "usual.event.hardware.usb.action.USB_DEVICE_ATTACHED"
302
303
304### COMMON_EVENT_USB_DEVICE_DETACHED
305
306Indicates that a USB device has been detached from the device functioning as a USB host.
307
308When a USB device is detached, the event notification service is triggered to publish this event.
309
310**System capability**: SystemCapability.Notification.CommonEvent
311
312**Required subscriber permissions**: none
313
314**Value**: "usual.event.hardware.usb.action.USB_DEVICE_DETACHED"
315
316
317### COMMON_EVENT_TIME_CHANGED
318
319Indicates the common event that the system time is set.
320
321When the system time is set, the event notification service is triggered to publish this event.
322
323**System capability**: SystemCapability.Notification.CommonEvent
324
325**Required subscriber permissions**: none
326
327**Value**: "usual.event.TIME_CHANGED"
328
329
330### COMMON_EVENT_TIME_TICK
331
332Indicates the common event that the system time has changed.
333
334When the system time in the unit of minute changes, the event notification service is triggered to publish this event.
335
336**System capability**: SystemCapability.Notification.CommonEvent
337
338**Required subscriber permissions**: none
339
340**Value**: "usual.event.TIME_TICK"
341
342
343### COMMON_EVENT_TIMEZONE_CHANGED
344
345Indicates the common event that the system time zone has changed.
346
347When the system time zone changes, the event notification service is triggered to publish this event.
348
349**System capability**: SystemCapability.Notification.CommonEvent
350
351**Required subscriber permissions**: none
352
353**Value**: "usual.event.TIMEZONE_CHANGED"
354
355### COMMON_EVENT_USER_INFO_UPDATED
356
357Indicates that the user information has been updated.
358
359When the distributed account information, system account profile picture, or system account name is changed, the event notification service is triggered to publish this event carrying the system account ID.
360
361APIs related to this event: **setOsAccountName**, **setOsAccountProfilePhoto**, and **setOsAccountDistributedInfon**. The first two are system APIs, and the last is a public API. For details, see [@ohos.account.osAccount (System Account Management)](../js-apis-osAccount.md) and [@ohos.account.distributedAccount (Distributed Account Management)](../js-apis-distributed-account.md).
362
363**System capability**: SystemCapability.Notification.CommonEvent
364
365**Required subscriber permissions**: none
366
367**System capability**: SystemCapability.Notification.CommonEvent
368
369**Value**: "usual.event.USER_INFO_UPDATED"
370
371
372### COMMON_EVENT_USER_UNLOCKED
373
374Indicates that the credential-encrypted storage has been unlocked for the current user after the device is restarted.
375
376When the device is unlocked with the lock screen password the first time after user switching, the event notification service is triggered to publish this event carrying the system account ID that identifies the user.
377
378APIs related to this event: **auth**. This API is a system API. For details, see [@ohos.account.osAccount (OS Account Management)](../js-apis-osAccount.md).
379
380**System capability**: SystemCapability.Notification.CommonEvent
381
382**Required subscriber permissions**: none
383
384**System capability**: SystemCapability.Notification.CommonEvent
385
386**Value**: "usual.event.USER_UNLOCKED"
387
388
389### COMMON_EVENT_DISTRIBUTED_ACCOUNT_LOGIN
390
391Indicates a successful login from a distributed account.
392
393When a distributed account is successfully logged in, the event notification service is triggered to publish this event carrying the system account ID.
394
395APIs related to this event: **setOsAccountDistributedInfo** and **updateOsAccountDistributedInfo** (discarded), and **setOsAccountDistributedInfoByLocalId**. The first two are public APIs, and the last one is a system API. For details, see [@ohos.account.distributedAccount (Distributed Account Management)](../js-apis-distributed-account.md).
396
397**System capability**: SystemCapability.Notification.CommonEvent
398
399**Required subscriber permissions**: none
400
401**Atomic service API**: This API can be used in atomic services since API version 12.
402
403**Value**: "common.event.DISTRIBUTED_ACCOUNT_LOGIN"
404
405
406### COMMON_EVENT_DISTRIBUTED_ACCOUNT_LOGOUT
407
408Indicates a successful logout from a distributed account.
409
410When a distributed account is successfully logged out, the event notification service is triggered to publish this event carrying the system account ID.
411
412APIs related to this event: **setOsAccountDistributedInfo** and **updateOsAccountDistributedInfo** (discarded), and **setOsAccountDistributedInfoByLocalId**. The first two are public APIs, and the last one is a system API. For details, see [@ohos.account.distributedAccount (Distributed Account Management)](../js-apis-distributed-account.md).
413
414**System capability**: SystemCapability.Notification.CommonEvent
415
416**Required subscriber permissions**: none
417
418**Atomic service API**: This API can be used in atomic services since API version 12.
419
420**Value**: "common.event.DISTRIBUTED_ACCOUNT_LOGOUT"
421
422
423### COMMON_EVENT_DISTRIBUTED_ACCOUNT_TOKEN_INVALID
424
425Indicates that the token of a distributed account is invalid.
426
427When the token of a distributed account is invalid, the event notification service is triggered to publish this event carrying the system account ID.
428
429APIs related to this event: **setOsAccountDistributedInfo** and **updateOsAccountDistributedInfo** (discarded), and **setOsAccountDistributedInfoByLocalId**. The first two are public APIs, and the last one is a system API. For details, see [@ohos.account.distributedAccount (Distributed Account Management)](../js-apis-distributed-account.md).
430
431**Required subscriber permissions**: none
432
433**System capability**: SystemCapability.Notification.CommonEvent
434
435**Atomic service API**: This API can be used in atomic services since API version 12.
436
437**Value**: "common.event.DISTRIBUTED_ACCOUNT_TOKEN_INVALID"
438
439### COMMON_EVENT_DISTRIBUTED_ACCOUNT_LOGOFF
440
441Indicates that a distributed account is deregistered.
442
443When a distributed account is deregistered, the event notification service is triggered to publish this event carrying the system account ID.
444
445APIs related to this event: **setOsAccountDistributedInfo** and **updateOsAccountDistributedInfo** (discarded), and **setOsAccountDistributedInfoByLocalId**. The first two are public APIs, and the last one is a system API. For details, see [@ohos.account.distributedAccount (Distributed Account Management)](../js-apis-distributed-account.md).
446
447**System capability**: SystemCapability.Notification.CommonEvent
448
449**Required subscriber permissions**: none
450
451**Atomic service API**: This API can be used in atomic services since API version 12.
452
453**Value**: "common.event.DISTRIBUTED_ACCOUNT_LOGOFF"
454
455### COMMON_EVENT_SCREEN_LOCKED
456
457Indicates that the screen has been locked.
458When the screen is locked, the event notification service is triggered to publish this event.
459
460**System capability**: SystemCapability.Notification.CommonEvent
461
462**Required subscriber permissions**: none
463
464**Atomic service API**: This API can be used in atomic services since API version 11.
465
466**Value**: usual.event.SCREEN_LOCKED
467
468### COMMON_EVENT_SCREEN_UNLOCKED
469
470Indicates that the screen has been unlocked.
471When the screen is unlocked, the event notification service is triggered to publish this event.
472
473**System capability**: SystemCapability.Notification.CommonEvent
474
475**Required subscriber permissions**: none
476
477**Atomic service API**: This API can be used in atomic services since API version 11.
478
479**Value**: usual.event.SCREEN_UNLOCKED
480
481
482### COMMON_EVENT_USER_PRESENT<sup>(deprecated)</sup>
483Indicates the action of a common event that the user unlocks the device.
484
485  > Notes:
486  >
487  > This API is deprecated since API Version 10 and replaced by [COMMON_EVENT_SCREEN_UNLOCKED](#common_event_screen_unlocked).
488
489**System capability**: SystemCapability.Notification.CommonEvent
490
491**Required subscriber permissions**: none
492
493**Value**: usual.event.USER_PRESENT
494
495
496### COMMON_EVENT_BATTERY_CHANGED
497
498Indicates that the charging state, level, and other information about the battery have changed.
499
500When any of the following information changes, the event notification service is triggered to publish this event: battery level, battery voltage, battery temperature, battery health status, type of the charger connected to the device, maximum current of the charger, maximum voltage of the charger, battery charging status, number of charging times, total battery capacity, remaining battery capacity, battery model, current of the battery, and battery charging type.
501
502**System capability**: SystemCapability.Notification.CommonEvent
503
504**Required subscriber permissions**: none
505
506**Value**: "usual.event.BATTERY_CHANGED"
507
508
509### COMMON_EVENT_BATTERY_LOW
510
511Indicates that the battery level is low.
512
513When the battery level drops to lower than the low battery level set for the device, the event notification service is triggered to publish this event. <!--Del-->For details about how to set the low battery level percentage, see [Battery Level Customization](https://gitee.com/openharmony/docs/blob/master/en/device-dev/subsystems/subsys-power-battery-level-customization.md).<!--DelEnd-->
514
515**System capability**: SystemCapability.Notification.CommonEvent
516
517**Required subscriber permissions**: none
518
519**Value**: "usual.event.BATTERY_LOW"
520
521
522### COMMON_EVENT_BATTERY_OKAY
523
524Indicates that the battery level is normal.
525
526When the battery level changes from the low level to normal level, the event notification service is triggered to publish this event.
527
528
529**System capability**: SystemCapability.Notification.CommonEvent
530
531**Required subscriber permissions**: none
532
533**Value**: "usual.event.BATTERY_OKAY"
534
535
536### COMMON_EVENT_POWER_CONNECTED
537
538Indicates that the device is connected to an external power supply.
539
540When the device connects to an external charger, the event notification service is triggered to publish this event.
541
542**System capability**: SystemCapability.Notification.CommonEvent
543
544**Required subscriber permissions**: none
545
546**Value**: "usual.event.POWER_CONNECTED"
547
548
549### COMMON_EVENT_POWER_DISCONNECTED
550
551Indicates that the device is disconnected from the external power supply.
552
553When the device is disconnected from the external power supply, the event notification service is triggered to publish this event.
554
555**System capability**: SystemCapability.Notification.CommonEvent
556
557**Required subscriber permissions**: none
558
559**Value**: "usual.event.POWER_DISCONNECTED"
560
561
562### COMMON_EVENT_DISCHARGING
563
564Indicates the common event that the system stops charging the battery.
565
566When the system stops charging the battery, the event notification service is triggered to publish this event.
567
568**System capability**: SystemCapability.Notification.CommonEvent
569
570**Required subscriber permissions**: none
571
572**Value**: "usual.event.DISCHARGING"
573
574
575### COMMON_EVENT_CHARGING
576
577Indicates the common event that the system starts charging the battery.
578
579When the system starts charging the battery, the event notification service is triggered to publish this event.
580
581**System capability**: SystemCapability.Notification.CommonEvent
582
583**Required subscriber permissions**: none
584
585**Value**: "usual.event.CHARGING"
586
587### COMMON_EVENT_CHARGE_IDLE_MODE_CHANGED<sup>10+</sup>
588
589Indicates the common event that the device enters the charging idle mode.
590
591When the device starts charging in idle mode, and the temperature rise is acceptable, the event notification service is triggered to publish this event.
592
593**System capability**: SystemCapability.Notification.CommonEvent
594
595**Required subscriber permissions**: none
596
597**Value**: "usual.event.CHARGE_IDLE_MODE_CHANGED"
598
599
600### COMMON_EVENT_SHUTDOWN
601
602Indicates the common event that the device is being shut down and the final shutdown will proceed.
603
604When the device is being shut down until it is powered off, the event notification service is triggered to publish this event.
605
606**System capability**: SystemCapability.Notification.CommonEvent
607
608**Required subscriber permissions**: none
609
610**Value**: "usual.event.SHUTDOWN"
611
612
613### COMMON_EVENT_SCREEN_OFF
614
615Indicates the common event that a device screen-off initiated by the power service is complete.
616
617When the device screen-off initiated by the power service is complete, the event notification service is triggered to release this event.
618
619**System capability**: SystemCapability.Notification.CommonEvent
620
621**Required subscriber permissions**: none
622
623**Value**: "usual.event.SCREEN_OFF"
624
625
626### COMMON_EVENT_SCREEN_ON
627
628Indicates the common event that a device screen-on initiated by the power service is complete.
629
630When the device screen-on initiated by the power service is complete, the event notification service is triggered to release this event.
631
632**System capability**: SystemCapability.Notification.CommonEvent
633
634**Required subscriber permissions**: none
635
636**Value**: "usual.event.SCREEN_ON"
637
638
639### COMMON_EVENT_POWER_SAVE_MODE_CHANGED
640
641Indicates that the system power saving mode has changed.
642
643When the system power saving mode changes, the event notification service is triggered to publish this event.
644
645**System capability**: SystemCapability.Notification.CommonEvent
646
647**Required subscriber permissions**: none
648
649**Value**: "usual.event.POWER_SAVE_MODE_CHANGED"
650
651
652### COMMON_EVENT_THERMAL_LEVEL_CHANGED
653
654Indicates that the device's thermal level has changed.
655
656When the device's thermal level changes, the event notification service is triggered to publish this event. <!--Del-->For details about how to configure the device thermal level, see [Thermal Level Customization](https://gitee.com/openharmony/docs/blob/master/en/device-dev/subsystems/subsys-thermal_level.md).<!--DelEnd-->
657
658**System capability**: SystemCapability.Notification.CommonEvent
659
660**Required subscriber permissions**: none
661
662**Value**: "usual.event.THERMAL_LEVEL_CHANGED"
663
664
665### COMMON_EVENT_ENTER_FORCE_SLEEP<sup>12+</sup>
666
667Indicates that the device is about to enter the forced sleep mode.
668
669When the device is about to enter the forced sleep mode, the event notification service is triggered to publish this event. This event should be processed within one second.
670
671
672**System capability**: SystemCapability.Notification.CommonEvent
673
674**Required subscriber permissions**: none
675
676**Value**: "usual.event.ENTER_FORCE_SLEEP"
677
678### COMMON_EVENT_EXIT_FORCE_SLEEP<sup>12+</sup>
679
680Indicates that the device exits the forced sleep mode.
681
682When the device exits the forced sleep mode, the event notification service is triggered to publish this event.
683
684
685**System capability**: SystemCapability.Notification.CommonEvent
686
687**Required subscriber permissions**: none
688
689**Value**: "usual.event.EXIT_FORCE_SLEEP"
690
691
692
693
694## Connectivity Kit
695
696
697### COMMON_EVENT_NFC_ACTION_ADAPTER_STATE_CHANGED
698
699Indicates that the state of the device NFC adapter has changed.
700
701When the state of the device NFC adapter changes, the event notification service is triggered to publish this event.
702
703**System capability**: SystemCapability.Notification.CommonEvent
704
705**Required subscriber permissions**: none
706
707**Value**: "usual.event.nfc.action.ADAPTER_STATE_CHANGED"
708
709
710### COMMON_EVENT_NFC_ACTION_RF_FIELD_ON_DETECTED
711
712Indicates that the NFC RF field is on.
713
714When the NFC RF field becomes available, the event notification service is triggered to publish this event.
715
716**System capability**: SystemCapability.Notification.CommonEvent
717
718**Required subscriber permissions**: none
719
720**Value**: "usual.event.nfc.action.RF_FIELD_ON_DETECTED"
721
722
723### COMMON_EVENT_NFC_ACTION_RF_FIELD_OFF_DETECTED
724
725Indicates that the NFC RF field is off.
726
727When the NFC RF field becomes unavailable, the event notification service is triggered to publish this event.
728
729**System capability**: SystemCapability.Notification.CommonEvent
730
731**Required subscriber permissions**: none
732
733**Value**: "usual.event.nfc.action.RF_FIELD_OFF_DETECTED"
734
735
736### COMMON_EVENT_WIFI_POWER_STATE
737
738Indicates that the Wi-Fi state changes.
739
740When the Wi-Fi state changes (such as enabled or disabled), the event notification service is triggered to release the system public event.
741
742State values: **0** indicates that the Wi-Fi is being disabled; **1** indicates that the Wi-Fi has been disabled; **2** indicates that the Wi-Fi is being enabled; **3** indicates that the Wi-Fi has been enabled.
743
744**System capability**: SystemCapability.Notification.CommonEvent
745
746**Required subscriber permissions**: none
747
748**Value**: "usual.event.wifi.POWER_STATE"
749
750
751### COMMON_EVENT_WIFI_SCAN_FINISHED
752
753Indicates that a Wi-Fi access point is detected and proven to be available.
754
755When a Wi-Fi access point is detected and proven to be available, the event notification service is triggered to publish this event.
756
757**System capability**: SystemCapability.Notification.CommonEvent
758
759**Required subscriber permissions**: ohos.permission.LOCATION
760
761**Value**: "usual.event.wifi.SCAN_FINISHED"
762
763
764### COMMON_EVENT_WIFI_SCAN_STATE
765
766Indicates that the Wi-Fi access point state has changed.
767
768When the Wi-Fi access point state changes, the event notification service is triggered to publish this event.
769
770**System capability**: SystemCapability.Notification.CommonEvent
771
772**Required subscriber permissions**: ohos.permission.LOCATION
773
774**Value**: "usual.event.wifi.SCAN_STATE"
775
776### COMMON_EVENT_WIFI_RSSI_VALUE
777
778  Indicates that the Wi-Fi signal strength (RSSI) has changed.
779
780  When the Wi-Fi signal strength (RSSI) changes, the event notification service is triggered to publish this event.
781
782**System capability**: SystemCapability.Notification.CommonEvent
783
784**Required subscriber permissions**: ohos.permission.GET_WIFI_INFO
785
786**Value**: "usual.event.wifi.RSSI_VALUE"
787
788### COMMON_EVENT_WIFI_CONN_STATE
789
790  Indicates that the Wi-Fi connection state has changed.
791
792  When the Wi-Fi connection state changes, the event notification service is triggered to publish this event.
793
794
795**System capability**: SystemCapability.Notification.CommonEvent
796
797**Required subscriber permissions**: none
798
799**Value**: "usual.event.wifi.CONN_STATE"
800
801
802### COMMON_EVENT_WIFI_HOTSPOT_STATE
803
804Indicates that the Wi-Fi hotspot state has changed.
805
806When the Wi-Fi hotspot state changes, the event notification service is triggered to publish this event.
807
808State values: **2** indicates that the AP is being enabled, **3** indicates that the AP has been enabled; **4** indicates that the AP is being disabled; **5** indicates that the AP has been disabled.
809
810**System capability**: SystemCapability.Notification.CommonEvent
811
812**Required subscriber permissions**: none
813
814**Value**: "usual.event.wifi.HOTSPOT_STATE"
815
816
817### COMMON_EVENT_WIFI_AP_STA_JOIN
818
819Indicates that a client has joined the Wi-Fi hotspot of the current device.
820
821When a client joins the Wi-Fi hotspot of the current device, the event notification service is triggered to publish this event.
822
823**System capability**: SystemCapability.Notification.CommonEvent
824
825**Required subscriber permissions**: ohos.permission.GET_WIFI_INFO
826
827**Value**: "usual.event.wifi.WIFI_HS_STA_JOIN"
828
829
830### COMMON_EVENT_WIFI_AP_STA_LEAVE
831
832Indicates that the client is disconnected from the Wi-Fi hotspot of the current device.
833
834When a client is disconnected from the Wi-Fi hotspot of the current device, the event notification service is triggered to publish this event.
835
836
837**System capability**: SystemCapability.Notification.CommonEvent
838
839**Required subscriber permissions**: ohos.permission.GET_WIFI_INFO
840
841**Value**: "usual.event.wifi.WIFI_HS_STA_LEAVE"
842
843
844### COMMON_EVENT_WIFI_MPLINK_STATE_CHANGE
845
846Indicates that the state of MPLINK (an enhanced Wi-Fi feature) has changed.
847
848When the state of MPLINK (an enhanced Wi-Fi feature) changes, the event notification service is triggered to publish this event.
849
850
851**System capability**: SystemCapability.Notification.CommonEvent
852
853**Required subscriber permissions**: ohos.permission.MPLINK_CHANGE_STATE
854
855**Value**: "usual.event.wifi.mplink.STATE_CHANGE"
856
857
858### COMMON_EVENT_WIFI_P2P_CONN_STATE
859
860Indicates that the Wi-Fi P2P connection state has changed.
861
862When the Wi-Fi P2P connection state changes, the event notification service is triggered to publish this event.
863
864
865**System capability**: SystemCapability.Notification.CommonEvent
866
867**Required subscriber permissions**: ohos.permission.GET_WIFI_INFO and ohos.permission.LOCATION
868
869**Value**: "usual.event.wifi.p2p.CONN_STATE_CHANGE"
870
871
872### COMMON_EVENT_WIFI_P2P_STATE_CHANGED
873
874Indicates that the Wi-Fi P2P state has changed.
875
876When the Wi-Fi P2P state changes, the event notification service is triggered to publish this event.
877
878State values: **2** indicates that the P2P is being enabled, **3** indicates that the P2P has been enabled; **4** indicates that the P2P is being disabled; **5** indicates that the P2P has been disabled.
879
880**System capability**: SystemCapability.Notification.CommonEvent
881
882**Required subscriber permissions**: ohos.permission.GET_WIFI_INFO
883
884**Value**: "usual.event.wifi.p2p.STATE_CHANGE"
885
886
887### COMMON_EVENT_WIFI_P2P_PEERS_STATE_CHANGED
888
889Indicates that the state of the Wi-Fi P2P peer device has changed.
890
891When the state of the Wi-Fi P2P peer device changes, the event notification service is triggered to publish this event.
892
893**System capability**: SystemCapability.Notification.CommonEvent
894
895**Required subscriber permissions**: ohos.permission.GET_WIFI_INFO
896
897**Value:** "usual.event.wifi.p2p.DEVICES_CHANGE"
898
899
900### COMMON_EVENT_WIFI_P2P_PEERS_DISCOVERY_STATE_CHANGED
901
902Indicates that the Wi-Fi P2P discovery state has changed.
903
904When the Wi-Fi P2P discovery state changes, the event notification service is triggered to publish this event.
905
906**System capability**: SystemCapability.Notification.CommonEvent
907
908**Required subscriber permissions**: ohos.permission.GET_WIFI_INFO
909
910**Value**: "usual.event.wifi.p2p.PEER_DISCOVERY_STATE_CHANGE"
911
912
913### COMMON_EVENT_WIFI_P2P_CURRENT_DEVICE_STATE_CHANGED
914
915Indicates that the state of the Wi-Fi P2P local device has changed.
916
917When the state of the Wi-Fi P2P local device changes, the event notification service is triggered to publish this event.
918
919**System capability**: SystemCapability.Notification.CommonEvent
920
921**Required subscriber permissions**: ohos.permission.GET_WIFI_INFO
922
923**Value**: "usual.event.wifi.p2p.CURRENT_DEVICE_CHANGE"
924
925
926### COMMON_EVENT_WIFI_P2P_GROUP_STATE_CHANGED
927
928Indicates that the Wi-Fi P2P group information has changed.
929
930When the Wi-Fi P2P group information changes, the event notification service is triggered to publish this event.
931
932**System capability**: SystemCapability.Notification.CommonEvent
933
934**Required subscriber permissions**: ohos.permission.GET_WIFI_INFO
935
936**Value**: "usual.event.wifi.p2p.GROUP_STATE_CHANGED"
937
938
939
940## Localization Kit
941
942### COMMON_EVENT_LOCALE_CHANGED
943
944Indicates the common event that the system language is set.
945When the system language is set, the event notification service is triggered to publish this event.
946
947**System capability**: SystemCapability.Notification.CommonEvent
948
949**Required subscriber permissions**: none
950
951**Value**: usual.event.LOCALE_CHANGED
952
953
954
955
956## Network Kit
957
958### COMMON_EVENT_CONNECTIVITY_CHANGE<sup>10+</sup>
959
960Indicates that the network connection state has changed.
961
962When the (Ethernet, Wi-Fi, or cellular) network connection state changes (to disconnected, connecting, or connected), the event notification service is triggered to publish this event.
963The following table lists the enumerated values and their corresponding connection status.
964
965| Value |  Connection State |
966| ------ | ---------- |
967|    2   |   Connecting.  |
968|    3   |   Connected.  |
969|    4   |   Disconnecting.|
970|    5   |   Disconnected.  |
971
972**System capability**: SystemCapability.Notification.CommonEvent
973
974**Required subscriber permissions**: none
975
976**Atomic service API**: This API can be used in atomic services since API version 11.
977
978**Value**: usual.event.CONNECTIVITY_CHANGE
979
980
981### COMMON_EVENT_AIRPLANE_MODE_CHANGED<sup>10+</sup>
982
983Indicates that the airplane mode state has changed.
984
985When the airplane mode is enabled or disabled, the event notification service is triggered to publish this event.
986
987**System capability**: SystemCapability.Notification.CommonEvent
988
989**Required subscriber permissions**: none
990
991**Value**: usual.event.AIRPLANE_MODE
992
993
994### COMMON_EVENT_HTTP_PROXY_CHANGE<sup>10+</sup>
995
996Indicates that the HTTP proxy configuration has changed.
997
998When the configuration information of the system global proxy or HTTP proxy on various networks (such as Ethernet, Wi-Fi, and cellular networks) changes, the event notification service is triggered to release the system common event.
999
1000**System capability**: SystemCapability.Notification.CommonEvent
1001
1002**Required subscriber permissions**: none
1003
1004**Value**: usual.event.HTTP_PROXY_CHANGE
1005
1006
1007
1008## Telephony Kit
1009
1010This document lists the common system events provided by the telephony subsystem to applications.
1011
1012### COMMON_EVENT_SIM_STATE_CHANGED<sup>10+</sup>
1013
1014Indicates that the SIM card status has changed.
1015
1016When there is a change in the SIM card status of the device, the event notification service is triggered to publish this event.
1017
1018**System capability**: SystemCapability.Notification.CommonEvent
1019
1020**Required subscriber permissions**: none
1021
1022**Value**: usual.event.SIM_STATE_CHANGED
1023
1024### COMMON_EVENT_CALL_STATE_CHANGED<sup>10+</sup>
1025
1026Indicates that the call state has been updated.
1027
1028When the call state of the device is updated, the event notification service is triggered to publish this event.
1029
1030**System capability**: SystemCapability.Notification.CommonEvent
1031
1032**Required subscriber permissions**: ohos.permission.GET_TELEPHONY_STATE (for system apps only)
1033
1034**Value**: usual.event.CALL_STATE_CHANGED
1035
1036### COMMON_EVENT_NETWORK_STATE_CHANGED<sup>10+</sup>
1037
1038Indicates that the network state has been updated.
1039
1040When the network state of the device is updated, the event notification service is triggered to publish this event.
1041
1042**System capability**: SystemCapability.Notification.CommonEvent
1043
1044**Required subscriber permissions**: none
1045
1046**Value**: usual.event.NETWORK_STATE_CHANGED
1047
1048
1049### COMMON_EVENT_SIGNAL_INFO_CHANGED<sup>10+</sup>
1050
1051Indicates that the signal information has been updated.
1052
1053When the signal information of the device is updated, the event notification service is triggered to publish this event.
1054
1055**System capability**: SystemCapability.Notification.CommonEvent
1056
1057**Required subscriber permissions**: none
1058
1059**Value**: usual.event.SIGNAL_INFO_CHANGED
1060
1061**System capability**: SystemCapability.Notification.CommonEvent
1062
1063
1064
1065## Store Kit
1066This document lists the common system events provided by the Store Kit to applications.
1067
1068### COMMON_EVENT_PRIVACY_STATE_CHANGED<sup>11+</sup>
1069Indicates the privacy signature result.
1070When a user clicks **Agree** in a privacy dialog box, the event notification service is triggered to publish this event.
1071
1072**System capability**: SystemCapability.Notification.CommonEvent
1073
1074**Required subscriber permissions**: none
1075
1076**Value**: "usual.event.PRIVACY_STATE_CHANGED"
1077
1078
1079
1080## Reserved Common Event
1081
1082Below are reserved common events that are not supported yet.
1083
1084
1085### COMMON_EVENT_PACKAGE_FIRST_LAUNCH
1086
1087(Reserved, not supported yet) Indicates an initial start of an application after installation.
1088
1089**System capability**: SystemCapability.Notification.CommonEvent
1090
1091**Required subscriber permissions**: none
1092
1093**Value**: "usual.event.PACKAGE_FIRST_LAUNCH"
1094
1095
1096### COMMON_EVENT_PACKAGE_NEEDS_VERIFICATION
1097
1098(Reserved, not supported yet) Indicates that a package is sent by the system verifier when the package needs verification.
1099
1100**System capability**: SystemCapability.Notification.CommonEvent
1101
1102**Required subscriber permissions**: none
1103
1104**Value**: "usual.event.PACKAGE_NEEDS_VERIFICATION"
1105
1106
1107### COMMON_EVENT_PACKAGE_VERIFIED
1108
1109(Reserved, not supported yet) Indicates that a package is sent by the system verifier when the package is verified.
1110
1111**System capability**: SystemCapability.Notification.CommonEvent
1112
1113**Required subscriber permissions**: none
1114
1115**Value**: "usual.event.PACKAGE_VERIFIED"
1116
1117### COMMON_EVENT_PACKAGE_REPLACED
1118
1119(Reserved, not supported yet) Indicates the action of a common event that a new version of an installed application package has replaced the previous one on the device. Data contains the name of the package.
1120
1121**System capability**: SystemCapability.Notification.CommonEvent
1122
1123**Required subscriber permissions**: none
1124
1125**Value**: "usual.event.PACKAGE_REPLACED"
1126
1127
1128### COMMON_EVENT_MY_PACKAGE_REPLACED
1129
1130(Reserved, not supported yet) Indicates the action of a common event that a new version of an installed application package has replaced the previous one on the device. This event does not contain additional data and is sent only to the replaced application.
1131
1132**System capability**: SystemCapability.Notification.CommonEvent
1133
1134**Required subscriber permissions**: none
1135
1136**Value**: "usual.event.MY_PACKAGE_REPLACED"
1137
1138
1139### COMMON_EVENT_PACKAGES_UNSUSPENDED
1140
1141(Reserved, not supported yet) Indicates that the package has been unsuspended.
1142
1143**System capability**: SystemCapability.Notification.CommonEvent
1144
1145**Required subscriber permissions**: none
1146
1147**Value**: "usual.event.PACKAGES_UNSUSPENDED"
1148
1149
1150### COMMON_EVENT_CLOSE_SYSTEM_DIALOGS
1151
1152(Reserved, not supported yet) Indicates the common event that a user closes a temporary system dialog box.
1153
1154**System capability**: SystemCapability.Notification.CommonEvent
1155
1156**Required subscriber permissions**: none
1157
1158**Value**: "usual.event.CLOSE_SYSTEM_DIALOGS"
1159
1160### COMMON_EVENT_UID_REMOVED
1161
1162(Reserved, not supported yet) Indicates the common event that a user ID has been removed from the system.
1163
1164**System capability**: SystemCapability.Notification.CommonEvent
1165
1166**Required subscriber permissions**: none
1167
1168**Value**: "usual.event.UID_REMOVED"
1169
1170
1171### COMMON_EVENT_EXTERNAL_APPLICATIONS_AVAILABLE
1172
1173(Reserved, not supported yet) Indicates the common event that applications installed on the external storage become available for the system.
1174
1175**System capability**: SystemCapability.Notification.CommonEvent
1176
1177**Required subscriber permissions**: none
1178
1179**Value**: "usual.event.EXTERNAL_APPLICATIONS_AVAILABLE"
1180
1181
1182### COMMON_EVENT_EXTERNAL_APPLICATIONS_UNAVAILABLE
1183
1184(Reserved, not supported yet) Indicates the common event that applications installed on the external storage become unavailable for the system.
1185
1186**System capability**: SystemCapability.Notification.CommonEvent
1187
1188**Required subscriber permissions**: none
1189
1190**Value**: "usual.event.EXTERNAL_APPLICATIONS_UNAVAILABLE"
1191
1192
1193### COMMON_EVENT_CONFIGURATION_CHANGED
1194
1195(Reserved, not supported yet) Indicates the common event that the device state (for example, orientation and locale) has changed.
1196
1197**System capability**: SystemCapability.Notification.CommonEvent
1198
1199**Required subscriber permissions**: none
1200
1201**Value**: "usual.event.CONFIGURATION_CHANGED"
1202
1203### COMMON_EVENT_DRIVE_MODE
1204(Reserved, not supported yet) Indicates the common event that the system is in driving mode.
1205
1206**System capability**: SystemCapability.Notification.CommonEvent
1207
1208**Required subscriber permissions**: none
1209
1210**Value**: "common.event.DRIVE_MODE"
1211
1212### COMMON_EVENT_HOME_MODE
1213(Reserved, not supported yet) Indicates the common event that the system is in home mode.
1214
1215**System capability**: SystemCapability.Notification.CommonEvent
1216
1217**Required subscriber permissions**: none
1218
1219**Value**: "common.event.HOME_MODE"
1220
1221### COMMON_EVENT_OFFICE_MODE
1222(Reserved, not supported yet) Indicates the common event that the system is in office mode.
1223
1224**System capability**: SystemCapability.Notification.CommonEvent
1225
1226**Required subscriber permissions**: none
1227
1228**Value**: "common.event.OFFICE_MODE"
1229
1230### COMMON_EVENT_USER_STARTED
1231
1232(Reserved, not supported yet) Indicates the common event that the user has been started.
1233
1234**System capability**: SystemCapability.Notification.CommonEvent
1235
1236**Required subscriber permissions**: none
1237
1238**Value**: "usual.event.USER_STARTED"
1239
1240
1241### COMMON_EVENT_USER_BACKGROUND
1242
1243(Reserved, not supported yet) Indicates the common event that the user has been brought to the background.
1244
1245**System capability**: SystemCapability.Notification.CommonEvent
1246
1247**Required subscriber permissions**: none
1248
1249**Value**: "usual.event.USER_BACKGROUND"
1250
1251
1252### COMMON_EVENT_USER_STARTING
1253(Reserved, not supported yet) Indicates the common event that the user is going to be started.
1254
1255**System capability**: SystemCapability.Notification.CommonEvent
1256
1257**Required subscriber permissions**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS (for system applications only)
1258
1259**Value**: "usual.event.USER_STARTING"
1260
1261### COMMON_EVENT_USER_STOPPING
1262(Reserved, not supported yet) Indicates the common event that the user is going to be stopped.
1263
1264**System capability**: SystemCapability.Notification.CommonEvent
1265
1266**Required subscriber permissions**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS (for system applications only)
1267
1268**Value**: "usual.event.USER_STOPPING"
1269
1270
1271### COMMON_EVENT_USER_STOPPED
1272(Reserved, not supported yet) Indicates the common event that the user has been stopped.
1273
1274**System capability**: SystemCapability.Notification.CommonEvent
1275
1276**Required subscriber permissions**: none
1277
1278**Value**: "usual.event.USER_STOPPED"
1279
1280
1281### COMMON_EVENT_DISK_REMOVED
1282
1283(Reserved, not supported yet) Indicates the common event that an external storage device was removed.
1284
1285**System capability**: SystemCapability.Notification.CommonEvent
1286
1287**Required subscriber permissions**: ohos.permission.STORAGE_MANAGER (for system applications only)
1288
1289**Value**: "usual.event.data.DISK_BAD_REMOVAL"
1290
1291
1292### COMMON_EVENT_DISK_UNMOUNTED
1293
1294(Reserved, not supported yet) Indicates the common event that an external storage device was unmounted.
1295
1296**System capability**: SystemCapability.Notification.CommonEvent
1297
1298**Required subscriber permissions**: ohos.permission.STORAGE_MANAGER (for system applications only)
1299
1300**Value**: "usual.event.data.DISK_UNMOUNTABLE"
1301
1302
1303### COMMON_EVENT_DISK_MOUNTED
1304
1305(Reserved, not supported yet) Indicates the common event that an external storage device was mounted.
1306
1307**System capability**: SystemCapability.Notification.CommonEvent
1308
1309**Required subscriber permissions**: ohos.permission.STORAGE_MANAGER (for system applications only)
1310
1311**Value**: "usual.event.hardware.usb.action.USB_ACCESSORY_DETACHED"
1312
1313### COMMON_EVENT_DISK_BAD_REMOVAL
1314
1315(Reserved, not supported yet) Indicates the common event that an external storage device was removed without being unmounted.
1316
1317**System capability**: SystemCapability.Notification.CommonEvent
1318
1319**Required subscriber permissions**: ohos.permission.STORAGE_MANAGER (for system applications only)
1320
1321**Value**: "usual.event.data.DISK_REMOVED"
1322
1323
1324### COMMON_EVENT_DISK_UNMOUNTABLE
1325
1326(Reserved, not supported yet) Indicates the common event that an external storage device becomes unmountable.
1327
1328**System capability**: SystemCapability.Notification.CommonEvent
1329
1330**Required subscriber permissions**: ohos.permission.STORAGE_MANAGER (for system applications only)
1331
1332**Value**: "usual.event.data.DISK_UNMOUNTED"
1333
1334
1335### COMMON_EVENT_DISK_EJECT
1336
1337(Reserved, not supported yet) Indicates the common event that an external storage device was ejected.
1338
1339**System capability**: SystemCapability.Notification.CommonEvent
1340
1341**Required subscriber permissions**: ohos.permission.STORAGE_MANAGER (for system applications only)
1342
1343**Value**: "usual.event.data.DISK_EJECT"
1344
1345
1346### COMMON_EVENT_DATE_CHANGED
1347
1348(Reserved, not supported yet) Indicates the common event that the system time has changed.
1349
1350**System capability**: SystemCapability.Notification.CommonEvent
1351
1352**Required subscriber permissions**: none
1353
1354**Value**: usual.event.DATE_CHANGED
1355
1356### COMMON_EVENT_USB_ACCESSORY_ATTACHED
1357
1358(Reserved, not supported yet) Indicates that a USB accessory was attached.
1359
1360**System capability**: SystemCapability.Notification.CommonEvent
1361
1362**Required subscriber permissions**: none
1363
1364**Value**: "usual.event.hardware.usb.action.USB_ACCESSORY_ATTACHED"
1365
1366
1367### COMMON_EVENT_USB_ACCESSORY_DETACHED
1368
1369(Reserved, not supported yet) Indicates the common event that a USB accessory was detached.
1370
1371**System capability**: SystemCapability.Notification.CommonEvent
1372
1373**Required subscriber permissions**: none
1374
1375**Value**: "usual.event.data.DISK_MOUNTED"
1376
1377### COMMON_EVENT_BLUETOOTH_HANDSFREE_AG_CONNECT_STATE_UPDATE
1378(Reserved, not supported yet) Indicates the common event about the connection state of Bluetooth handsfree communication.
1379
1380**System capability**: SystemCapability.Notification.CommonEvent
1381
1382**Required subscriber permissions**: ohos.permission.USE_BLUETOOTH
1383
1384**Value**: "usual.event.bluetooth.handsfree.ag.CONNECT_STATE_UPDATE"
1385
1386### COMMON_EVENT_BLUETOOTH_HANDSFREE_AG_CURRENT_DEVICE_UPDATE
1387(Reserved, not supported yet) Indicates the common event that the device connected to the Bluetooth handsfree is active.
1388
1389**System capability**: SystemCapability.Notification.CommonEvent
1390
1391**Required subscriber permissions**: ohos.permission.USE_BLUETOOTH
1392
1393**Value**: "usual.event.bluetooth.handsfree.ag.CURRENT_DEVICE_UPDATE"
1394
1395
1396### COMMON_EVENT_BLUETOOTH_HANDSFREE_AG_AUDIO_STATE_UPDATE
1397(Reserved, not supported yet) Indicates the common event that the connection state of Bluetooth A2DP has changed.
1398
1399**System capability**: SystemCapability.Notification.CommonEvent
1400
1401**Required subscriber permissions**: ohos.permission.USE_BLUETOOTH
1402
1403**Value**: "usual.event.bluetooth.handsfree.ag.AUDIO_STATE_UPDATE"
1404
1405
1406### COMMON_EVENT_BLUETOOTH_A2DPSOURCE_CONNECT_STATE_UPDATE
1407(Reserved, not supported yet) Indicates the common event about the connection state of Bluetooth A2DP.
1408
1409**System capability**: SystemCapability.Notification.CommonEvent
1410
1411**Required subscriber permissions**: ohos.permission.USE_BLUETOOTH
1412
1413**Value**: "usual.event.bluetooth.a2dpsource.CONNECT_STATE_UPDATE"
1414
1415
1416### COMMON_EVENT_BLUETOOTH_A2DPSOURCE_CURRENT_DEVICE_UPDATE
1417(Reserved, not supported yet) Indicates the common event that the device connected using Bluetooth A2DP is active.
1418
1419**System capability**: SystemCapability.Notification.CommonEvent
1420
1421**Required subscriber permissions**: ohos.permission.USE_BLUETOOTH
1422
1423**Value**: "usual.event.bluetooth.a2dpsource.CURRENT_DEVICE_UPDATE"
1424
1425### COMMON_EVENT_BLUETOOTH_A2DPSOURCE_AVRCP_CONNECT_STATE_UPDATE
1426(Reserved, not supported yet) Indicates the common event that the AVRCP connection state of Bluetooth A2DP has changed.
1427
1428**System capability**: SystemCapability.Notification.CommonEvent
1429
1430**Required subscriber permissions**: ohos.permission.USE_BLUETOOTH
1431
1432**Value**: "usual.event.bluetooth.a2dpsource.AVRCP_CONNECT_STATE_UPDATE"
1433
1434### COMMON_EVENT_BLUETOOTH_A2DPSOURCE_PLAYING_STATE_UPDATE
1435(Reserved, not supported yet) Indicates the common event that the playing state of Bluetooth A2DP has changed.
1436
1437**System capability**: SystemCapability.Notification.CommonEvent
1438
1439**Required subscriber permissions**: ohos.permission.USE_BLUETOOTH
1440
1441**Value**: "usual.event.bluetooth.a2dpsource.PLAYING_STATE_UPDATE"
1442
1443### COMMON_EVENT_BLUETOOTH_A2DPSOURCE_CODEC_VALUE_UPDATE
1444(Reserved, not supported yet) Indicates the common event that the audio codec state of Bluetooth A2DP has changed.
1445
1446**System capability**: SystemCapability.Notification.CommonEvent
1447
1448**Required subscriber permissions**: ohos.permission.USE_BLUETOOTH
1449
1450**Value**: "usual.event.bluetooth.a2dpsource.CODEC_VALUE_UPDATE"
1451
1452
1453### COMMON_EVENT_USER_FOREGROUND
1454
1455(Reserved, not supported yet) Indicates the common event that the user has been brought to the foreground.
1456
1457**System capability**: SystemCapability.Notification.CommonEvent
1458
1459**Required subscriber permissions**: none
1460
1461**Value**: "usual.event.USER_FOREGROUND"
1462
1463
1464### COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_DISCOVERED
1465(Reserved, not supported yet) Indicates the common event that a remote Bluetooth device is discovered.
1466
1467**System capability**: SystemCapability.Notification.CommonEvent
1468
1469**Required subscriber permissions**: ohos.permission.LOCATION and ohos.permission.USE_BLUETOOTH
1470
1471**Value**: "usual.event.bluetooth.remotedevice.DISCOVERED"
1472
1473
1474### COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_CLASS_VALUE_UPDATE
1475(Reserved, not supported yet) Indicates the common event that the Bluetooth class of a remote Bluetooth device has changed.
1476
1477**System capability**: SystemCapability.Notification.CommonEvent
1478
1479**Required subscriber permissions**: ohos.permission.USE_BLUETOOTH
1480
1481**Value**: "usual.event.bluetooth.remotedevice.CLASS_VALUE_UPDATE"
1482
1483
1484### COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_ACL_CONNECTED
1485(Reserved, not supported yet) Indicates the common event that a low-ACL connection has been established with a remote Bluetooth device.
1486
1487
1488**System capability**: SystemCapability.Notification.CommonEvent
1489
1490**Required subscriber permissions**: none
1491
1492**Value**: "usual.event.bluetooth.remotedevice.ACL_CONNECTED"
1493
1494
1495### COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_ACL_DISCONNECTED
1496(Reserved, not supported yet) Indicates the common event that a low-ACL connection has been disconnected from a remote Bluetooth device.
1497
1498**System capability**: SystemCapability.Notification.CommonEvent
1499
1500**Required subscriber permissions**: ohos.permission.USE_BLUETOOTH
1501
1502**Value**: "usual.event.bluetooth.remotedevice.ACL_DISCONNECTED"
1503
1504
1505### COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_NAME_UPDATE
1506
1507(Reserved, not supported yet) Indicates the common event that the friendly name of a remote Bluetooth device is retrieved for the first time or has changed since the last retrieval.
1508
1509**System capability**: SystemCapability.Notification.CommonEvent
1510
1511**Required subscriber permissions**: ohos.permission.ACCESS_BLUETOOTH
1512
1513**Value**: "usual.event.bluetooth.remotedevice.NAME_UPDATE"
1514
1515
1516### COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_PAIR_STATE
1517(Reserved, not supported yet) Indicates the common event that the connection state of a remote Bluetooth device has changed.
1518
1519**System capability**: SystemCapability.Notification.CommonEvent
1520
1521**Required subscriber permissions**: ohos.permission.USE_BLUETOOTH
1522
1523**Value**: "usual.event.bluetooth.remotedevice.PAIR_STATE"
1524
1525### COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_BATTERY_VALUE_UPDATE
1526(Reserved, not supported yet) Indicates the common event that the battery level of a remote Bluetooth device is retrieved for the first time or has changed since the last retrieval.
1527
1528**System capability**: SystemCapability.Notification.CommonEvent
1529
1530**Required subscriber permissions**: ohos.permission.USE_BLUETOOTH
1531
1532**Value**: "usual.event.bluetooth.remotedevice.BATTERY_VALUE_UPDATE"
1533
1534
1535### COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_SDP_RESULT
1536(Reserved, not supported yet) Indicates the common event about the SDP state of a remote Bluetooth device.
1537
1538**System capability**: SystemCapability.Notification.CommonEvent
1539
1540**Required subscriber permissions**: none
1541
1542**Value**: "usual.event.bluetooth.remotedevice.SDP_RESULT"
1543
1544
1545### COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_UUID_VALUE
1546Indicates the action of a common event about the UUID connection state of a remote Bluetooth device.
1547
1548**System capability**: SystemCapability.Notification.CommonEvent
1549
1550**Required subscriber permissions**: ohos.permission.ACCESS_BLUETOOTH
1551
1552**Value**: "usual.event.bluetooth.remotedevice.UUID_VALUE"
1553
1554
1555### COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_PAIRING_REQ
1556(Reserved, not supported yet) Indicates the common event about the pairing request from a remote Bluetooth device.
1557
1558**System capability**: SystemCapability.Notification.CommonEvent
1559
1560**Required subscriber permissions**: ohos.permission.DISCOVER_BLUETOOTH
1561
1562**Value**: "usual.event.bluetooth.remotedevice.PAIRING_REQ"
1563
1564
1565### COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_PAIRING_CANCEL
1566(Reserved, not supported yet) Indicates the common event that Bluetooth pairing is canceled.
1567
1568**System capability**: SystemCapability.Notification.CommonEvent
1569
1570**Required subscriber permissions**: none
1571
1572**Value**: "usual.event.bluetooth.remotedevice.PAIRING_CANCEL"
1573
1574
1575### COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_CONNECT_REQ
1576(Reserved, not supported yet) Indicates the common event about the connection request from a remote Bluetooth device.
1577
1578**System capability**: SystemCapability.Notification.CommonEvent
1579
1580**Required subscriber permissions**: none
1581
1582**Value**: "usual.event.bluetooth.remotedevice.CONNECT_REQ"
1583
1584
1585### COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_CONNECT_REPLY
1586(Reserved, not supported yet) Indicates the common event about the response to the connection request from a remote Bluetooth device.
1587
1588**System capability**: SystemCapability.Notification.CommonEvent
1589
1590**Required subscriber permissions**: none
1591
1592**Value**: "usual.event.bluetooth.remotedevice.CONNECT_REPLY"
1593
1594
1595### COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_CONNECT_CANCEL
1596(Reserved, not supported yet) Indicates the common event that the connection to a remote Bluetooth device has been canceled.
1597
1598**System capability**: SystemCapability.Notification.CommonEvent
1599
1600**Required subscriber permissions**: none
1601
1602**Value**: "usual.event.bluetooth.remotedevice.CONNECT_CANCEL"
1603
1604
1605### COMMON_EVENT_BLUETOOTH_HANDSFREEUNIT_CONNECT_STATE_UPDATE
1606(Reserved, not supported yet) Indicates the common event that the connection state of a Bluetooth handsfree has changed.
1607
1608**System capability**: SystemCapability.Notification.CommonEvent
1609
1610**Required subscriber permissions**: none
1611
1612**Value**: "usual.event.bluetooth.handsfreeunit.CONNECT_STATE_UPDATE"
1613
1614
1615### COMMON_EVENT_BLUETOOTH_HANDSFREEUNIT_AUDIO_STATE_UPDATE
1616(Reserved, not supported yet) Indicates the common event that the audio state of a Bluetooth handsfree has changed.
1617
1618**System capability**: SystemCapability.Notification.CommonEvent
1619
1620**Required subscriber permissions**: none
1621
1622**Value**: "usual.event.bluetooth.handsfreeunit.AUDIO_STATE_UPDATE"
1623
1624
1625### COMMON_EVENT_BLUETOOTH_HANDSFREEUNIT_AG_COMMON_EVENT
1626(Reserved, not supported yet) Indicates the common event that the audio gateway state of a Bluetooth handsfree has changed.
1627
1628**System capability**: SystemCapability.Notification.CommonEvent
1629
1630**Required subscriber permissions**: none
1631
1632**Value**: "usual.event.bluetooth.handsfreeunit.AG_COMMON_EVENT"
1633
1634
1635### COMMON_EVENT_BLUETOOTH_HANDSFREEUNIT_AG_CALL_STATE_UPDATE
1636(Reserved, not supported yet) Indicates the common event that the calling state of a Bluetooth handsfree has changed.
1637
1638**System capability**: SystemCapability.Notification.CommonEvent
1639
1640**Required subscriber permissions**: none
1641
1642**Value**: "usual.event.bluetooth.handsfreeunit.AG_CALL_STATE_UPDATE"
1643
1644
1645### COMMON_EVENT_BLUETOOTH_HOST_STATE_UPDATE
1646Indicates the common event that the state of a Bluetooth adapter has been changed, for example, Bluetooth has been enabled or disabled.
1647
1648**System capability**: SystemCapability.Notification.CommonEvent
1649
1650**Required subscriber permissions**: none
1651
1652**Value**: "usual.event.bluetooth.host.STATE_UPDATE"
1653
1654
1655### COMMON_EVENT_BLUETOOTH_HOST_REQ_DISCOVERABLE
1656(Reserved, not supported yet) Indicates the common event about the request for the user to allow Bluetooth device scanning.
1657
1658**System capability**: SystemCapability.Notification.CommonEvent
1659
1660**Required subscriber permissions**: none
1661
1662**Value**: "usual.event.bluetooth.host.REQ_DISCOVERABLE"
1663
1664
1665### COMMON_EVENT_BLUETOOTH_HOST_REQ_ENABLE
1666(Reserved, not supported yet) Indicates the common event about the request for the user to enable Bluetooth.
1667
1668**System capability**: SystemCapability.Notification.CommonEvent
1669
1670**Required subscriber permissions**: ohos.permission.USE_BLUETOOTH
1671
1672**Value**: "usual.event.bluetooth.host.REQ_ENABLE"
1673
1674### COMMON_EVENT_BLUETOOTH_HOST_REQ_DISABLE
1675(Reserved, not supported yet) Indicates the common event about the request for the user to disable Bluetooth.
1676
1677**System capability**: SystemCapability.Notification.CommonEvent
1678
1679**Required subscriber permissions**: ohos.permission.USE_BLUETOOTH
1680
1681**Value**: "usual.event.bluetooth.host.REQ_DISABLE"
1682
1683
1684### COMMON_EVENT_BLUETOOTH_HOST_SCAN_MODE_UPDATE
1685(Reserved, not supported yet) Indicates the common event that the Bluetooth scanning mode of a device has changed.
1686
1687**System capability**: SystemCapability.Notification.CommonEvent
1688
1689**Required subscriber permissions**: ohos.permission.USE_BLUETOOTH
1690
1691**Value**: "usual.event.bluetooth.host.SCAN_MODE_UPDATE"
1692
1693
1694### COMMON_EVENT_BLUETOOTH_HOST_DISCOVERY_STARTED
1695Indicates the common event that the Bluetooth scanning has been started on the device.
1696
1697**System capability**: SystemCapability.Notification.CommonEvent
1698
1699**Required subscriber permissions**: ohos.permission.ACCESS_BLUETOOTH
1700
1701**Value**: "usual.event.bluetooth.host.DISCOVERY_STARTED"
1702
1703
1704### COMMON_EVENT_BLUETOOTH_HOST_DISCOVERY_FINISHED
1705Indicates the common event that the Bluetooth scanning is finished on the device.
1706
1707**System capability**: SystemCapability.Notification.CommonEvent
1708
1709**Required subscriber permissions**: ohos.permission.ACCESS_BLUETOOTH
1710
1711**Value**: "usual.event.bluetooth.host.DISCOVERY_FINISHED"
1712
1713
1714### COMMON_EVENT_BLUETOOTH_HOST_NAME_UPDATE
1715Indicates the common event that the Bluetooth adapter name of the device has changed.
1716
1717**System capability**: SystemCapability.Notification.CommonEvent
1718
1719**Required subscriber permissions**: ohos.permission.ACCESS_BLUETOOTH
1720
1721**Value**: "usual.event.bluetooth.host.NAME_UPDATE"
1722
1723
1724### COMMON_EVENT_BLUETOOTH_A2DPSINK_CONNECT_STATE_UPDATE
1725(Reserved, not supported yet) Indicates the common event that the connection state of Bluetooth A2DP Sink has changed.
1726
1727**System capability**: SystemCapability.Notification.CommonEvent
1728
1729**Required subscriber permissions**: ohos.permission.USE_BLUETOOTH
1730
1731**Value**: "usual.event.bluetooth.a2dpsink.CONNECT_STATE_UPDATE"
1732
1733### COMMON_EVENT_BLUETOOTH_A2DPSINK_PLAYING_STATE_UPDATE
1734(Reserved, not supported yet) Indicates the common event that the playing state of Bluetooth A2DP Sink has changed.
1735
1736**System capability**: SystemCapability.Notification.CommonEvent
1737
1738**Required subscriber permissions**: ohos.permission.USE_BLUETOOTH
1739
1740**Value**: "usual.event.bluetooth.a2dpsink.PLAYING_STATE_UPDATE"
1741
1742
1743### COMMON_EVENT_BLUETOOTH_A2DPSINK_AUDIO_STATE_UPDATE
1744(Reserved, not supported yet) Indicates the common event that the audio state of Bluetooth A2DP Sink has changed.
1745
1746**System capability**: SystemCapability.Notification.CommonEvent
1747
1748**Required subscriber permissions**: ohos.permission.USE_BLUETOOTH
1749
1750**Value**: "usual.event.bluetooth.a2dpsink.AUDIO_STATE_UPDATE"
1751
1752
1753### COMMON_EVENT_ABILITY_ADDED
1754(Reserved, not supported yet) Indicates the common event that an ability has been added.
1755
1756**System capability**: SystemCapability.Notification.CommonEvent
1757
1758**Required subscriber permissions**: ohos.permission.LISTEN_BUNDLE_CHANGE
1759
1760**Value**: "usual.event.ABILITY_ADDED"
1761
1762
1763### COMMON_EVENT_ABILITY_REMOVED
1764(Reserved, not supported yet) Indicates the common event that an ability has been removed.
1765**System capability**: SystemCapability.Notification.CommonEvent
1766
1767**Required subscriber permissions**: ohos.permission.LISTEN_BUNDLE_CHANGE
1768
1769**Value**: "usual.event.ABILITY_REMOVED"
1770
1771### COMMON_EVENT_ABILITY_UPDATED
1772(Reserved, not supported yet) Indicates the common event that an ability has been updated.
1773
1774**System capability**: SystemCapability.Notification.CommonEvent
1775
1776**Required subscriber permissions**: ohos.permission.LISTEN_BUNDLE_CHANGE
1777
1778**Value**: "usual.event.ABILITY_UPDATED"
1779
1780
1781### COMMON_EVENT_LOCATION_MODE_STATE_CHANGED
1782(Reserved, not supported yet) Indicates the common event that the location mode of the system has changed.
1783
1784**System capability**: SystemCapability.Notification.CommonEvent
1785
1786**Required subscriber permissions**: none
1787
1788**Value**: "usual.event.location.MODE_STATE_CHANGED"
1789
1790
1791### COMMON_EVENT_IVI_SLEEP
1792(Reserved, not supported yet) Indicates the common event that the in-vehicle infotainment (IVI) system of a vehicle is sleeping.
1793
1794**System capability**: SystemCapability.Notification.CommonEvent
1795
1796**Required subscriber permissions**: none
1797
1798**Value**: "common.event.IVI_SLEEP"
1799
1800
1801### COMMON_EVENT_IVI_PAUSE
1802(Reserved, not supported yet) Indicates the common event that the IVI system of a vehicle has entered sleep mode and the playing application is instructed to stop playback.
1803
1804
1805**System capability**: SystemCapability.Notification.CommonEvent
1806
1807**Required subscriber permissions**: none
1808
1809**Value**: "common.event.IVI_PAUSE"
1810
1811### COMMON_EVENT_IVI_STANDBY
1812(Reserved, not supported yet) Indicates the common event that a third-party application is instructed to pause the current work.
1813
1814**System capability**: SystemCapability.Notification.CommonEvent
1815
1816**Required subscriber permissions**: none
1817
1818**Value**: "common.event.IVI_STANDBY"
1819
1820
1821### COMMON_EVENT_IVI_LASTMODE_SAVE
1822(Reserved, not supported yet) Indicates the common event that a third-party application is instructed to save its last mode.
1823
1824**System capability**: SystemCapability.Notification.CommonEvent
1825
1826**Required subscriber permissions**: none
1827
1828**Value**: "common.event.IVI_LASTMODE_SAVE"
1829
1830
1831### COMMON_EVENT_IVI_VOLTAGE_ABNORMAL
1832(Reserved, not supported yet) Indicates the common event that the voltage of the vehicle's power system is abnormal.
1833
1834**System capability**: SystemCapability.Notification.CommonEvent
1835
1836**Required subscriber permissions**: none
1837
1838**Value**: "common.event.IVI_VOLTAGE_ABNORMAL"
1839
1840
1841### COMMON_EVENT_IVI_HIGH_TEMPERATURE
1842
1843(Reserved, not supported yet) Indicates the common event that the temperature of the IVI system is high.
1844
1845**System capability**: SystemCapability.Notification.CommonEvent
1846
1847**Required subscriber permissions**: none
1848
1849**Value**: "common.event.IVI_HIGH_TEMPERATURE"
1850
1851
1852### COMMON_EVENT_IVI_EXTREME_TEMPERATURE
1853(Reserved, not supported yet) Indicates the common event that the temperature of the IVI system is extremely high.
1854
1855**System capability**: SystemCapability.Notification.CommonEvent
1856
1857**Required subscriber permissions**: none
1858
1859**Value**: "common.event.IVI_EXTREME_TEMPERATURE"
1860
1861### COMMON_EVENT_IVI_TEMPERATURE_ABNORMAL
1862(Reserved, not supported yet) Indicates the common event that the IVI system has an extreme temperature.
1863
1864
1865**System capability**: SystemCapability.Notification.CommonEvent
1866
1867**Required subscriber permissions**: none
1868
1869**Value**: "common.event.IVI_TEMPERATURE_ABNORMAL"
1870
1871
1872### COMMON_EVENT_IVI_VOLTAGE_RECOVERY
1873(Reserved, not supported yet) Indicates the common event that the voltage of the vehicle's power system is restored to normal.
1874
1875**System capability**: SystemCapability.Notification.CommonEvent
1876
1877**Required subscriber permissions**: none
1878
1879**Value**: "common.event.IVI_VOLTAGE_RECOVERY"
1880
1881
1882### COMMON_EVENT_IVI_TEMPERATURE_RECOVERY
1883(Reserved, not supported yet) Indicates the common event that the temperature of the IVI system is restored to normal.
1884
1885**System capability**: SystemCapability.Notification.CommonEvent
1886
1887**Required subscriber permissions**: none
1888
1889**Value**: "common.event.IVI_TEMPERATURE_RECOVERY"
1890
1891
1892### COMMON_EVENT_IVI_ACTIVE
1893(Reserved, not supported yet) Indicates the common event that the battery service is active.
1894
1895**System capability**: SystemCapability.Notification.CommonEvent
1896
1897**Required subscriber permissions**: none
1898
1899**Value**: "common.event.IVI_ACTIVE"
1900
1901### COMMON_EVENT_VISIBLE_ACCOUNTS_UPDATED
1902(Reserved, not supported yet) Indicates the common event that the account visibility changed.
1903
1904**System capability**: SystemCapability.Notification.CommonEvent
1905
1906**Required subscriber permissions**: ohos.permission.GET_APP_ACCOUNTS (for system applications only)
1907
1908**Value**: "usual.event.data.VISIBLE_ACCOUNTS_UPDATED"
1909
1910
1911### COMMON_EVENT_ACCOUNT_DELETED
1912(Reserved, not supported yet) Indicates the common event that the account was deleted.
1913
1914**System capability**: SystemCapability.Notification.CommonEvent
1915
1916**Required subscriber permissions**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS (for system applications only)
1917
1918**Value**: "usual.event.data.ACCOUNT_DELETED"
1919
1920### COMMON_EVENT_FOUNDATION_READY
1921(Reserved, not supported yet) Indicates the common event that the foundation is ready.
1922
1923**System capability**: SystemCapability.Notification.CommonEvent
1924
1925**Required subscriber permissions**: ohos.permission.RECEIVER_STARTUP_COMPLETED (for system applications only)
1926
1927**Value**: "usual.event.data.FOUNDATION_READY"
1928
1929### COMMON_EVENT_SPN_INFO_CHANGED
1930Indicates the common event of that the SPN information had changed.
1931
1932**System capability**: SystemCapability.Notification.CommonEvent
1933
1934**Required subscriber permissions**: none
1935
1936**Value**: "usual.event.SPN_INFO_CHANGED"
1937
1938