# System Common Events (System API)

This topic provides a list of common events defined by the system.

Common event types are defined in [Support enumeration of the ohos.commonEventManager module](../js-apis-commonEventManager.md#support).

> **NOTE**
>
> The current page contains only the system APIs of this module. For details about other public APIs, see [System Common Events](../common_event/commonEventManager-definitions.md).




## Ability Kit


### COMMON_EVENT_BOOT_COMPLETED

Indicates that the boot is complete and the system is loaded.

When the specified user finishes the boot process on the device, the common event service is triggered to publish this event.

**System API**: This is a system API.

**System capability**: SystemCapability.Notification.CommonEvent

**Required permissions**: ohos.permission.RECEIVER_STARTUP_COMPLETED (for system applications only)


**Value**: "usual.event.BOOT_COMPLETED"



### COMMON_EVENT_PACKAGE_INSTALLATION_STARTED<sup>12+</sup>

Indicates that a package is sent by the system verifier when the package is verified.

When a new application starts to be installed by a specified user on the device, the common event service is triggered to publish this event.

**System API**: This is a system API.

**System capability**: SystemCapability.Notification.CommonEvent

**Required permissions**: none

**Value**: "usual.event.PACKAGE_INSTALLATION_STARTED"


### COMMON_EVENT_BUNDLE_RESOURCES_CHANGED<sup>15+</sup>

Indicates the common event of updating bundle management resource data.

This common event is sent when the bundle management resource data is updated in scenarios such as language or theme switching.

**System API**: This is a system API.

**System capability**: SystemCapability.Notification.CommonEvent

**Required permissions**: ohos.permission.GET_BUNDLE_RESOURCES

**Value**: "usual.event.BUNDLE_RESOURCES_CHANGED"


### COMMON_EVENT_DEFAULT_APPLICATION_CHANGED<sup>19+</sup>

Indicates that the default application for opening a file has changed.

This common event is sent when the default application for opening a file changes.

**System API**: This is a system API.

**System capability**: SystemCapability.Notification.CommonEvent

**Required permissions**: ohos.permission.CHANGE_DEFAULT_APPLICATION

**Value:** "usual.event.DEFAULT_APPLICATION_CHANGED"


### COMMON_EVENT_SHORTCUT_CHANGED<sup>20+</sup>

Indicates that the application shortcut has changed.

This common event is sent when the shortcut is changed (for example, when [setShortcutVisibleForSelf](../../apis-ability-kit/js-apis-shortcutManager.md#shortcutmanagersetshortcutvisibleforself) of the shortcutManager module is successfully called).

**System API**: This is a system API.

**System capability**: SystemCapability.Notification.CommonEvent

**Required permissions**: ohos.permission.MANAGE_SHORTCUTS

**Value:** "usual.event.SHORTCUT_CHANGED"


### COMMON_EVENT_KIOSK_MODE_ON<sup>20+</sup>

Indicates that the kiosk mode is enabled. When this mode is on, the common event service is triggered to publish this system common event.  

**System API**: This is a system API.

**System capability**: SystemCapability.Notification.CommonEvent

**Required permissions**: none

**Value:** usual.event.KIOSK_MODE_ON


### COMMON_EVENT_KIOSK_MODE_OFF<sup>20+</sup>

Indicates that the kiosk mode is disabled. When this mode is off, the common event service is triggered to publish this system common event.

**System API**: This is a system API.

**System capability**: SystemCapability.Notification.CommonEvent

**Required permissions**: none

**Value:** usual.event.KIOSK_MODE_OFF


## Background Tasks Kit 

### COMMON_EVENT_DEVICE_IDLE_EXEMPTION_LIST_UPDATED<sup>10+</sup>

Indicates that the exemption list for resource usage restrictions has been updated in idle mode.

When the exemption list for resource usage restrictions is updated, the common event service is triggered to publish this event.
Resources include application network access, Timer usage, and WorkScheduler task usage.

System applications can call JavaScript APIs to apply for removing resource usage restrictions.

**System API**: This is a system API.

**System capability**: SystemCapability.Notification.CommonEvent

**Required permissions**: none

**Value**: "usual.event.DEVICE_IDLE_EXEMPTION_LIST_UPDATED"

## Basic Services Kit - Customization

### COMMON_EVENT_CUSTOM_CONFIG_POLICY_UPDATED<sup>20+</sup>

Indicates that the configuration directory level and system parameters of a device are updated.

This common event is sent when the system updates the device configuration directory level and system parameters after identifying the home area and roaming area of the device.

**System API**: This is a system API.

**System capability**: SystemCapability.Notification.CommonEvent

**Required permissions**: none

**Value:** "usual.event.CUSTOM_CONFIG_POLICY_UPDATED"

### COMMON_EVENT_CUSTOM_ROAMING_REGION_UPDATED<sup>20+</sup>

Indicates that the roaming area of a device is updated.

When the attributes such as network injection, persistent Connection, and GPS location of a device change, the system identifies the roaming area and updates the parameters if the roaming area changes. After the update is complete, this common event is sent.

**System API**: This is a system API.

**System capability**: SystemCapability.Notification.CommonEvent

**Required permissions**: none

**Value:** "usual.event.CUSTOM_ROAMING_REGION_UPDATED"

## Basic Services Kit - Power Supply

### COMMON_EVENT_CHARGE_TYPE_CHANGED<sup>10+</sup>

Indicates that the system charging type has changed.

When the system charging type changes, the common event service is triggered to publish this event.

**System API**: This is a system API.

**System capability**: SystemCapability.Notification.CommonEvent

**Required permissions**: none

**Value**: "usual.event.CHARGE_TYPE_CHANGED"


### COMMON_EVENT_USER_ADDED

Indicates that a user has been added to the system.

When a system account is created, the common event service is triggered to publish this event carrying the system account ID.

APIs related to this event: **createOsAccount** and **createOsAccountForDomain**. These APIs are system APIs. For details, see [@ohos.account.osAccount (System Account Management)](../js-apis-osAccount.md).

**System API**: This is a system API.

**System capability**: SystemCapability.Notification.CommonEvent

**Required permissions**: ohos.permission.MANAGE_LOCAL_ACCOUNTS (for system applications only)

**Value**: "usual.event.USER_ADDED"


### COMMON_EVENT_USER_REMOVED

Indicates that a user has been removed from the system.

When a system account is removed, the common event service is triggered to publish this event carrying the system account ID.

APIs related to this event: **removeOsAccount**. This API is a system API. For details, see [@ohos.account.osAccount (System Account Management)](../js-apis-osAccount.md).

**System API**: This is a system API.

**System capability**: SystemCapability.Notification.CommonEvent

**Required permissions**: ohos.permission.MANAGE_LOCAL_ACCOUNTS (for system applications only)

**Value**: "usual.event.USER_REMOVED"


### COMMON_EVENT_DOMAIN_ACCOUNT_STATUS_CHANGED

Indicates that the status of the domain account status changes.

When a domain user account is authenticated, deleted, or has the token updated, the common event service is triggered to publish this event carrying the system account ID, domain name, and account status.

APIs related to this event: **removeOsAccount**, **DomainAccountManager.auth**, and **updateAccountToken**. These APIs are system APIs. For details, see [@ohos.account.osAccount (System Account Management)](../js-apis-osAccount.md).

**System API**: This is a system API.

**System capability**: SystemCapability.Notification.CommonEvent

**Required permissions**: ohos.permission.GET_LOCAL_ACCOUNTS (for system applications only)

**Value**: "usual.event.DOMAIN_ACCOUNT_STATUS_CHANGED"


### COMMON_EVENT_USER_SWITCHED

Indicates that a user switchover is complete.

When a system account is switched, the common event service is triggered to publish this event carrying the system account ID.

APIs related to this event: **activateOsAccount**. This API is a system API. For details, see [@ohos.account.osAccount (System Account Management)](../js-apis-osAccount.md).

**System API**: This is a system API.

**System capability**: SystemCapability.Notification.CommonEvent

**Required permissions**: ohos.permission.MANAGE_LOCAL_ACCOUNTS (for system applications only)

**Value**: "usual.event.USER_SWITCHED"


### COMMON_EVENT_USER_LOCKING

Indicates that a user is about to be locked.

Before a user is locked, the common event service is triggered to publish this event carrying the system account ID.

**System API**: This is a system API.

**System capability**: SystemCapability.Notification.CommonEvent

**Value**: "usual.event.USER_LOCKING"


### COMMON_EVENT_USER_LOCKED

Indicates that a user is locked.

After a user is locked, the common event service is triggered to publish this event carrying the system account ID.

**System API**: This is a system API.

**System capability**: SystemCapability.Notification.CommonEvent

**Value**: "usual.event.USER_LOCKED"


## Core File Kit

This document lists the common system events provided by the file management subsystem to applications. Applications can use [APIs](../js-apis-commonEventManager.md) to subscribe to common system events.


### COMMON_EVENT_VOLUME_REMOVED

Indicates that an external storage device was removed.

This common event is triggered when an external storage device is removed.

**System API**: This is a system API.

**System capability**: SystemCapability.Notification.CommonEvent

**Required permissions**: ohos.permission.STORAGE_MANAGER

**Value**: "usual.event.data.VOLUME_REMOVED"



### COMMON_EVENT_VOLUME_UNMOUNTED

Indicates that an external storage device was unmounted.

This common event is triggered when an external storage device is successfully unmounted by calling the **unmount** API or by removing the device.

**System API**: This is a system API.

**System capability**: SystemCapability.Notification.CommonEvent

**Required permissions**: ohos.permission.STORAGE_MANAGER

**Value**: "usual.event.data.VOLUME_UNMOUNTED"


### COMMON_EVENT_VOLUME_MOUNTED

Indicates that an external storage device was mounted.

This common event is triggered when an external storage device is successfully mounted by calling the **mount** API or by inserting the device.

**System API**: This is a system API.

**System capability**: SystemCapability.Notification.CommonEvent

**Required permissions**: ohos.permission.STORAGE_MANAGER

**Value**: "usual.event.data.VOLUME_MOUNTED"


### COMMON_EVENT_VOLUME_BAD_REMOVAL

Indicates that an external storage device was removed without being unmounted.

This common event is triggered when an external storage device is directly removed without being unmounted.

**System API**: This is a system API.

**System capability**: SystemCapability.Notification.CommonEvent

**Required permissions**: ohos.permission.STORAGE_MANAGER

**Value**: "usual.event.data.VOLUME_BAD_REMOVAL"


### COMMON_EVENT_VOLUME_EJECT

Indicates that an external storage device is about to be ejected.

This common event is triggered when the user calls the **unmount** API on a mounted external storage device or removes the device.

**System API**: This is a system API.

**System capability**: SystemCapability.Notification.CommonEvent

**Required permissions**: ohos.permission.STORAGE_MANAGER

**Value**: "usual.event.data.VOLUME_EJECT"


### COMMON_EVENT_RESTORE_START<sup>13+</sup>

Indicates the common event that an application starts to be restored.

When a data migration application starts the backup and restore framework to perform a restoration task, the common event service is triggered to publish this event.

**System API**: This is a system API.

**System capability**: SystemCapability.Notification.CommonEvent

**Required permissions**: ohos.permission.START_RESTORE_NOTIFICATION

**Value**: "usual.event.RESTORE_START"


## Media Kit

### COMMON_EVENT_SCREEN_SHARE

Indicates that a screen sharing event has occurred in the system.

This is a protected common event and can be sent only by the system.

**System API**: This is a system API.

**System capability**: SystemCapability.Notification.CommonEvent

**Required permissions**: ohos.permission.RECEIVE_SMS (for system applications only)

**Value**: usual.event.SCREEN_SHARE


## Telephony Kit

### COMMON_EVENT_SMS_RECEIVE_COMPLETED<sup>10+</sup>

Indicates that an SMS message is received.

When the device receives an SMS message, the common event service is triggered to publish this event.

**System API**: This is a system API.

**System capability**: SystemCapability.Notification.CommonEvent

**Required permissions**: ohos.permission.RECEIVE_SMS (for system applications only)

**Value**: usual.event.SMS_RECEIVED_COMPLETED


### COMMON_EVENT_SMS_EMERGENCY_CB_RECEIVE_COMPLETED<sup>10+</sup>

Indicates that an emergency cell broadcast message is received.

When the device receives an emergency cell broadcast message, the common event service is triggered to publish this event.

**System API**: This is a system API.

**System capability**: SystemCapability.Notification.CommonEvent

**Required permissions**: ohos.permission.RECEIVE_SMS (for system applications only)

**Value**: usual.event.SMS_EMERGENCY_CB_RECEIVE_COMPLETED


### COMMON_EVENT_SMS_CB_RECEIVE_COMPLETED<sup>10+</sup>

Indicates that a cell broadcast message is received.

When the device receives a cell broadcast message, the common event service is triggered to publish this event.

**System API**: This is a system API.

**System capability**: SystemCapability.Notification.CommonEvent

**Required permissions**: ohos.permission.RECEIVE_SMS (for system applications only)

**Value**: usual.event.SMS_CB_RECEIVE_COMPLETED





### COMMON_EVENT_OPERATOR_CONFIG_CHANGED<sup>10+</sup>

Indicates that the carrier configuration has been updated.

When the carrier configuration of the device is updated, the common event service is triggered to publish this event.

**System API**: This is a system API.

**System capability**: SystemCapability.Notification.CommonEvent

**Required permissions**: none

**Value**: usual.event.OPERATOR_CONFIG_CHANGED


### COMMON_EVENT_SIM_CARD_DEFAULT_SMS_SUBSCRIPTION_CHANGED<sup>10+</sup>

Indicates that the default primary SIM card for the SMS service has been updated.

When the default primary SIM card for the SMS service is updated, the common event service is triggered to publish this event.

**System API**: This is a system API.

**System capability**: SystemCapability.Notification.CommonEvent

**Required permissions**: none

**Value**: usual.event.DEFAULT_SMS_SUBSCRIPTION_CHANGED


### COMMON_EVENT_SIM_CARD_DEFAULT_DATA_SUBSCRIPTION_CHANGED<sup>10+</sup>

Indicates that the default primary SIM card for the data service has been updated.

When the default primary SIM card for the data service is updated, the common event service is triggered to publish this event.

**System API**: This is a system API.

**System capability**: SystemCapability.Notification.CommonEvent

**Required permissions**: none

**Value**: usual.event.DEFAULT_DATA_SUBSCRIPTION_CHANGED


### COMMON_EVENT_SIM_CARD_DEFAULT_MAIN_SUBSCRIPTION_CHANGED<sup>10+</sup>

Indicates that the default primary SIM card of the device has been updated.

When the default primary SIM card of the device is updated, the common event service is triggered to publish this event.

**System API**: This is a system API.

**System capability**: SystemCapability.Notification.CommonEvent

**Required permissions**: none

**Value**: usual.event.SIM.DEFAULT_MAIN_SUBSCRIPTION_CHANGED


### COMMON_EVENT_SET_PRIMARY_SLOT_STATUS<sup>11+</sup>

Indicates that the status of the action for setting the primary SIM card changes.

When the status of the action for setting the primary SIM card changes (for example, when the status is updated to executing or completed), the common event service is triggered to publish this event.

**System API**: This is a system API.

**System capability**: SystemCapability.Notification.CommonEvent

**Required permissions**: none

**Value**: usual.event.SET_PRIMARY_SLOT_STATUS


### COMMON_EVENT_PRIMARY_SLOT_ROAMING<sup>11+</sup>

Indicates that the roaming status of the default primary SIM card is updated.

When the roaming status of the default primary SIM card changes, the common event service is triggered to publish this event.

**System API**: This is a system API.

**System capability**: SystemCapability.Notification.CommonEvent

**Required permissions**: none

**Value**: usual.event.PRIMARY_SLOT_ROAMING


### COMMON_EVENT_SIM_CARD_DEFAULT_VOICE_SUBSCRIPTION_CHANGED<sup>10+</sup>

Indicates that the default primary SIM card for the voice service has been updated. 

When the default primary SIM card for the voice service is updated, the common event service is triggered to publish this event.

**System API**: This is a system API.

**System capability**: SystemCapability.Notification.CommonEvent

**Required permissions**: none

**Value**: usual.event.DEFAULT_VOICE_SUBSCRIPTION_CHANGED


### COMMON_EVENT_CELLULAR_DATA_STATE_CHANGED<sup>10+</sup>

Indicates that the cellular data state has been updated.

When the cellular data state of the device is updated, the common event service is triggered to publish this event.

**System API**: This is a system API.

**System capability**: SystemCapability.Notification.CommonEvent

**Required permissions**: none

**Value**: usual.event.CELLULAR_DATA_STATE_CHANGED


### COMMON_EVENT_INCOMING_CALL_MISSED<sup>10+</sup>

Indicates that an incoming call is missed.

When an incoming call is missed on the device, the common event service is triggered to publish this event.

**System API**: This is a system API.

**System capability**: SystemCapability.Notification.CommonEvent

**Required permissions**: ohos.permission.GET_TELEPHONY_STATE (for system applications only)

**Value**: usual.event.INCOMING_CALL_MISSED


### COMMON_EVENT_RADIO_STATE_CHANGE<sup>10+</sup>

Indicates that the radio state of the device has changed.

When there is a change in the radio state of the device, the common event service is triggered to publish this event.

**System API**: This is a system API.

**System capability**: SystemCapability.Notification.CommonEvent

**Required permissions**: none

**Value**: usual.event.RADIO_STATE_CHANGE


### COMMON_EVENT_SPECIAL_CODE<sup>10+</sup>

Indicates that a secret code is sent successfully.

When a secret code is successfully sent on the device, the common event service is triggered to publish this event.

**System API**: This is a system API.

**System capability**: SystemCapability.Notification.CommonEvent

**Required permissions**: none

**Value**: usual.event.DIALER_SPECIAL_CODE


### COMMON_EVENT_AUDIO_QUALITY_CHANGE<sup>10+</sup>

Indicates that the audio quality has changed.

When there is a change in the audio quality of the device, the common event service is triggered to publish this event.

**System API**: This is a system API.

**System capability**: SystemCapability.Notification.CommonEvent

**Required permissions**: none

**Value**: usual.event.AUDIO_QUALITY_CHANGE


## Reserved Common Event

Below are reserved common events that are not supported yet.

### COMMON_EVENT_STK_COMMAND<sup>10+</sup>

(Reserved, not supported yet) Indicates that an STK command is sent.

When an STK command is sent, the common event service is triggered to publish this event.

**System API**: This is a system API.

**System capability**: SystemCapability.Notification.CommonEvent

**Required permissions**: none

**Value**: usual.event.STK_COMMAND


### COMMON_EVENT_STK_SESSION_END<sup>10+</sup>

(Reserved, not supported yet) Indicates that an STK session has ended.

When an STK session ends, the common event service is triggered to publish this event.

**System API**: This is a system API.

**System capability**: SystemCapability.Notification.CommonEvent

**Required permissions**: none

**Value**: usual.event.STK_SESSION_END


### COMMON_EVENT_STK_CARD_STATE_CHANGED<sup>10+</sup>

(Reserved, not supported yet) Indicates that the STK card state has been updated.

When the STK card state is updated, the common event service is triggered to publish this event.

**System API**: This is a system API.

**System capability**: SystemCapability.Notification.CommonEvent

**Required permissions**: none


**Value**: usual.event.STK_CARD_STATE_CHANGED

### COMMON_EVENT_STK_ALPHA_IDENTIFIER<sup>10+</sup>

(Reserved, not supported yet) Indicates that an STK Alpha identifier is sent.

When an STK Alpha identifier is sent, the common event service is triggered to publish this event.

**System API**: This is a system API.

**System capability**: SystemCapability.Notification.CommonEvent

**Required permissions**: none

**Value**: usual.event.STK_ALPHA_IDENTIFIER


### COMMON_EVENT_SMS_WAPPUSH_RECEIVE_COMPLETED<sup>10+</sup>

(Reserved, not supported yet) Indicates that a WAP push message is received.

When the device receives a WAP push message, the common event service is triggered to publish this event.

**System API**: This is a system API.

**System capability**: SystemCapability.Notification.CommonEvent

**Required permissions**: ohos.permission.RECEIVE_SMS (for system applications only)

**Value**: usual.event.SMS_WAPPUSH_RECEIVE_COMPLETED