鸿蒙开发接口公共事件与通知：【@ohos.commonEvent (公共事件模块)】

最新推荐文章于 2024-05-24 22:20:29 发布
最新推荐文章于 2024-05-24 22:20:29 发布
阅读量1k 收藏 24
点赞数 33
分类专栏： 鸿蒙 文章标签： harmonyos 鸿蒙开发 openharmony 移动开发 鸿蒙 鸿蒙系统 程序员
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/2301_76813281/article/details/139076149
版权

 公共事件模块

icon-note.gif

  说明：  本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import CommonEvent from '@ohos.commonEvent';
`HarmonyOS与OpenHarmony鸿蒙文档籽料：mau123789是v直接拿`

搜狗高速浏览器截图20240326151450.png

Support

CommonEvent模块支持的事件类型。名称指的是系统公共事件宏；值指的是系统公共事件。

系统能力：  SystemCapability.Notification.CommonEvent

名称值订阅者所需权限说明
COMMON_EVENT_BOOT_COMPLETEDusual.event.BOOT_COMPLETEDohos.permission.RECEIVER_STARTUP_COMPLETED指示用户已完成引导并加载系统的公共事件的操作。
COMMON_EVENT_LOCKED_BOOT_COMPLETEDusual.event.LOCKED_BOOT_COMPLETEDohos.permission.RECEIVER_STARTUP_COMPLETED表示用户已完成引导，系统已加载，但屏幕仍锁定的公共事件的操作。
COMMON_EVENT_SHUTDOWNusual.event.SHUTDOWN无指示设备正在关闭并将继续最终关闭的公共事件的操作。
COMMON_EVENT_BATTERY_CHANGEDusual.event.BATTERY_CHANGED无表示电池充电状态、电平和其他信息发生变化的公共事件的动作。
COMMON_EVENT_BATTERY_LOWusual.event.BATTERY_LOW无表示电池电量低的普通事件的动作。
COMMON_EVENT_BATTERY_OKAYusual.event.BATTERY_OKAY无表示电池退出低电平状态的公共事件的动作。
COMMON_EVENT_POWER_CONNECTEDusual.event.POWER_CONNECTED无设备连接到外部电源的公共事件的动作。
COMMON_EVENT_POWER_DISCONNECTEDusual.event.POWER_DISCONNECTED无设备与外部电源断开的公共事件的动作。
COMMON_EVENT_SCREEN_OFFusual.event.SCREEN_OFF无指示设备屏幕关闭且设备处于睡眠状态的普通事件的动作。
COMMON_EVENT_SCREEN_ONusual.event.SCREEN_ON无指示设备屏幕打开且设备处于交互状态的公共事件的操作。
COMMON_EVENT_THERMAL_LEVEL_CHANGED8+usual.event.THERMAL_LEVEL_CHANGED无指示设备热状态的公共事件的动作。
COMMON_EVENT_USER_PRESENTusual.event.USER_PRESENT无用户解锁设备的公共事件的动作。
COMMON_EVENT_TIME_TICKusual.event.TIME_TICK无表示系统时间更改的公共事件的动作。
COMMON_EVENT_TIME_CHANGEDusual.event.TIME_CHANGED无设置系统时间的公共事件的动作。
COMMON_EVENT_DATE_CHANGEDusual.event.DATE_CHANGED无表示系统日期已更改的公共事件的动作。
COMMON_EVENT_TIMEZONE_CHANGEDusual.event.TIMEZONE_CHANGED无表示系统时区更改的公共事件的动作。
COMMON_EVENT_CLOSE_SYSTEM_DIALOGSusual.event.CLOSE_SYSTEM_DIALOGS无表示用户关闭临时系统对话框的公共事件的动作。
COMMON_EVENT_PACKAGE_ADDEDusual.event.PACKAGE_ADDED无设备上已安装新应用包的公共事件的动作。
COMMON_EVENT_PACKAGE_REPLACEDusual.event.PACKAGE_REPLACED无指示已安装的应用程序包的新版本已替换设备上的旧版本的公共事件的操作。
COMMON_EVENT_MY_PACKAGE_REPLACEDusual.event.MY_PACKAGE_REPLACED无指示应用程序包的新版本已取代前一个版本的公共事件的操作。
COMMON_EVENT_PACKAGE_REMOVEDusual.event.PACKAGE_REMOVED无指示已从设备卸载已安装的应用程序，但应用程序数据保留的公共事件的操作。
COMMON_EVENT_BUNDLE_REMOVEDusual.event.BUNDLE_REMOVED无指示已从设备中卸载已安装的捆绑包，但应用程序数据仍保留的公共事件的操作。
COMMON_EVENT_PACKAGE_FULLY_REMOVEDusual.event.PACKAGE_FULLY_REMOVED无指示已从设备中完全卸载已安装的应用程序（包括应用程序数据和代码）的公共事件的操作。
COMMON_EVENT_PACKAGE_CHANGEDusual.event.PACKAGE_CHANGED无指示应用包已更改的公共事件的动作（例如，包中的组件已启用或禁用）。
COMMON_EVENT_PACKAGE_RESTARTEDusual.event.PACKAGE_RESTARTED无表示用户重启应用包并杀死其所有进程的普通事件的动作。
COMMON_EVENT_PACKAGE_DATA_CLEAREDusual.event.PACKAGE_DATA_CLEARED无用户清除应用包数据的公共事件的动作。
COMMON_EVENT_PACKAGES_SUSPENDEDusual.event.PACKAGES_SUSPENDED无表示应用包已挂起的公共事件的动作。
COMMON_EVENT_PACKAGES_UNSUSPENDEDusual.event.PACKAGES_UNSUSPENDED无表示应用包未挂起的公共事件的动作。
COMMON_EVENT_MY_PACKAGE_SUSPENDEDusual.event.MY_PACKAGE_SUSPENDED无应用包被挂起的公共事件的动作。
COMMON_EVENT_MY_PACKAGE_UNSUSPENDEDusual.event.MY_PACKAGE_UNSUSPENDED无表示应用包未挂起的公共事件的动作。
COMMON_EVENT_UID_REMOVEDusual.event.UID_REMOVED无表示用户ID已从系统中删除的公共事件的动作。
COMMON_EVENT_PACKAGE_FIRST_LAUNCHusual.event.PACKAGE_FIRST_LAUNCH无表示首次启动已安装应用程序的公共事件的动作。
COMMON_EVENT_PACKAGE_NEEDS_VERIFICATIONusual.event.PACKAGE_NEEDS_VERIFICATION无表示应用需要系统校验的公共事件的动作。
COMMON_EVENT_PACKAGE_VERIFIEDusual.event.PACKAGE_VERIFIED无表示应用已被系统校验的公共事件的动作。
COMMON_EVENT_EXTERNAL_APPLICATIONS_AVAILABLEusual.event.EXTERNAL_APPLICATIONS_AVAILABLE无指示安装在外部存储上的应用程序对系统可用的公共事件的操作。
COMMON_EVENT_EXTERNAL_APPLICATIONS_UNAVAILABLEusual.event.EXTERNAL_APPLICATIONS_UNAVAILABLE无指示安装在外部存储上的应用程序对系统不可用的公共事件的操作。
COMMON_EVENT_CONFIGURATION_CHANGEDusual.event.CONFIGURATION_CHANGED无指示设备状态（例如，方向和区域设置）已更改的公共事件的操作。
COMMON_EVENT_LOCALE_CHANGEDusual.event.LOCALE_CHANGED无指示设备区域设置已更改的公共事件的操作。
COMMON_EVENT_MANAGE_PACKAGE_STORAGEusual.event.MANAGE_PACKAGE_STORAGE无设备存储空间不足的公共事件的动作。
COMMON_EVENT_DRIVE_MODEcommon.event.DRIVE_MODE无指示系统处于驾驶模式的公共事件的动作。
COMMON_EVENT_HOME_MODEcommon.event.HOME_MODE无表示系统处于HOME模式的公共事件的动作。
COMMON_EVENT_OFFICE_MODEcommon.event.OFFICE_MODE无表示系统处于办公模式的公共事件的动作。
COMMON_EVENT_USER_STARTEDusual.event.USER_STARTED无表示用户已启动的公共事件的动作。
COMMON_EVENT_USER_BACKGROUNDusual.event.USER_BACKGROUND无表示用户已被带到后台的公共事件的动作。
COMMON_EVENT_USER_FOREGROUNDusual.event.USER_FOREGROUND无表示用户已被带到前台的公共事件的动作。
COMMON_EVENT_USER_SWITCHEDusual.event.USER_SWITCHEDohos.permission.MANAGE_USERS表示用户切换正在发生的公共事件的动作。
COMMON_EVENT_USER_STARTINGusual.event.USER_STARTINGohos.permission.INTERACT_ACROSS_USERS表示要启动用户的公共事件的动作。
COMMON_EVENT_USER_UNLOCKEDusual.event.USER_UNLOCKED无设备重启后解锁时，当前用户的凭据加密存储已解锁的公共事件的动作。
COMMON_EVENT_USER_STOPPINGusual.event.USER_STOPPINGohos.permission.INTERACT_ACROSS_USERS表示要停止用户的公共事件的动作。
COMMON_EVENT_USER_STOPPEDusual.event.USER_STOPPED无表示用户已停止的公共事件的动作。
COMMON_EVENT_HWID_LOGINcommon.event.HWID_LOGIN无华为账号ID用户登录公共事件的动作。
COMMON_EVENT_HWID_LOGOUTcommon.event.HWID_LOGOUT无华为帐号ID用户下线的公共事件动作。
COMMON_EVENT_HWID_TOKEN_INVALIDcommon.event.HWID_TOKEN_INVALID无华为帐号ID无效的公共事件的动作。
COMMON_EVENT_HWID_LOGOFFcommon.event.HWID_LOGOFF无华为账号ID注销公共事件的动作。
COMMON_EVENT_WIFI_POWER_STATEusual.event.wifi.POWER_STATE无Wi-Fi状态公共事件的动作，如启用和禁用。
COMMON_EVENT_WIFI_SCAN_FINISHEDusual.event.wifi.SCAN_FINISHEDohos.permission.LOCATION表示Wi-Fi接入点已被扫描并证明可用的公共事件的操作。
COMMON_EVENT_WIFI_RSSI_VALUEusual.event.wifi.RSSI_VALUEohos.permission.GET_WIFI_INFO表示Wi-Fi信号强度（RSSI）改变的公共事件的动作。
COMMON_EVENT_WIFI_CONN_STATEusual.event.wifi.CONN_STATE无Wi-Fi连接状态发生改变的公共事件的动作。
COMMON_EVENT_WIFI_HOTSPOT_STATEusual.event.wifi.HOTSPOT_STATE无Wi-Fi热点状态的公共事件的动作，如启用或禁用。
COMMON_EVENT_WIFI_AP_STA_JOINusual.event.wifi.WIFI_HS_STA_JOINohos.permission.GET_WIFI_INFO客户端加入当前设备Wi-Fi热点的普通事件的动作。
COMMON_EVENT_WIFI_AP_STA_LEAVEusual.event.wifi.WIFI_HS_STA_LEAVEohos.permission.GET_WIFI_INFO客户端已断开与当前设备Wi-Fi热点的连接的公共事件的动作。
COMMON_EVENT_WIFI_MPLINK_STATE_CHANGEusual.event.wifi.mplink.STATE_CHANGEohos.permission.MPLINK_CHANGE_STATE表示MPLink（增强Wi-Fi功能）状态已更改的公共事件的动作。
COMMON_EVENT_WIFI_P2P_CONN_STATEusual.event.wifi.p2p.CONN_STATE_CHANGEohos.permission.GET_WIFI_INFO and ohos.permission.LOCATIONWi-Fi P2P连接状态改变的公共事件的动作。
COMMON_EVENT_WIFI_P2P_STATE_CHANGEDusual.event.wifi.p2p.STATE_CHANGEohos.permission.GET_WIFI_INFOWi-Fi P2P状态公共事件的动作，如启用和禁用。
COMMON_EVENT_WIFI_P2P_PEERS_STATE_CHANGEDusual.event.wifi.p2p.DEVICES_CHANGEohos.permission.GET_WIFI_INFOWi-Fi P2P对等体状态变化。
COMMON_EVENT_WIFI_P2P_PEERS_DISCOVERY_STATE_CHANGEDusual.event.wifi.p2p.PEER_DISCOVERY_STATE_CHANGEohos.permission.GET_WIFI_INFOWi-Fi P2P发现状态变化。
COMMON_EVENT_WIFI_P2P_CURRENT_DEVICE_STATE_CHANGEDusual.event.wifi.p2p.CURRENT_DEVICE_CHANGEohos.permission.GET_WIFI_INFOWi-Fi P2P当前设备状态变化。
COMMON_EVENT_WIFI_P2P_GROUP_STATE_CHANGEDusual.event.wifi.p2p.GROUP_STATE_CHANGEDohos.permission.GET_WIFI_INFOWi-Fi P2P群组信息已更改。
COMMON_EVENT_BLUETOOTH_HANDSFREE_AG_CONNECT_STATE_UPDATEusual.event.bluetooth.handsfree.ag.CONNECT_STATE_UPDATEohos.permission.USE_BLUETOOTH蓝牙免提通信连接状态公共事件的动作。
COMMON_EVENT_BLUETOOTH_HANDSFREE_AG_CURRENT_DEVICE_UPDATEusual.event.bluetooth.handsfree.ag.CURRENT_DEVICE_UPDATEohos.permission.USE_BLUETOOTH表示连接到蓝牙免提的设备处于活动状态的公共事件的动作。
COMMON_EVENT_BLUETOOTH_HANDSFREE_AG_AUDIO_STATE_UPDATEusual.event.bluetooth.handsfree.ag.AUDIO_STATE_UPDATEohos.permission.USE_BLUETOOTH表示蓝牙A2DP连接状态已更改的公共事件的动作。
COMMON_EVENT_BLUETOOTH_A2DPSOURCE_CONNECT_STATE_UPDATEusual.event.bluetooth.a2dpsource.CONNECT_STATE_UPDATEohos.permission.USE_BLUETOOTH蓝牙A2DP连接状态公共事件的动作。
COMMON_EVENT_BLUETOOTH_A2DPSOURCE_CURRENT_DEVICE_UPDATEusual.event.bluetooth.a2dpsource.CURRENT_DEVICE_UPDATEohos.permission.USE_BLUETOOTH表示使用蓝牙A2DP连接的设备处于活动状态的公共事件的动作。
COMMON_EVENT_BLUETOOTH_A2DPSOURCE_PLAYING_STATE_UPDATEusual.event.bluetooth.a2dpsource.PLAYING_STATE_UPDATEohos.permission.USE_BLUETOOTH蓝牙A2DP播放状态改变的普通事件的动作。
COMMON_EVENT_BLUETOOTH_A2DPSOURCE_AVRCP_CONNECT_STATE_UPDATEusual.event.bluetooth.a2dpsource.AVRCP_CONNECT_STATE_UPDATEohos.permission.USE_BLUETOOTH表示蓝牙A2DP的AVRCP连接状态已更改的公共事件的动作。
COMMON_EVENT_BLUETOOTH_A2DPSOURCE_CODEC_VALUE_UPDATEusual.event.bluetooth.a2dpsource.CODEC_VALUE_UPDATEohos.permission.USE_BLUETOOTH表示蓝牙A2DP音频编解码状态更改的公共事件的动作。
COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_DISCOVEREDusual.event.bluetooth.remotedevice.DISCOVEREDohos.permission.LOCATION and ohos.permission.USE_BLUETOOTH表示发现远程蓝牙设备的公共事件的动作。
COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_CLASS_VALUE_UPDATEusual.event.bluetooth.remotedevice.CLASS_VALUE_UPDATEohos.permission.USE_BLUETOOTH表示远程蓝牙设备的蓝牙类别已更改的公共事件的动作。
COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_ACL_CONNECTEDusual.event.bluetooth.remotedevice.ACL_CONNECTEDohos.permission.USE_BLUETOOTH指示已与远程蓝牙设备建立低级别（ACL）连接的公共事件的动作。
COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_ACL_DISCONNECTEDusual.event.bluetooth.remotedevice.ACL_DISCONNECTEDohos.permission.USE_BLUETOOTH表示低电平（ACL）连接已从远程蓝牙设备断开的普通事件的动作。
COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_NAME_UPDATEusual.event.bluetooth.remotedevice.NAME_UPDATEohos.permission.USE_BLUETOOTH表示远程蓝牙设备的友好名称首次被检索或自上次检索以来被更改的公共事件的操作。
COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_PAIR_STATEusual.event.bluetooth.remotedevice.PAIR_STATEohos.permission.USE_BLUETOOTH远程蓝牙设备连接状态更改的公共事件的动作。
COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_BATTERY_VALUE_UPDATEusual.event.bluetooth.remotedevice.BATTERY_VALUE_UPDATEohos.permission.USE_BLUETOOTH表示远程蓝牙设备的电池电量首次被检索或自上次检索以来被更改的公共事件的动作。
COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_SDP_RESULTusual.event.bluetooth.remotedevice.SDP_RESULT无远程蓝牙设备SDP状态公共事件的动作。
COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_UUID_VALUEusual.event.bluetooth.remotedevice.UUID_VALUEohos.permission.DISCOVER_BLUETOOTH远程蓝牙设备UUID连接状态公共事件的动作。
COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_PAIRING_REQusual.event.bluetooth.remotedevice.PAIRING_REQohos.permission.DISCOVER_BLUETOOTH表示远程蓝牙设备配对请求的公共事件的动作。
COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_PAIRING_CANCELusual.event.bluetooth.remotedevice.PAIRING_CANCEL无取消蓝牙配对的公共事件的动作。
COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_CONNECT_REQusual.event.bluetooth.remotedevice.CONNECT_REQ无表示远程蓝牙设备连接请求的公共事件的动作。
COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_CONNECT_REPLYusual.event.bluetooth.remotedevice.CONNECT_REPLY无表示远程蓝牙设备连接请求响应的公共事件的动作。
COMMON_EVENT_BLUETOOTH_REMOTEDEVICE_CONNECT_CANCELusual.event.bluetooth.remotedevice.CONNECT_CANCEL无表示取消与远程蓝牙设备的连接的公共事件的动作。
COMMON_EVENT_BLUETOOTH_HANDSFREEUNIT_CONNECT_STATE_UPDATEusual.event.bluetooth.handsfreeunit.CONNECT_STATE_UPDATE无表示蓝牙免提连接状态已更改的公共事件的动作。
COMMON_EVENT_BLUETOOTH_HANDSFREEUNIT_AUDIO_STATE_UPDATEusual.event.bluetooth.handsfreeunit.AUDIO_STATE_UPDATE无表示蓝牙免提音频状态已更改的公共事件的动作。
COMMON_EVENT_BLUETOOTH_HANDSFREEUNIT_AG_COMMON_EVENTusual.event.bluetooth.handsfreeunit.AG_COMMON_EVENT无表示蓝牙免提音频网关状态已更改的公共事件的动作。
COMMON_EVENT_BLUETOOTH_HANDSFREEUNIT_AG_CALL_STATE_UPDATEusual.event.bluetooth.handsfreeunit.AG_CALL_STATE_UPDATE无表示蓝牙免提呼叫状态已更改的公共事件的动作。
COMMON_EVENT_BLUETOOTH_HOST_STATE_UPDATEusual.event.bluetooth.host.STATE_UPDATEohos.permission.USE_BLUETOOTH表示蓝牙适配器状态已更改的公共事件的操作，例如蓝牙已打开或关闭。
COMMON_EVENT_BLUETOOTH_HOST_REQ_DISCOVERABLEusual.event.bluetooth.host.REQ_DISCOVERABLE无表示用户允许扫描蓝牙请求的公共事件的动作。
COMMON_EVENT_BLUETOOTH_HOST_REQ_ENABLEusual.event.bluetooth.host.REQ_ENABLEohos.permission.USE_BLUETOOTH表示用户打开蓝牙请求的公共事件的动作。
COMMON_EVENT_BLUETOOTH_HOST_REQ_DISABLEusual.event.bluetooth.host.REQ_DISABLEohos.permission.USE_BLUETOOTH表示用户关闭蓝牙请求的公共事件的动作。
COMMON_EVENT_BLUETOOTH_HOST_SCAN_MODE_UPDATEusual.event.bluetooth.host.SCAN_MODE_UPDATEohos.permission.USE_BLUETOOTH设备蓝牙扫描模式更改的公共事件的动作。
COMMON_EVENT_BLUETOOTH_HOST_DISCOVERY_STARTEDusual.event.bluetooth.host.DISCOVERY_STARTEDohos.permission.USE_BLUETOOTH设备上已启动蓝牙扫描的公共事件的动作。
COMMON_EVENT_BLUETOOTH_HOST_DISCOVERY_FINISHEDusual.event.bluetooth.host.DISCOVERY_FINISHEDohos.permission.USE_BLUETOOTH设备上蓝牙扫描完成的公共事件的动作。
COMMON_EVENT_BLUETOOTH_HOST_NAME_UPDATEusual.event.bluetooth.host.NAME_UPDATEohos.permission.USE_BLUETOOTH指示设备蓝牙适配器名称已更改的公共事件的操作。
COMMON_EVENT_BLUETOOTH_A2DPSINK_CONNECT_STATE_UPDATEusual.event.bluetooth.a2dpsink.CONNECT_STATE_UPDATEohos.permission.USE_BLUETOOTH表示蓝牙A2DP宿连接状态已更改的公共事件的动作。
COMMON_EVENT_BLUETOOTH_A2DPSINK_PLAYING_STATE_UPDATEusual.event.bluetooth.a2dpsink.PLAYING_STATE_UPDATEohos.permission.USE_BLUETOOTH蓝牙A2DP宿播放状态改变的普通事件的动作。
COMMON_EVENT_BLUETOOTH_A2DPSINK_AUDIO_STATE_UPDATEusual.event.bluetooth.a2dpsink.AUDIO_STATE_UPDATEohos.permission.USE_BLUETOOTH表示蓝牙A2DP宿的音频状态已更改的公共事件的动作。
COMMON_EVENT_NFC_ACTION_ADAPTER_STATE_CHANGEDusual.event.nfc.action.ADAPTER_STATE_CHANGED无指示设备NFC适配器状态已更改的公共事件的操作。
COMMON_EVENT_NFC_ACTION_RF_FIELD_ON_DETECTEDusual.event.nfc.action.RF_FIELD_ON_DETECTEDohos.permission.MANAGE_SECURE_SETTINGS检测到NFC RF字段处于使能状态的公共事件的动作。
COMMON_EVENT_NFC_ACTION_RF_FIELD_OFF_DETECTEDusual.event.nfc.action.RF_FIELD_OFF_DETECTEDohos.permission.MANAGE_SECURE_SETTINGS检测到NFC RF字段处于关闭状态的公共事件的动作。
COMMON_EVENT_DISCHARGINGusual.event.DISCHARGING无表示系统停止为电池充电的公共事件的动作。
COMMON_EVENT_CHARGINGusual.event.CHARGING无表示系统开始为电池充电的公共事件的动作。
COMMON_EVENT_DEVICE_IDLE_MODE_CHANGEDusual.event.DEVICE_IDLE_MODE_CHANGED无表示系统空闲模式已更改的公共事件的动作。
COMMON_EVENT_POWER_SAVE_MODE_CHANGEDusual.event.POWER_SAVE_MODE_CHANGED无表示系统节能模式更改的公共事件的动作。
COMMON_EVENT_USER_ADDEDusual.event.USER_ADDEDohos.permission.MANAGE_USERS表示用户已添加到系统中的公共事件的动作。
COMMON_EVENT_USER_REMOVEDusual.event.USER_REMOVEDohos.permission.MANAGE_USERS表示用户已从系统中删除的公共事件的动作。
COMMON_EVENT_ABILITY_ADDEDusual.event.ABILITY_ADDEDohos.permission.LISTEN_BUNDLE_CHANGE表示已添加能力的公共事件的动作。
COMMON_EVENT_ABILITY_REMOVEDusual.event.ABILITY_REMOVEDohos.permission.LISTEN_BUNDLE_CHANGE表示已删除能力的公共事件的动作。
COMMON_EVENT_ABILITY_UPDATEDusual.event.ABILITY_UPDATEDohos.permission.LISTEN_BUNDLE_CHANGE表示能力已更新的公共事件的动作。
COMMON_EVENT_LOCATION_MODE_STATE_CHANGEDusual.event.location.MODE_STATE_CHANGED无表示系统定位模式已更改的公共事件的动作。
COMMON_EVENT_IVI_SLEEPcommon.event.IVI_SLEEP无表示指示车辆的车载信息娱乐（IVI）系统正在休眠的常见事件的动作。
COMMON_EVENT_IVI_PAUSEcommon.event.IVI_PAUSE无表示IVI已休眠，并通知应用程序停止播放。
COMMON_EVENT_IVI_STANDBYcommon.event.IVI_STANDBY无指示第三方应用暂停当前工作的公共事件的动作。
COMMON_EVENT_IVI_LASTMODE_SAVEcommon.event.IVI_LASTMODE_SAVE无指示第三方应用保存其最后一个模式的公共事件的动作。
COMMON_EVENT_IVI_VOLTAGE_ABNORMALcommon.event.IVI_VOLTAGE_ABNORMAL无表示车辆电源系统电压异常的公共事件的动作。
COMMON_EVENT_IVI_HIGH_TEMPERATUREcommon.event.IVI_HIGH_TEMPERATURE无表示IVI温度过高。
COMMON_EVENT_IVI_EXTREME_TEMPERATUREcommon.event.IVI_EXTREME_TEMPERATURE无表示IVI温度极高。
COMMON_EVENT_IVI_TEMPERATURE_ABNORMALcommon.event.IVI_TEMPERATURE_ABNORMAL无表示车载系统具有极端温度的常见事件的动作。
COMMON_EVENT_IVI_VOLTAGE_RECOVERYcommon.event.IVI_VOLTAGE_RECOVERY无表示车辆电源系统电压恢复正常的公共事件的动作。
COMMON_EVENT_IVI_TEMPERATURE_RECOVERYcommon.event.IVI_TEMPERATURE_RECOVERY无表示车载系统温度恢复正常的公共事件的动作。
COMMON_EVENT_IVI_ACTIVEcommon.event.IVI_ACTIVE无表示电池服务处于活动状态的公共事件的动作。
COMMON_EVENT_USB_DEVICE_ATTACHEDusual.event.hardware.usb.action.USB_DEVICE_ATTACHED无当用户设备作为USB主机时，USB设备已挂载的公共事件的动作。
COMMON_EVENT_USB_DEVICE_DETACHEDusual.event.hardware.usb.action.USB_DEVICE_DETACHED无当用户设备作为USB主机时，USB设备被卸载的公共事件的动作。
COMMON_EVENT_USB_ACCESSORY_ATTACHEDusual.event.hardware.usb.action.USB_ACCESSORY_ATTACHED无表示已连接USB附件的公共事件的动作。
COMMON_EVENT_USB_ACCESSORY_DETACHEDusual.event.hardware.usb.action.USB_ACCESSORY_DETACHED无表示USB附件被卸载的公共事件的动作。
COMMON_EVENT_DISK_REMOVEDusual.event.data.DISK_REMOVEDohos.permission.WRITE_USER_STORAGE 或 ohos.permission.READ_USER_STORAGE外部存储设备状态变更为移除时发送此公共事件。
COMMON_EVENT_DISK_UNMOUNTEDusual.event.data.DISK_UNMOUNTEDohos.permission.WRITE_USER_STORAGE 或 ohos.permission.READ_USER_STORAGE外部存储设备状态变更为卸载时发送此公共事件。
COMMON_EVENT_DISK_MOUNTEDusual.event.data.DISK_MOUNTEDohos.permission.WRITE_USER_STORAGE 或 ohos.permission.READ_USER_STORAGE外部存储设备状态变更为挂载时发送此公共事件。
COMMON_EVENT_DISK_BAD_REMOVALusual.event.data.DISK_BAD_REMOVALohos.permission.WRITE_USER_STORAGE 或 ohos.permission.READ_USER_STORAGE外部存储设备状态变更为挂载状态下移除时发送此公共事件。
COMMON_EVENT_DISK_UNMOUNTABLEusual.event.data.DISK_UNMOUNTABLEohos.permission.WRITE_USER_STORAGE 或 ohos.permission.READ_USER_STORAGE外部存储设备状态变更为插卡情况下无法挂载时发送此公共事件。
COMMON_EVENT_DISK_EJECTusual.event.data.DISK_EJECTohos.permission.WRITE_USER_STORAGE 或 ohos.permission.READ_USER_STORAGE用户已表示希望删除外部存储介质时发送此公共事件。
COMMON_EVENT_VOLUME_REMOVED9+usual.event.data.VOLUME_REMOVEDohos.permission.WRITE_USER_STORAGE 或 ohos.permission.READ_USER_STORAGE外部存储设备状态变更为移除时发送此公共事件。
COMMON_EVENT_VOLUME_UNMOUNTED9+usual.event.data.VOLUME_UNMOUNTEDohos.permission.WRITE_USER_STORAGE 或 ohos.permission.READ_USER_STORAGE外部存储设备状态变更为卸载时发送此公共事件。
COMMON_EVENT_VOLUME_MOUNTED9+usual.event.data.VOLUME_MOUNTEDohos.permission.WRITE_USER_STORAGE 或 ohos.permission.READ_USER_STORAGE外部存储设备状态变更为挂载时发送此公共事件。
COMMON_EVENT_VOLUME_BAD_REMOVAL9+usual.event.data.VOLUME_BAD_REMOVALohos.permission.WRITE_USER_STORAGE 或 ohos.permission.READ_USER_STORAGE外部存储设备状态变更为挂载状态下移除时发送此公共事件。
COMMON_EVENT_VOLUME_EJECT9+usual.event.data.VOLUME_EJECTohos.permission.WRITE_USER_STORAGE 或 ohos.permission.READ_USER_STORAGE用户已表示希望删除外部存储介质时发送此公共事件。
COMMON_EVENT_VISIBLE_ACCOUNTS_UPDATEDusual.event.data.VISIBLE_ACCOUNTS_UPDATEDohos.permission.GET_APP_ACCOUNTS表示帐户可见更改的公共事件的动作。
COMMON_EVENT_ACCOUNT_DELETEDusual.event.data.ACCOUNT_DELETEDohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS删除帐户的公共事件的动作。
COMMON_EVENT_FOUNDATION_READYusual.event.data.FOUNDATION_READYohos.permission.RECEIVER_STARTUP_COMPLETED表示foundation已准备好的公共事件的动作。
COMMON_EVENT_AIRPLANE_MODE_CHANGEDusual.event.AIRPLANE_MODE无表示设备飞行模式已更改的公共事件的动作。
COMMON_EVENT_SPLIT_SCREEN8+usual.event.SPLIT_SCREENohos.permission.RECEIVER_SPLIT_SCREEN表示分屏的公共事件的动作。

