1# Power（V1_2） 2 3 4## 概述 5 6提供休眠/唤醒操作、订阅休眠/唤醒状态、运行锁管理的接口。 7 8电源模块为电源服务提供的休眠/唤醒操作、订阅休眠/唤醒状态和运行锁管理的接口。 服务获取此模块的对象或代理后，可以调用相关的接口对设备进行休眠/唤醒、订阅休眠/唤醒状态和管理运行锁。 9 10**起始版本：** 3.1 11 12 13## 汇总 14 15 16### 文件 17 18| 名称 | 描述 | 19| -------- | -------- | 20| [IPowerHdiCallback.idl](_i_power_hdi_callback_8idl.md) | 休眠/唤醒状态的回调。电源模块为电源服务提供的订阅休眠/唤醒状态的回调。 | 21| [IPowerInterface.idl](_i_power_interface_8idl.md) | 电源模块为电源服务提供休眠/唤醒操作、订阅休眠/唤醒状态和运行锁管理的接口。 | 22| [IPowerRunningLockCallback.idl](_i_power_running_lock_callback_8idl.md) | 提供运行锁定状态的回调。电源模块为电源服务提供回调，以处理运行锁状态。 | 23| [PowerTypes.idl](_power_types_8idl.md) | 电源相关的数据类型。电源管理中使用的数据类型，包括命令参数、回调参数和系统状态。 | 24| [RunningLockTypes.idl](_running_lock_types_8idl.md) | 枚举与运行锁管理相关的数据类型。这些数据类型包括运行锁类型和运行锁信息。 | 25 26 27### 结构体 28 29| 名称 | 描述 | 30| -------- | -------- | 31| interface [IPowerHdiCallback](interface_i_power_hdi_callback.md) | 休眠/唤醒状态的回调。服务创建此回调对象后，可以调用[IPowerInterface](interface_i_power_interface.md)的接口注册回调，从而订阅休眠/唤醒状态的变化。 | 32| interface [IPowerInterface](interface_i_power_interface.md) | 休眠/唤醒操作、订阅休眠/唤醒状态、运行锁管理的接口。 | 33| interface [IPowerRunningLockCallback](interface_i_power_running_lock_callback.md) | 表示运行中的锁定状态的回调。创建回调对象后，电源服务可以调用 [IPowerInterface](interface_i_power_interface.md)来注册回调，以订阅运行锁状态变化。 | 34| struct [RunningLockInfo](_running_lock_info.md) | 定义运行锁的信息。 | 35 36 37### 枚举 38 39| 名称 | 描述 | 40| -------- | -------- | 41| [PowerHdfCmd](#powerhdfcmd) {<br/>CMD_REGISTER_CALLBCK = 0, <br/>CMD_START_SUSPEND, <br/>CMD_STOP_SUSPEND, <br/>CMD_FORCE_SUSPEND,<br/>CMD_SUSPEND_BLOCK, <br/>CMD_SUSPEND_UNBLOCK, <br/>CMD_DUMP<br/>} | 枚举电源命令的参数。 | 42| [PowerHdfCallbackCmd](#powerhdfcallbackcmd) { <br/>CMD_ON_SUSPEND = 0, <br/>CMD_ON_WAKEUP <br/>} | 枚举电源状态回调的参数。 | 43| [PowerHdfState](#powerhdfstate) { <br/>AWAKE = 0, <br/>INACTIVE, SLEEP <br/>} | 枚举电源的状态。 | 44| [BaseRunningLockType](#baserunninglocktype) { <br/>RUNNINGLOCK_SCREEN = 0, <br/>RUNNINGLOCK_BACKGROUND = 1, <br/>RUNNINGLOCK_PROXIMITY_SCREEN_CONTROL = 2 <br/>} | 枚举基本运行锁类型。 | 45| [RunningLockType](#runninglocktype) {<br/>RUNNINGLOCK_BACKGROUND_PHONE = 3, <br/>RUNNINGLOCK_BACKGROUND_NOTIFICATION = 5, <br/>RUNNINGLOCK_BACKGROUND_AUDIO = 9, <br/>RUNNINGLOCK_BACKGROUND_SPORT = 17,<br/>RUNNINGLOCK_BACKGROUND_NAVIGATION = 33, <br/>RUNNINGLOCK_BACKGROUND_TASK = 65, <br/>RUNNINGLOCK_BUTT<br/>} | 枚举运行锁类型。 | 46 47 48## 枚举类型说明 49 50 51### BaseRunningLockType 52 53``` 54enum BaseRunningLockType 55``` 56 57**描述** 58 59枚举基本运行锁类型。 60 61**起始版本：** 4.0 62 63| 枚举值 | 描述 | 64| -------- | -------- | 65| RUNNINGLOCK_SCREEN | 用于保持屏幕处于开启状态。 | 66| RUNNINGLOCK_BACKGROUND | 用于保持 CPU 处于运行状态，锁屏状态下继续完成后台任务。 | 67| RUNNINGLOCK_PROXIMITY_SCREEN_CONTROL | 通过传感器控制屏幕的开关。 | 68 69 70### PowerHdfCallbackCmd 71 72``` 73enum PowerHdfCallbackCmd 74``` 75 76**描述** 77 78枚举电源状态回调的参数。 79 80**起始版本：** 3.1 81 82**废弃版本：** 从4.0版本废弃。 83 84| 枚举值 | 描述 | 85| -------- | -------- | 86| CMD_ON_SUSPEND | 休眠回调的命令参数。 | 87| CMD_ON_WAKEUP | 唤醒回调的命令参数。 | 88 89 90### PowerHdfCmd 91 92``` 93enum PowerHdfCmd 94``` 95 96**描述** 97 98枚举电源命令的参数。 99 100**起始版本：** 3.1 101 102**废弃版本：** 从4.0版本废弃。 103 104| 枚举值 | 描述 | 105| -------- | -------- | 106| CMD_REGISTER_CALLBCK | 订阅状态的命令参数 | 107| CMD_START_SUSPEND | 休眠的命令参数 | 108| CMD_STOP_SUSPEND | 唤醒的命令参数 | 109| CMD_FORCE_SUSPEND | 强制休眠的命令参数 | 110| CMD_SUSPEND_BLOCK | 打开运行锁的命令参数 | 111| CMD_SUSPEND_UNBLOCK | 关闭运行锁的命令参数 | 112| CMD_DUMP | Dump的命令参数 | 113 114 115### PowerHdfState 116 117``` 118enum PowerHdfState 119``` 120 121**描述** 122 123枚举电源的状态。 124 125**起始版本：** 3.1 126 127| 枚举值 | 描述 | 128| -------- | -------- | 129| AWAKE | 唤醒状态。 | 130| INACTIVE | 非活动状态。 | 131| SLEEP | 休眠状态。 | 132 133 134### RunningLockType 135 136``` 137enum RunningLockType 138``` 139 140**描述** 141 142枚举运行锁类型。 143 144**起始版本：** 4.0 145 146| 枚举值 | 描述 | 147| -------- | -------- | 148| RUNNINGLOCK_BACKGROUND_PHONE | 用于保持后台手机任务的完成。 | 149| RUNNINGLOCK_BACKGROUND_NOTIFICATION | 用于保持后台通知任务完成。 | 150| RUNNINGLOCK_BACKGROUND_AUDIO | 用于保持后台音频任务完成。 | 151| RUNNINGLOCK_BACKGROUND_SPORT | 用于保持后台运动任务的完成。 | 152| RUNNINGLOCK_BACKGROUND_NAVIGATION | 用于保持后台导航任务的完成。 | 153| RUNNINGLOCK_BACKGROUND_TASK | 用于保持后台常见任务的完成。 | 154| RUNNINGLOCK_BUTT | 预留运行锁类型。 | 155