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