CommonEvent.publish

publish(event: string, callback: AsyncCallback<void>): void

发布公共事件（callback形式）。

系统能力：  SystemCapability.Notification.CommonEvent

参数：

名称读写属性类型必填描述
event只读string是表示要发送的公共事件。
callback只读AsyncCallback<void>是表示被指定的回调方法。

示例：

//发布公共事件回调
function PublishCallBack(err) {
    if (err.code) {
        console.error("publish failed " + JSON.stringify(err));
    } else {
        console.info("publish");
    }
}

//发布公共事件
CommonEvent.publish("event", PublishCallBack);

CommonEvent.publish

publish(event: string, options: CommonEventPublishData, callback: AsyncCallback<void>): void

发布公共事件指定发布信息（callback形式）。

系统能力：  SystemCapability.Notification.CommonEvent

参数：

名称读写属性类型必填描述
event只读string是表示要发布的公共事件。
options只读CommonEventPublishData是表示发布公共事件的属性。
callback只读AsyncCallback<void>是表示被指定的回调方法。

示例：

//公共事件相关信息
var options = {
    code: 0,             //公共事件的初始代码
    data: "initial data",//公共事件的初始数据
    isOrdered: true     //有序公共事件
}

//发布公共事件回调
function PublishCallBack(err) {
    if (err.code) {
        console.error("publish failed " + JSON.stringify(err));
    } else {
        console.info("publish");
    }
}

