System Common Events
This topic provides a list of common events defined by the system. Common event types are defined in Support of the ohos.commonEventManager module.
NOTE
The initial APIs of this module are supported since API version 9. Newly added APIs will be marked with a superscript to indicate their earliest API version.
Ability Kit
COMMON_EVENT_PACKAGE_RESTARTED
Indicates that the user has restarted the application package and killed all its processes.
When the specified user restarts the application and kills all its processes, the event notification service is triggered to publish this event.
NOTE
System applications can listen for the restart event of themselves and other applications.Third-party applications can only listen for the restart event of themselves.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.PACKAGE_RESTARTED
COMMON_EVENT_PACKAGE_DATA_CLEARED
Indicates that the user has cleared the application package data.
When the specified user clears the application package data on the device, the event notification service is triggered to publish this event.
NOTE
System applications can listen for the data clearance event of themselves and other applications.Third-party applications can only listen for the data clearance event of themselves.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.PACKAGE_DATA_CLEARED
COMMON_EVENT_QUICK_FIX_APPLY_RESULT
Indicates the result of applying a quick fix to the application.
When the specified user applies a quick fix to the application on the device, the event notification service is triggered to publish this event.
NOTE
System applications can listen for the quick fix event of themselves and other applications.Third-party applications can only listen for the quick fix event of themselves.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.QUICK_FIX_APPLY_RESULT
COMMON_EVENT_QUICK_FIX_REVOKE_RESULT10+
Indicates the result of revoking a quick fix to the application.
When a quick fix to the application is revoked on the device, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.QUICK_FIX_REVOKE_RESULT
COMMON_EVENT_PACKAGE_ADDED
Indicates that a new application package has been installed on the device.
When a new application is installed by a specified user on the device, the event notification service is triggered to publish this event.
NOTE
System applications can listen for the installation event of themselves and other applications.Third-party applications can only listen for the installation event of themselves.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.PACKAGE_ADDED
COMMON_EVENT_PACKAGE_REMOVED
Indicates that an installed application has been uninstalled from the device with the application data retained.
When a specified application package is removed by a specified user on the device, the event notification service is triggered to publish this event.
NOTE
System applications can listen for the uninstallation event of themselves and other applications.Third-party applications can only listen for the uninstallation event of themselves.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.PACKAGE_REMOVED
COMMON_EVENT_BUNDLE_REMOVED
Indicates that an installed bundle has been uninstalled from the device.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.BUNDLE_REMOVED
COMMON_EVENT_PACKAGE_FULLY_REMOVED
Indicates that an installed application has been completely uninstalled from the device.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.PACKAGE_FULLY_REMOVED
COMMON_EVENT_PACKAGE_CHANGED
Indicates that an application package has been changed (for example, an ability in the package has been enabled or disabled).
When 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.
NOTE
System applications can listen for the change event of themselves and other applications.Third-party applications can only listen for the change event of themselves.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.PACKAGE_CHANGED
COMMON_EVENT_PACKAGE_CACHE_CLEARED
Indicates that the user cleared the application package cache.
When the cache of an application package installed on the device is cleared, the event notification service is triggered to publish this event.
NOTE
System applications can listen for the cache clearance event of themselves and other applications.Third-party applications can only listen for the cache clearance event of themselves.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.PACKAGE_CACHE_CLEARED
COMMON_EVENT_PACKAGES_SUSPENDED
Indicates that application packages have been suspended.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.PACKAGES_SUSPENDED
COMMON_EVENT_MY_PACKAGE_SUSPENDED
Indicates that application packages have been suspended by the system.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.MY_PACKAGE_SUSPENDED
COMMON_EVENT_MY_PACKAGE_UNSUSPENDED
Indicates that application packages have been unsuspended by the system.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.MY_PACKAGE_UNSUSPENDED
COMMON_EVENT_MANAGE_PACKAGE_STORAGE
Notifies the low memory state and package management should be started.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.MANAGE_PACKAGE_STORAGE
Account Kit
COMMON_EVENT_MINORSMODE_ON12+
Indicates that the minor mode is enabled.
When the minor mode is enabled on the device, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Atomic service API: This API can be used in atomic services since API version 12.
Value: usual.event.MINORSMODE_ON
COMMON_EVENT_MINORSMODE_OFF12+
Indicates that the minor mode is disabled.
When the minor mode is disabled on the device, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Atomic service API: This API can be used in atomic services since API version 12.
Value: usual.event.MINORSMODE_OFF
ArkData
COMMON_EVENT_DATA_SHARE_READY12+
Indicates that the DataShare service is available.
After the DataShare service is started, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.DATA_SHARE_READY
ArkUI
COMMON_EVENT_SPLIT_SCREEN
Indicates a screen splitting action.
When 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.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Atomic service API: This API can be used in atomic services since API version 11.
Value: common.event.SPLIT_SCREEN
Notification Kit
COMMON_EVENT_SLOT_CHANGE
Indicates that the notification slot or notification switch settings have changed.
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.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.NOTIFICATION_CONTROLLER
Value: usual.event.SLOT_CHANGE
Background Tasks Kit
COMMON_EVENT_DEVICE_IDLE_MODE_CHANGED
Indicates that the system idle mode has changed.
When 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.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.DEVICE_IDLE_MODE_CHANGED
Basic Services Kit
COMMON_EVENT_USB_STATE
Indicates that the USB device state has changed.
When a USB device is connected to or disconnected from the device, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.hardware.usb.action.USB_STATE
COMMON_EVENT_USB_PORT_CHANGED
Indicates that the USB port state of the device has changed.
When the USB port state changes, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.hardware.usb.action.USB_PORT_CHANGED
COMMON_EVENT_USB_DEVICE_ATTACHED
Indicates that a USB device has been attached to the device functioning as a USB host.
When a USB device is attached, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.hardware.usb.action.USB_DEVICE_ATTACHED
COMMON_EVENT_USB_DEVICE_DETACHED
Indicates that a USB device has been detached from the device functioning as a USB host.
When a USB device is detached, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.hardware.usb.action.USB_DEVICE_DETACHED
COMMON_EVENT_TIME_CHANGED
Indicates that the system time is set.
When the system time is set, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.TIME_CHANGED
COMMON_EVENT_TIME_TICK
Indicates that the system time has changed.
When the system time in the unit of minute changes, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.TIME_TICK
COMMON_EVENT_TIMEZONE_CHANGED
Indicates that the system time zone has changed.
When the system time zone changes, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.TIMEZONE_CHANGED
COMMON_EVENT_USER_INFO_UPDATED
Indicates that the user information has been updated.
When 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.
APIs related to this event: setOsAccountName, setOsAccountProfilePhoto, and setOsAccountDistributedInfo. The first two are system APIs, and the last is a public API. For details, see @ohos.account.osAccount (System Account Management) and @ohos.account.distributedAccount (Distributed Account Management).
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.USER_INFO_UPDATED
COMMON_EVENT_USER_UNLOCKED
Indicates that the credential-encrypted storage has been unlocked for the current user after the device is restarted.
When 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.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.USER_UNLOCKED
COMMON_EVENT_DISTRIBUTED_ACCOUNT_LOGIN
Indicates a successful login from a distributed account.
When a distributed account is successfully logged in, the event notification service is triggered to publish this event carrying the system account ID.
APIs 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).
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Atomic service API: This API can be used in atomic services since API version 12.
Value: common.event.DISTRIBUTED_ACCOUNT_LOGIN
COMMON_EVENT_DISTRIBUTED_ACCOUNT_LOGOUT
Indicates a successful logout from a distributed account.
When a distributed account is successfully logged out, the event notification service is triggered to publish this event carrying the system account ID.
APIs 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).
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Atomic service API: This API can be used in atomic services since API version 12.
Value: common.event.DISTRIBUTED_ACCOUNT_LOGOUT
COMMON_EVENT_DISTRIBUTED_ACCOUNT_TOKEN_INVALID
Indicates that the token of a distributed account is invalid.
When the token of a distributed account is invalid, the event notification service is triggered to publish this event carrying the system account ID.
APIs 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).
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Atomic service API: This API can be used in atomic services since API version 12.
Value: common.event.DISTRIBUTED_ACCOUNT_TOKEN_INVALID
COMMON_EVENT_DISTRIBUTED_ACCOUNT_LOGOFF
Indicates that a distributed account is deregistered.
When a distributed account is deregistered, the event notification service is triggered to publish this event carrying the system account ID.
APIs 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).
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Atomic service API: This API can be used in atomic services since API version 12.
Value: common.event.DISTRIBUTED_ACCOUNT_LOGOFF
COMMON_EVENT_SCREEN_LOCKED
Indicates that the screen has been locked. When the screen is locked, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Atomic service API: This API can be used in atomic services since API version 11.
Value: usual.event.SCREEN_LOCKED
COMMON_EVENT_SCREEN_UNLOCKED
Indicates that the screen has been unlocked. When the screen is unlocked, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Atomic service API: This API can be used in atomic services since API version 11.
Value: usual.event.SCREEN_UNLOCKED
COMMON_EVENT_USER_PRESENT(deprecated)
Indicates the action of a common event that the user unlocks the device.
NOTE
This API is deprecated since API Version 10 and replaced by COMMON_EVENT_SCREEN_UNLOCKED.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.USER_PRESENT
COMMON_EVENT_BATTERY_CHANGED
Indicates that the charging state, level, and other information about the battery have changed.
When any of the following information changes, the event notification service is triggered to publish this event: battery level, 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, and battery charging type.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.BATTERY_CHANGED
COMMON_EVENT_BATTERY_LOW
Indicates that the battery level is low.
When 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. For details about how to set the low battery level percentage, see Battery Level Customization.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.BATTERY_LOW
COMMON_EVENT_BATTERY_OKAY
Indicates that the battery level is normal.
When the battery level changes from the low level to normal level, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.BATTERY_OKAY
COMMON_EVENT_POWER_CONNECTED
Indicates that the device is connected to an external power supply.
When the device connects to an external charger, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.POWER_CONNECTED
COMMON_EVENT_POWER_DISCONNECTED
Indicates that the device is disconnected from the external power supply.
When the device is disconnected from the external power supply, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.POWER_DISCONNECTED
COMMON_EVENT_DISCHARGING
Indicates that the system stops charging the battery.
When the system stops charging the battery, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.DISCHARGING
COMMON_EVENT_CHARGING
Indicates that the system starts charging the battery.
When the system starts charging the battery, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.CHARGING
COMMON_EVENT_CHARGE_IDLE_MODE_CHANGED10+
Indicates that the device enters the charging idle mode.
When the device starts charging in idle mode, and the temperature rise is acceptable, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.CHARGE_IDLE_MODE_CHANGED
COMMON_EVENT_SHUTDOWN
Indicates that the device is being shut down and the final shutdown will proceed.
When the device is being shut down until it is powered off, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.SHUTDOWN
COMMON_EVENT_SCREEN_OFF
Indicates that a device screen-off initiated by the power service is complete.
When the device screen-off initiated by the power service is complete, the event notification service is triggered to release this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.SCREEN_OFF
COMMON_EVENT_SCREEN_ON
Indicates that a device screen-on initiated by the power service is complete.
When the device screen-on initiated by the power service is complete, the event notification service is triggered to release this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.SCREEN_ON
COMMON_EVENT_POWER_SAVE_MODE_CHANGED
Indicates that the system power-saving mode has changed.
When the system power saving mode changes, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.POWER_SAVE_MODE_CHANGED
COMMON_EVENT_THERMAL_LEVEL_CHANGED
Indicates that the device's thermal level has changed.
When the device's thermal level changes, the event notification service is triggered to publish this event. For details about how to configure the device thermal level, see Thermal Level Customization.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.THERMAL_LEVEL_CHANGED
COMMON_EVENT_ENTER_FORCE_SLEEP12+
Indicates that the device is about to enter the forced sleep mode.
When 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.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.ENTER_FORCE_SLEEP
COMMON_EVENT_EXIT_FORCE_SLEEP12+
Indicates that the device exits the forced sleep mode.
When the device exits the forced sleep mode, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.EXIT_FORCE_SLEEP
COMMON_EVENT_ENTER_HIBERNATE15+
Indicates that the device is about to enter the hibernation mode.
When the device is about to enter the hibernation mode, the event notification service is triggered to publish this event. This event should be processed within one second.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.ENTER_HIBERNATE
COMMON_EVENT_EXIT_HIBERNATE15+
Indicates that the device exits the hibernation mode.
When the device exits the hibernation mode, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.EXIT_HIBERNATE
COMMON_EVENT_VOLUME_DECRYPTED
Indicates that specific volumes on the device have been decrypted.
When specific volumes on the device have been decrypted, the event notification service is triggered to publish this event.
Since: 26.0.0
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: "usual.event.VOLUME_DECRYPTED"
COMMON_EVENT_VOLUME_ENCRYPTED
Indicates that specific volumes on the device have been encrypted.
When specific volumes on the device have been encrypted, the event notification service is triggered to publish this event.
Since: 26.0.0
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: "usual.event.VOLUME_ENCRYPTED"
COMMON_EVENT_VOLUME_ENCRYPTION_POLICY_SET
Indicates that specific volumes on the device have had their encryption policy set.
When specific volumes on the device have had their encryption policy set, the event notification service is triggered to publish this event.
Since: 26.0.0
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.QUERY_VOLUME_ENCRYPTION_STATUS
Value: "usual.event.VOLUME_ENCRYPTION_POLICY_SET"
Connectivity Kit
COMMON_EVENT_BLUETOOTH_HANDSFREE_AG_CONNECT_STATE_CHANGE20+
Indicates that the Bluetooth HFP AG connection state changes.
When the Bluetooth HFP AG connection state changes, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.ACCESS_BLUETOOTH
Value: usual.event.bluetooth.handsfree.ag.CONNECT_STATE_CHANGE
COMMON_EVENT_BLUETOOTH_A2DPSOURCE_CONNECT_STATE_CHANGE20+
Indicates that the Bluetooth A2DP source connection state changes.
When the Bluetooth A2DP source connection state changes, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.ACCESS_BLUETOOTH
Value: usual.event.bluetooth.a2dpsource.CONNECT_STATE_CHANGE
COMMON_EVENT_BLUETOOTH_A2DPSOURCE_AVRCP_CONNECT_STATE_CHANGE20+
Indicates that the Bluetooth AVRCP connection state changes.
When the Bluetooth AVRCP connection state changes, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.ACCESS_BLUETOOTH
Value: usual.event.bluetooth.a2dpsource.AVRCP_CONNECT_STATE_CHANGE
COMMON_EVENT_BLUETOOTH_A2DPSOURCE_CODEC_VALUE_CHANGE20+
Indicates that the Bluetooth media codec changes.
When the Bluetooth media codec changes, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.ACCESS_BLUETOOTH
Value: usual.event.bluetooth.a2dpsource.CODEC_VALUE_CHANGE
COMMON_EVENT_BLUETOOTH_A2DPSOURCE_PLAY_STATE_CHANGE24+
Indicates that the Bluetooth A2DP playback state changes.
When the Bluetooth A2DP playback state changes, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.ACCESS_BLUETOOTH
Value: usual.event.bluetooth.a2dpsource.PLAY_STATE_CHANGE
COMMON_EVENT_BLUETOOTH_SCO_CONNECT_STATE_CHANGE24+
Indicates that the Bluetooth SCO state changes.
When the Bluetooth SCO state changes, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.ACCESS_BLUETOOTH
Value: usual.event.bluetooth.SCO_CONNECT_STATE_CHANGE
COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_ACL_STATE_CHANGE20+
Indicates that the Bluetooth ACL connection state changes.
When the Bluetooth ACL connection state changes, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.ACCESS_BLUETOOTH
Value: usual.event.bluetooth.remotedevice.ACL_STATE_CHANGE
COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_PAIR_STATE_CHANGE20+
Indicates that the Bluetooth pairing state changes.
When the Bluetooth pairing state changes, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.ACCESS_BLUETOOTH
Value: usual.event.bluetooth.remotedevice.PAIR_STATE_CHANGE
COMMON_EVENT_BLUETOOTH_HOST_SCAN_MODE_CHANGE23+
Indicates that the Bluetooth scanning mode changes.
When the Bluetooth scanning mode changes, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.ACCESS_BLUETOOTH
Value: usual.event.bluetooth.host.SCAN_MODE_CHANGE
COMMON_EVENT_NFC_ACTION_ADAPTER_STATE_CHANGED
Indicates that the state of the device NFC adapter has changed.
When the state of the device NFC adapter changes, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.nfc.action.ADAPTER_STATE_CHANGED
COMMON_EVENT_NFC_ACTION_RF_FIELD_ON_DETECTED
Indicates that the NFC RF field is on.
When the NFC RF field becomes available, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.nfc.action.RF_FIELD_ON_DETECTED
COMMON_EVENT_NFC_ACTION_RF_FIELD_OFF_DETECTED
Indicates that the NFC RF field is off.
When the NFC RF field becomes unavailable, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.nfc.action.RF_FIELD_OFF_DETECTED
COMMON_EVENT_WIFI_POWER_STATE
Indicates that the Wi-Fi state changes.
When the Wi-Fi state changes (such as enabled or disabled), the event notification service is triggered to release the system public event.
State 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.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.wifi.POWER_STATE
COMMON_EVENT_WIFI_SCAN_FINISHED
Indicates that a Wi-Fi access point is detected and proven to be available.
When a Wi-Fi access point is detected and proven to be available, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.LOCATION
Value: usual.event.wifi.SCAN_FINISHED
COMMON_EVENT_WIFI_SCAN_STATE
Indicates that the Wi-Fi access point state has changed.
When the Wi-Fi access point state changes, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.LOCATION
Value: usual.event.wifi.SCAN_STATE
COMMON_EVENT_WIFI_RSSI_VALUE
Indicates that the Wi-Fi signal strength (RSSI) has changed.
When the Wi-Fi signal strength (RSSI) changes, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.GET_WIFI_INFO
Value: usual.event.wifi.RSSI_VALUE
COMMON_EVENT_WIFI_CONN_STATE
Indicates that the Wi-Fi connection state has changed.
When the Wi-Fi connection state changes, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.wifi.CONN_STATE
COMMON_EVENT_WIFI_HOTSPOT_STATE
Indicates that the Wi-Fi hotspot state has changed.
When the Wi-Fi hotspot state changes, the event notification service is triggered to publish this event.
State 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.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.wifi.HOTSPOT_STATE
COMMON_EVENT_WIFI_AP_STA_JOIN
Indicates that a client has joined the Wi-Fi hotspot of the current device.
When a client joins the Wi-Fi hotspot of the current device, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.GET_WIFI_INFO
Value: usual.event.wifi.WIFI_HS_STA_JOIN
COMMON_EVENT_WIFI_AP_STA_LEAVE
Indicates that the client is disconnected from the Wi-Fi hotspot of the current device.
When a client is disconnected from the Wi-Fi hotspot of the current device, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.GET_WIFI_INFO
Value: usual.event.wifi.WIFI_HS_STA_LEAVE
COMMON_EVENT_WIFI_MPLINK_STATE_CHANGE
Indicates that the state of MPLINK (an enhanced Wi-Fi feature) has changed.
When the state of MPLINK changes, the event notification service is triggered to publish this event (not supported yet).
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.wifi.mplink.STATE_CHANGE
COMMON_EVENT_WIFI_P2P_CONN_STATE
Indicates that the Wi-Fi P2P connection state has changed.
When the Wi-Fi P2P connection state changes, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.GET_WIFI_INFO and ohos.permission.LOCATION
Value: usual.event.wifi.p2p.CONN_STATE_CHANGE
COMMON_EVENT_WIFI_P2P_STATE_CHANGED
Indicates that the Wi-Fi P2P state has changed.
When the Wi-Fi P2P state changes, the event notification service is triggered to publish this event.
State 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.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.GET_WIFI_INFO
Value: usual.event.wifi.p2p.STATE_CHANGE
COMMON_EVENT_WIFI_P2P_PEERS_STATE_CHANGED
Indicates that the state of the Wi-Fi P2P peer device has changed.
When the state of the Wi-Fi P2P peer device changes, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.GET_WIFI_INFO
Value: usual.event.wifi.p2p.DEVICES_CHANGE
COMMON_EVENT_WIFI_P2P_PEERS_DISCOVERY_STATE_CHANGED
Indicates that the Wi-Fi P2P discovery state has changed.
When the Wi-Fi P2P discovery state changes, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.GET_WIFI_INFO
Value: usual.event.wifi.p2p.PEER_DISCOVERY_STATE_CHANGE
COMMON_EVENT_WIFI_P2P_CURRENT_DEVICE_STATE_CHANGED
Indicates that the state of the Wi-Fi P2P local device has changed.
When the state of the Wi-Fi P2P local device changes, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.GET_WIFI_INFO
Value: usual.event.wifi.p2p.CURRENT_DEVICE_CHANGE
COMMON_EVENT_WIFI_P2P_GROUP_STATE_CHANGED
Indicates that the Wi-Fi P2P group information has changed.
When the Wi-Fi P2P group information changes, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.GET_WIFI_INFO
Value: usual.event.wifi.p2p.GROUP_STATE_CHANGED
MDM Kit
COMMON_EVENT_MANAGED_BROWSER_POLICY_CHANGED
Indicates that the browser hosting policy has been changed.
When the browser hosting policy changes, the event notification service is triggered to publish this system common event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.MANAGED_BROWSER_POLICY_CHANGED
Localization Kit
COMMON_EVENT_LOCALE_CHANGED
Indicates that the system language is set. When the system language is set, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.LOCALE_CHANGED
Network Kit
COMMON_EVENT_CONNECTIVITY_CHANGE10+
Indicates that the network connection state has changed.
When the (Ethernet, Wi-Fi, or cellular) network connection state changes (disconnected, connecting, or connected), the event notification service is triggered to publish this event. The following table lists the enum values and their corresponding connection status.
| Value | Connection State |
|---|---|
| 2 | Connecting. |
| 3 | Connected. |
| 4 | Disconnecting. |
| 5 | Disconnected. |
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Atomic service API: This API can be used in atomic services since API version 11.
Value: usual.event.CONNECTIVITY_CHANGE
COMMON_EVENT_AIRPLANE_MODE_CHANGED10+
Indicates that the airplane mode state has changed.
When the airplane mode is enabled or disabled, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.AIRPLANE_MODE
COMMON_EVENT_HTTP_PROXY_CHANGE10+
Indicates that the HTTP proxy configuration has changed.
When 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.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.HTTP_PROXY_CHANGE
Telephony Kit
This topic lists the common system events provided by the telephony subsystem to applications.
COMMON_EVENT_SIM_STATE_CHANGED10+
Indicates that the SIM card status has changed.
When there is a change in the SIM card status of the device, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.SIM_STATE_CHANGED
COMMON_EVENT_CALL_STATE_CHANGED10+
Indicates that the call state has been updated.
When the call state of the device is updated, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.GET_TELEPHONY_STATE (for system apps only)
Value: usual.event.CALL_STATE_CHANGED
COMMON_EVENT_NETWORK_STATE_CHANGED10+
Indicates that the network state has been updated.
When the network state of the device is updated, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.NETWORK_STATE_CHANGED
COMMON_EVENT_SIGNAL_INFO_CHANGED10+
Indicates that the signal information has been updated.
When the signal information of the device is updated, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.SIGNAL_INFO_CHANGED
AppGallery Kit
This topic lists the common system events provided by the AppGallery Kit to applications.
COMMON_EVENT_PRIVACY_STATE_CHANGED11+
Indicates the privacy state has been changed. When a user clicks Agree in a privacy dialog box, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.PRIVACY_STATE_CHANGED
Multimodalinput Kit
This topic lists the common system events provided by the Multimodalinput Kit to applications.
COMMON_EVENT_TABLET_MODE_CHANGED23+
Indicates that the tablet mode of a device (such as a tablet with bracket) has been changed. When the tablet mode of a device has been changed, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Value: usual.event.TABLET_MODE_CHANGED
COMMON_EVENT_LID_STATE_CHANGED23+
Indicates that the lid state of a device (such as a laptop) has been changed. When the lid state of a device has been changed, the event notification service is triggered to publish this event.
System capability: SystemCapability.Notification.CommonEvent
Value: usual.event.LID_STATE_CHANGED
Reserved Common Event
Below are reserved common events that are not supported yet.
COMMON_EVENT_LOCKED_BOOT_COMPLETED
(Reserved, not supported yet) Indicates that the guidance is complete and the system is loaded, but the screen is still locked.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.LOCKED_BOOT_COMPLETED
COMMON_EVENT_PACKAGE_FIRST_LAUNCH
(Reserved, not supported yet) Indicates an initial start of an application after installation.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.PACKAGE_FIRST_LAUNCH
COMMON_EVENT_PACKAGE_NEEDS_VERIFICATION
(Reserved, not supported yet) Indicates that a package is sent by the system verifier when the package needs verification.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.PACKAGE_NEEDS_VERIFICATION
COMMON_EVENT_PACKAGE_VERIFIED
(Reserved, not supported yet) Indicates that a package is sent by the system verifier when the package is verified.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.PACKAGE_VERIFIED
COMMON_EVENT_PACKAGE_REPLACED
(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.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.PACKAGE_REPLACED
COMMON_EVENT_MY_PACKAGE_REPLACED
(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.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.MY_PACKAGE_REPLACED
COMMON_EVENT_PACKAGES_UNSUSPENDED
(Reserved, not supported yet) Indicates that the package has been unsuspended.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.PACKAGES_UNSUSPENDED
COMMON_EVENT_CLOSE_SYSTEM_DIALOGS
(Reserved, not supported yet) Indicates that a user closes a temporary system dialog box.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.CLOSE_SYSTEM_DIALOGS
COMMON_EVENT_UID_REMOVED
(Reserved, not supported yet) Indicates that a user ID has been removed from the system.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.UID_REMOVED
COMMON_EVENT_EXTERNAL_APPLICATIONS_AVAILABLE
(Reserved, not supported yet) Indicates that applications installed on the external storage become available for the system.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.EXTERNAL_APPLICATIONS_AVAILABLE
COMMON_EVENT_EXTERNAL_APPLICATIONS_UNAVAILABLE
(Reserved, not supported yet) Indicates that applications installed on the external storage become unavailable for the system.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.EXTERNAL_APPLICATIONS_UNAVAILABLE
COMMON_EVENT_CONFIGURATION_CHANGED
(Reserved, not supported yet) Indicates that the device state (for example, orientation and locale) has changed.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.CONFIGURATION_CHANGED
COMMON_EVENT_DRIVE_MODE
(Reserved, not supported yet) Indicates that the system is in driving mode.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: common.event.DRIVE_MODE
COMMON_EVENT_HOME_MODE
(Reserved, not supported yet) Indicates that the system is in home mode.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: common.event.HOME_MODE
COMMON_EVENT_OFFICE_MODE
(Reserved, not supported yet) Indicates that the system is in office mode.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: common.event.OFFICE_MODE
COMMON_EVENT_USER_STARTED
(Reserved, not supported yet) Indicates that the user has been started.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.USER_STARTED
COMMON_EVENT_USER_BACKGROUND
(Reserved, not supported yet) Indicates that the user has been brought to the background.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.USER_BACKGROUND
COMMON_EVENT_USER_STARTING
(Reserved, not supported yet) Indicates that the user is going to be started.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS (for system applications only)
Value: usual.event.USER_STARTING
COMMON_EVENT_USER_STOPPING
(Reserved, not supported yet) Indicates that the user is going to be stopped.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS (for system applications only)
Value: usual.event.USER_STOPPING
COMMON_EVENT_USER_STOPPED
(Reserved, not supported yet) Indicates that the user has been stopped.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.USER_STOPPED
COMMON_EVENT_DISK_REMOVED
(Reserved, not supported yet) Indicates that an external storage device was removed.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.STORAGE_MANAGER (for system applications only)
Value: usual.event.data.DISK_REMOVED
COMMON_EVENT_DISK_UNMOUNTED
(Reserved, not supported yet) Indicates that an external storage device was unmounted.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.STORAGE_MANAGER (for system applications only)
Value: usual.event.data.DISK_UNMOUNTED
COMMON_EVENT_DISK_MOUNTED
(Reserved, not supported yet) Indicates that an external storage device was mounted.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.STORAGE_MANAGER (for system applications only)
Value: usual.event.data.DISK_MOUNTED
COMMON_EVENT_DISK_BAD_REMOVAL
(Reserved, not supported yet) Indicates that an external storage device was removed without being unmounted.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.STORAGE_MANAGER (for system applications only)
Value: usual.event.data.DISK_BAD_REMOVAL
COMMON_EVENT_DISK_UNMOUNTABLE
(Reserved, not supported yet) Indicates that an external storage device becomes unmountable.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.STORAGE_MANAGER (for system applications only)
Value: usual.event.data.DISK_UNMOUNTABLE
COMMON_EVENT_DISK_EJECT
(Reserved, not supported yet) Indicates that an external storage device was ejected.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.STORAGE_MANAGER (for system applications only)
Value: usual.event.data.DISK_EJECT
COMMON_EVENT_DATE_CHANGED
(Reserved, not supported yet) Indicates that the system time has changed.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.DATE_CHANGED
COMMON_EVENT_USB_ACCESSORY_ATTACHED
Indicates that a USB accessory has been attached.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.hardware.usb.action.USB_ACCESSORY_ATTACHED
COMMON_EVENT_USB_ACCESSORY_DETACHED
Indicates that a USB accessory has been detached.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.hardware.usb.action.USB_ACCESSORY_DETACHED
COMMON_EVENT_BLUETOOTH_HANDSFREE_AG_CONNECT_STATE_UPDATE(deprecated)
(Reserved, not supported yet) Indicates the common event about the connection state of Bluetooth handsfree communication.
NOTE
This API is supported since API version 9 and deprecated since API version 20. You are advised to use COMMON_EVENT_BLUETOOTH_HANDSFREE_AG_CONNECT_STATE_CHANGE instead.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.USE_BLUETOOTH
Value: usual.event.bluetooth.handsfree.ag.CONNECT_STATE_UPDATE
COMMON_EVENT_BLUETOOTH_HANDSFREE_AG_CURRENT_DEVICE_UPDATE(deprecated)
(Reserved, not supported yet) Indicates that the device connected to the Bluetooth handsfree is active.
NOTE
This API is supported since API version 9 and deprecated since API version 20.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.USE_BLUETOOTH
Value: usual.event.bluetooth.handsfree.ag.CURRENT_DEVICE_UPDATE
COMMON_EVENT_BLUETOOTH_HANDSFREE_AG_AUDIO_STATE_UPDATE(deprecated)
(Reserved, not supported yet) Indicates that the connection state of Bluetooth A2DP has changed.
NOTE
This API is supported since API version 9 and deprecated since API version 20.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.USE_BLUETOOTH
Value: usual.event.bluetooth.handsfree.ag.AUDIO_STATE_UPDATE
COMMON_EVENT_BLUETOOTH_A2DPSOURCE_CONNECT_STATE_UPDATE(deprecated)
(Reserved, not supported yet) Indicates the common event about the connection state of Bluetooth A2DP.
NOTE
This API is supported since API version 9 and deprecated since API version 20. You are advised to use COMMON_EVENT_BLUETOOTH_A2DPSOURCE_CONNECT_STATE_CHANGE instead.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.USE_BLUETOOTH
Value: usual.event.bluetooth.a2dpsource.CONNECT_STATE_UPDATE
COMMON_EVENT_BLUETOOTH_A2DPSOURCE_CURRENT_DEVICE_UPDATE(deprecated)
(Reserved, not supported yet) Indicates that the device connected using Bluetooth A2DP is active.
NOTE
This API is supported since API version 9 and deprecated since API version 20.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.USE_BLUETOOTH
Value: usual.event.bluetooth.a2dpsource.CURRENT_DEVICE_UPDATE
COMMON_EVENT_BLUETOOTH_A2DPSOURCE_AVRCP_CONNECT_STATE_UPDATE(deprecated)
(Reserved, not supported yet) Indicates that the AVRCP connection state of Bluetooth A2DP has changed.
NOTE
This API is supported since API version 9 and deprecated since API version 20. You are advised to use COMMON_EVENT_BLUETOOTH_A2DPSOURCE_AVRCP_CONNECT_STATE_CHANGE instead.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.USE_BLUETOOTH
Value: usual.event.bluetooth.a2dpsource.AVRCP_CONNECT_STATE_UPDATE
COMMON_EVENT_BLUETOOTH_A2DPSOURCE_PLAYING_STATE_UPDATE(deprecated)
(Reserved, not supported yet) Indicates that the playing state of Bluetooth A2DP has changed.
NOTE
This API is supported since API version 9 and deprecated since API version 20.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.USE_BLUETOOTH
Value: usual.event.bluetooth.a2dpsource.PLAYING_STATE_UPDATE
COMMON_EVENT_BLUETOOTH_A2DPSOURCE_CODEC_VALUE_UPDATE(deprecated)
(Reserved, not supported yet) Indicates that the audio codec state of Bluetooth A2DP has changed.
NOTE
This API is supported since API version 9 and deprecated since API version 20. You are advised to use COMMON_EVENT_BLUETOOTH_A2DPSOURCE_CODEC_VALUE_CHANGE instead.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.USE_BLUETOOTH
Value: usual.event.bluetooth.a2dpsource.CODEC_VALUE_UPDATE
COMMON_EVENT_USER_FOREGROUND
(Reserved, not supported yet) Indicates that the user has been brought to the foreground.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.USER_FOREGROUND
COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_DISCOVERED(deprecated)
(Reserved, not supported yet) Indicates that a remote Bluetooth device is discovered.
NOTE
This API is supported since API version 9 and deprecated since API version 20.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.LOCATION and ohos.permission.USE_BLUETOOTH
Value: usual.event.bluetooth.remotedevice.DISCOVERED
COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_CLASS_VALUE_UPDATE(deprecated)
(Reserved, not supported yet) Indicates that the Bluetooth class of a remote Bluetooth device has changed.
NOTE
This API is supported since API version 9 and deprecated since API version 20.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.USE_BLUETOOTH
Value: usual.event.bluetooth.remotedevice.CLASS_VALUE_UPDATE
COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_ACL_CONNECTED(deprecated)
(Reserved, not supported yet) Indicates that a low-ACL connection has been established with a remote Bluetooth device.
NOTE
This API is supported since API version 9 and deprecated since API version 20. You are advised to use COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_ACL_STATE_CHANGE instead.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.bluetooth.remotedevice.ACL_CONNECTED
COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_ACL_DISCONNECTED(deprecated)
(Reserved, not supported yet) Indicates that a low-ACL connection has been disconnected from a remote Bluetooth device.
NOTE
This API is supported since API version 9 and deprecated since API version 20. You are advised to use COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_ACL_STATE_CHANGE instead.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.USE_BLUETOOTH
Value: usual.event.bluetooth.remotedevice.ACL_DISCONNECTED
COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_NAME_UPDATE(deprecated)
(Reserved, not supported yet) Indicates that the friendly name of a remote Bluetooth device is retrieved for the first time or has changed since the last retrieval.
NOTE
This API is supported since API version 9 and deprecated since API version 20.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.ACCESS_BLUETOOTH
Value: usual.event.bluetooth.remotedevice.NAME_UPDATE
COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_PAIR_STATE(deprecated)
(Reserved, not supported yet) Indicates that the connection state of a remote Bluetooth device has changed.
NOTE
This API is supported since API version 9 and deprecated since API version 20. You are advised to use COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_PAIR_STATE_CHANGE instead.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.USE_BLUETOOTH
Value: usual.event.bluetooth.remotedevice.PAIR_STATE
COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_BATTERY_VALUE_UPDATE(deprecated)
(Reserved, not supported yet) Indicates that the battery level of a remote Bluetooth device is retrieved for the first time or has changed since the last retrieval.
NOTE
This API is supported since API version 9 and deprecated since API version 20.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.USE_BLUETOOTH
Value: usual.event.bluetooth.remotedevice.BATTERY_VALUE_UPDATE
COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_SDP_RESULT(deprecated)
(Reserved, not supported yet) Indicates the common event about the SDP state of a remote Bluetooth device.
NOTE
This API is supported since API version 9 and deprecated since API version 20.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.bluetooth.remotedevice.SDP_RESULT
COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_UUID_VALUE(deprecated)
Indicates the action of a common event about the UUID connection state of a remote Bluetooth device.
NOTE
This API is supported since API version 9 and deprecated since API version 20.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.ACCESS_BLUETOOTH
Value: usual.event.bluetooth.remotedevice.UUID_VALUE
COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_PAIRING_REQ(deprecated)
(Reserved, not supported yet) Indicates the common event about the pairing request from a remote Bluetooth device.
NOTE
This API is supported since API version 9 and deprecated since API version 20.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.DISCOVER_BLUETOOTH
Value: usual.event.bluetooth.remotedevice.PAIRING_REQ
COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_PAIRING_CANCEL(deprecated)
(Reserved, not supported yet) Indicates that Bluetooth pairing is canceled.
NOTE
This API is supported since API version 9 and deprecated since API version 20.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.bluetooth.remotedevice.PAIRING_CANCEL
COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_CONNECT_REQ(deprecated)
(Reserved, not supported yet) Indicates the common event about the connection request from a remote Bluetooth device.
NOTE
This API is supported since API version 9 and deprecated since API version 20.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.bluetooth.remotedevice.CONNECT_REQ
COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_CONNECT_REPLY(deprecated)
(Reserved, not supported yet) Indicates the common event about the response to the connection request from a remote Bluetooth device.
NOTE
This API is supported since API version 9 and deprecated since API version 20.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.bluetooth.remotedevice.CONNECT_REPLY
COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_CONNECT_CANCEL(deprecated)
(Reserved, not supported yet) Indicates that the connection to a remote Bluetooth device has been canceled.
NOTE
This API is supported since API version 9 and deprecated since API version 20.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.bluetooth.remotedevice.CONNECT_CANCEL
COMMON_EVENT_BLUETOOTH_HANDSFREEUNIT_CONNECT_STATE_UPDATE(deprecated)
(Reserved, not supported yet) Indicates that the connection state of a Bluetooth handsfree has changed.
NOTE
This API is supported since API version 9 and deprecated since API version 20.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.bluetooth.handsfreeunit.CONNECT_STATE_UPDATE
COMMON_EVENT_BLUETOOTH_HANDSFREEUNIT_AUDIO_STATE_UPDATE(deprecated)
(Reserved, not supported yet) Indicates that the audio state of a Bluetooth handsfree has changed.
NOTE
This API is supported since API version 9 and deprecated since API version 20.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.bluetooth.handsfreeunit.AUDIO_STATE_UPDATE
COMMON_EVENT_BLUETOOTH_HANDSFREEUNIT_AG_COMMON_EVENT(deprecated)
(Reserved, not supported yet) Indicates that the audio gateway state of a Bluetooth handsfree has changed.
NOTE
This API is supported since API version 9 and deprecated since API version 20.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.bluetooth.handsfreeunit.AG_COMMON_EVENT
COMMON_EVENT_BLUETOOTH_HANDSFREEUNIT_AG_CALL_STATE_UPDATE(deprecated)
(Reserved, not supported yet) Indicates that the calling state of a Bluetooth handsfree has changed.
NOTE
This API is supported since API version 9 and deprecated since API version 20.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.bluetooth.handsfreeunit.AG_CALL_STATE_UPDATE
COMMON_EVENT_BLUETOOTH_HOST_STATE_UPDATE(deprecated)
Indicates that the state of a Bluetooth adapter has been changed, for example, Bluetooth has been enabled or disabled.
NOTE
This API is supported since API version 9 and deprecated since API version 20.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.bluetooth.host.STATE_UPDATE
COMMON_EVENT_BLUETOOTH_HOST_REQ_DISCOVERABLE(deprecated)
NOTE
This API is supported since API version 9 and deprecated since API version 20.
(Reserved, not supported yet) Indicates the common event about the request for the user to allow Bluetooth device scanning.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.bluetooth.host.REQ_DISCOVERABLE
COMMON_EVENT_BLUETOOTH_HOST_REQ_ENABLE(deprecated)
(Reserved, not supported yet) Indicates the common event about the request for the user to enable Bluetooth.
NOTE
This API is supported since API version 9 and deprecated since API version 20.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.USE_BLUETOOTH
Value: usual.event.bluetooth.host.REQ_ENABLE
COMMON_EVENT_BLUETOOTH_HOST_REQ_DISABLE(deprecated)
(Reserved, not supported yet) Indicates the common event about the request for the user to disable Bluetooth.
NOTE
This API is supported since API version 9 and deprecated since API version 20.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.USE_BLUETOOTH
Value: usual.event.bluetooth.host.REQ_DISABLE
COMMON_EVENT_BLUETOOTH_HOST_SCAN_MODE_UPDATE(deprecated)
(Reserved, not supported yet) Indicates that the Bluetooth scanning mode of a device has changed.
NOTE
This API is supported since API version 9 and deprecated since API version 20.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.USE_BLUETOOTH
Value: usual.event.bluetooth.host.SCAN_MODE_UPDATE
COMMON_EVENT_BLUETOOTH_HOST_DISCOVERY_STARTED(deprecated)
Indicates that the Bluetooth scanning has been started on the device.
NOTE
This API is supported since API version 9 and deprecated since API version 20.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.ACCESS_BLUETOOTH
Value: usual.event.bluetooth.host.DISCOVERY_STARTED
COMMON_EVENT_BLUETOOTH_HOST_DISCOVERY_FINISHED(deprecated)
Indicates that the Bluetooth scanning is finished on the device.
NOTE
This API is supported since API version 9 and deprecated since API version 20.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.ACCESS_BLUETOOTH
Value: usual.event.bluetooth.host.DISCOVERY_FINISHED
COMMON_EVENT_BLUETOOTH_HOST_NAME_UPDATE(deprecated)
Indicates that the Bluetooth adapter name of the device has changed.
NOTE
This API is supported since API version 9 and deprecated since API version 20.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.ACCESS_BLUETOOTH
Value: usual.event.bluetooth.host.NAME_UPDATE
COMMON_EVENT_BLUETOOTH_A2DPSINK_CONNECT_STATE_UPDATE(deprecated)
(Reserved, not supported yet) Indicates that the connection state of Bluetooth A2DP has changed.
NOTE
This API is supported since API version 9 and deprecated since API version 20.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.USE_BLUETOOTH
Value: usual.event.bluetooth.a2dpsink.CONNECT_STATE_UPDATE
COMMON_EVENT_BLUETOOTH_A2DPSINK_PLAYING_STATE_UPDATE(deprecated)
(Reserved, not supported yet) Indicates that the playing state of Bluetooth A2DP has changed.
NOTE
This API is supported since API version 9 and deprecated since API version 20.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.USE_BLUETOOTH
Value: usual.event.bluetooth.a2dpsink.PLAYING_STATE_UPDATE
COMMON_EVENT_BLUETOOTH_A2DPSINK_AUDIO_STATE_UPDATE(deprecated)
(Reserved, not supported yet) Indicates that the audio state of Bluetooth A2DP Sink has changed.
NOTE
This API is supported since API version 9 and deprecated since API version 20.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.USE_BLUETOOTH
Value: usual.event.bluetooth.a2dpsink.AUDIO_STATE_UPDATE
COMMON_EVENT_ABILITY_ADDED
(Reserved, not supported yet) Indicates that an ability has been added.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.LISTEN_BUNDLE_CHANGE
Value: usual.event.ABILITY_ADDED
COMMON_EVENT_ABILITY_REMOVED
(Reserved, not supported yet) Indicates that an ability has been removed.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.LISTEN_BUNDLE_CHANGE
Value: usual.event.ABILITY_REMOVED
COMMON_EVENT_ABILITY_UPDATED
(Reserved, not supported yet) Indicates that an ability has been updated.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.LISTEN_BUNDLE_CHANGE
Value: usual.event.ABILITY_UPDATED
COMMON_EVENT_LOCATION_MODE_STATE_CHANGED
(Reserved, not supported yet) Indicates that the location mode of the system has changed.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.location.MODE_STATE_CHANGED
COMMON_EVENT_IVI_SLEEP
(Reserved, not supported yet) Indicates that the in-vehicle infotainment (IVI) system of a vehicle is sleeping.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: common.event.IVI_SLEEP
COMMON_EVENT_IVI_PAUSE
(Reserved, not supported yet) Indicates that the IVI system of a vehicle has entered sleep mode and the playing application is instructed to stop playback.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: common.event.IVI_PAUSE
COMMON_EVENT_IVI_STANDBY
(Reserved, not supported yet) Indicates that a third-party application is instructed to pause the current work.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: common.event.IVI_STANDBY
COMMON_EVENT_IVI_LASTMODE_SAVE
(Reserved, not supported yet) Indicates that a third-party application is instructed to save its last mode.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: common.event.IVI_LASTMODE_SAVE
COMMON_EVENT_IVI_VOLTAGE_ABNORMAL
(Reserved, not supported yet) Indicates that the voltage of the vehicle's power system is abnormal.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: common.event.IVI_VOLTAGE_ABNORMAL
COMMON_EVENT_IVI_HIGH_TEMPERATURE
(Reserved, not supported yet) Indicates that the temperature of the IVI system is high.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: common.event.IVI_HIGH_TEMPERATURE
COMMON_EVENT_IVI_EXTREME_TEMPERATURE
(Reserved, not supported yet) Indicates that the temperature of the IVI system is extremely high.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: common.event.IVI_EXTREME_TEMPERATURE
COMMON_EVENT_IVI_TEMPERATURE_ABNORMAL
(Reserved, not supported yet) Indicates that the IVI system has an extreme temperature.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: common.event.IVI_TEMPERATURE_ABNORMAL
COMMON_EVENT_IVI_VOLTAGE_RECOVERY
(Reserved, not supported yet) Indicates that the voltage of the vehicle's power system is restored to normal.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: common.event.IVI_VOLTAGE_RECOVERY
COMMON_EVENT_IVI_TEMPERATURE_RECOVERY
(Reserved, not supported yet) Indicates that the temperature of the IVI system is restored to normal.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: common.event.IVI_TEMPERATURE_RECOVERY
COMMON_EVENT_IVI_ACTIVE
(Reserved, not supported yet) Indicates that the battery service is active.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: common.event.IVI_ACTIVE
COMMON_EVENT_VISIBLE_ACCOUNTS_UPDATED
(Reserved, not supported yet) Indicates that the account visibility changed.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.GET_APP_ACCOUNTS (for system applications only)
Value: usual.event.data.VISIBLE_ACCOUNTS_UPDATED
COMMON_EVENT_ACCOUNT_DELETED
(Reserved, not supported yet) Indicates that the account was deleted.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS (for system applications only)
Value: usual.event.data.ACCOUNT_DELETED
COMMON_EVENT_FOUNDATION_READY
(Reserved, not supported yet) Indicates that the foundation is ready.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: ohos.permission.RECEIVER_STARTUP_COMPLETED (for system applications only)
Value: usual.event.data.FOUNDATION_READY
COMMON_EVENT_SPN_INFO_CHANGED
Indicates that the SPN information had changed.
System capability: SystemCapability.Notification.CommonEvent
Required permissions: none
Value: usual.event.SPN_INFO_CHANGED