1# 系统定义的公共事件（系统接口） 2 3本文档提供了系统定义的公共事件清单。 4 5公共事件类型定义在[ohos.commonEventManager模块的Support枚举](../js-apis-commonEventManager.md#support)中。 6 7> **说明：** 8> 9> 当前界面仅包含本模块的系统接口，其他公开接口参见[系统公共事件定义](../common_event/commonEventManager-definitions.md)。 10 11 12 13 14## Ability Kit 15 16 17### COMMON_EVENT_BOOT_COMPLETED 18 19表示用户已完成引导并加载系统。 20 21在设备上指定用户已完成引导并加载系统，将会触发事件通知服务发布该系统公共事件。 22 23**系统接口：** 此接口为系统接口。 24 25**系统能力：** SystemCapability.Notification.CommonEvent 26 27**订阅者所需权限：** ohos.permission.RECEIVER_STARTUP_COMPLETED（该权限仅系统应用可申请） 28 29 30**取值：** "usual.event.BOOT_COMPLETED" 31 32 33 34### COMMON_EVENT_PACKAGE_INSTALLATION_STARTED<sup>12+</sup> 35 36当一个包被验证时，由系统包验证者发送。 37 38在设备上指定用户下开始安装应用程序，将会触发事件通知服务发布该系统公共事件。 39 40**系统接口：** 此接口为系统接口。 41 42**系统能力：** SystemCapability.Notification.CommonEvent 43 44**订阅者所需权限：** 无 45 46**取值：** "usual.event.PACKAGE_INSTALLATION_STARTED" 47 48 49 50## Background Tasks Kit 51 52### COMMON_EVENT_DEVICE_IDLE_EXEMPTION_LIST_UPDATED<sup>10+<sup> 53 54表示待机状态下解除资源使用限制的豁免名单出现变化，触发公共事件发布动作。 55 56待机状态下后台应用程序CPU和网络访问被限制，系统应用可以申请解除资源使用限制，将会触发公共事件服务发布该系统公共事件。 57资源包括应用网络访问、Timer使用、WorkScheduler任务使用等。 58 59系统应用可以调用JS API接口申请解除资源使用限制。 60 61**系统接口：** 此接口为系统接口。 62 63**系统能力：** SystemCapability.Notification.CommonEvent 64 65**订阅者所需权限：** 无 66 67**取值：** "usual.event.DEVICE_IDLE_EXEMPTION_LIST_UPDATED" 68 69 70## Basic Services Kit-电源 71 72### COMMON_EVENT_CHARGE_TYPE_CHANGED<sup>10+<sup> 73 74表示系统充电类型改变的公共事件的动作。 75 76当系统充电类型改变时，将会触发事件通知服务发布该系统公共事件。 77 78**系统接口：** 此接口为系统接口。 79 80**系统能力：** SystemCapability.Notification.CommonEvent 81 82**订阅者所需权限：** 无 83 84**取值：** "usual.event.CHARGE_TYPE_CHANGED" 85 86 87### COMMON_EVENT_USER_ADDED 88 89表示用户已添加到系统中的公共事件的动作。 90 91创建系统账号将会触发事件通知服务发布该系统公共事件，事件携带系统账号ID。 92 93与这个公共事件相关的接口：createOsAccount、createOsAccountForDomain, 这些为系统API，具体参看[系统账号接口文档](../js-apis-osAccount.md)。 94 95**系统接口：** 此接口为系统接口。 96 97**系统能力：** SystemCapability.Notification.CommonEvent 98 99**订阅者所需权限：** ohos.permission.MANAGE_LOCAL_ACCOUNTS（该权限仅系统应用可申请） 100 101**取值：** "usual.event.USER_ADDED" 102 103 104### COMMON_EVENT_USER_REMOVED 105 106表示用户已从系统中删除的公共事件的动作。 107 108删除系统账号将会触发事件通知服务发布该系统公共事件，事件携带系统账号ID。 109 110与这个公共事件相关的接口：removeOsAccount, 为系统API，具体参看[系统账号接口文档](../js-apis-osAccount.md)。 111 112**系统接口：** 此接口为系统接口。 113 114**系统能力：** SystemCapability.Notification.CommonEvent 115 116**订阅者所需权限：** ohos.permission.MANAGE_LOCAL_ACCOUNTS（该权限仅系统应用可申请） 117 118**取值：** "usual.event.USER_REMOVED" 119 120 121### COMMON_EVENT_DOMAIN_ACCOUNT_STATUS_CHANGED 122 123表示域账号状态发生变化。 124 125域账号认证、删除、令牌更新、令牌失效将会触发事件通知服务发布该系统公共事件，事件携带域账号名、域名、域账号状态等信息。 126 127与这个公共事件相关的接口：removeOsAccount、DomainAccountManager.auth、updateAccountToken, 这些为系统API，具体参看[系统账号接口文档](../js-apis-osAccount.md)。 128 129**系统接口：** 此接口为系统接口。 130 131**系统能力：** SystemCapability.Notification.CommonEvent 132 133**订阅者所需权限：** ohos.permission.GET_LOCAL_ACCOUNTS（该权限仅系统应用可申请） 134 135**取值：** "usual.event.DOMAIN_ACCOUNT_STATUS_CHANGED" 136 137 138### COMMON_EVENT_USER_SWITCHED 139 140表示用户切换完成的公共事件的动作。 141 142切换系统账号将会触发事件通知服务发布该系统公共事件，事件携带系统账号ID。 143 144与这个公共事件相关的接口：activateOsAccount, 为系统API，具体参看[系统账号接口文档](../js-apis-osAccount.md)。 145 146**系统接口：** 此接口为系统接口。 147 148**系统能力：** SystemCapability.Notification.CommonEvent 149 150**订阅者所需权限：** ohos.permission.MANAGE_LOCAL_ACCOUNTS（该权限仅系统应用可申请） 151 152**取值：** "usual.event.USER_SWITCHED" 153 154 155## Core File Kit 156 157文件管理子系统面向应用发布如下系统公共事件，应用如需订阅系统公共事件，请参考公共事件[接口文档](../js-apis-commonEventManager.md)。 158 159 160### COMMON_EVENT_VOLUME_REMOVED 161 162表示外部存储设备正常移除的公共事件。 163 164当外部存储设备处于卸载状态，移除该设备时，会发送此公共事件。 165 166**系统接口：** 此接口为系统接口。 167 168**系统能力：** SystemCapability.Notification.CommonEvent 169 170**订阅者所需权限：** ohos.permission.STORAGE_MANAGER 171 172**取值：** "usual.event.data.VOLUME_REMOVED" 173 174 175 176### COMMON_EVENT_VOLUME_UNMOUNTED 177 178表示外部存储设备状态变更为卸载的公共事件。 179 180当外部存储设备处于挂载状态时，用户选择通过调用unmount接口或者直接移除设备的方法弹出该设备，并且已将外部存储设备卸载成功后，会发送此公共事件。 181 182**系统接口：** 此接口为系统接口。 183 184**系统能力：** SystemCapability.Notification.CommonEvent 185 186**订阅者所需权限：** ohos.permission.STORAGE_MANAGER 187 188**取值：** "usual.event.data.VOLUME_UNMOUNTED" 189 190 191### COMMON_EVENT_VOLUME_MOUNTED 192 193表示外部存储设备状态变更为挂载的公共事件。 194 195当用户插入外部存储设备自动挂载成功或者将处于卸载状态的外部存储设备调用mount接口进行挂载成功后，会发送此公共事件。 196 197**系统接口：** 此接口为系统接口。 198 199**系统能力：** SystemCapability.Notification.CommonEvent 200 201**订阅者所需权限：** ohos.permission.STORAGE_MANAGER 202 203**取值：** "usual.event.data.VOLUME_MOUNTED" 204 205 206### COMMON_EVENT_VOLUME_BAD_REMOVAL 207 208表示外部存储设备异常移除的公共事件。 209 210当外部存储设备处于挂载状态时，用户直接移除该外部存储设备，会发送此公共事件。 211 212**系统接口：** 此接口为系统接口。 213 214**系统能力：** SystemCapability.Notification.CommonEvent 215 216**订阅者所需权限：** ohos.permission.STORAGE_MANAGER 217 218**取值：** "usual.event.data.VOLUME_BAD_REMOVAL" 219 220 221### COMMON_EVENT_VOLUME_EJECT 222 223表示外部存储设备即将被弹出的公共事件。 224 225当外部存储设备处于挂载状态时，用户选择通过调用unmount接口或者直接移除设备的方法弹出该设备时，会发送此公共事件。 226 227**系统接口：** 此接口为系统接口。 228 229**系统能力：** SystemCapability.Notification.CommonEvent 230 231**订阅者所需权限：** ohos.permission.STORAGE_MANAGER 232 233**取值：** "usual.event.data.VOLUME_EJECT" 234 235 236### COMMON_EVENT_RESTORE_START<sup>13+<sup> 237 238表示某个应用开始恢复的公共事件。 239 240当数据迁移相关应用拉起备份恢复框架进行恢复任务，某个应用恢复开始时会发送此公共事件。 241 242**系统接口：** 此接口为系统接口。 243 244**系统能力：** SystemCapability.Notification.CommonEvent 245 246**订阅者所需权限：** ohos.permission.START_RESTORE_NOTIFICATION 247 248**取值：** "usual.event.RESTORE_START" 249 250 251## Telephony Kit 252 253### COMMON_EVENT_SMS_RECEIVE_COMPLETED<sup>10+<sup> 254 255提示短信接收完成。 256 257在设备接收到短信时，将会触发事件通知服务发布该系统公共事件。 258 259**系统接口：** 此接口为系统接口。 260 261**系统能力：** SystemCapability.Notification.CommonEvent 262 263**订阅者所需权限：** ohos.permission.RECEIVE_SMS（该权限仅系统应用可申请） 264 265**取值：** usual.event.SMS_RECEIVED_COMPLETED 266 267 268### COMMON_EVENT_SMS_EMERGENCY_CB_RECEIVE_COMPLETED<sup>10+<sup> 269 270提示紧急小区广播短信接收完成。 271 272在设备接收到紧急小区广播短信时，将会触发事件通知服务发布该系统公共事件。 273 274**系统接口：** 此接口为系统接口。 275 276**系统能力：** SystemCapability.Notification.CommonEvent 277 278**订阅者所需权限：** ohos.permission.RECEIVE_SMS（该权限仅系统应用可申请） 279 280**取值：** usual.event.SMS_EMERGENCY_CB_RECEIVE_COMPLETED 281 282 283### COMMON_EVENT_SMS_CB_RECEIVE_COMPLETED<sup>10+<sup> 284 285提示小区广播短信接收完成。 286 287在设备接收到小区广播短信时，将会触发事件通知服务发布该系统公共事件。 288 289**系统接口：** 此接口为系统接口。 290 291**系统能力：** SystemCapability.Notification.CommonEvent 292 293**订阅者所需权限：** ohos.permission.RECEIVE_SMS（该权限仅系统应用可申请） 294 295**取值：** usual.event.SMS_CB_RECEIVE_COMPLETED 296 297 298 299 300 301### COMMON_EVENT_OPERATOR_CONFIG_CHANGED<sup>10+<sup> 302 303提示运营商配置已更新。 304 305在设备运营商配置更新时，将会触发事件通知服务发布该系统公共事件。 306 307**系统接口：** 此接口为系统接口。 308 309**系统能力：** SystemCapability.Notification.CommonEvent 310 311**订阅者所需权限：** 无 312 313**取值：** usual.event.OPERATOR_CONFIG_CHANGED 314 315 316### COMMON_EVENT_SIM_CARD_DEFAULT_SMS_SUBSCRIPTION_CHANGED<sup>10+<sup> 317 318提示SIM卡默认短信主卡已更新。 319 320在设备SIM卡默认短信主卡更新时，将会触发事件通知服务发布该系统公共事件。 321 322**系统接口：** 此接口为系统接口。 323 324**系统能力：** SystemCapability.Notification.CommonEvent 325 326**订阅者所需权限：** 无 327 328**取值：** usual.event.DEFAULT_SMS_SUBSCRIPTION_CHANGED 329 330 331### COMMON_EVENT_SIM_CARD_DEFAULT_DATA_SUBSCRIPTION_CHANGED<sup>10+<sup> 332 333提示SIM卡默认数据主卡已更新。 334 335在设备SIM卡默认数据主卡更新时，将会触发事件通知服务发布该系统公共事件。 336 337**系统接口：** 此接口为系统接口。 338 339**系统能力：** SystemCapability.Notification.CommonEvent 340 341**订阅者所需权限：** 无 342 343**取值：** usual.event.DEFAULT_DATA_SUBSCRIPTION_CHANGED 344 345 346### COMMON_EVENT_SIM_CARD_DEFAULT_MAIN_SUBSCRIPTION_CHANGED<sup>10+<sup> 347 348提示SIM卡默认主卡已更新。 349 350在设备SIM卡默认主卡更新时，将会触发事件通知服务发布该系统公共事件。 351 352**系统接口：** 此接口为系统接口。 353 354**系统能力：** SystemCapability.Notification.CommonEvent 355 356**订阅者所需权限：** 无 357 358**取值：** usual.event.SIM.DEFAULT_MAIN_SUBSCRIPTION_CHANGED 359 360 361### COMMON_EVENT_SET_PRIMARY_SLOT_STATUS<sup>11+<sup> 362 363提示设置SIM卡默认主卡的动作，其状态更新为执行中或已完成。 364 365在设备上设置SIM卡默认主卡时，当执行状态发生变化（比如状态更新到执行中或已完成），将会触发事件通知服务发布该系统公共事件。 366 367**系统接口：** 此接口为系统接口。 368 369**系统能力：** SystemCapability.Notification.CommonEvent 370 371**订阅者所需权限：** 无 372 373**取值：** usual.event.SET_PRIMARY_SLOT_STATUS 374 375 376### COMMON_EVENT_PRIMARY_SLOT_ROAMING<sup>11+<sup> 377 378提示SIM卡默认主卡的漫游状态已更新。 379 380在设备SIM卡默认主卡的漫游状态发生变化时，将会触发事件通知服务发布该系统公共事件。 381 382**系统接口：** 此接口为系统接口。 383 384**系统能力：** SystemCapability.Notification.CommonEvent 385 386**订阅者所需权限：** 无 387 388**取值：** usual.event.PRIMARY_SLOT_ROAMING 389 390 391### COMMON_EVENT_SIM_CARD_DEFAULT_VOICE_SUBSCRIPTION_CHANGED<sup>10+<sup> 392 393提示SIM卡默认语音主卡已更新。 394 395在设备SIM卡默认语音主卡更新时，将会触发事件通知服务发布该系统公共事件。 396 397**系统接口：** 此接口为系统接口。 398 399**系统能力：** SystemCapability.Notification.CommonEvent 400 401**订阅者所需权限：** 无 402 403**取值：** usual.event.DEFAULT_VOICE_SUBSCRIPTION_CHANGED 404 405 406### COMMON_EVENT_CELLULAR_DATA_STATE_CHANGED<sup>10+<sup> 407 408提示蜂窝数据状态更新。 409 410在设备蜂窝数据状态更新时，将会触发事件通知服务发布该系统公共事件。 411 412**系统接口：** 此接口为系统接口。 413 414**系统能力：** SystemCapability.Notification.CommonEvent 415 416**订阅者所需权限：** 无 417 418**取值：** usual.event.CELLULAR_DATA_STATE_CHANGED 419 420 421### COMMON_EVENT_INCOMING_CALL_MISSED<sup>10+<sup> 422 423提示未接来电。 424 425在设备有未接来电时，将会触发事件通知服务发布该系统公共事件。 426 427**系统接口：** 此接口为系统接口。 428 429**系统能力：** SystemCapability.Notification.CommonEvent 430 431**订阅者所需权限：** ohos.permission.GET_TELEPHONY_STATE（该权限仅系统应用可申请） 432 433**取值：** usual.event.INCOMING_CALL_MISSED 434 435 436### COMMON_EVENT_RADIO_STATE_CHANGE<sup>10+<sup> 437 438提示设备modem上下电状态变化。 439 440在设备modem上下电状态变化时，将会触发事件通知服务发布该系统公共事件。 441 442**系统接口：** 此接口为系统接口。 443 444**系统能力：** SystemCapability.Notification.CommonEvent 445 446**订阅者所需权限：** 无 447 448**取值：** usual.event.RADIO_STATE_CHANGE 449 450 451### COMMON_EVENT_SPECIAL_CODE<sup>10+<sup> 452 453提示暗码发送成功。 454 455在设备上发送暗码成功时，将会触发事件通知服务发布该系统公共事件。 456 457**系统接口：** 此接口为系统接口。 458 459**系统能力：** SystemCapability.Notification.CommonEvent 460 461**订阅者所需权限：** 无 462 463**取值：** usual.event.DIALER_SPECIAL_CODE 464 465 466### COMMON_EVENT_AUDIO_QUALITY_CHANGE<sup>10+<sup> 467 468提示音频质量发生变化。 469 470在设备音频质量发送变化时，将会触发事件通知服务发布该系统公共事件。 471 472**系统接口：** 此接口为系统接口。 473 474**系统能力：** SystemCapability.Notification.CommonEvent 475 476**订阅者所需权限：** 无 477 478**取值：** usual.event.AUDIO_QUALITY_CHANGE 479 480 481## 预留公共事件 482 483以下事件为预留公共事件，暂未支持。 484 485### COMMON_EVENT_STK_COMMAND<sup>10+<sup> 486 487（预留事件，暂未支持）提示STK命令。 488 489在发送STK命令时，将会触发事件通知服务发布该系统公共事件。 490 491**系统接口：** 此接口为系统接口。 492 493**系统能力：** SystemCapability.Notification.CommonEvent 494 495**订阅者所需权限：** 无 496 497**取值：** usual.event.STK_COMMAND 498 499 500### COMMON_EVENT_STK_SESSION_END<sup>10+<sup> 501 502（预留事件，暂未支持）提示STK会话结束。 503 504在STK会话结束时，将会触发事件通知服务发布该系统公共事件。 505 506**系统接口：** 此接口为系统接口。 507 508**系统能力：** SystemCapability.Notification.CommonEvent 509 510**订阅者所需权限：** 无 511 512**取值：** usual.event.STK_SESSION_END 513 514 515### COMMON_EVENT_STK_CARD_STATE_CHANGED<sup>10+<sup> 516 517（预留事件，暂未支持）提示STK卡状态已更新。 518 519在STK卡状态更新时，将会触发事件通知服务发布该系统公共事件。 520 521**系统接口：** 此接口为系统接口。 522 523**系统能力：** SystemCapability.Notification.CommonEvent 524 525**订阅者所需权限：** 无 526 527 528**取值：** usual.event.STK_CARD_STATE_CHANGED 529 530### COMMON_EVENT_STK_ALPHA_IDENTIFIER<sup>10+<sup> 531 532（预留事件，暂未支持）提示STK ALPHA标识符。 533 534在发送STK ALPHA标识符时，将会触发事件通知服务发布该系统公共事件。 535 536**系统接口：** 此接口为系统接口。 537 538**系统能力：** SystemCapability.Notification.CommonEvent 539 540**订阅者所需权限：** 无 541 542**取值：** usual.event.STK_ALPHA_IDENTIFIER 543 544 545### COMMON_EVENT_SMS_WAPPUSH_RECEIVE_COMPLETED<sup>10+<sup> 546 547（预留事件，暂未支持）提示服务信息短信接收完成。 548 549在设备接收服务信息短信完成时，将会触发事件通知服务发布该系统公共事件。 550 551**系统接口：** 此接口为系统接口。 552 553**系统能力：** SystemCapability.Notification.CommonEvent 554 555**订阅者所需权限：** ohos.permission.RECEIVE_SMS（该权限仅系统应用可申请） 556 557**取值：** usual.event.SMS_WAPPUSH_RECEIVE_COMPLETED