//发布公共事件
CommonEvent.publish("event", options, PublishCallBack);

CommonEvent.publishAsUser8+

publishAsUser(event: string, userId: number, callback: AsyncCallback<void>): void

向指定用户发布公共事件（callback形式）。

系统能力：  SystemCapability.Notification.CommonEvent

系统API：  此接口为系统接口，三方应用不支持调用。

参数：

名称读写属性类型必填描述
event只读string是表示要发送的公共事件。
userId只读number是表示指定向该用户ID发送此公共事件。
callback只读AsyncCallback<void>是表示被指定的回调方法。

示例：

//发布公共事件回调
function PublishAsUserCallBack(err) {
    if (err.code) {
        console.error("publishAsUser failed " + JSON.stringify(err));
    } else {
        console.info("publishAsUser");
    }
}

//指定发送的用户
var userId = 100;

//发布公共事件
CommonEvent.publishAsUser("event", userId, PublishAsUserCallBack);

CommonEvent.publishAsUser8+

publishAsUser(event: string, userId: number, options: CommonEventPublishData, callback: AsyncCallback<void>): void

向指定用户发布公共事件并指定发布信息（callback形式）。

系统能力：  SystemCapability.Notification.CommonEvent

系统API：  此接口为系统接口，三方应用不支持调用。

