0
  • 聊天消息
  • 系统消息
  • 评论与回复
登录后你可以
  • 下载海量资料
  • 学习在线课程
  • 观看技术视频
  • 写文章/发帖/加入社区
会员中心
创作中心

完善资料让更多小伙伴认识你,还能领取20积分哦,立即完善>

3天内不再提示

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

jf_46214456 来源:jf_46214456 作者:jf_46214456 2024-05-21 11:13 次阅读

公共事件模块

icon-note.gif说明: 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。

导入模块

import CommonEvent from '@ohos.commonEvent';
`HarmonyOSOpenHarmony鸿蒙文档籽料: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_STATEWi-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_STATEWi-Fi连接状态发生改变的公共事件的动作。
COMMON_EVENT_WIFI_HOTSPOT_STATEusual.event.wifi.HOTSPOT_STATEWi-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

发布公共事件(callback形式)。

系统能力: SystemCapability.Notification.CommonEvent

参数

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

示例:

//发布公共事件回调
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

发布公共事件指定发布信息(callback形式)。

系统能力: SystemCapability.Notification.CommonEvent

参数:

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

示例:

//公共事件相关信息
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

向指定用户发布公共事件(callback形式)。

系统能力: SystemCapability.Notification.CommonEvent

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

参数:

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

示例:

//发布公共事件回调
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

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

系统能力: SystemCapability.Notification.CommonEvent

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

参数:

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

示例:

//公共事件相关信息
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): 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

创建订阅者(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): 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

取消订阅公共事件(callback形式)。

系统能力: SystemCapability.Notification.CommonEvent

参数:

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

示例:

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): void

获取公共事件的结果代码(callback形式)。

系统能力 :SystemCapability.Notification.CommonEvent

参数:

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

示例:

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

获取公共事件的结果代码(Promise形式)。

系统能力 :SystemCapability.Notification.CommonEvent

返回值:

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

示例:

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

设置公共事件的结果代码(callback形式)。

系统能力 :SystemCapability.Notification.CommonEvent

参数:

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

示例:

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

设置公共事件的结果代码(Promise形式)。

系统能力 :SystemCapability.Notification.CommonEvent

参数:

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

返回值:

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

示例:

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

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

getData

getData(callback: AsyncCallback): void

获取公共事件的结果数据(callback形式)。

系统能力 :SystemCapability.Notification.CommonEvent

参数:

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

示例:

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

获取公共事件的结果数据(Promise形式)。

系统能力 :SystemCapability.Notification.CommonEvent

返回值:

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

示例:

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

设置公共事件的结果数据(callback形式)。

系统能力 :SystemCapability.Notification.CommonEvent

参数:

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

示例:

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

设置公共事件的结果数据(Promise形式)。

系统能力 :SystemCapability.Notification.CommonEvent

参数:

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

返回值:

类型说明
Promise返回一个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

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

系统能力 :SystemCapability.Notification.CommonEvent

参数:

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

示例:

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

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

系统能力 :SystemCapability.Notification.CommonEvent

参数:

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

返回值:

类型说明
Promise返回一个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): void

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

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

系统能力 :SystemCapability.Notification.CommonEvent

参数:

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

示例:

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

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

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

系统能力 :SystemCapability.Notification.CommonEvent

返回值:

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

示例:

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): void

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

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

系统能力 :SystemCapability.Notification.CommonEvent

参数:

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

示例:

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

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

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

系统能力 :SystemCapability.Notification.CommonEvent

返回值:

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

示例:

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

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

系统能力 :SystemCapability.Notification.CommonEvent

参数:

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

示例:

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

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

系统能力 :SystemCapability.Notification.CommonEvent

返回值:

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

示例:

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

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

clearAbortCommonEvent

clearAbortCommonEvent(callback: AsyncCallback): void

清除当前公共事件的取消状态,仅对有序公共事件有效(callback形式)。

系统能力 :SystemCapability.Notification.CommonEvent

参数:

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

示例:

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

清除当前公共事件的取消状态,仅对有序公共事件有效(Promise形式)。

系统能力 :SystemCapability.Notification.CommonEvent

返回值:

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

示例:

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

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

getAbortCommonEvent

getAbortCommonEvent(callback: AsyncCallback): void

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

系统能力 :SystemCapability.Notification.CommonEvent

参数:

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

示例:

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

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

系统能力 :SystemCapability.Notification.CommonEvent

返回值:

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

示例:

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): 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

获取订阅者的订阅信息(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

结束当前有序公共事件(callback形式)。

系统能力 :SystemCapability.Notification.CommonEvent

参数:

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

示例:

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

结束当前有序公共事件(Promise形式)。

系统能力 :SystemCapability.Notification.CommonEvent

返回值:

类型说明
Promise返回一个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表示订阅者的权限。
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表示要发送的公共事件。
publisherPermission只读string表示发布者的权限。
publisherDeviceId只读string表示设备ID,该值必须是同一ohos网络上的现有设备ID。
userId只读number表示用户ID。此参数是可选的,默认值当前用户的ID。如果指定了此参数,则该值必须是系统中现有的用户ID。
priority只读number表示订阅者的优先级。值的范围是-100到1000。

审核编辑 黄宇

声明:本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人,不代表电子发烧友网立场。文章及其配图仅供工程师学习之用,如有内容侵权或者其他违规问题,请联系本站处理。 举报投诉
  • 接口
    +关注

    关注

    33

    文章

    8575

    浏览量

    151016
  • 鸿蒙
    +关注

    关注

    57

    文章

    2339

    浏览量

    42805
收藏 人收藏

    评论

    相关推荐

    鸿蒙开发接口公共事件与通知:【@ohos.events.emitter (Emitter)】

    模块首批接口从API version 7开始支持。
    的头像 发表于 05-21 16:06 1340次阅读
    <b class='flag-5'>鸿蒙</b><b class='flag-5'>开发</b><b class='flag-5'>接口</b><b class='flag-5'>公共事</b>件与<b class='flag-5'>通知</b>:【@<b class='flag-5'>ohos</b>.events.emitter (Emitter)】

    鸿蒙开发接口公共事件与通知:【Notification模块

    模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
    的头像 发表于 05-21 17:04 2183次阅读
    <b class='flag-5'>鸿蒙</b><b class='flag-5'>开发</b><b class='flag-5'>接口</b><b class='flag-5'>公共事</b>件与<b class='flag-5'>通知</b>:【Notification<b class='flag-5'>模块</b>】

    鸿蒙开发接口公共事件与通知:【@ohos.reminderAgent (后台代理提醒)】

    开发应用时,开发者可以调用后台提醒发布的接口创建定时提醒,包括倒计时、日历、闹钟三种提醒类型。使用后台代理提醒能力后,应用可以被冻结或退出,计时和弹出提醒的功能将被后台系统服务代理。
    的头像 发表于 05-25 16:27 716次阅读
    <b class='flag-5'>鸿蒙</b><b class='flag-5'>开发</b><b class='flag-5'>接口</b><b class='flag-5'>公共事</b>件与<b class='flag-5'>通知</b>:【@<b class='flag-5'>ohos</b>.reminderAgent (后台代理提醒)】

    鸿蒙开发接口公共事件与通知:【application/EventHub (EventHub)】

    EventHub模块提供了事件中心,提供订阅、取消订阅、触发事件的能力。
    的头像 发表于 05-25 16:31 793次阅读
    <b class='flag-5'>鸿蒙</b><b class='flag-5'>开发</b><b class='flag-5'>接口</b><b class='flag-5'>公共事</b>件与<b class='flag-5'>通知</b>:【application/EventHub (EventHub)】

    鸿蒙开发接口公共事件与通知:【FFI能力】 N-API在Android、iOS平台应用的使用指导

    N-API接口可以实现ArkTS/TS/JS与C/C++(Native)之间的交互,ArkUI-X中支持的N-API接口情况和使用场景请见[FFI能力(N-API)]。本文档以[ArkUI-X/Samples]中的Native样例工程为例,介绍如何在Android平台上使
    的头像 发表于 05-25 16:33 1910次阅读
    <b class='flag-5'>鸿蒙</b><b class='flag-5'>开发</b><b class='flag-5'>接口</b><b class='flag-5'>公共事</b>件与<b class='flag-5'>通知</b>:【FFI能力】 N-API在Android、iOS平台应用的使用指导

    鸿蒙原生应用/元服务开发-通知添加行为意图

    WantAgent提供了封装行为意图的能力,这里所说的行为意图主要是指拉起指定的应用组件及发布公共事件等能力。HarmonyOS支持以通知的形式,将WantAgent从发布方传递至接收方,从而在接收
    发表于 01-05 15:07

    基于ArkTS语言的OpenHarmony APP应用开发公共事件的订阅和发布

    /d05_CustomCommonEvent API接口:9 2、知识准备 2.1、commonEvent模块 OpenHarmony通过CES(Common Event Service,公共
    发表于 09-18 13:16

    HarmonyOS应用开发-公共事件处理

    开发过程中service想要控制多个ability时,可以考虑使用公共事件处理。发布无序的公共事件: //发布公共事件 同步修改卡片与页面public void subscribeE
    发表于 11-02 15:15

    HarmonyOS应用API-CommonEvent.publish

    Api:CommonEvent.publish版本适配:Api7作用:发布公共事件示例代码://发布公共事件回调function PublishCallBack(err) {
    发表于 10-27 15:09

    华为携手智慧城市与公共事业行业打造高效运转的“城市智脑”

      从数字化走向智能化, 智慧城市和公共事业,发生了怎样的改变? 是在“城市智脑”的高效运转下,让市民、企业办事少跑腿、更舒心;是算力翻番,让科研人员从容高效面对deadline,让研发效率
    的头像 发表于 09-08 10:34 1176次阅读

    华为重磅发布政府与公共事业行业智能化架构白皮书

    [中国,上海,2023年9月20日] 华为全联接大会2023期间,华为聚焦公共事业行业场景需求,在以“加速政府与公共事业智能化,共建数智社会”主题峰会上,华为重磅发布政府与公共事业行业智能化架构
    的头像 发表于 09-22 10:21 686次阅读

    云天励飞与上海交大国际与公共事务学院合作推动人工智能产业快速发展

    近日,上海交通大学国际与公共事务学院二十周年院庆大会在上海交通大学徐汇校区文治堂举行。 大会上,云天励飞与与上海交大国际与公共事务学院签订战略合作协议。上海交大领导王宗光、谢绳武、叶取源、盛焕烨、周
    的头像 发表于 10-31 14:12 924次阅读

    鸿蒙开发接口Ability框架:【@ohos.ability.wantConstant (wantConstant)】

    wantConstant模块提供want中action和entity的权限列表的能力,包括系统公共事件宏,系统公共事件名称等。
    的头像 发表于 04-30 16:33 619次阅读
    <b class='flag-5'>鸿蒙</b><b class='flag-5'>开发</b><b class='flag-5'>接口</b>Ability框架:【@<b class='flag-5'>ohos</b>.ability.wantConstant (wantConstant)】

    鸿蒙开发接口公共事件与通知:【FFI能力(Node-API)】

    Node-API是封装底层JavaScript运行时能力的一套Native接口。OpenHarmony的N-API组件对Node-API的接口进行了重新实现,ArkUI-X同样拥有这部分能力,目前支持部分接口,支持列表。
    的头像 发表于 05-21 16:38 967次阅读
    <b class='flag-5'>鸿蒙</b><b class='flag-5'>开发</b><b class='flag-5'>接口</b><b class='flag-5'>公共事</b>件与<b class='flag-5'>通知</b>:【FFI能力(Node-API)】

    基于ArkTS语言的OpenHarmony APP应用开发公共事件的订阅和发布

    1、程序介绍本示例主要展示了公共事件相关的功能,实现了一个检测用户部分行为的应用。具体而言,本案例实现了如下几个公共事件功能:通过订阅系统公共事件,实现对用户操作行为(亮灭屏、断联网)的监测;通过
    的头像 发表于 09-19 08:05 426次阅读
    基于ArkTS语言的OpenHarmony APP应用<b class='flag-5'>开发</b>:<b class='flag-5'>公共事</b>件的订阅和发布