Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
2a6a7f15
D
Docs
项目概览
OpenHarmony
/
Docs
大约 2 年 前同步成功
通知
161
Star
293
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
提交
2a6a7f15
编写于
5月 25, 2023
作者:
G
geraltxu
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
文档修改
Signed-off-by:
N
xufanghan
<
xufanghan@huawei.com
>
上级
4b897008
变更
2
显示空白变更内容
内联
并排
Showing
2 changed file
with
28 addition
and
38 deletion
+28
-38
zh-cn/application-dev/device_standby/device-standby-use-guide.md
...pplication-dev/device_standby/device-standby-use-guide.md
+12
-16
zh-cn/application-dev/reference/apis/js-apis-resourceschedule-deviceStandby.md
.../reference/apis/js-apis-resourceschedule-deviceStandby.md
+16
-22
未找到文件。
zh-cn/application-dev/device_standby/device-standby-use-guide.md
浏览文件 @
2a6a7f15
# 设备待机续航部件开发指南
## 场景介绍
当前设备在灭屏进入待机睡眠前,应用不会被冻结、Work任务不会被延迟、Timer时间不会变慢、CPU锁不会释放、应用网络访问不会停止,导致设备灭屏功耗大,影响整机续航。
因此,在进入待机空闲状态下,需要限制后台应用使用资源,降低整机功耗。
<br>
解决以下场景
<br>
一、采集系统设备进入待机空闲特征,进入待机时机,退出待机条件
<br>
二、检测设备进入浅睡眠状态和深睡眠状态
<br>
三、设备每隔一段时间暂停睡眠,进入维护状态
<br>
四、检测到设备进入待机空闲状态,触发资源管控
# 设备待机模块开发指南
## 设备待机模块概述
为提高设备续航,降低设备功耗,在设备进入待机空闲状态时,限制后台应用使用资源。开发者可以根据自身情况,为自己的应用申请纳入待机资源管控或者暂时不被待机资源管控。
本文档旨在帮助开发者理解设备待机空闲下的相关功能和资源使用规范。
## 待机低续航模式介绍
待机低续航模式会延迟应用后台cpu和网络活动,从而延长电池续航时间。
<br>
包括:
...
...
@@ -17,9 +10,12 @@
<br>
3.running_lock锁:释放应用申请的cpu running_lock锁
<br>
4.Timer响应:延迟应用的timer响应
## 接口说明
一、应用查询待机空闲状态接口
<br>
isDeviceInStandby
二、应用申请待机空闲状态正常使用资源的接口
<br>
getExemptedApps
requestExemptionResource
releaseExemptionResource
[
设备待机模块接口api开发文档
](
https://gitee.com/openharmony/docs/blob/4b89700885537543d26e2dfc96b4dee15a544229/zh-cn/application-dev/reference/apis/js-apis-resourceschedule-deviceStandby.md
)
主要接口
| 接口 | 说明 |
|--------------------------|----|
| isDeviceInStandby | 查询应用是否处于待机空闲状态,如果处于空闲状态,该应用可能被纳入资源管控。 |
| getExemptedApps | 获取不会被纳入待机资源管控的应用列表 |
| requestExemptionResource | 为应用申请暂时不会被纳入待机资源管控的能力 |
| releaseExemptionResource | 取消应用暂时不会被纳入待机资源管控能力 |
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-resourceschedule-deviceStandby.md
浏览文件 @
2a6a7f15
# @ohos.resourceschedule.deviceStandby(设备待机模块)
本模块提供设备待机空闲部件管理功能
API使用场景:
当设备长时间未被使用或通过按键,可以使设备进入待机模式。待机模式不影响应用使用,还可以延长电池续航时间。
通过本模块接口,可查询设备是否为待机模式,以及使应用灵活申请开启或关闭待机模式。
本模块提供设备待机空闲部件管理功能。当设备长时间未被使用或通过按键,可以使设备进入待机模式。待机模式不影响应用使用,还可以延长电池续航时间。通过本模块接口,可查询设备是否为待机模式,以及使应用灵活申请开启或关闭待机模式。
> **说明:**
> - 本模块首批接口从API version 10开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
...
...
@@ -26,6 +22,7 @@ isDeviceInStandby(callback: AsyncCallback<boolean>): void;
| callback | Callback
<
boolean
>
| 是 | 延迟即将超时的回调函数,一般在超时前6秒通过此回调通知应用。 |
**错误码**
:
以下错误码的详细介绍请参见
[
后台任务错误码
](
../errorcodes/errorcode-backgroundTaskMgr.md
)
。
| 错误码ID | 错误信息 |
...
...
@@ -73,8 +70,8 @@ getExemptedApps(resourceTypes: number, callback: AsyncCallback<Array<Exempted
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------------------- | ---- | ------------------------------ |
|
resourceTypes |number | 是 |
[
ResourceType
](
#resourcetype
)
|
| callback | AsyncCallback
<Array
&
lt
;
ExemptedAppInfo
&
gt
;
>
| 是 |
[
ExemptedAppInfo
](
#exemptedappinfo
)
|
|
[
ResourceType
](
#resourcetype
)
|number | 是 | 资源类型
|
| callback | AsyncCallback
<Array
&
lt
;
[
ExemptedAppInfo
](
#exemptedappinfo
)&
gt
;
>
| 是 |豁免应用信息
|
**错误码**
:
...
...
@@ -101,13 +98,13 @@ getExemptedApps(resourceTypes: number): Promise<Array<ExemptedAppInfo>>;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------------------- | ---- | ------------------------------ |
|
resourceTypes |number | 是 |
[
ResourceType
](
#resourcetype
)
|
|
[
ResourceType
](
#resourcetype
)
|number | 是 |资源类型
|
**返回值**
:
| 类型 | 说明 |
| --------------------- | ---------------------------------------- |
| Promise
<Array
&
lt
;
ExemptedAppInfo
&
gt
;
>
|
[
ExemptedAppInfo
](
#exemptedappinfo
)
|
| Promise
<Array
&
lt
;
[
ExemptedAppInfo
](
#exemptedappinfo
)&
gt
;
>
| 豁免应用信息
|
**错误码**
:
...
...
@@ -127,7 +124,7 @@ getExemptedApps(resourceTypes: number): Promise<Array<ExemptedAppInfo>>;
## deviceStandby.requestExemptionResource
requestExemptionResource(request: ResourceRequest): void;
订阅申请豁免。
订阅申请豁免
,为应用申请临时不进入待机管控能力
。
**系统能力:**
SystemCapability.ResourceSchedule.DeviceStandby.Exemption
...
...
@@ -137,7 +134,7 @@ requestExemptionResource(request: ResourceRequest): void;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------------------- | ---- | ------------------------------ |
| request |
ResourceRequest | 是 |
[
ResourceRequest
](
#resourcerequest
)
|
| request |
[
ResourceRequest
](
#resourcerequest
)
| 是 | 资源请求
|
**错误码**
:
...
...
@@ -154,7 +151,7 @@ requestExemptionResource(request: ResourceRequest): void;
## deviceStandby.releaseExemptionResource
releaseExemptionResource(request: ResourceRequest): void;
去除订阅申请豁免。
去除订阅申请豁免
,去除应用暂时不进入待机管控的能力
。
**系统能力:**
SystemCapability.ResourceSchedule.DeviceStandby.Exemption
...
...
@@ -164,7 +161,7 @@ releaseExemptionResource(request: ResourceRequest): void;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------------------- | ---- | ------------------------------ |
| request |
ResourceRequest | 是 |
[
ResourceRequest
](
#resourcerequest
)
|
| request |
[
ResourceRequest
](
#resourcerequest
)
| 是 | 资源请求
|
**错误码**
:
...
...
@@ -178,9 +175,8 @@ releaseExemptionResource(request: ResourceRequest): void;
| 9800004 | System service operation failed. |
| 18700001 | Caller information verification failed when applying for efficiency resources. |
## 枚举类和请求体
### ResourceType
豁免应用资源枚举
## ResourceType
应用资源枚举。
<br>
|名称 |值 |说明|
...
...
@@ -193,10 +189,8 @@ releaseExemptionResource(request: ResourceRequest): void;
|PUSH |32 | 非待机pushkit资源|
|FREEZE |64 | 非待机冻结应用资源|
### ExemptedAppInfo
豁免应用信息
..
## ExemptedAppInfo
豁免应用信息,不进入待机管控的应用信息。
<br>
|名称 |类型 |说明 |
...
...
@@ -205,8 +199,8 @@ releaseExemptionResource(request: ResourceRequest): void;
|name |string | 应用名 |
|duration | number | 豁免时长 |
##
#
ResourceRequest
待机资源请求体
## ResourceRequest
待机资源请求体
。
<br>
|名称 |类型 |说明 |
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录