参数：

名称读写属性类型必填描述
event只读string是表示要发布的公共事件。
userId只读number是表示指定向该用户ID发送此公共事件。
options只读CommonEventPublishData是表示发布公共事件的属性。
callback只读AsyncCallback<void>是表示被指定的回调方法。

示例：

//公共事件相关信息
var options = {
    code: 0,             //公共事件的初始代码
    data: "initial data",//公共事件的初始数据
}

//发布公共事件回调
function PublishAsUserCallBack(err) {
    if (err.code) {
        console.error("publishAsUser failed " + JSON.stringify(err));
    } else {
        console.info("publishAsUser");
    }
}

//指定发送的用户
var userId = 100;

//发布公共事件
CommonEvent.publishAsUser("event", userId, options, PublishAsUserCallBack);

CommonEvent.createSubscriber

createSubscriber(subscribeInfo: CommonEventSubscribeInfo, callback: AsyncCallback<CommonEventSubscriber>): void

创建订阅者（callback形式）。

系统能力：  SystemCapability.Notification.CommonEvent

参数：

名称读写属性类型必填描述
subscribeInfo只读CommonEventSubscribeInfo是表示订阅信息。
callback只读AsyncCallback<CommonEventSubscriber>是表示创建订阅者的回调方法。

示例：

