From d1c9cb0809a55be8fe98a90dbc3aacd27deaf740 Mon Sep 17 00:00:00 2001 From: "ester.zhou" Date: Wed, 5 Jul 2023 12:27:17 +0800 Subject: [PATCH] Update docs (19703) Signed-off-by: ester.zhou --- .../apis/commonEventManager-definitions.md | 442 +++++------------- .../apis/common_event/commonEvent-account.md | 76 +++ .../commonEvent-filemanagement.md | 37 ++ .../apis/common_event/commonEvent-mms.md | 11 + .../common_event/commonEvent-netmanager.md | 57 +++ .../apis/common_event/commonEvent-nfc.md | 26 ++ .../apis/common_event/commonEvent-powermgr.md | 106 +++++ .../common_event/commonEvent-screenlock.md | 18 + .../apis/common_event/commonEvent-time.md | 26 ++ .../apis/common_event/commonEvent-wifi.md | 123 +++++ .../apis/common_event/commonEvent-window.md | 10 + 11 files changed, 597 insertions(+), 335 deletions(-) create mode 100644 en/application-dev/reference/apis/common_event/commonEvent-account.md create mode 100644 en/application-dev/reference/apis/common_event/commonEvent-filemanagement.md create mode 100644 en/application-dev/reference/apis/common_event/commonEvent-mms.md create mode 100644 en/application-dev/reference/apis/common_event/commonEvent-netmanager.md create mode 100644 en/application-dev/reference/apis/common_event/commonEvent-nfc.md create mode 100644 en/application-dev/reference/apis/common_event/commonEvent-powermgr.md create mode 100644 en/application-dev/reference/apis/common_event/commonEvent-screenlock.md create mode 100644 en/application-dev/reference/apis/common_event/commonEvent-time.md create mode 100644 en/application-dev/reference/apis/common_event/commonEvent-wifi.md create mode 100644 en/application-dev/reference/apis/common_event/commonEvent-window.md diff --git a/en/application-dev/reference/apis/commonEventManager-definitions.md b/en/application-dev/reference/apis/commonEventManager-definitions.md index 05f158ad54..f0695d7a98 100644 --- a/en/application-dev/reference/apis/commonEventManager-definitions.md +++ b/en/application-dev/reference/apis/commonEventManager-definitions.md @@ -13,50 +13,32 @@ Indicates that the user has finished the boot process. - Value: **usual.event.LOCKED_BOOT_COMPLETED** - Required subscriber permissions: ohos.permission.RECEIVER_STARTUP_COMPLETED -## COMMON_EVENT_SHUTDOWN +## [COMMON_EVENT_SHUTDOWN](./common_event/commonEvent-powermgr.md) Indicates that the device is being shut down and the final shutdown will proceed. -- Value: **usual.event.SHUTDOWN** -- Required subscriber permissions: none -## COMMON_EVENT_BATTERY_CHANGED +## [COMMON_EVENT_BATTERY_CHANGED](./common_event/commonEvent-powermgr.md) Indicates that the charging state, level, and other information about the battery have changed. -- Value: **usual.event.BATTERY_CHANGED** -- Required subscriber permissions: none -## COMMON_EVENT_BATTERY_LOW +## [COMMON_EVENT_BATTERY_LOW](./common_event/commonEvent-powermgr.md) Indicates that the battery level is low. -- Value: **usual.event.BATTERY_LOW** -- Required subscriber permissions: none -## COMMON_EVENT_BATTERY_OKAY +## [COMMON_EVENT_BATTERY_OKAY](./common_event/commonEvent-powermgr.md) Indicates that the battery level is normal. -- Value: **usual.event.BATTERY_OKAY** -- Required subscriber permissions: none -## COMMON_EVENT_POWER_CONNECTED +## [COMMON_EVENT_POWER_CONNECTED](./common_event/commonEvent-powermgr.md) Indicates that the device is connected to an external power supply. -- Value: **usual.event.POWER_CONNECTED** -- Required subscriber permissions: none -## COMMON_EVENT_POWER_DISCONNECTED +## [COMMON_EVENT_POWER_DISCONNECTED](./common_event/commonEvent-powermgr.md) Indicates that the device is disconnected from the external power supply. -- Value: **usual.event.POWER_DISCONNECTED** -- Required subscriber permissions: none -## COMMON_EVENT_SCREEN_OFF +## [COMMON_EVENT_SCREEN_OFF](./common_event/commonEvent-powermgr.md) Indicates that the device screen is off and the device is in sleep mode. -- Value: **usual.event.SCREEN_OFF** -- Required subscriber permissions: none -## COMMON_EVENT_SCREEN_ON -Indicates that the device screen is on and the device is in interactive state. -- Value: **usual.event.SCREEN_ON** -- Required subscriber permissions: none +## [COMMON_EVENT_SCREEN_ON](./common_event/commonEvent-powermgr.md) +Indicates that the device screen is on and the device is in the active state. -## COMMON_EVENT_THERMAL_LEVEL_CHANGED8+ +## [COMMON_EVENT_THERMAL_LEVEL_CHANGED](./common_event/commonEvent-powermgr.md) Indicates that the device's thermal level has changed. -- Value: **usual.event.THERMAL_LEVEL_CHANGED** -- Required subscriber permissions: none ## COMMON_EVENT_USER_PRESENT(deprecated) (Reserved, not supported yet) Indicates that the user unlocks the device. @@ -65,37 +47,29 @@ Indicates that the device's thermal level has changed. > NOTE > > This API is deprecated since API version 10. +> You are advised to use [COMMON_EVENT_SCREEN_UNLOCKED10+](./common_event/commonEvent-screenlock.md) instead. -## COMMON_EVENT_TIME_TICK +## [COMMON_EVENT_TIME_TICK](./common_event/commonEvent-time.md) Indicates that the system time has changed as time ticks by. -- Value: **usual.event.TIME_TICK** -- Required subscriber permissions: none -## COMMON_EVENT_TIME_CHANGED +## [COMMON_EVENT_TIME_CHANGED](./common_event/commonEvent-time.md) Indicates that the system time is set. -- Value: **usual.event.TIME_CHANGED** -- Required subscriber permissions: none ## COMMON_EVENT_DATE_CHANGED (Reserved, not supported yet) Indicates that the system date has changed. - Value: **usual.event.DATE_CHANGED** - Required subscriber permissions: none -## COMMON_EVENT_TIMEZONE_CHANGED +## [COMMON_EVENT_TIMEZONE_CHANGED](./common_event/commonEvent-time.md) Indicates that the system time zone has changed. -- Value: **usual.event.TIMEZONE_CHANGED** -- Required subscriber permissions: none ## COMMON_EVENT_CLOSE_SYSTEM_DIALOGS (Reserved, not supported yet) Indicates that the user closes a temporary system dialog box. - Value: **usual.event.CLOSE_SYSTEM_DIALOGS** - Required subscriber permissions: none -## COMMON_EVENT_PACKAGE_ADDED +## [COMMON_EVENT_PACKAGE_ADDED](./common_event/commonEvent-bundleManager.md) Indicates that a new application package has been installed on the device. -- Value: **usual.event.PACKAGE_ADDED** -- Required subscriber permissions: none - ## COMMON_EVENT_PACKAGE_REPLACED (Reserved, not supported yet) Indicates that a later version of an installed application package has replaced the previous one on the device. - Value: **usual.event.PACKAGE_REPLACED** @@ -106,11 +80,8 @@ Indicates that a new application package has been installed on the device. - Value: **usual.event.MY_PACKAGE_REPLACED** - Required subscriber permissions: none -## COMMON_EVENT_PACKAGE_REMOVED +## [COMMON_EVENT_PACKAGE_REMOVED](./common_event/commonEvent-bundleManager.md) Indicates that an installed application has been uninstalled from the device with the application data retained. -- Value: **usual.event.PACKAGE_REMOVED** -- Required subscriber permissions: none - ## COMMON_EVENT_BUNDLE_REMOVED (Reserved, not supported yet) Indicates that an installed bundle has been uninstalled from the device with the application data retained. - Value: **usual.event.BUNDLE_REMOVED** @@ -121,22 +92,16 @@ Indicates that an installed application has been uninstalled from the device wit - Value: **usual.event.PACKAGE_FULLY_REMOVED** - Required subscriber permissions: none -## COMMON_EVENT_PACKAGE_CHANGED +## [COMMON_EVENT_PACKAGE_CHANGED](./common_event/commonEvent-bundleManager.md) Indicates that an application package has been changed (for example, an ability in the package has been enabled or disabled). -- Value: **usual.event.PACKAGE_CHANGED** -- Required subscriber permissions: none - ## [COMMON_EVENT_PACKAGE_RESTARTED](./common_event/commonEvent-ability.md) Indicates that the user closed all processes of the application and restarted the application. ## [COMMON_EVENT_PACKAGE_DATA_CLEARED](./common_event/commonEvent-ability.md) Indicates that the user cleared the application package data. -## COMMON_EVENT_PACKAGE_CACHE_CLEARED9+ +## [COMMON_EVENT_PACKAGE_CACHE_CLEARED9+](./common_event/commonEvent-bundleManager.md) Indicates that the user cleared the application package cache. -- Value: **usual.event.PACKAGE_CACHE_CLEARED** -- Required subscriber permissions: none - ## COMMON_EVENT_PACKAGES_SUSPENDED (Reserved, not supported yet) Indicates that application HAP files are suspended. - Value: **usual.event.PACKAGES_SUSPENDED** @@ -177,7 +142,6 @@ Indicates that an application HAP file is not suspended. - Value: **usual.event.PACKAGE_VERIFIED** - Required subscriber permissions: none - ## COMMON_EVENT_EXTERNAL_APPLICATIONS_AVAILABLE (Reserved, not supported yet) Indicates that applications installed on the external storage are available for the system. - Value: **usual.event.EXTERNAL_APPLICATIONS_AVAILABLE** @@ -233,11 +197,8 @@ Indicates that an application HAP file is not suspended. - Value: **usual.event.USER_FOREGROUND** - Required subscriber permissions: none -## COMMON_EVENT_USER_SWITCHED +## [COMMON_EVENT_USER_SWITCHED](./common_event/commonEvent-account.md) Indicates that user switching is in progress. -- Value: **usual.event.USER_SWITCHED** -- Required subscriber permissions: ohos.permission.MANAGE_LOCAL_ACCOUNTS - ## COMMON_EVENT_USER_STARTING (Reserved, not supported yet) Indicates that the user is being started. - Value: **usual.event.USER_STARTING** @@ -258,466 +219,335 @@ Indicates that user switching is in progress. - Value: **usual.event.USER_STOPPED** - Required subscriber permissions: none -## COMMON_EVENT_DISTRIBUTED_ACCOUNT_LOGIN +## [COMMON_EVENT_DISTRIBUTED_ACCOUNT_LOGIN](./common_event/commonEvent-account.md) (Reserved, not supported yet) Indicates a successful login to a distributed account. -- Value: **usual.event.DISTRIBUTED_ACCOUNT_LOGIN** -- Required subscriber permissions: none - -## COMMON_EVENT_DISTRIBUTED_ACCOUNT_LOGOUT +## [COMMON_EVENT_DISTRIBUTED_ACCOUNT_LOGOUT](./common_event/commonEvent-account.md) (Reserved, not supported yet) Indicates a successful logout of a distributed account. -- Value: **usual.event.DISTRIBUTED_ACCOUNT_LOGOUT** -- Required subscriber permissions: none - -## COMMON_EVENT_DISTRIBUTED_ACCOUNT_TOKEN_INVALID +## [COMMON_EVENT_DISTRIBUTED_ACCOUNT_TOKEN_INVALID](./common_event/commonEvent-account.md) (Reserved, not supported yet) Indicates the token of a distributed account is invalid. -- Value: **usual.event.DISTRIBUTED_ACCOUNT_TOKEN_INVALID** -- Required subscriber permissions: none - -## COMMON_EVENT_DISTRIBUTED_ACCOUNT_LOGOFF +## [COMMON_EVENT_DISTRIBUTED_ACCOUNT_LOGOFF](./common_event/commonEvent-account.md) (Reserved, not supported yet) Indicates that a distributed account is deregistered. -- Value: **usual.event.DISTRIBUTED_ACCOUNT_LOGOFF** -- Required subscriber permissions: none -## COMMON_EVENT_WIFI_POWER_STATE +## [COMMON_EVENT_WIFI_POWER_STATE](./common_event/commonEvent-wifi.md) Indicates that the Wi-Fi state has changed, for example, enabled or disabled. -- Value: **usual.event.wifi.POWER_STATE** -- Required subscriber permissions: none - -## COMMON_EVENT_WIFI_SCAN_FINISHED +## [COMMON_EVENT_WIFI_SCAN_FINISHED](./common_event/commonEvent-wifi.md) Indicates that the Wi-Fi access point has been detected and proven to be available. -- Value: **usual.event.wifi.SCAN_FINISHED** -- Required subscriber permissions: ohos.permission.LOCATION +## [COMMON_EVENT_WIFI_SCAN_STATE](./common_event/commonEvent-wifi.md) +Indicates that the Wi-Fi access point state has changed. -## COMMON_EVENT_WIFI_RSSI_VALUE +## [COMMON_EVENT_WIFI_RSSI_VALUE](./common_event/commonEvent-wifi.md) Indicates that the Wi-Fi signal strength (RSSI) has changed. -- Value: **usual.event.wifi.RSSI_VALUE** -- Required subscriber permissions: ohos.permission.GET_WIFI_INFO - -## COMMON_EVENT_WIFI_CONN_STATE +## [COMMON_EVENT_WIFI_CONN_STATE](./common_event/commonEvent-wifi.md) Indicates that the Wi-Fi connection state has changed. -- Value: **usual.event.wifi.CONN_STATE** -- Required subscriber permissions: none - -## COMMON_EVENT_WIFI_HOTSPOT_STATE +## [COMMON_EVENT_WIFI_HOTSPOT_STATE](./common_event/commonEvent-wifi.md) Indicates that the Wi-Fi hotspot state has changed, for example, enabled or disabled. -- Value: **usual.event.wifi.HOTSPOT_STATE** -- Required subscriber permissions: none - -## COMMON_EVENT_WIFI_AP_STA_JOIN +## [COMMON_EVENT_WIFI_AP_STA_JOIN](./common_event/commonEvent-wifi.md) Indicates that a client has joined the Wi-Fi hotspot of the current device. -- Value: **usual.event.wifi.WIFI_HS_STA_JOIN** -- Required subscriber permissions: ohos.permission.GET_WIFI_INFO - -## COMMON_EVENT_WIFI_AP_STA_LEAVE +## [COMMON_EVENT_WIFI_AP_STA_LEAVE](./common_event/commonEvent-wifi.md) Indicates that a client has disconnected from the Wi-Fi hotspot of the current device. -- Value: **usual.event.wifi.WIFI_HS_STA_LEAVE** -- Required subscriber permissions: ohos.permission.GET_WIFI_INFO - -## COMMON_EVENT_WIFI_MPLINK_STATE_CHANGE +## [COMMON_EVENT_WIFI_MPLINK_STATE_CHANGE](./common_event/commonEvent-wifi.md) Indicates that the state of MPLINK (an enhanced Wi-Fi feature) has changed. -- Value: **usual.event.wifi.mplink.STATE_CHANGE** -- Required subscriber permissions: ohos.permission.MPLINK_CHANGE_STATE - -## COMMON_EVENT_WIFI_P2P_CONN_STATE +## [COMMON_EVENT_WIFI_P2P_CONN_STATE](./common_event/commonEvent-wifi.md) Indicates that the Wi-Fi P2P connection state has changed. -- Value: **usual.event.wifi.p2p.CONN_STATE_CHANGE** -- Required subscriber permissions: ohos.permission.GET_WIFI_INFO and ohos.permission.LOCATION - -## COMMON_EVENT_WIFI_P2P_STATE_CHANGED +## [COMMON_EVENT_WIFI_P2P_STATE_CHANGED](./common_event/commonEvent-wifi.md) Indicates that the Wi-Fi P2P state has changed, for example, enabled or disabled. -- Value: **usual.event.wifi.p2p.STATE_CHANGE** -- Required subscriber permissions: ohos.permission.GET_WIFI_INFO - -## COMMON_EVENT_WIFI_P2P_PEERS_STATE_CHANGED +## [COMMON_EVENT_WIFI_P2P_PEERS_STATE_CHANGED](./common_event/commonEvent-wifi.md) Indicates that the state of the Wi-Fi P2P peer device has changed. -- Value: **usual.event.wifi.p2p.DEVICES_CHANGE** -- Required subscriber permissions: ohos.permission.GET_WIFI_INFO - -## COMMON_EVENT_WIFI_P2P_PEERS_DISCOVERY_STATE_CHANGED +## [COMMON_EVENT_WIFI_P2P_PEERS_DISCOVERY_STATE_CHANGED](./common_event/commonEvent-wifi.md) Indicates that the Wi-Fi P2P discovery state has changed. -- Value: **usual.event.wifi.p2p.PEER_DISCOVERY_STATE_CHANGE** -- Required subscriber permissions: ohos.permission.GET_WIFI_INFO - -## COMMON_EVENT_WIFI_P2P_CURRENT_DEVICE_STATE_CHANGED +## [COMMON_EVENT_WIFI_P2P_CURRENT_DEVICE_STATE_CHANGED](./common_event/commonEvent-wifi.md) Indicates that the state of the Wi-Fi P2P local device has changed. -- Value: **usual.event.wifi.p2p.CURRENT_DEVICE_CHANGE** -- Required subscriber permissions: ohos.permission.GET_WIFI_INFO - -## COMMON_EVENT_WIFI_P2P_GROUP_STATE_CHANGED +## [COMMON_EVENT_WIFI_P2P_GROUP_STATE_CHANGED](./common_event/commonEvent-wifi.md) Indicates that the Wi-Fi P2P group information has changed. -- Value: **usual.event.wifi.p2p.GROUP_STATE_CHANGED** -- Required subscriber permissions: ohos.permission.GET_WIFI_INFO - ## COMMON_EVENT_BLUETOOTH_HANDSFREE_AG_CONNECT_STATE_UPDATE (Reserved, not supported yet) Indicates the connection state of Bluetooth handsfree communication. - Value: **usual.event.bluetooth.handsfree.ag.CONNECT_STATE_UPDATE** - Required subscriber permissions: ohos.permission.USE_BLUETOOTH - ## COMMON_EVENT_BLUETOOTH_HANDSFREE_AG_CURRENT_DEVICE_UPDATE (Reserved, not supported yet) Indicates that the device connected through Bluetooth handsfree is active. - Value: **usual.event.bluetooth.handsfree.ag.CURRENT_DEVICE_UPDATE** - Required subscriber permissions: ohos.permission.USE_BLUETOOTH - ## COMMON_EVENT_BLUETOOTH_HANDSFREE_AG_AUDIO_STATE_UPDATE (Reserved, not supported yet) Indicates that the connection state of Bluetooth A2DP has changed. - Value: **usual.event.bluetooth.handsfree.ag.AUDIO_STATE_UPDATE** - Required subscriber permissions: ohos.permission.USE_BLUETOOTH - ## COMMON_EVENT_BLUETOOTH_A2DPSOURCE_CONNECT_STATE_UPDATE (Reserved, not supported yet) Indicates the connection state of Bluetooth A2DP. - Value: **usual.event.bluetooth.a2dpsource.CONNECT_STATE_UPDATE** - Required subscriber permissions: ohos.permission.USE_BLUETOOTH - ## COMMON_EVENT_BLUETOOTH_A2DPSOURCE_CURRENT_DEVICE_UPDATE (Reserved, not supported yet) Indicates that the device connected using Bluetooth A2DP is active. - Value: **usual.event.bluetooth.a2dpsource.CURRENT_DEVICE_UPDATE** - Required subscriber permissions: ohos.permission.USE_BLUETOOTH - ## COMMON_EVENT_BLUETOOTH_A2DPSOURCE_PLAYING_STATE_UPDATE (Reserved, not supported yet) Indicates that the playing state of Bluetooth A2DP has changed. - Value: **usual.event.bluetooth.a2dpsource.PLAYING_STATE_UPDATE** - Required subscriber permissions: ohos.permission.USE_BLUETOOTH - ## COMMON_EVENT_BLUETOOTH_A2DPSOURCE_AVRCP_CONNECT_STATE_UPDATE (Reserved, not supported yet) Indicates that the AVRCP connection state of Bluetooth A2DP has changed. - Value: **usual.event.bluetooth.a2dpsource.AVRCP_CONNECT_STATE_UPDATE** - Required subscriber permissions: ohos.permission.USE_BLUETOOTH - ## COMMON_EVENT_BLUETOOTH_A2DPSOURCE_CODEC_VALUE_UPDATE (Reserved, not supported yet) Indicates that the audio codec state of Bluetooth A2DP has changed. - Value: **usual.event.bluetooth.a2dpsource.CODEC_VALUE_UPDATE** - Required subscriber permissions: ohos.permission.USE_BLUETOOTH - ## COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_DISCOVERED (Reserved, not supported yet) Indicates that a remote Bluetooth device is discovered. - Value: **usual.event.bluetooth.remotedevice.DISCOVERED** - Required subscriber permissions: ohos.permission.LOCATION and ohos.permission.USE_BLUETOOTH - ## COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_CLASS_VALUE_UPDATE (Reserved, not supported yet) Indicates that the Bluetooth class of a remote Bluetooth device has changed. - Value: **usual.event.bluetooth.remotedevice.CLASS_VALUE_UPDATE** - Required subscriber permissions: ohos.permission.USE_BLUETOOTH - ## COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_ACL_CONNECTED (Reserved, not supported yet) Indicates that a low-ACL connection with a remote Bluetooth device has been established. - Value: **usual.event.bluetooth.remotedevice.ACL_CONNECTED** -- Required subscriber permissions: ohos.permission.USE_BLUETOOTH - +- Required subscriber permissions: none ## COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_ACL_DISCONNECTED (Reserved, not supported yet) Indicates that the low-ACL connection with a remote Bluetooth device has been terminated. - Value: **usual.event.bluetooth.remotedevice.ACL_DISCONNECTED** - Required subscriber permissions: ohos.permission.USE_BLUETOOTH - ## COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_NAME_UPDATE (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. - Value: **usual.event.bluetooth.remotedevice.NAME_UPDATE** - Required subscriber permissions: ohos.permission.USE_BLUETOOTH - ## COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_PAIR_STATE (Reserved, not supported yet) Indicates that the connection state with a remote Bluetooth device has changed. - Value: **usual.event.bluetooth.remotedevice.PAIR_STATE** - Required subscriber permissions: ohos.permission.USE_BLUETOOTH - ## COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_BATTERY_VALUE_UPDATE (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. - Value: **usual.event.bluetooth.remotedevice.BATTERY_VALUE_UPDATE** - Required subscriber permissions: ohos.permission.USE_BLUETOOTH - ## COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_SDP_RESULT (Reserved, not supported yet) Indicates the SDP state of a remote Bluetooth device. - Value: **usual.event.bluetooth.remotedevice.SDP_RESULT** - Required subscriber permissions: none - ## COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_UUID_VALUE (Reserved, not supported yet) Indicates the UUID connection state with a remote Bluetooth device. - Value: **usual.event.bluetooth.remotedevice.UUID_VALUE** - Required subscriber permissions: ohos.permission.DISCOVER_BLUETOOTH - ## COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_PAIRING_REQ (Reserved, not supported yet) Indicates the pairing request from a remote Bluetooth device. - Value: **usual.event.bluetooth.remotedevice.PAIRING_REQ** - Required subscriber permissions: ohos.permission.DISCOVER_BLUETOOTH - ## COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_PAIRING_CANCEL (Reserved, not supported yet) Indicates that Bluetooth pairing has been canceled. - Value: **usual.event.bluetooth.remotedevice.PAIRING_CANCEL** - Required subscriber permissions: none - ## COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_CONNECT_REQ (Reserved, not supported yet) Indicates the connection request from a remote Bluetooth device. - Value: **usual.event.bluetooth.remotedevice.CONNECT_REQ** - Required subscriber permissions: none - ## COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_CONNECT_REPLY (Reserved, not supported yet) Indicates the response to the connection request from a remote Bluetooth device. - Value: **usual.event.bluetooth.remotedevice.CONNECT_REPLY** - Required subscriber permissions: none - ## COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_CONNECT_CANCEL (Reserved, not supported yet) Indicates that the connection to a remote Bluetooth device has been canceled. - Value: **usual.event.bluetooth.remotedevice.CONNECT_CANCEL** - Required subscriber permissions: none - ## COMMON_EVENT_BLUETOOTH_HANDSFREEUNIT_CONNECT_STATE_UPDATE (Reserved, not supported yet) Indicates that the connection state with a Bluetooth handsfree has changed. - Value: **usual.event.bluetooth.handsfreeunit.CONNECT_STATE_UPDATE** - Required subscriber permissions: none - ## COMMON_EVENT_BLUETOOTH_HANDSFREEUNIT_AUDIO_STATE_UPDATE (Reserved, not supported yet) Indicates that the audio state of a Bluetooth handsfree has changed. - Value: **usual.event.bluetooth.handsfreeunit.AUDIO_STATE_UPDATE** - Required subscriber permissions: none - ## COMMON_EVENT_BLUETOOTH_HANDSFREEUNIT_AG_COMMON_EVENT (Reserved, not supported yet) Indicates that the audio gateway state of a Bluetooth handsfree has changed. - Value: **usual.event.bluetooth.handsfreeunit.AG_COMMON_EVENT** - Required subscriber permissions: none - ## COMMON_EVENT_BLUETOOTH_HANDSFREEUNIT_AG_CALL_STATE_UPDATE (Reserved, not supported yet) Indicates that the calling state of a Bluetooth handsfree has changed. - Value: **usual.event.bluetooth.handsfreeunit.AG_CALL_STATE_UPDATE** - Required subscriber permissions: none - ## COMMON_EVENT_BLUETOOTH_HOST_STATE_UPDATE (Reserved, not supported yet) Indicates that the state of a Bluetooth adapter has changed, for example, Bluetooth has been enabled or disabled. - Value: **usual.event.bluetooth.host.STATE_UPDATE** - Required subscriber permissions: ohos.permission.USE_BLUETOOTH - ## COMMON_EVENT_BLUETOOTH_HOST_REQ_DISCOVERABLE (Reserved, not supported yet) Indicates the request for the user to allow Bluetooth device scanning. - Value: **usual.event.bluetooth.host.REQ_DISCOVERABLE** - Required subscriber permissions: none - ## COMMON_EVENT_BLUETOOTH_HOST_REQ_ENABLE (Reserved, not supported yet) Indicates the request for the user to enable Bluetooth. - Value: **usual.event.bluetooth.host.REQ_ENABLE** - Required subscriber permissions: ohos.permission.USE_BLUETOOTH - ## COMMON_EVENT_BLUETOOTH_HOST_REQ_DISABLE (Reserved, not supported yet) Indicates the request for the user to disable Bluetooth. - Value: **usual.event.bluetooth.host.REQ_DISABLE** - Required subscriber permissions: ohos.permission.USE_BLUETOOTH - ## COMMON_EVENT_BLUETOOTH_HOST_SCAN_MODE_UPDATE (Reserved, not supported yet) Indicates that the Bluetooth scanning mode of the device has changed. - Value: **usual.event.bluetooth.host.SCAN_MODE_UPDATE** - Required subscriber permissions: ohos.permission.USE_BLUETOOTH - ## COMMON_EVENT_BLUETOOTH_HOST_DISCOVERY_STARTED (Reserved, not supported yet) Indicates that Bluetooth scanning has been started on the device. - Value: **usual.event.bluetooth.host.DISCOVERY_STARTED** - Required subscriber permissions: ohos.permission.USE_BLUETOOTH - ## COMMON_EVENT_BLUETOOTH_HOST_DISCOVERY_FINISHED (Reserved, not supported yet) Indicates that Bluetooth scanning is finished on the device. - Value: **usual.event.bluetooth.host.DISCOVERY_FINISHED** - Required subscriber permissions: ohos.permission.USE_BLUETOOTH - ## COMMON_EVENT_BLUETOOTH_HOST_NAME_UPDATE (Reserved, not supported yet) Indicates that the Bluetooth adapter name of the device has changed. - Value: **usual.event.bluetooth.host.NAME_UPDATE** - Required subscriber permissions: ohos.permission.USE_BLUETOOTH - ## COMMON_EVENT_BLUETOOTH_A2DPSINK_CONNECT_STATE_UPDATE (Reserved, not supported yet) Indicates that the connection state of Bluetooth A2DP Sink has changed. - Value: **usual.event.bluetooth.a2dpsink.CONNECT_STATE_UPDATE** - Required subscriber permissions: ohos.permission.USE_BLUETOOTH - ## COMMON_EVENT_BLUETOOTH_A2DPSINK_PLAYING_STATE_UPDATE (Reserved, not supported yet) Indicates that the playing state of Bluetooth A2DP Sink has changed. - Value: **usual.event.bluetooth.a2dpsink.PLAYING_STATE_UPDATE** - Required subscriber permissions: ohos.permission.USE_BLUETOOTH - ## COMMON_EVENT_BLUETOOTH_A2DPSINK_AUDIO_STATE_UPDATE (Reserved, not supported yet) Indicates that the audio state of Bluetooth A2DP Sink has changed. - Value: **usual.event.bluetooth.a2dpsink.AUDIO_STATE_UPDATE** - Required subscriber permissions: ohos.permission.USE_BLUETOOTH +## [COMMON_EVENT_NFC_ACTION_ADAPTER_STATE_CHANGED](./common_event/commonEvent-nfc.md) +Indicates that the state of the device NFC adapter has changed. -## COMMON_EVENT_NFC_ACTION_ADAPTER_STATE_CHANGED -(Reserved, not supported yet) Indicates that the state of the device NFC adapter has changed. -- Value: **usual.event.nfc.action.ADAPTER_STATE_CHANGED** -- Required subscriber permissions: none - - -## COMMON_EVENT_NFC_ACTION_RF_FIELD_ON_DETECTED -(Reserved, not supported yet) Indicates that the NFC RF field is detected to be in the enabled state. -- Value: **usual.event.nfc.action.RF_FIELD_ON_DETECTED** -- Required subscriber permissions: ohos.permission.MANAGE_SECURE_SETTINGS - +## [COMMON_EVENT_NFC_ACTION_RF_FIELD_ON_DETECTED](./common_event/commonEvent-nfc.md) +Indicates that the NFC RF field is on. -## COMMON_EVENT_NFC_ACTION_RF_FIELD_OFF_DETECTED -(Reserved, not supported yet) Indicates that the NFC RF field is detected to be in the disabled state. -- Value: **usual.event.nfc.action.RF_FIELD_OFF_DETECTED** -- Required subscriber permissions: ohos.permission.MANAGE_SECURE_SETTINGS +## [COMMON_EVENT_NFC_ACTION_RF_FIELD_OFF_DETECTED](./common_event/commonEvent-nfc.md) +Indicates that the NFC RF field is off. - -## COMMON_EVENT_DISCHARGING +## [COMMON_EVENT_DISCHARGING](./common_event/commonEvent-powermgr.md) Indicates that the system stops charging the battery. -- Value: **usual.event.DISCHARGING** -- Required subscriber permissions: none - -## COMMON_EVENT_CHARGING +## [COMMON_EVENT_CHARGING](./common_event/commonEvent-powermgr.md) Indicates that the system starts charging the battery. -- Value: **usual.event.CHARGING** -- Required subscriber permissions: none -## COMMON_EVENT_CHARGE_TYPE_CHANGED +## [COMMON_EVENT_CHARGE_TYPE_CHANGED](./common_event/commonEvent-powermgr.md) Indicates that the system charging type has changed. This event is available only for system applications. -- Value: **usual.event.CHARGE_TYPE_CHANGED** -- Required subscriber permissions: none ## [COMMON_EVENT_DEVICE_IDLE_MODE_CHANGED](./common_event/commonEvent-resourceschedule.md) -(Reserved, not supported yet) Indicates that the system idle mode has changed. -- Value: **usual.event.DEVICE_IDLE_MODE_CHANGED** -- Required subscriber permissions: none - +Indicates that the system idle mode has changed. ## [COMMON_EVENT_DEVICE_IDLE_EXEMPTION_LIST_UPDATED10+](./common_event/commonEvent-resourceschedule.md) Indicates that the exemption list for resource usage restrictions has been updated in idle mode. This event is for system applications only. -- Value: **usual.event.DEVICE_IDLE_EXEMPTION_LIST_UPDATED** -- Required subscriber permissions: none -## COMMON_EVENT_POWER_SAVE_MODE_CHANGED +## [COMMON_EVENT_POWER_SAVE_MODE_CHANGED](./common_event/commonEvent-powermgr.md) Indicates that the system power saving mode has changed. -- Value: **usual.event.POWER_SAVE_MODE_CHANGED** -- Required subscriber permissions: none - -## COMMON_EVENT_USER_ADDED +## [COMMON_EVENT_USER_ADDED](./common_event/commonEvent-account.md) Indicates that a user has been added to the system. -- Value: **usual.event.USER_ADDED** -- Required subscriber permissions: ohos.permission.MANAGE_LOCAL_ACCOUNTS - - -## COMMON_EVENT_USER_REMOVED +## [COMMON_EVENT_USER_REMOVED](./common_event/commonEvent-account.md) Indicates that a user has been removed from the system. -- Value: **usual.event.USER_REMOVED** -- Required subscriber permissions: ohos.permission.MANAGE_LOCAL_ACCOUNTS - - ## COMMON_EVENT_ABILITY_ADDED (Reserved, not supported yet) Indicates that an ability has been added. - Value: **usual.event.ABILITY_ADDED** - Required subscriber permissions: ohos.permission.LISTEN_BUNDLE_CHANGE - ## COMMON_EVENT_ABILITY_REMOVED (Reserved, not supported yet) Indicates that an ability has been removed. - Value: **usual.event.ABILITY_REMOVED** - Required subscriber permissions: ohos.permission.LISTEN_BUNDLE_CHANGE - ## COMMON_EVENT_ABILITY_UPDATED (Reserved, not supported yet) Indicates that an ability has been updated. - Value: **usual.event.ABILITY_UPDATED** - Required subscriber permissions: ohos.permission.LISTEN_BUNDLE_CHANGE - ## COMMON_EVENT_LOCATION_MODE_STATE_CHANGED (Reserved, not supported yet) Indicates that the location mode of the system has changed. - Value: **usual.event.location.MODE_STATE_CHANGED** - Required subscriber permissions: none - ## COMMON_EVENT_IVI_SLEEP (Reserved, not supported yet) Indicates that the in-vehicle infotainment (IVI) system is in sleep mode. - Value: **common.event.IVI_SLEEP** - Required subscriber permissions: none - ## COMMON_EVENT_IVI_PAUSE (Reserved, not supported yet) Indicates that the IVI system as entered sleep mode and instructs the playing application to stop playback. - Value: **common.event.IVI_PAUSE** - Required subscriber permissions: none - ## COMMON_EVENT_IVI_STANDBY (Reserved, not supported yet) Requests a third-party application in the IVI system to pause the current work. - Value: **common.event.IVI_STANDBY** - Required subscriber permissions: none - ## COMMON_EVENT_IVI_LASTMODE_SAVE (Reserved, not supported yet) Requests a third-party application in the IVI system to save its last mode. - Value: **common.event.IVI_LASTMODE_SAVE** - Required subscriber permissions: none - ## COMMON_EVENT_IVI_VOLTAGE_ABNORMAL (Reserved, not supported yet) Indicates that the voltage of the vehicle's power system is abnormal. - Value: **common.event.IVI_VOLTAGE_ABNORMAL** - Required subscriber permissions: none - ## COMMON_EVENT_IVI_HIGH_TEMPERATURE (Reserved, not supported yet) Indicates that the temperature of the IVI system is high. - Value: **common.event.IVI_HIGH_TEMPERATURE** - Required subscriber permissions: none - ## COMMON_EVENT_IVI_EXTREME_TEMPERATURE (Reserved, not supported yet) Indicates that the temperature of the IVI system is extremely high. - Value: **common.event.IVI_EXTREME_TEMPERATURE** - Required subscriber permissions: none - ## COMMON_EVENT_IVI_TEMPERATURE_ABNORMAL (Reserved, not supported yet) Indicates that the IVI system is at an extreme temperature. - Value: **common.event.IVI_TEMPERATURE_ABNORMAL** - Required subscriber permissions: none - ## COMMON_EVENT_IVI_VOLTAGE_RECOVERY (Reserved, not supported yet) Indicates that the voltage of the vehicle's power system is restored to normal. - Value: **common.event.IVI_VOLTAGE_RECOVERY** @@ -733,36 +563,24 @@ Indicates that a user has been removed from the system. - Value: **common.event.IVI_ACTIVE** - Required subscriber permissions: none -## COMMON_EVENT_USB_STATE9+ +## [COMMON_EVENT_USB_STATE9+](common_event/commonEvent-usb.md) Indicates that the USB device state has changed. -For details, see [Common Events of the USB Subsystem](common_event/commonEvent-usb.md). - -## COMMON_EVENT_USB_PORT_CHANGED9+ +## [**COMMON_EVENT_USB_PORT_CHANGED**9+](./common_event/commonEvent-usb.md) Indicates that the USB port state of the device has changed. -For details, see [Common Events of the USB Subsystem](common_event/commonEvent-usb.md). - -## COMMON_EVENT_USB_DEVICE_ATTACHED +## [COMMON_EVENT_USB_DEVICE_ATTACHED](./common_event/commonEvent-usb.md) Indicates that a USB device has been attached to the device functioning as a USB host. -For details, see [Common Events of the USB Subsystem](common_event/commonEvent-usb.md). - -## COMMON_EVENT_USB_DEVICE_DETACHED +## [COMMON_EVENT_USB_DEVICE_DETACHED](./common_event/commonEvent-usb.md) Indicates that a USB device has been detached from the device functioning as a USB host. -For details, see [Common Events of the USB Subsystem](common_event/commonEvent-usb.md). - -## COMMON_EVENT_USB_ACCESSORY_ATTACHED +## [COMMON_EVENT_USB_ACCESSORY_ATTACHED](./common_event/commonEvent-usb.md) (Reserved, not supported yet) Indicates that a USB accessory was attached. -For details, see [Common Events of the USB Subsystem](common_event/commonEvent-usb.md). - -## COMMON_EVENT_USB_ACCESSORY_DETACHED +## [COMMON_EVENT_USB_ACCESSORY_DETACHED](./common_event/commonEvent-usb.md) (Reserved, not supported yet) Indicates that a USB accessory was detached. -For details, see [Common Events of the USB Subsystem](common_event/commonEvent-usb.md). - ## COMMON_EVENT_DISK_REMOVED (Reserved, not supported yet) Indicates that an external storage device was removed. - Value: **usual.event.data.DISK_BAD_REMOVAL** @@ -773,13 +591,11 @@ For details, see [Common Events of the USB Subsystem](common_event/commonEvent-u - Value: **usual.event.data.DISK_UNMOUNTABLE** - Required subscriber permissions: ohos.permission.STORAGE_MANAGER - ## COMMON_EVENT_DISK_MOUNTED (Reserved, not supported yet) Indicates that an external storage device was mounted. - Value: **usual.event.hardware.usb.action.USB_ACCESSORY_DETACHED** - Required subscriber permissions: ohos.permission.STORAGE_MANAGER - ## COMMON_EVENT_DISK_BAD_REMOVAL (Reserved, not supported yet) Indicates that an external storage device was removed without being unmounted. - Value: usual.event.data.DISK_REMOVED @@ -795,30 +611,20 @@ For details, see [Common Events of the USB Subsystem](common_event/commonEvent-u - Value: **usual.event.data.DISK_EJECT** - Required subscriber permissions: ohos.permission.STORAGE_MANAGER -## COMMON_EVENT_VOLUME_REMOVED9+ +## [COMMON_EVENT_VOLUME_REMOVED9+](./common_event/commonEvent-filemanagement.md) Indicates that an external storage device was removed. -- Value: **usual.event.data.VOLUME_REMOVED** -- Required subscriber permissions: ohos.permission.STORAGE_MANAGER -## COMMON_EVENT_VOLUME_UNMOUNTED9+ +## [COMMON_EVENT_VOLUME_UNMOUNTED9+](./common_event/commonEvent-filemanagement.md) Indicates that an external storage device was unmounted. -- Value: **usual.event.data.VOLUME_UNMOUNTED** -- Required subscriber permissions: ohos.permission.STORAGE_MANAGER -## COMMON_EVENT_VOLUME_MOUNTED9+ +## [COMMON_EVENT_VOLUME_MOUNTED9+](./common_event/commonEvent-filemanagement.md) Indicates that an external storage device was mounted. -- Value: **usual.event.data.VOLUME_MOUNTED** -- Required subscriber permissions: ohos.permission.STORAGE_MANAGER -## COMMON_EVENT_VOLUME_BAD_REMOVAL9+ +## [COMMON_EVENT_VOLUME_BAD_REMOVAL9+](./common_event/commonEvent-filemanagement.md) Indicates that an external storage device was removed without being unmounted. -- Value: **usual.event.data.VOLUME_BAD_REMOVAL** -- Required subscriber permissions: ohos.permission.STORAGE_MANAGER -## COMMON_EVENT_VOLUME_EJECT9+ +## [COMMON_EVENT_VOLUME_EJECT9+](./common_event/commonEvent-filemanagement.md) Indicates that an external storage device was ejected (at the software level). -- Value: usual.event.data.VOLUME_EJECT -- Required subscriber permissions: ohos.permission.STORAGE_MANAGER ## COMMON_EVENT_VISIBLE_ACCOUNTS_UPDATED (Reserved, not supported yet) Indicates that the account visibility changed. @@ -845,11 +651,8 @@ Indicates that the screen has been split. - Value: **usual.event.SPLIT_SCREEN** - Required subscriber permissions: ohos.permission.RECEIVER_SPLIT_SCREEN -## COMMON_EVENT_SLOT_CHANGE9+ +## [COMMON_EVENT_SLOT_CHANGE9+](./common_event/commonEvent-ans.md) Indicates that the notification slot has been updated. -- Value: **usual.event.SLOT_CHANGE** -- Required subscriber permissions: ohos.permission.NOTIFICATION_CONTROLLER - ## COMMON_EVENT_SPN_INFO_CHANGED9+ Indicates that the SPN displayed has been updated. - Value: **usual.event.SPN_INFO_CHANGED** @@ -857,130 +660,99 @@ Indicates that the SPN displayed has been updated. ## [COMMON_EVENT_QUICK_FIX_APPLY_RESULT9+](./common_event/commonEvent-ability.md) Indicates the result of applying a quick fix to the application. -- Value: **usual.event.QUICK_FIX_APPLY_RESULT** -- Required subscriber permissions: none ## COMMON_EVENT_HTTP_PROXY_CHANGE10+ Indicates that the HTTP proxy configuration has changed. - Value: **usual.event.HTTP_PROXY_CHANGE** - Required subscriber permissions: none -## COMMON_EVENT_DOMAIN_ACCOUNT_STATUS_CHANGED10+ +## [COMMON_EVENT_DOMAIN_ACCOUNT_STATUS_CHANGED10+](./common_event/commonEvent-account.md) Indicates that the domain account status has changed. -- Value: **usual.event.DOMAIN_ACCOUNT_STATUS_CHANGED** -- Required subscriber permissions: none - ## [COMMON_EVENT_SIM_STATE_CHANGED10+](./common_event/commonEvent-telephony.md) Indicates that the SIM card state has changed. -- Value: **usual.event.SIM_STATE_CHANGED** -- Required subscriber permissions: none - ## [COMMON_EVENT_SMS_RECEIVED_COMPLETED10+](./common_event/commonEvent-telephony.md) Indicates that the SMS message is received. -- Value: **usual.event.SMS_RECEIVED_COMPLETED** -- Required subscriber permissions: ohos.permission.RECEIVE_SMS - ## [COMMON_EVENT_SMS_EMERGENCY_CB_RECEIVE_COMPLETED10+](./common_event/commonEvent-telephony.md) Indicates that an emergency cell broadcast message is received. -- Value: **usual.event.SMS_EMERGENCY_CB_RECEIVE_COMPLETED** -- Required subscriber permissions: ohos.permission.RECEIVE_SMS - ## [COMMON_EVENT_SMS_CB_RECEIVE_COMPLETED10+](./common_event/commonEvent-telephony.md) Indicates that a cell broadcast message is received. -- Value: **usual.event.SMS_CB_RECEIVE_COMPLETED** -- Required subscriber permissions: ohos.permission.RECEIVE_SMS - ## [COMMON_EVENT_STK_COMMAND10+](./common_event/commonEvent-telephony.md) (Reserved, not supported yet) Indicates the STK command. -- Value: **usual.event.STK_COMMAND** -- Required subscriber permissions: none - ## [COMMON_EVENT_STK_SESSION_END10+](./common_event/commonEvent-telephony.md) (Reserved, not supported yet) Indicates that an STK session ends. -- Value: **usual.event.STK_SESSION_END** -- Required subscriber permissions: none - ## [COMMON_EVENT_STK_CARD_STATE_CHANGED10+](./common_event/commonEvent-telephony.md) (Reserved, not supported yet) Indicates that the STK card state has changed. -- Value: **usual.event.STK_CARD_STATE_CHANGED** -- Required subscriber permissions: ohos.permission - ## [COMMON_EVENT_STK_ALPHA_IDENTIFIER10+](./common_event/commonEvent-telephony.md) (Reserved, not supported yet) Indicates the STK alpha indicator. -- Value: **usual.event.STK_ALPHA_IDENTIFIER** -- Required subscriber permissions: none - ## [COMMON_EVENT_SMS_WAPPUSH_RECEIVE_COMPLETED10+](./common_event/commonEvent-telephony.md) Indicates that a WAP push message is received. -- Value: **usual.event.SMS_WAPPUSH_RECEIVE_COMPLETED** -- Required subscriber permissions: ohos.permission.RECEIVE_SMS - ## [COMMON_EVENT_OPERATOR_CONFIG_CHANGED10+](./common_event/commonEvent-telephony.md) Indicates that the carrier configuration has been updated. -- Value: **usual.event.OPERATOR_CONFIG_CHANGED** -- Required subscriber permissions: none - ## [COMMON_EVENT_SIM_CARD_DEFAULT_SMS_SUBSCRIPTION_CHANGED10+](./common_event/commonEvent-telephony.md) Indicates that the default SIM card for the SMS service has changed. -- Value: **usual.event.DEFAULT_SMS_SUBSCRIPTION_CHANGED** -- Required subscriber permissions: none - ## [COMMON_EVENT_SIM_CARD_DEFAULT_DATA_SUBSCRIPTION_CHANGED10+](./common_event/commonEvent-telephony.md) Indicates that the default SIM card for the mobile data service has changed. -- Value: **usual.event.DEFAULT_DATA_SUBSCRIPTION_CHANGED** -- Required subscriber permissions: none - ## [COMMON_EVENT_SIM_CARD_DEFAULT_MAIN_SUBSCRIPTION_CHANGED10+](./common_event/commonEvent-telephony.md) Indicates that the default primary SIM card has changed. -- Value: **usual.event.SIM.DEFAULT_MAIN_SUBSCRIPTION_CHANGED** -- Required subscriber permissions: none - ## [COMMON_EVENT_SIM_CARD_DEFAULT_VOICE_SUBSCRIPTION_CHANGED10+](./common_event/commonEvent-telephony.md) Indicates that the default SIM card for the voice service has changed. -- Value: **usual.event.DEFAULT_VOICE_SUBSCRIPTION_CHANGED** -- Required subscriber permissions: none - ## [COMMON_EVENT_CALL_STATE_CHANGED10+](./common_event/commonEvent-telephony.md) Indicates that the call state has changed. -- Value: **usual.event.CALL_STATE_CHANGED** -- Required subscriber permissions: ohos.permission.GET_TELEPHONY_STATE - ## [COMMON_EVENT_CELLULAR_DATA_STATE_CHANGED10+](./common_event/commonEvent-telephony.md) Indicates that the cellular data state has changed. -- Value: **usual.event.CELLULAR_DATA_STATE_CHANGED** -- Required subscriber permissions: none - ## [COMMON_EVENT_NETWORK_STATE_CHANGED10+](./common_event/commonEvent-telephony.md) Indicates that the network state has changed. -- Value: **usual.event.NETWORK_STATE_CHANGED** -- Required subscriber permissions: none - ## [COMMON_EVENT_SIGNAL_INFO_CHANGED10+](./common_event/commonEvent-telephony.md) Indicates that the signal information is updated. -- Value: **usual.event.SIGNAL_INFO_CHANGED** -- Required subscriber permissions: none - ## [COMMON_EVENT_INCOMING_CALL_MISSED10+](./common_event/commonEvent-telephony.md) Indicates a missed call. -- Value: **usual.event.INCOMING_CALL_MISSED** -- Required subscriber permissions: ohos.permission.GET_TELEPHONY_STATE - ## [COMMON_EVENT_RADIO_STATE_CHANGE10+](./common_event/commonEvent-telephony.md) Indicates that the power-on and power-off status of the modem has changed. -- Value: **usual.event.RADIO_STATE_CHANGE** - -## COMMON_EVENT_SCREEN_LOCKED 10+ +## [COMMON_EVENT_SCREEN_LOCKED 10+](./common_event/commonEvent-screenlock.md) Indicates that the screen is locked. -- Value: **usual.event.SCREEN_LOCKED** -- Required subscriber permissions: none - -## COMMON_EVENT_SCREEN_UNLOCKED10+ +## [COMMON_EVENT_SCREEN_UNLOCKED10+](./common_event/commonEvent-screenlock.md) Indicates that the screen is unlocked. -- Value: **usual.event.SCREEN_UNLOCKED** -- Required subscriber permissions: none ## [COMMON_EVENT_QUICK_FIX_REVOKE_RESULT10+](./common_event/commonEvent-ability.md#common_event_quick_fix_revoke_result10) -ָIndicates the result of revoking a quick fix to the application. \ No newline at end of file +ָIndicates the result of revoking a quick fix to the application. + +## [COMMON_EVENT_DISTRIBUTED_ACCOUNT_LOGIN](./common_event/commonEvent-account.md) +(Reserved, not supported yet) Indicates a successful login to a distributed account. + +## [COMMON_EVENT_DISTRIBUTED_ACCOUNT_LOGOUT](./common_event/commonEvent-account.md) +(Reserved, not supported yet) Indicates a successful logout of a distributed account. + +## [COMMON_EVENT_DISTRIBUTED_ACCOUNT_TOKEN_INVALID](./common_event/commonEvent-account.md) +(Reserved, not supported yet) Indicates the token of a distributed account is invalid. + +## [COMMON_EVENT_DISTRIBUTED_ACCOUNT_LOGOFF](./common_event/commonEvent-account.md) +(Reserved, not supported yet) Indicates that a distributed account is deregistered. + +## [COMMON_EVENT_USER_INFO_UPDATED9+](./common_event/commonEvent-account.md) + +Indicates that the user information has been updated. + +## [COMMON_EVENT_AUDIO_QUALITY_CHANGE](./common_event/commonEvent-telephony.md) + +Indicates that the audio quality has changed. + +## [COMMON_EVENT_NET_QUOTA_WARNING10+](./common_event/commonEvent-netmanager.md) +Indicates that the network data usage has reached the alarm threshold. + +## [COMMON_EVENT_NET_QUOTA_LIMIT_REMINDED10+](./common_event/commonEvent-netmanager.md) +Indicates that the network data usage has reached the upper limit, and network access is still available. + +## [OMMON_EVENT_NET_QUOTA_LIMIT10+](./common_event/commonEvent-netmanager.md) +Indicates that the network data usage has reached the upper limit, and network access becomes unavailable. + +## [COMMON_EVENT_HTTP_PROXY_CHANGE10+](./common_event/commonEvent-netmanager.md) +Indicates that the HTTP proxy configuration has changed. + +## [COMMON_EVENT_AIRPLANE_MODE_CHANGED10+](./common_event/commonEvent-netmanager.md) +Indicates that the airplane mode state has changed. + +## [COMMON_EVENT_CONNECTIVITY_CHANGE10+](./common_event/commonEvent-netmanager.md) +Indicates that the network connection state has changed. \ No newline at end of file diff --git a/en/application-dev/reference/apis/common_event/commonEvent-account.md b/en/application-dev/reference/apis/common_event/commonEvent-account.md new file mode 100644 index 0000000000..f850f33644 --- /dev/null +++ b/en/application-dev/reference/apis/common_event/commonEvent-account.md @@ -0,0 +1,76 @@ +# Common Events of the Account Subsystem +This document lists the common system events provided by the account subsystem to applications. Applications can use [APIs](../js-apis-commonEventManager.md) to subscribe to common system events. + +## COMMON_EVENT_USER_ADDED +Indicates that a user has been added to the system. + +- Value: usual.event.USER_ADDED +- Required subscriber permissions: ohos.permission.MANAGE_LOCAL_ACCOUNTS + +When a system account is created, the event notification 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 (OS Account Management)](../js-apis-osAccount.md). + +## COMMON_EVENT_USER_REMOVED +Indicates that a user has been removed from the system. + +- Value: usual.event.USER_REMOVED +- Required subscriber permissions: ohos.permission.MANAGE_LOCAL_ACCOUNTS + +When a system account is removed, the event notification 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 (OS Account Management)](../js-apis-osAccount.md). + +## COMMON_EVENT_DOMAIN_ACCOUNT_STATUS_CHANGED10+ +Indicates that the status of the domain account status changes. + +- Value: usual.event.DOMAIN_ACCOUNT_STATUS_CHANGED +- Required subscriber permissions: ohos.permission.GET_LOCAL_ACCOUNTS + +When a domain user account is authenticated, deleted, or has the token updated, the event notification 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 (OS Account Management)](../js-apis-osAccount.md). + +## COMMON_EVENT_USER_SWITCHED +Indicates that user switching is in progress. + +- Value: usual.event.USER_SWITCHED +- Required subscriber permissions: ohos.permission.MANAGE_LOCAL_ACCOUNTS + +When the system account is switched, the event notification 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 (OS Account Management)](../js-apis-osAccount.md). + +## COMMON_EVENT_USER_INFO_UPDATED9+ +Indicates that the user information has been updated. + +- Value: **usual.event.USER_INFO_UPDATED** +- Required subscriber permissions: none + +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 **setOsAccountDistributedInfon**. The first two are system APIs, and the last is a public API. For details, see [@ohos.account.osAccount (OS Account Management)](../js-apis-osAccount.md). + +## COMMON_EVENT_DISTRIBUTED_ACCOUNT_LOGIN +(Reserved, not supported yet) Indicates a successful login to a distributed account. + +- Value: usual.event.DISTRIBUTED_ACCOUNT_LOGIN +- Required subscriber permissions: none + +## COMMON_EVENT_DISTRIBUTED_ACCOUNT_LOGOUT +(Reserved, not supported yet) Indicates a successful logout of a distributed account. + +- Value: usual.event.DISTRIBUTED_ACCOUNT_LOGOUT +- Required subscriber permissions: none + +## COMMON_EVENT_DISTRIBUTED_ACCOUNT_TOKEN_INVALID +(Reserved, not supported yet) Indicates the token of a distributed account is invalid. + +- Value: usual.event.DISTRIBUTED_ACCOUNT_TOKEN_INVALID +- Required subscriber permissions: none + +## COMMON_EVENT_DISTRIBUTED_ACCOUNT_LOGOFF +(Reserved, not supported yet) Indicates that a distributed account is deregistered. + +- Value: usual.event.DISTRIBUTED_ACCOUNT_LOGOFF +- Required subscriber permissions: none diff --git a/en/application-dev/reference/apis/common_event/commonEvent-filemanagement.md b/en/application-dev/reference/apis/common_event/commonEvent-filemanagement.md new file mode 100644 index 0000000000..04c4d99a1e --- /dev/null +++ b/en/application-dev/reference/apis/common_event/commonEvent-filemanagement.md @@ -0,0 +1,37 @@ +# Common Events of the File Management Subsystem +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_REMOVED9+ +Indicates that an external storage device was removed. +- Value: usual.event.data.VOLUME_REMOVED +- Required subscriber permissions: ohos.permission.STORAGE_MANAGER + +When an external storage device is removed, the event notification service is triggered to publish this event. + +## COMMON_EVENT_VOLUME_UNMOUNTED9+ +Indicates that an external storage device was unmounted. +- Value: usual.event.data.VOLUME_UNMOUNTED +- Required subscriber permissions: ohos.permission.STORAGE_MANAGER + +When an external storage device is successfully unmounted by calling [unmount](../js-apis-file-volumemanager.md) or by removing the device, the event notification service is triggered to publish this event. + +## COMMON_EVENT_VOLUME_MOUNTED9+ +Indicates that an external storage device was mounted. +- Value: usual.event.data.VOLUME_MOUNTED +- Required subscriber permissions: ohos.permission.STORAGE_MANAGER + +When an external storage device is mounted by calling [mount](../js-apis-file-volumemanager.md) or by inserting the device, the event notification service is triggered to publish this event. + +## COMMON_EVENT_VOLUME_BAD_REMOVAL9+ +Indicates that an external storage device was removed without being unmounted. +- Value: usual.event.data.VOLUME_BAD_REMOVAL +- Required subscriber permissions: ohos.permission.STORAGE_MANAGER + +When an external storage device is directly removed without being umounted, the event notification service is triggered to publish this event. + +## COMMON_EVENT_VOLUME_EJECT9+ +Indicates that an external storage device is about to be ejected. +- Value: usual.event.data.VOLUME_EJECT +- Required subscriber permissions: ohos.permission.STORAGE_MANAGER + +When the user calls [unmount](../js-apis-file-volumemanager.md) on a mounted external storage device or removes the device, the event notification service is triggered to publish this event. diff --git a/en/application-dev/reference/apis/common_event/commonEvent-mms.md b/en/application-dev/reference/apis/common_event/commonEvent-mms.md new file mode 100644 index 0000000000..4c4425b2db --- /dev/null +++ b/en/application-dev/reference/apis/common_event/commonEvent-mms.md @@ -0,0 +1,11 @@ +# Common Events of the SMS Application +This document lists the common system events provided by the SMS application to applications. Applications can use [APIs](../js-apis-commonEventManager.md) to subscribe to common system events. + +## COMMON_EVENT_SMS_RECEIVE_COMPLETED + +Indicates that a new SMS message has been received. + +- Value: usual.event.SMS_RECEIVE_COMPLETED +- Required subscriber permissions: none + +When the device receives a new SMS message, the event notification service is triggered to publish this event. diff --git a/en/application-dev/reference/apis/common_event/commonEvent-netmanager.md b/en/application-dev/reference/apis/common_event/commonEvent-netmanager.md new file mode 100644 index 0000000000..73471c0ef6 --- /dev/null +++ b/en/application-dev/reference/apis/common_event/commonEvent-netmanager.md @@ -0,0 +1,57 @@ +# Common Events of the Network Management Subsystem +This document lists the common system events provided by the network management subsystem to applications. Applications can use [APIs](../js-apis-commonEventManager.md) to subscribe to common system events. + + +## COMMON_EVENT_CONNECTIVITY_CHANGE10+ + +Indicates that the network connection state has changed. + +- Value: usual.event.CONNECTIVITY_CHANGE +- Required subscriber permissions: none + +When 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. + +## COMMON_EVENT_AIRPLANE_MODE_CHANGED10+ + +Indicates that the airplane mode state has changed. + +- Value: usual.event.AIRPLANE_MODE +- Required subscriber permissions: none + +When the airplane mode is set, the event notification service is triggered to publish this event. + +## COMMON_EVENT_HTTP_PROXY_CHANGE10+ + +Indicates that the HTTP proxy configuration has changed. + +- Value: usual.event.HTTP_PROXY_CHANGE +- Required subscriber permissions: none + +When the configuration of the global or network-specific (such as Ethernet and Wi-Fi) HTTP proxy changes, the event notification service is triggered to publish this event. + +## COMMON_EVENT_NET_QUOTA_WARNING10+ + +Indicates that the network data usage has reached the alarm threshold. + +- Value: usual.event.QUOTA_WARNING +- Required subscriber permissions: none + +When the network data usage reaches 80% of the limit, the event notification service is triggered to publish this event. + +## COMMON_EVENT_NET_QUOTA_LIMIT_REMINDED10+ + +Indicates that the network data usage has reached the upper limit, and network access is still available. + +- Value: usual.event.NET_QUOTA_LIMIT_REMINDED +- Required subscriber permissions: none + +When the network data usage reaches the upper limit and the user chooses to continue to use the network, the event notification service is triggered to publish this event. + +## COMMON_EVENT_NET_QUOTA_LIMIT10+ + +Indicates that the network data usage has reached the upper limit, and network access becomes unavailable. + +- Value: usual.event.NET_QUOTA_LIMIT +- Required subscriber permissions: none + +When the network data usage reaches the upper limit and continuing to use the network is not allowed, the event notification service is triggered to publish this event. diff --git a/en/application-dev/reference/apis/common_event/commonEvent-nfc.md b/en/application-dev/reference/apis/common_event/commonEvent-nfc.md new file mode 100644 index 0000000000..b049143416 --- /dev/null +++ b/en/application-dev/reference/apis/common_event/commonEvent-nfc.md @@ -0,0 +1,26 @@ +# Common Events of the NFC Subsystem +This document lists the common system events provided by the NFC subsystem to applications. Applications can use [APIs](../js-apis-commonEventManager.md) to subscribe to common system events. + +## COMMON_EVENT_NFC_ACTION_ADAPTER_STATE_CHANGED +Indicates that the state of the device NFC adapter has changed. + +- Value: usual.event.nfc.action.ADAPTER_STATE_CHANGED +- Required subscriber permissions: none + +When the state of the device NFC adapter changes, the event notification service is triggered to publish this event. + +## COMMON_EVENT_NFC_ACTION_RF_FIELD_ON_DETECTED +Indicates that the NFC RF field is on. + +- Value: usual.event.nfc.action.RF_FIELD_ON_DETECTED +- Required subscriber permissions: ohos.permission.MANAGE_SECURE_SETTINGS + +When the NFC RF field becomes available, the event notification service is triggered to publish this event. + +## COMMON_EVENT_NFC_ACTION_RF_FIELD_OFF_DETECTED +Indicates that the NFC RF field is off. + +- Value: usual.event.nfc.action.RF_FIELD_OFF_DETECTED +- Required subscriber permissions: ohos.permission.MANAGE_SECURE_SETTINGS + +When the NFC RF field becomes unavailable, the event notification service is triggered to publish this event. diff --git a/en/application-dev/reference/apis/common_event/commonEvent-powermgr.md b/en/application-dev/reference/apis/common_event/commonEvent-powermgr.md new file mode 100644 index 0000000000..d2829f0638 --- /dev/null +++ b/en/application-dev/reference/apis/common_event/commonEvent-powermgr.md @@ -0,0 +1,106 @@ +# Common Events of the Power Management Subsystem +This document lists the common system events provided by the power management subsystem to applications. Applications can use [APIs](../js-apis-commonEventManager.md) to subscribe to common system events. + +## COMMON_EVENT_BATTERY_CHANGED +Indicates that the charging state, level, and other information about the battery have changed. + +- Value: usual.event.BATTERY_CHANGED +- Required subscriber permissions: none + +When 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. + +## COMMON_EVENT_BATTERY_LOW +Indicates that the battery level is low. + +- Value: usual.event.BATTERY_LOW +- Required subscriber permissions: none + +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, see [Battery Level Customization](../../../../device-dev/subsystems/subsys-power-battery-level-customization.md). + +## COMMON_EVENT_BATTERY_OKAY +Indicates that the battery level is normal. + +- Value: usual.event.BATTERY_OKAY +- Required subscriber permissions: none + +When the battery level changes from the low level to normal level, the event notification service is triggered to publish this event. + +## COMMON_EVENT_POWER_CONNECTED +Indicates that the device is connected to an external power supply. + +- Value: usual.event.POWER_CONNECTED +- Required subscriber permissions: none + +When the device connects to an external charger, the event notification service is triggered to publish this event. + +## COMMON_EVENT_POWER_DISCONNECTED +Indicates that the device is disconnected from the external power supply. + +- Value: usual.event.POWER_DISCONNECTED +- Required subscriber permissions: none + +When the device is disconnected from the external power supply, the event notification service is triggered to publish this event. + +## COMMON_EVENT_DISCHARGING +Indicates that the system stops charging the battery. + +- Value: usual.event.DISCHARGING +- Required subscriber permissions: none + +When the system stops charging the battery, the event notification service is triggered to publish this event. + +## COMMON_EVENT_CHARGING +Indicates that the system starts charging the battery. + +- Value: usual.event.CHARGING +- Required subscriber permissions: none + +When the system starts charging the battery, the event notification service is triggered to publish this event. + +## COMMON_EVENT_CHARGE_TYPE_CHANGED +Indicates that the system charging type has changed. This event is available only for system applications. +- Value: usual.event.CHARGE_TYPE_CHANGED + +- Required subscriber permissions: none + +When the system charging type changes, the event notification service is triggered to publish this event. + +## COMMON_EVENT_SHUTDOWN +Indicates that the device is being and will be shut down. + +- Value: usual.event.SHUTDOWN +- Required subscriber permissions: none + +When the device is being shut down until it is powered off, the event notification service is triggered to publish this event. + +## COMMON_EVENT_SCREEN_OFF +Indicates that the device screen is off and the device is in sleep mode. + +- Value: usual.event.SCREEN_OFF +- Required subscriber permissions: none + +When the device screen is turned off and the device is in sleep mode, the event notification service is triggered to publish this event. + +## COMMON_EVENT_SCREEN_ON +Indicates that the device screen is on and the device is in the active state. + +- Value: usual.event.SCREEN_ON +- Required subscriber permissions: none + +When the device screen is turned on and in the active state, the event notification service is triggered to publish this event. + +## COMMON_EVENT_POWER_SAVE_MODE_CHANGED +Indicates that the system power saving mode has changed. + +- Value: usual.event.POWER_SAVE_MODE_CHANGED +- Required subscriber permissions: none + +When the system power saving mode changes, the event notification service is triggered to publish this event. + +## COMMON_EVENT_THERMAL_LEVEL_CHANGED +Indicates that the device's thermal level has changed. + +- Value: usual.event.THERMAL_LEVEL_CHANGED +- Required subscriber permissions: none + +When the device's thermal level changes, the event notification service is triggered to publish this event. For details about how to configure the thermal level, see [Thermal Level Customization](../../../../device-dev/subsystems/subsys-thermal_level.md). diff --git a/en/application-dev/reference/apis/common_event/commonEvent-screenlock.md b/en/application-dev/reference/apis/common_event/commonEvent-screenlock.md new file mode 100644 index 0000000000..01cbd10b64 --- /dev/null +++ b/en/application-dev/reference/apis/common_event/commonEvent-screenlock.md @@ -0,0 +1,18 @@ +# Common Events of the Theme Framework - Lock Screen +This document lists the common system events provided by the theme framework - lock screen to applications. Applications can use [APIs](../js-apis-commonEventManager.md) to subscribe to common system events. + +## COMMON_EVENT_SCREEN_LOCKED +Indicates that the screen has been locked. + +- Value: usual.event.SCREEN_LOCKED +- Required subscriber permissions: none + +When the screen is locked, the event notification service is triggered to publish this event. + +## COMMON_EVENT_SCREEN_UNLOCKED +Indicates that the screen has been unlocked. + +- Value: usual.event.SCREEN_UNLOCKED +- Required subscriber permissions: none + +When the screen is unlocked, the event notification service is triggered to publish this event. diff --git a/en/application-dev/reference/apis/common_event/commonEvent-time.md b/en/application-dev/reference/apis/common_event/commonEvent-time.md new file mode 100644 index 0000000000..d1fe1562c4 --- /dev/null +++ b/en/application-dev/reference/apis/common_event/commonEvent-time.md @@ -0,0 +1,26 @@ +# Common Events of the Time and Time Zone Subsystem +This document lists the common system events provided by the time and time zone subsystem to applications. Applications can use [APIs](../js-apis-commonEventManager.md) to subscribe to common system events. + +## COMMON_EVENT_TIME_CHANGED +Indicates that the system time has been set. + +- Value: usual.event.TIME_CHANGED +- Required subscriber permissions: none + +When the system time is set, the event notification service is triggered to publish this event. + +## COMMON_EVENT_TIME_TICK +Indicates that the system time has changed. + +- Value: usual.event.TIME_TICK +- Required subscriber permissions: none + +When the system time changes, the event notification service is triggered to publish this event. + +## COMMON_EVENT_TIMEZONE_CHANGED +Indicates that the system time zone has changed. + +- Value: usual.event.TIMEZONE_CHANGED +- Required subscriber permissions: none + +When the system time zone changes, the event notification service is triggered to publish this event. diff --git a/en/application-dev/reference/apis/common_event/commonEvent-wifi.md b/en/application-dev/reference/apis/common_event/commonEvent-wifi.md new file mode 100644 index 0000000000..7930f1e688 --- /dev/null +++ b/en/application-dev/reference/apis/common_event/commonEvent-wifi.md @@ -0,0 +1,123 @@ +# Common Events of the Wi-Fi Subsystem +This document lists the common system events provided by the Wi-Fi subsystem to applications. Applications can use [APIs](../js-apis-commonEventManager.md) to subscribe to common system events. + +## COMMON_EVENT_WIFI_POWER_STATE +Indicates that the Wi-Fi state has changed, for example, enabled or disabled. + +- Value: usual.event.wifi.POWER_STATE +- Required subscriber permissions: none + +When the Wi-Fi state changes, the event notification service is triggered to publish this event. + +## COMMON_EVENT_WIFI_SCAN_FINISHED +Indicates that the Wi-Fi access point has been detected and proven to be available. + +- Value: usual.event.wifi.SCAN_FINISHED +- Required subscriber permissions: ohos.permission.LOCATION + +When a Wi-Fi access point is detected and proven to be available, the event notification service is triggered to publish this event. + +## COMMON_EVENT_WIFI_SCAN_STATE +Indicates that the Wi-Fi access point state has changed. + +- Value: usual.event.wifi.SCAN_STATE +- Required subscriber permissions: ohos.permission.LOCATION + +When the Wi-Fi access point state changes, the event notification service is triggered to publish this event. + +## COMMON_EVENT_WIFI_RSSI_VALUE +Indicates that the Wi-Fi signal strength (RSSI) has changed. + +- Value: usual.event.wifi.RSSI_VALUE +- Required subscriber permissions: ohos.permission.GET_WIFI_INFO + +When the Wi-Fi signal strength (RSSI) changes, the event notification service is triggered to publish this event. + +## COMMON_EVENT_WIFI_CONN_STATE +Indicates that the Wi-Fi connection state has changed. + +- Value: usual.event.wifi.CONN_STATE +- Required subscriber permissions: none + +When the Wi-Fi connection state changes, the event notification service is triggered to publish this event. + +## COMMON_EVENT_WIFI_HOTSPOT_STATE +Indicates that the Wi-Fi hotspot state has changed, for example, enabled or disabled. + +- Value: usual.event.wifi.HOTSPOT_STATE +- Required subscriber permissions: none + +When the Wi-Fi hotspot state changes, the event notification service is triggered to publish this event. + +## COMMON_EVENT_WIFI_AP_STA_JOIN +Indicates that a client has joined the Wi-Fi hotspot of the current device. + +- Value: usual.event.wifi.WIFI_HS_STA_JOIN +- Required subscriber permissions: ohos.permission.GET_WIFI_INFO + +When a client joins the Wi-Fi hotspot of the current device, the event notification service is triggered to publish this event. + + +## COMMON_EVENT_WIFI_AP_STA_LEAVE +Indicates that a client has disconnected from the Wi-Fi hotspot of the current device. + +- Value: usual.event.wifi.WIFI_HS_STA_LEAVE +- Required subscriber permissions: ohos.permission.GET_WIFI_INFO + +When a client is disconnected from the Wi-Fi hotspot of the current device, the event notification service is triggered to publish this event. + +## COMMON_EVENT_WIFI_MPLINK_STATE_CHANGE +Indicates that the state of MPLINK (an enhanced Wi-Fi feature) has changed. + +- Value: usual.event.wifi.mplink.STATE_CHANGE +- Required subscriber permissions: ohos.permission.MPLINK_CHANGE_STATE + +When the state of MPLINK (an enhanced Wi-Fi feature) changes, the event notification service is triggered to publish this event. + +## COMMON_EVENT_WIFI_P2P_CONN_STATE +Indicates that the Wi-Fi P2P connection state has changed. + +- Value: usual.event.wifi.p2p.CONN_STATE_CHANGE +- Required subscriber permissions: ohos.permission.GET_WIFI_INFO and ohos.permission.LOCATION + +When the Wi-Fi P2P connection state changes, the event notification service is triggered to publish this event. + +## COMMON_EVENT_WIFI_P2P_STATE_CHANGED +Indicates that the Wi-Fi P2P state has changed, for example, enabled or disabled. + +- Value: usual.event.wifi.p2p.STATE_CHANGE +- Required subscriber permissions: ohos.permission.GET_WIFI_INFO + +When the Wi-Fi P2P state changes, the event notification service is triggered to publish this event. + +## COMMON_EVENT_WIFI_P2P_PEERS_STATE_CHANGED +Indicates that the state of the Wi-Fi P2P peer device has changed. + +- Value: usual.event.wifi.p2p.DEVICES_CHANGE +- Required subscriber permissions: ohos.permission.GET_WIFI_INFO + +When the state of the Wi-Fi P2P peer device changes, the event notification service is triggered to publish this event. + +## COMMON_EVENT_WIFI_P2P_PEERS_DISCOVERY_STATE_CHANGED +Indicates that the Wi-Fi P2P discovery state has changed. + +- Value: usual.event.wifi.p2p.PEER_DISCOVERY_STATE_CHANGE +- Required subscriber permissions: ohos.permission.GET_WIFI_INFO + +When the Wi-Fi P2P discovery state changes, the event notification service is triggered to publish this event. + +## COMMON_EVENT_WIFI_P2P_CURRENT_DEVICE_STATE_CHANGED +Indicates that the state of the Wi-Fi P2P local device has changed. + +- Value: usual.event.wifi.p2p.CURRENT_DEVICE_CHANGE +- Required subscriber permissions: ohos.permission.GET_WIFI_INFO + +When the state of the Wi-Fi P2P local device changes, the event notification service is triggered to publish this event. + +## COMMON_EVENT_WIFI_P2P_GROUP_STATE_CHANGED +Indicates that the Wi-Fi P2P group information has changed. + +- Value: usual.event.wifi.p2p.GROUP_STATE_CHANGED +- Required subscriber permissions: ohos.permission.GET_WIFI_INFO + +When the Wi-Fi P2P group information changes, the event notification service is triggered to publish this event. diff --git a/en/application-dev/reference/apis/common_event/commonEvent-window.md b/en/application-dev/reference/apis/common_event/commonEvent-window.md new file mode 100644 index 0000000000..b656008573 --- /dev/null +++ b/en/application-dev/reference/apis/common_event/commonEvent-window.md @@ -0,0 +1,10 @@ +# Common Events of the Window Management Subsystem +This document lists the common system events provided by the window management subsystem to applications. Applications can use [APIs](../js-apis-commonEventManager.md) to subscribe to common system events. + +### COMMON_EVENT_SPLIT_SCREEN10+ +Indicates a screen splitting action. + +- Value: usual.event.SPLIT_SCREEN +- Required subscriber permissions: none + +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. -- GitLab