var subscriber; //用于保存创建成功的订阅者对象，后续使用其完成订阅及退订的动作

//订阅者信息
var subscribeInfo = {
    events: ["event"]
};

//创建订阅者回调
function CreateSubscriberCallBack(err, commonEventSubscriber) {
    if (err.code) {
        console.error("createSubscriber failed " + JSON.stringify(err));
    } else {
        console.info("createSubscriber");
        subscriber = commonEventSubscriber;
    }
}

//创建订阅者
CommonEvent.createSubscriber(subscribeInfo, CreateSubscriberCallBack);

CommonEvent.createSubscriber

createSubscriber(subscribeInfo: CommonEventSubscribeInfo): Promise<CommonEventSubscriber>

创建订阅者（Promise形式）。

系统能力：  SystemCapability.Notification.CommonEvent

参数：

名称读写属性类型必填描述
subscribeInfo只读CommonEventSubscribeInfo是表示订阅信息。

返回值：

类型说明
Promise<CommonEventSubscriber>返回订阅者对象。

示例：

var subscriber; //用于保存创建成功的订阅者对象，后续使用其完成订阅及退订的动作

//订阅者信息
var subscribeInfo = {
    events: ["event"]
};

//创建订阅者
CommonEvent.createSubscriber(subscribeInfo).then((commonEventSubscriber) => {
    console.info("createSubscriber");
    subscriber = commonEventSubscriber;
}).catch((err) => {
    console.error("createSubscriber failed " + JSON.stringify(err));
});

CommonEvent.subscribe

subscribe(subscriber: CommonEventSubscriber, callback: AsyncCallback<CommonEventData>): void

订阅公共事件（callback形式）。

系统能力：  SystemCapability.Notification.CommonEvent

参数：

名称读写属性类型必填描述
subscriber只读CommonEventSubscriber是表示订阅者对象。
callback只读AsyncCallback<CommonEventData>是表示接收公共事件数据的回调函数。

示例：

var subscriber; //用于保存创建成功的订阅者对象，后续使用其完成订阅及退订的动作

//订阅者信息
var subscribeInfo = {
    events: ["event"]
};

//订阅公共事件回调
function SubscribeCallBack(err, data) {
    if (err.code) {
        console.error("subscribe failed " + JSON.stringify(err));
    } else {
        console.info("subscribe " + JSON.stringify(data));
    }
}

//创建订阅者回调
function CreateSubscriberCallBack(err, commonEventSubscriber) {
    if (err.code) {
        console.error("createSubscriber failed " + JSON.stringify(err));
    } else {
        console.info("createSubscriber");
        subscriber = commonEventSubscriber;
        //订阅公共事件
        CommonEvent.subscribe(subscriber, SubscribeCallBack);
    }
}

//创建订阅者
CommonEvent.createSubscriber(subscribeInfo, CreateSubscriberCallBack);

CommonEvent.unsubscribe

unsubscribe(subscriber: CommonEventSubscriber, callback?: AsyncCallback<void>): void

取消订阅公共事件（callback形式）。

系统能力：  SystemCapability.Notification.CommonEvent

参数：

名称读写属性类型必填描述
subscriber只读CommonEventSubscriber是表示订阅者对象。
callback只读AsyncCallback<void>否表示取消订阅的回调方法。

示例：

var subscriber;    //用于保存创建成功的订阅者对象，后续使用其完成订阅及退订的动作

//订阅者信息
var subscribeInfo = {
    events: ["event"]
};

//订阅公共事件回调
function SubscribeCallBack(err, data) {
    if (err.code) {
        console.info("subscribe failed " + JSON.stringify(err));
    } else {
        console.info("subscribe " + JSON.stringify(data));
    }
}

//创建订阅者回调
function CreateSubscriberCallBack(err, commonEventSubscriber) {
    if (err.code) {
        console.info("createSubscriber failed " + JSON.stringify(err));
    } else {
        console.info("createSubscriber");
        subscriber = commonEventSubscriber;
        //订阅公共事件
        CommonEvent.subscribe(subscriber, SubscribeCallBack);
    }
}

//取消订阅公共事件回调
function UnsubscribeCallBack(err) {
    if (err.code) {
        console.info("unsubscribe failed " + JSON.stringify(err));
    } else {
        console.info("unsubscribe");
    }
}

//创建订阅者
CommonEvent.createSubscriber(subscribeInfo, CreateSubscriberCallBack);

//取消订阅公共事件
CommonEvent.unsubscribe(subscriber, UnsubscribeCallBack);

CommonEventSubscriber

getCode

getCode(callback: AsyncCallback<number>): void

获取公共事件的结果代码（callback形式）。

系统能力：SystemCapability.Notification.CommonEvent

参数：

参数名类型必填描述
callbackAsyncCallback<number>是公共事件的结果代码。

示例：

var subscriber;    //创建成功的订阅者对象

//获取有序公共事件的结果代码回调
function getCodeCallback(err, Code) {
    if (err.code) {
        console.error("getCode failed " + JSON.stringify(err));
    } else {
        console.info("getCode " + JSON.stringify(Code));
    }
}
subscriber.getCode(getCodeCallback);

getCode

getCode(): Promise<number>

获取公共事件的结果代码（Promise形式）。

系统能力：SystemCapability.Notification.CommonEvent

返回值：

类型说明
Promise<number>公共事件的结果代码。

示例：

var subscriber;    //创建成功的订阅者对象

subscriber.getCode().then((Code) => {
    console.info("getCode " + JSON.stringify(Code));
}).catch((err) => {
    console.error("getCode failed " + JSON.stringify(err));
});

setCode

setCode(code: number, callback: AsyncCallback<void>): void

设置公共事件的结果代码（callback形式）。

系统能力：SystemCapability.Notification.CommonEvent

参数：

参数名类型必填描述
codenumber是公共事件的结果代码。
callbackAsyncCallback<void>是表示被指定的回调方法。

示例：

var subscriber;    //创建成功的订阅者对象

//设置有序公共事件的结果代码回调
function setCodeCallback(err) {
    if (err.code) {
        console.error("setCode failed " + JSON.stringify(err));
    } else {
        console.info("setCode");
    }
}
subscriber.setCode(1, setCodeCallback);

setCode

setCode(code: number): Promise<void>

设置公共事件的结果代码（Promise形式）。

系统能力：SystemCapability.Notification.CommonEvent

参数：

参数名类型必填描述
codenumber是公共事件的结果代码。

返回值：

类型说明
Promise<void>返回一个Promise的结果。

示例：

var subscriber;    //创建成功的订阅者对象

subscriber.setCode(1).then(() => {
    console.info("setCode");
}).catch((err) => {
    console.error("setCode failed " + JSON.stringify(err));
});

getData

getData(callback: AsyncCallback<string>): void

获取公共事件的结果数据（callback形式）。

系统能力：SystemCapability.Notification.CommonEvent

参数：

参数名类型必填描述
callbackAsyncCallback<string>是公共事件的结果数据。

示例：

var subscriber;    //创建成功的订阅者对象

//获取有序公共事件的结果数据回调
function getDataCallback(err, Data) {
    if (err.code) {
        console.error("getData failed " + JSON.stringify(err));
    } else {
        console.info("getData " + JSON.stringify(Data));
    }
}
subscriber.getData(getDataCallback);

getData

getData(): Promise<string>

获取公共事件的结果数据（Promise形式）。

系统能力：SystemCapability.Notification.CommonEvent

返回值：

类型说明
Promise<string>公共事件的结果数据。

示例：

var subscriber;    //创建成功的订阅者对象

subscriber.getData().then((Data) => {
    console.info("getData " + JSON.stringify(Data));
}).catch((err) => {
    console.error("getData failed " + JSON.stringify(err));
});

setData

setData(data: string, callback: AsyncCallback<void>): void

设置公共事件的结果数据（callback形式）。

系统能力：SystemCapability.Notification.CommonEvent

参数：

参数名类型必填描述
datastring是公共事件的结果数据。
callbackAsyncCallback<void>是表示被指定的回调方法。

示例：

var subscriber;    //创建成功的订阅者对象

//设置有序公共事件的结果数据回调
function setDataCallback(err) {
    if (err.code) {
        console.error("setData failed " + JSON.stringify(err));
    } else {
        console.info("setData");
    }
}
subscriber.setData("publish_data_changed", setDataCallback);

setData

setData(data: string): Promise<void>

设置公共事件的结果数据（Promise形式）。

系统能力：SystemCapability.Notification.CommonEvent

参数：

参数名类型必填描述
datastring是公共事件的结果数据。

返回值：

类型说明
Promise<void>返回一个Promise的结果。

示例：

var subscriber;    //创建成功的订阅者对象

subscriber.setData("publish_data_changed").then(() => {
    console.info("setData");
}).catch((err) => {
    console.error("setData failed " + JSON.stringify(err));
});

setCodeAndData

setCodeAndData(code: number, data: string, callback:AsyncCallback<void>): void

设置公共事件的结果代码和结果数据（callback形式）。

系统能力：SystemCapability.Notification.CommonEvent

参数：

参数名类型必填描述
codenumber是公共事件的结果代码。
datastring是公共事件的结果数据。
callbackAsyncCallback<void>是表示被指定的回调方法。

示例：

var subscriber;    //创建成功的订阅者对象

//设置有序公共事件的结果代码和结果数据回调
function setCodeDataCallback(err) {
    if (err.code) {
        console.error("setCodeAndData failed " + JSON.stringify(err));
    } else {
        console.info("setCodeDataCallback");
    }
}
subscriber.setCodeAndData(1, "publish_data_changed", setCodeDataCallback);

setCodeAndData

setCodeAndData(code: number, data: string): Promise<void>

设置公共事件的结果代码和结果数据（Promise形式）。

系统能力：SystemCapability.Notification.CommonEvent

参数：

参数名类型必填描述
codenumber是公共事件的结果代码。
datastring是公共事件的结果数据。

返回值：

类型说明
Promise<void>返回一个Promise的结果。

示例：

var subscriber;    //创建成功的订阅者对象

subscriber.setCodeAndData(1, "publish_data_changed").then(() => {
    console.info("setCodeAndData");
}).catch((err) => {
    console.info("setCodeAndData failed " + JSON.stringify(err));
});

isOrderedCommonEvent

isOrderedCommonEvent(callback: AsyncCallback<boolean>): void

查询当前公共事件的是否为有序公共事件（callback形式）。

返回true代表是有序公共事件，false代表不是有序公共事件。

系统能力：SystemCapability.Notification.CommonEvent

参数：

参数名类型必填描述
callbackAsyncCallback<boolean>是当前公共事件的是否为有序公共事件。

示例：

var subscriber;    //创建成功的订阅者对象

//获取当前公共事件是否为有序事件的回调
function isOrderedCallback(err, isOrdered) {
    if (err.code) {
        console.error("isOrderedCommonEvent failed " + JSON.stringify(err));
    } else {
        console.info("isOrdered " + JSON.stringify(isOrdered));
    }
}
subscriber.isOrderedCommonEvent(isOrderedCallback);

isOrderedCommonEvent

isOrderedCommonEvent(): Promise<boolean>

查询当前公共事件的是否为有序公共事件（Promise形式）。

返回true代表是有序公共事件，false代表不是有序公共事件。

系统能力：SystemCapability.Notification.CommonEvent

返回值：

类型说明
Promise<boolean>当前公共事件的是否为有序公共事件。

示例：

var subscriber;    //创建成功的订阅者对象

subscriber.isOrderedCommonEvent().then((isOrdered) => {
    console.info("isOrdered " + JSON.stringify(isOrdered));
}).catch((err) => {
    console.error("isOrdered failed " + JSON.stringify(err));
});

isStickyCommonEvent

isStickyCommonEvent(callback: AsyncCallback<boolean>): void

检查当前公共事件是否为一个粘性事件（callback形式）。

返回true代表是粘性公共事件，false代表不是粘性公共事件。

系统能力：SystemCapability.Notification.CommonEvent

参数：

参数名类型必填描述
callbackAsyncCallback<boolean>是当前公共事件的是否为粘性公共事件。

示例：

var subscriber;    //创建成功的订阅者对象

//获取当前公共事件是否为粘性事件的回调
function isStickyCallback(err, isSticky) {
    if (err.code) {
        console.error("isStickyCommonEvent failed " + JSON.stringify(err));
    } else {
        console.info("isSticky " + JSON.stringify(isSticky));
    }
}
subscriber.isStickyCommonEvent(isStickyCallback);

isStickyCommonEvent

isStickyCommonEvent(): Promise<boolean>

检查当前公共事件是否为一个粘性事件（Promise形式）。

返回true代表是粘性公共事件，false代表不是粘性公共事件。

系统能力：SystemCapability.Notification.CommonEvent

返回值：

类型说明
Promise<boolean>当前公共事件的是否为粘性公共事件。

示例：

var subscriber;    //创建成功的订阅者对象

subscriber.isStickyCommonEvent().then((isSticky) => {
    console.info("isSticky " + JSON.stringify(isSticky));
}).catch((err) => {
    console.error("isSticky failed " + JSON.stringify(err));
});

abortCommonEvent

abortCommonEvent(callback: AsyncCallback<void>): void

取消当前的公共事件，仅对有序公共事件有效，取消后，公共事件不再向下一个订阅者传递（callback形式）。

系统能力：SystemCapability.Notification.CommonEvent

参数：

参数名类型必填描述
callbackAsyncCallback<void>是取消当前的公共事件。

示例：

var subscriber;    //创建成功的订阅者对象

//取消当前有序公共事件的回调
function abortCallback(err) {
    if (err.code) {
        console.error("abortCommonEvent failed " + JSON.stringify(err));
    } else {
        console.info("abortCommonEvent");
    }
}
subscriber.abortCommonEvent(abortCallback);

abortCommonEvent

abortCommonEvent(): Promise<void>

取消当前的公共事件，仅对有序公共事件有效，取消后，公共事件不再向下一个订阅者传递（Promise形式）。

系统能力：SystemCapability.Notification.CommonEvent

返回值：

类型说明
Promise<void>返回一个Promise的结果。

示例：

var subscriber;    //创建成功的订阅者对象

subscriber.abortCommonEvent().then(() => {
    console.info("abortCommonEvent");
}).catch((err) => {
    console.error("abortCommonEvent failed " + JSON.stringify(err));
});

clearAbortCommonEvent

clearAbortCommonEvent(callback: AsyncCallback<void>): void

清除当前公共事件的取消状态，仅对有序公共事件有效（callback形式）。

系统能力：SystemCapability.Notification.CommonEvent

参数：

参数名类型必填描述
callbackAsyncCallback<void>是表示被指定的回调方法。

示例：

var subscriber;    //创建成功的订阅者对象

//清除当前公共事件取消状态的回调
function clearAbortCallback(err) {
    if (err.code) {
        console.error("clearAbortCommonEvent failed " + JSON.stringify(err));
    } else {
        console.info("clearAbortCommonEvent");
    }
}
subscriber.clearAbortCommonEvent(clearAbortCallback);

clearAbortCommonEvent

clearAbortCommonEvent(): Promise<void>

清除当前公共事件的取消状态，仅对有序公共事件有效（Promise形式）。

系统能力：SystemCapability.Notification.CommonEvent

返回值：

类型说明
Promise<void>返回一个Promise的结果。

示例：

var subscriber;    //创建成功的订阅者对象

subscriber.clearAbortCommonEvent().then(() => {
    console.info("clearAbortCommonEvent");
}).catch((err) => {
    console.error("clearAbortCommonEvent failed " + JSON.stringify(err));
});

getAbortCommonEvent

getAbortCommonEvent(callback: AsyncCallback<boolean>): void

获取当前有序公共事件是否取消的状态（callback形式）。

系统能力：SystemCapability.Notification.CommonEvent

参数：

参数名类型必填描述
callbackAsyncCallback<boolean>是表示当前有序公共事件是否取消的状态。

示例：

var subscriber;    //创建成功的订阅者对象

//获取当前有序公共事件是否取消的回调
function getAbortCallback(err, AbortCommonEvent) {
    if (err.code) {
        console.error("getAbortCommonEvent failed " + JSON.stringify(err));
    } else {
        console.info("AbortCommonEvent " + AbortCommonEvent)
    }
}
subscriber.getAbortCommonEvent(getAbortCallback);

getAbortCommonEvent

getAbortCommonEvent(): Promise<boolean>

获取当前有序公共事件是否取消的状态（Promise形式）。

系统能力：SystemCapability.Notification.CommonEvent

返回值：

类型说明
Promise<boolean>表示当前有序公共事件是否取消的状态。

示例：

var subscriber;    //创建成功的订阅者对象

subscriber.getAbortCommonEvent().then((AbortCommonEvent) => {
    console.info("AbortCommonEvent " + JSON.stringify(AbortCommonEvent));
}).catch((err) => {
    console.error("getAbortCommonEvent failed " + JSON.stringify(err));
});

getSubscribeInfo

getSubscribeInfo(callback: AsyncCallback<CommonEventSubscribeInfo>): void

获取订阅者的订阅信息（callback形式）。

系统能力：SystemCapability.Notification.CommonEvent

参数：

参数名类型必填描述
callbackAsyncCallback<CommonEventSubscribeInfo>是表示订阅者的订阅信息。

示例：

var subscriber;    //创建成功的订阅者对象

//获取订阅者信息回调
function getSubscribeInfoCallback(err, SubscribeInfo) {
    if (err.code) {
        console.error("getSubscribeInfo failed " + JSON.stringify(err));
    } else {
        console.info("SubscribeInfo " + JSON.stringify(SubscribeInfo));
    }
}
subscriber.getSubscribeInfo(getSubscribeInfoCallback);

getSubscribeInfo

getSubscribeInfo(): Promise<CommonEventSubscribeInfo>

获取订阅者的订阅信息（Promise形式）。

系统能力：SystemCapability.Notification.CommonEvent

返回值：

类型说明
Promise<CommonEventSubscribeInfo>表示订阅者的订阅信息。

示例：

var subscriber;    //创建成功的订阅者对象

subscriber.getSubscribeInfo().then((SubscribeInfo) => {
    console.info("SubscribeInfo " + JSON.stringify(SubscribeInfo));
}).catch((err) => {
    console.error("getSubscribeInfo failed " + JSON.stringify(err));
});

finishCommonEvent9+

finishCommonEvent(callback: AsyncCallback<void>): void

结束当前有序公共事件（callback形式）。

系统能力：SystemCapability.Notification.CommonEvent

参数：

参数名类型必填描述
callbackAsyncCallback<void>是表示有序公共事件结束后的回调函数。

示例：

var subscriber; //创建成功的订阅者对象

//结束当前有序公共事件的回调
function finishCommonEventCallback(err) {
  if (err.code) {
    console.error("finishCommonEvent failed " + JSON.stringify(err));
} else {
    console.info("FinishCommonEvent");
}
}
subscriber.finishCommonEvent(finishCommonEventCallback);

finishCommonEvent9+

finishCommonEvent(): Promise<void>

结束当前有序公共事件（Promise形式）。

系统能力：SystemCapability.Notification.CommonEvent

返回值：

类型说明
Promise<void>返回一个Promise的结果。

示例：

var subscriber;    //创建成功的订阅者对象

subscriber.finishCommonEvent().then(() => {
    console.info("FinishCommonEvent");
}).catch((err) => {
    console.error("finishCommonEvent failed " + JSON.stringify(err));
});

CommonEventData

系统能力：  以下各项对应的系统能力均为SystemCapability.Notification.CommonEvent

名称读写属性类型必填描述
event只读string是表示当前接收的公共事件名称。
bundleName只读string否表示包名称。
code只读number否表示公共事件的结果代码，用于传递int类型的数据。
data只读string否表示公共事件的自定义结果数据，用于传递string类型的数据。
parameters只读{[key: string]: any}否表示公共事件的附加信息。

CommonEventPublishData

系统能力：  以下各项对应的系统能力均为SystemCapability.Notification.CommonEvent

名称读写属性类型必填描述
bundleName只读string否表示包名称。
code只读number否表示公共事件的结果代码。
data只读string否表示公共事件的自定义结果数据。
subscriberPermissions只读Array<string>否表示订阅者的权限。
isOrdered只读boolean否表示是否是有序事件。
isSticky只读boolean否表示是否是粘性事件。
parameters只读{[key: string]: any}否表示公共事件的附加信息。

CommonEventSubscribeInfo

系统能力：  以下各项对应的系统能力均为SystemCapability.Notification.CommonEvent

名称 鸿蒙开发指导文档：gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md点击或者复制转到。读写属性类型必填描述
events只读Array<string>是表示要发送的公共事件。
publisherPermission只读string否表示发布者的权限。
publisherDeviceId只读string否表示设备ID，该值必须是同一ohos网络上的现有设备ID。
userId只读number否表示用户ID。此参数是可选的，默认值当前用户的ID。如果指定了此参数，则该值必须是系统中现有的用户ID。
priority只读number否表示订阅者的优先级。值的范围是-100到1000。

最后呢，很多开发朋友不知道需要学习那些鸿蒙技术？鸿蒙开发岗位需要掌握那些核心技术点？为此鸿蒙的开发学习必须要系统性的进行。

而网上有关鸿蒙的开发资料非常的少，假如你想学好鸿蒙的应用开发与系统底层开发。你可以参考这份资料，少走很多弯路，节省没必要的麻烦。由两位前阿里高级研发工程师联合打造的《鸿蒙NEXT星河版OpenHarmony开发文档》里面内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（Harmony NEXT）技术知识点

如果你是一名Android、Java、前端等等开发人员，想要转入鸿蒙方向发展。可以直接领取这份资料辅助你的学习。下面是鸿蒙开发的学习路线图。

高清完整版请点击→《鸿蒙NEXT星河版开发学习文档》

针对鸿蒙成长路线打造的鸿蒙学习文档。话不多说，我们直接看详细资料鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，帮助大家在技术的道路上更进一步。

《鸿蒙 (OpenHarmony)开发学习视频》

图片

《鸿蒙生态应用开发V2.0白皮书》

图片

《鸿蒙 (OpenHarmony)开发基础到实战手册》

获取这份鸿蒙星河版学习资料，请点击→《鸿蒙NEXT星河版开发学习文档》

OpenHarmony北向、南向开发环境搭建

图片

《鸿蒙开发基础》

  1. ArkTS语言

  2. 安装DevEco Studio

  3. 运用你的第一个ArkTS应用

  4. ArkUI声明式UI开发

  5. .……

图片

《鸿蒙开发进阶》

  1. Stage模型入门

  2. 网络管理

  3. 数据管理

  4. 电话服务

  5. 分布式应用开发

  6. 通知与窗口管理

  7. 多媒体技术

  8. 安全技能

  9. 任务管理

  10. WebGL

  11. 国际化开发

  12. 应用测试

  13. DFX面向未来设计

  14. 鸿蒙系统移植和裁剪定制

  15. ……

图片

《鸿蒙开发实战》

  1. ArkTS实践

  2. UIAbility应用

  3. 网络案例

  4. ……

图片

 获取这份鸿蒙星河版学习资料，请点击→《鸿蒙NEXT星河版开发学习文档》

总结

鸿蒙—作为国家主力推送的国产操作系统。部分的高校已经取消了安卓课程，从而开设鸿蒙课程；企业纷纷跟进启动了鸿蒙研发。

并且鸿蒙是完全具备无与伦比的机遇和潜力的；预计到年底将有 5,000 款的应用完成原生鸿蒙开发，未来将会支持 50 万款的应用。那么这么多的应用需要开发，也就意味着需要有更多的鸿蒙人才。鸿蒙开发工程师也将会迎来爆发式的增长，学习鸿蒙势在必行！

爱桥代码的程序媛
关注
  • 33
    点赞
  • 踩
  • 24
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
HarmonyOS鸿蒙开发指南:基于ArkTS开发 公共事件与通知
sybh的博客
01-10 1646
HarmonyOS通过CES（Common Event Service，公共事件服务）为应用程序提供订阅、发布、退订公共事件的能力。公共事件可分为系统公共事件和自定义公共事件。系统公共事件：系统将收集到的事件信息，根据系统策略发送给订阅该事件的用户程序。例如：系统关键服务发布的系统事件（例如：hap安装，更新，卸载等）。自定义公共事件：应用自定义一些公共事件用来实现跨应用的事件通信能力。每个应用都可以按需订阅公共事件，订阅成功且公共事件发布，系统会把其发送给应用。
鸿蒙HarmonyOS 开发通过 @BuilderParam装饰器：引用@Builder函数实现自定义标题栏
02-22
在鸿蒙HarmonyOS开发中，自定义标题栏是一个常见的需求，这有助于为应用程序提供独特的用户界面和交互体验。@BuilderParam装饰器和@Builder函数是HarmonyOS SDK中的两个关键工具，它们允许开发者轻松创建和配置...
鸿蒙开发接口公共事件与通知：【Notification模块】
2301_76813281的博客
05-21 446
开发前请熟悉鸿蒙开发指导文档：gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md点击或者复制转到。 Notification.publish publish(request: NotificationRequest, callback: AsyncCallback): void发布通知（callback形式）。系统能力：SystemCapability.Notification.Notification参数：示例： No
HarmonyOS实战开发：@ohos.commonEventManager (公共事件模块)
2401_84194030的博客
05-24 1269
公共事件相关的能力，包括发布公共事件、订阅公共事件、以及退订公共事件。
鸿蒙系列--动态共享包的依赖与使用
weixin_42277946的博客
01-04 3134
鸿蒙系列--动态共享包的跨包调用
如何使用命令行对RK开发板进行OpenHarmony版本烧录？
m0_64420071的博客
03-29 1398
开发版烧录
HarmonyOS基础（七）- 详细剖析鸿蒙引入第三方库案例篇（1）
康宝的博客
02-26 4523
详细剖析鸿蒙引入第三方库案例的两种方法。ohpm的使用，本地库开发和使用，第三方库的下载、引入和使用等
HarmonyOS @ohos.net.http 网络GET、POST请求封装
04-16
在 HarmonyOS 操作系统中，网络通信是应用开发不可或缺的一部分，@ohos.net.http 包提供了对 HTTP 协议的支持，使得开发者可以方便地进行 GET 和 POST 请求的封装。本篇将详细介绍如何利用这些功能来实现高效且可靠...
HarmonyOS Ability 公共事件与通知1
08-08
在 HarmonyOS 操作系统中，公共事件与通知是两个关键的组件，它们分别由 Common Event Service (CES) 和 Advanced Notification Service (ANS) 提供。这些服务使得开发者能够构建更加高效和用户友好的应用程序。 ...
HarmonyOS应用开发-公共事件处理.docx
最新发布
06-05
本文将详细介绍如何在HarmonyOS应用开发中实现公共事件的发布与订阅，帮助开发者更好地理解并运用这一机制。 #### 二、公共事件概述 公共事件是HarmonyOS提供的用于实现不同Ability（或Service）之间通信的一种...
基于鸿蒙HarmonyOS，使用ArkTS开发纯净的浏览器（小狐狸浏览器）.zip
02-07
在本项目中，我们将探讨如何基于华为的鸿蒙HarmonyOS操作系统，利用 ArkTS 开发一个纯净的浏览器应用，以“小狐狸浏览器”为例。鸿蒙系统是华为面向物联网时代推出的一款全新分布式操作系统，旨在提供跨平台、跨设备...
OpenHarmony Framework层服务一览
weixin_44205232的博客
03-28 717
服务 描述 是否裁剪 代码位置 AccountMgr 账号子系统的主要服务 ？ /base/account/os_account/services/accountmgr/ AIEngine AI子系统 是 /foundation/ai/ai_engine/ AbilityManagerService Ability管理服务 否 /foundation/ability/ability_runtime/services/abilitymgr/ DataObserverMgr Data
消息通知之系统层事件发布相关流程
isoftstone_HOS的博客
05-18 807
Openharmony 3.1Release中存在消息通知的处理，消息通知包括系统层事件发布、消息订阅、消息投递与处理，为了开发者能够熟悉消息的处理流程，本篇文章主要介绍系统层事件发布的相关流程。
鸿蒙 进程模型-公共事件
ganshenml的专栏
03-05 751
公共事件—>Receiver。
前端开发 | 鸿蒙(HarmonyOS)应用开发指南
360技术
01-18 5886
1. 概述1.1 简介鸿蒙（即 HarmonyOS ，开发代号 Ark，正式名称为华为终端鸿蒙智能设备操作系统软件）是华为公司自 2012 年以来开发的一款可支持鸿蒙原生应用和兼容 AOSP 应用的分布式操作系统。该系统利用“分布式”技术将手机、电脑、平板、电视、汽车和智能穿戴等多款设备融合成一个“超级终端”，使用户便于操作和共享各种设备的资源。1.2 本文读者收获帮助开发者全面了解 Harmon...
OpenHarmony实战开发—进程间通讯
m0_70748458的博客
04-26 1152
OpenHarmony通过CES（Common Event Service，公共事件服务）为应用程序提供订阅、发布、退订公共事件的能力。公共事件从系统角度可分为：系统公共事件和自定义公共事件。系统公共事件：CES内部定义的公共事件，只有系统应用和系统服务才能发布，例如HAP安装，更新，卸载等公共事件。目前支持的系统公共事件详见 系统公共事件列表。自定义公共事件：应用自定义一些公共事件用来实现跨进程的事件通信能力。公共事件按发送方式可分为：无序公共事件、有序公共事件和粘性公共事件。
鸿蒙OS开发实例：【工具类封装-页面路由】
2301_76813281的博客
03-28 1333
鸿蒙是完全具备无与伦比的机遇和潜力的；预计到年底将有 5,000 款的应用完成原生鸿蒙开发，这么多的应用需要开发，也就意味着需要有更多的鸿蒙人才。鸿蒙开发工程师也将会迎来爆发式的增长，学习鸿蒙势在必行！
鸿蒙开发3-1 基本组件+通用属性+通用事件
weixin_51267334的博客
01-05 2210
本系列是windows系统下、采用ArkTS语言、ArkUI框架、deveco studio编译器学习纯鸿蒙软件研发，采用API version 9进行。本小节主要了解鸿蒙开发的部分常用组件、属性、事件等。并基于该章结合之前的博客知识点，补充了函数作为参数的传递方式，带有this对象的函数作为参数的传递方式，实现了一个待办事项的Demo及其升级。纯小白，一步步学习，记录一下过程便于查询。
npm ERR! 400 Bad Request - GET https://repo.harmonyos.com/npm/@ohos%2fhpm-cli
03-24
我不确定这个问题的上下文，请问您能否提供更多的信息？是在使用 npm 安装 @ohos/hpm-cli 时遇到了错误码为 400 的 Bad Request 错误吗？可能是您的请求不符合服务器的要求，请检查您的网络连接和相关配置，或者尝试使用其他方式安装。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值