未验证 提交 314e917f 编写于 作者: N ningning 提交者: Gitee

update zh-cn/application-dev/reference/apis/js-apis-resourceschedule-deviceStandby.md.

Signed-off-by: Nningning <3248127340@qq.com>
上级 05cd3ae9
...@@ -3,14 +3,16 @@ ...@@ -3,14 +3,16 @@
> **说明**: > **说明**:
> >
> - 本模块首批接口从API version 10开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。<br> > 本模块首批接口从API version 10开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。<br>
## 导入模块 ## 导入模块
```js ```js
import deviceStandby from '@ohos.resourceschedule.deviceStandby'; import deviceStandby from '@ohos.resourceschedule.deviceStandby';
``` ```
## deviceStandby.isDeviceInStandby ## deviceStandby.isDeviceInStandby
isDeviceInStandby(callback: AsyncCallback&lt;boolean&gt;): void; isDeviceInStandby(callback: AsyncCallback&lt;boolean&gt;): void;
当前设备是否进入待机低功耗续航模式,使用Callback异步回调。 当前设备是否进入待机低功耗续航模式,使用Callback异步回调。
...@@ -38,20 +40,22 @@ isDeviceInStandby(callback: AsyncCallback&lt;boolean&gt;): void; ...@@ -38,20 +40,22 @@ isDeviceInStandby(callback: AsyncCallback&lt;boolean&gt;): void;
| 18700001 | Caller information verification failed. | | 18700001 | Caller information verification failed. |
**示例** **示例**
```js
try{ try{
deviceStandby.isDeviceInStandby((err, res) => { deviceStandby.isDeviceInStandby((err, res) => {
if (err) { if (err) {
console.log('DEVICE_STANDBY isDeviceInStandby callback failed. code is: ' + err.code + ',message is: ' + err.message); console.log('DEVICE_STANDBY isDeviceInStandby callback failed. code is: ' + err.code + ',message is: ' + err.message);
} else { } else {
console.log('DEVICE_STANDBY isDeviceInStandby callback succeeded, result: ' + JSON.stringify(res)); console.log('DEVICE_STANDBY isDeviceInStandby callback succeeded, result: ' + JSON.stringify(res));
} }
}); });
} catch(error) { } catch(error) {
console.log('DEVICE_STANDBY isDeviceInStandby throw error, code is: ' + error.code + ',message is: ' + error.message); console.log('DEVICE_STANDBY isDeviceInStandby throw error, code is: ' + error.code + ',message is: ' + error.message);
} }
```
## deviceStandby.isDeviceInStandby ## deviceStandby.isDeviceInStandby
isDeviceInStandby(): Promise&lt;boolean&gt; isDeviceInStandby(): Promise&lt;boolean&gt;
当前设备是否进入待机低功耗续航模式,使用Promise异步回调。 当前设备是否进入待机低功耗续航模式,使用Promise异步回调。
...@@ -64,7 +68,7 @@ isDeviceInStandby(): Promise&lt;boolean&gt; ...@@ -64,7 +68,7 @@ isDeviceInStandby(): Promise&lt;boolean&gt;
| 类型 | 说明 | | 类型 | 说明 |
| --------------------- | ---------------------------------------- | | --------------------- | ---------------------------------------- |
| Promise&lt;boolean&gt; | 指定的Promise回调方法返回是否进入待机低功耗续航模式。| | Promise&lt;boolean&gt; | 指定的Promise回调方法返回是否进入待机低功耗续航模式。|
**错误码** **错误码**
...@@ -79,18 +83,20 @@ isDeviceInStandby(): Promise&lt;boolean&gt; ...@@ -79,18 +83,20 @@ isDeviceInStandby(): Promise&lt;boolean&gt;
| 18700001 | Caller information verification failed. | | 18700001 | Caller information verification failed. |
**示例** **示例**
```js
try{ try{
deviceStandby.isDeviceInStandby().then( res => { deviceStandby.isDeviceInStandby().then( res => {
console.log('DEVICE_STANDBY isDeviceInStandby promise succeeded, result: ' + JSON.stringify(res)); console.log('DEVICE_STANDBY isDeviceInStandby promise succeeded, result: ' + JSON.stringify(res));
}).catch( err => { }).catch( err => {
console.log('DEVICE_STANDBY isDeviceInStandby promise failed. code is: ' + err.code + ',message is: ' + err.message); console.log('DEVICE_STANDBY isDeviceInStandby promise failed. code is: ' + err.code + ',message is: ' + err.message);
}); });
} catch (error) { } catch (error) {
console.log('DEVICE_STANDBY isDeviceInStandby throw error, code is: ' + error.code + ',message is: ' + error.message); console.log('DEVICE_STANDBY isDeviceInStandby throw error, code is: ' + error.code + ',message is: ' + error.message);
} }
```
## deviceStandby.getExemptedApps ## deviceStandby.getExemptedApps
getExemptedApps(resourceTypes: number, callback: AsyncCallback<Array&lt;ExemptedAppInfo&gt;>): void; getExemptedApps(resourceTypes: number, callback: AsyncCallback<Array&lt;ExemptedAppInfo&gt;>): void;
获取进入待机模式的应用名单,使用Callback异步回调。 获取进入待机模式的应用名单,使用Callback异步回调。
...@@ -105,8 +111,8 @@ getExemptedApps(resourceTypes: number, callback: AsyncCallback<Array&lt;Exempted ...@@ -105,8 +111,8 @@ getExemptedApps(resourceTypes: number, callback: AsyncCallback<Array&lt;Exempted
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------------------- | ---- | ------------------------------ | | -------- | -------------------- | ---- | ------------------------------ |
| [ResourceType](#resourcetype)|number | 是 | 资源类型 | | [ResourceTypes](#resourcetype)|number | 是 | 资源类型。 |
| callback | AsyncCallback<Array&lt;[ExemptedAppInfo](#exemptedappinfo)&gt;> | 是 |豁免应用信息 | | callback | AsyncCallback<Array&lt;[ExemptedAppInfo](#exemptedappinfo)&gt;> | 是 |豁免应用信息 |
**错误码** **错误码**
...@@ -121,9 +127,9 @@ getExemptedApps(resourceTypes: number, callback: AsyncCallback<Array&lt;Exempted ...@@ -121,9 +127,9 @@ getExemptedApps(resourceTypes: number, callback: AsyncCallback<Array&lt;Exempted
| 18700001 | Caller information verification failed. | | 18700001 | Caller information verification failed. |
**示例** **示例**
```js
try{ try{
deviceStandby.getExemptedApps(resourceTypes, (err, res) => { deviceStandby.getExemptedApps(resourceTypes, (err, res) => {
if (err) { if (err) {
console.log('DEVICE_STANDBY getExemptedApps callback failed. code is: ' + err.code + ',message is: ' + err.message); console.log('DEVICE_STANDBY getExemptedApps callback failed. code is: ' + err.code + ',message is: ' + err.message);
} else { } else {
...@@ -132,12 +138,14 @@ getExemptedApps(resourceTypes: number, callback: AsyncCallback<Array&lt;Exempted ...@@ -132,12 +138,14 @@ getExemptedApps(resourceTypes: number, callback: AsyncCallback<Array&lt;Exempted
console.log('DEVICE_STANDBY getExemptedApps callback result ' + JSON.stringify(res[i])); console.log('DEVICE_STANDBY getExemptedApps callback result ' + JSON.stringify(res[i]));
} }
} }
}); });
} catch (error) { } catch (error) {
console.log('DEVICE_STANDBY getExemptedApps throw error, code is: ' + error.code + ',message is: ' + error.message); console.log('DEVICE_STANDBY getExemptedApps throw error, code is: ' + error.code + ',message is: ' + error.message);
} }
```
## deviceStandby.getExemptedApps ## deviceStandby.getExemptedApps
getExemptedApps(resourceTypes: number): Promise<Array&lt;ExemptedAppInfo&gt;>; getExemptedApps(resourceTypes: number): Promise<Array&lt;ExemptedAppInfo&gt;>;
获取进入待机模式的应用名单,使用Promise异步回调。 获取进入待机模式的应用名单,使用Promise异步回调。
...@@ -152,13 +160,13 @@ getExemptedApps(resourceTypes: number): Promise<Array&lt;ExemptedAppInfo&gt;>; ...@@ -152,13 +160,13 @@ getExemptedApps(resourceTypes: number): Promise<Array&lt;ExemptedAppInfo&gt;>;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------------------- | ---- | ------------------------------ | | -------- | -------------------- | ---- | ------------------------------ |
| [ResourceType](#resourcetype)|number | 是 |资源类型| | [ResourceTypes](#resourcetype)|number | 是 |资源类型。|
**返回值** **返回值**
| 类型 | 说明 | | 类型 | 说明 |
| --------------------- | ---------------------------------------- | | --------------------- | ---------------------------------------- |
| Promise<Array&lt;[ExemptedAppInfo](#exemptedappinfo)&gt;> | 豁免应用信息 | | Promise<Array&lt;[ExemptedAppInfo](#exemptedappinfo)&gt;> | 豁免应用信息 |
**错误码** **错误码**
...@@ -176,21 +184,23 @@ getExemptedApps(resourceTypes: number): Promise<Array&lt;ExemptedAppInfo&gt;>; ...@@ -176,21 +184,23 @@ getExemptedApps(resourceTypes: number): Promise<Array&lt;ExemptedAppInfo&gt;>;
| 18700001 | Caller information verification failed. | | 18700001 | Caller information verification failed. |
**示例** **示例**
```js
try{ try{
deviceStandby.getExemptedApps(resourceTypes).then( res => { deviceStandby.getExemptedApps(resourceTypes).then( res => {
console.log('DEVICE_STANDBY getExemptedApps promise success.'); console.log('DEVICE_STANDBY getExemptedApps promise success.');
for (let i = 0; i < res.length; i++) { for (let i = 0; i < res.length; i++) {
console.log('DEVICE_STANDBY getExemptedApps promise result ' + JSON.stringify(res[i])); console.log('DEVICE_STANDBY getExemptedApps promise result ' + JSON.stringify(res[i]));
} }
}).catch( err => { }).catch( err => {
console.log('DEVICE_STANDBY getExemptedApps promise failed. code is: ' + err.code + ',message is: ' + err.message); console.log('DEVICE_STANDBY getExemptedApps promise failed. code is: ' + err.code + ',message is: ' + err.message);
}); });
} catch (error) { } catch (error) {
console.log('DEVICE_STANDBY getExemptedApps throw error, code is: ' + error.code + ',message is: ' + error.message); console.log('DEVICE_STANDBY getExemptedApps throw error, code is: ' + error.code + ',message is: ' + error.message);
} }
```
## deviceStandby.requestExemptionResource ## deviceStandby.requestExemptionResource
requestExemptionResource(request: ResourceRequest): void; requestExemptionResource(request: ResourceRequest): void;
应用订阅申请豁免,使应用临时不进入待机管控。 应用订阅申请豁免,使应用临时不进入待机管控。
...@@ -205,7 +215,7 @@ requestExemptionResource(request: ResourceRequest): void; ...@@ -205,7 +215,7 @@ requestExemptionResource(request: ResourceRequest): void;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------------------- | ---- | ------------------------------ | | -------- | -------------------- | ---- | ------------------------------ |
| request |[ResourceRequest](#resourcerequest)| 是 | 资源请求 | | request |[ResourceRequest](#resourcerequest)| 是 | 资源请求 |
**错误码** **错误码**
...@@ -220,39 +230,41 @@ requestExemptionResource(request: ResourceRequest): void; ...@@ -220,39 +230,41 @@ requestExemptionResource(request: ResourceRequest): void;
| 18700001 | Caller information verification failed. | | 18700001 | Caller information verification failed. |
**示例** **示例**
```js
let resRequest = { let resRequest = {
resourceTypes: 1, resourceTypes: 1,
uid:10003, uid:10003,
name:"com.example.app", name:"com.example.app",
duration:10, duration:10,
reason:"apply", reason:"apply",
}; };
// 异步方法promise方式 // 异步方法promise方式
try{ try{
deviceStandby.requestExemptionResource(resRequest).then( () => { deviceStandby.requestExemptionResource(resRequest).then( () => {
console.log('DEVICE_STANDBY requestExemptionResource promise succeeded.'); console.log('DEVICE_STANDBY requestExemptionResource promise succeeded.');
}).catch( err => { }).catch( err => {
console.log('DEVICE_STANDBY requestExemptionResource promise failed. code is: ' + err.code + ',message is: ' + err.message); console.log('DEVICE_STANDBY requestExemptionResource promise failed. code is: ' + err.code + ',message is: ' + err.message);
}); });
} catch (error) { } catch (error) {
console.log('DEVICE_STANDBY requestExemptionResource throw error, code is: ' + error.code + ',message is: ' + error.message); console.log('DEVICE_STANDBY requestExemptionResource throw error, code is: ' + error.code + ',message is: ' + error.message);
} }
// 异步方法callback方式 // 异步方法callback方式
try{ try{
deviceStandby.requestExemptionResource(resRequest, (err) => { deviceStandby.requestExemptionResource(resRequest, (err) => {
if (err) { if (err) {
console.log('DEVICE_STANDBY requestExemptionResource callback failed. code is: ' + err.code + ',message is: ' + err.message); console.log('DEVICE_STANDBY requestExemptionResource callback failed. code is: ' + err.code + ',message is: ' + err.message);
} else { } else {
console.log('DEVICE_STANDBY requestExemptionResource callback succeeded.'); console.log('DEVICE_STANDBY requestExemptionResource callback succeeded.');
} }
}); });
} catch (error) { } catch (error) {
console.log('DEVICE_STANDBY requestExemptionResource throw error, code is: ' + error.code + ',message is: ' + error.message); console.log('DEVICE_STANDBY requestExemptionResource throw error, code is: ' + error.code + ',message is: ' + error.message);
} }
```
## deviceStandby.releaseExemptionResource ## deviceStandby.releaseExemptionResource
releaseExemptionResource(request: ResourceRequest): void; releaseExemptionResource(request: ResourceRequest): void;
取消应用订阅申请豁免。 取消应用订阅申请豁免。
...@@ -267,7 +279,7 @@ releaseExemptionResource(request: ResourceRequest): void; ...@@ -267,7 +279,7 @@ releaseExemptionResource(request: ResourceRequest): void;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------------------- | ---- | ------------------------------ | | -------- | -------------------- | ---- | ------------------------------ |
| request |[ResourceRequest](#resourcerequest)| 是 | 资源请求 | | request |[ResourceRequest](#resourcerequest)| 是 | 资源请求 |
**错误码** **错误码**
...@@ -282,45 +294,46 @@ releaseExemptionResource(request: ResourceRequest): void; ...@@ -282,45 +294,46 @@ releaseExemptionResource(request: ResourceRequest): void;
| 18700001 | Caller information verification failed. | | 18700001 | Caller information verification failed. |
**示例** **示例**
```js
let resRequest = { let resRequest = {
resourceTypes: 1, resourceTypes: 1,
uid:10003, uid:10003,
name:"com.demo.app", name:"com.demo.app",
duration:10, duration:10,
reason:"unapply", reason:"unapply",
}; };
// 异步方法promise方式 // 异步方法promise方式
try{ try{
deviceStandby.releaseExemptionResource(resRequest).then( () => { deviceStandby.releaseExemptionResource(resRequest).then( () => {
console.log('DEVICE_STANDBY releaseExemptionResource promise succeeded.'); console.log('DEVICE_STANDBY releaseExemptionResource promise succeeded.');
}).catch( err => { }).catch( err => {
console.log('DEVICE_STANDBY releaseExemptionResource promise failed. code is: ' + err.code + ',message is: ' + err.message); console.log('DEVICE_STANDBY releaseExemptionResource promise failed. code is: ' + err.code + ',message is: ' + err.message);
}); });
} catch (error) { } catch (error) {
console.log('DEVICE_STANDBY releaseExemptionResource throw error, code is: ' + error.code + ',message is: ' + error.message); console.log('DEVICE_STANDBY releaseExemptionResource throw error, code is: ' + error.code + ',message is: ' + error.message);
} }
// 异步方法callback方式 // 异步方法callback方式
try{ try{
deviceStandby.releaseExemptionResource(resRequest, (err) => { deviceStandby.releaseExemptionResource(resRequest, (err) => {
if (err) { if (err) {
console.log('DEVICE_STANDBY releaseExemptionResource callback failed. code is: ' + err.code + ',message is: ' + err.message); console.log('DEVICE_STANDBY releaseExemptionResource callback failed. code is: ' + err.code + ',message is: ' + err.message);
} else { } else {
console.log('DEVICE_STANDBY releaseExemptionResource callback succeeded.'); console.log('DEVICE_STANDBY releaseExemptionResource callback succeeded.');
} }
}); });
} catch (error) { } catch (error) {
console.log('DEVICE_STANDBY releaseExemptionResource throw error, code is: ' + error.code + ',message is: ' + error.message); console.log('DEVICE_STANDBY releaseExemptionResource throw error, code is: ' + error.code + ',message is: ' + error.message);
} }
## ResourceType ## ResourceType
非待机应用资源枚举 非待机应用资源枚举
<br>
**系统API:** 此接口为系统接口。
**需要权限:** ohos.permission.DEVICE_STANDBY_EXEMPTION **需要权限:** ohos.permission.DEVICE_STANDBY_EXEMPTION
**系统API:** 此接口为系统接口
|名称 | |说明| |名称 | |说明|
| ------------ | ------------ |--------------| | ------------ | ------------ |--------------|
|NETWORK |1 |网络访问资源| |NETWORK |1 |网络访问资源|
...@@ -332,28 +345,30 @@ releaseExemptionResource(request: ResourceRequest): void; ...@@ -332,28 +345,30 @@ releaseExemptionResource(request: ResourceRequest): void;
|FREEZE |64 | 冻结应用资源| |FREEZE |64 | 冻结应用资源|
## ExemptedAppInfo ## ExemptedAppInfo
豁免应用信息,不进入待机管控的应用信息。
<br> 豁免应用信息未进入待机管控的应用信息
**系统API:** 此接口为系统接口。
**需要权限:** ohos.permission.DEVICE_STANDBY_EXEMPTION **需要权限:** ohos.permission.DEVICE_STANDBY_EXEMPTION
**系统API:** 此接口为系统接口
|名称 |类型 | 必填 |说明 | |名称 |类型 | 必填 |说明 |
| ------------ | ------------ |------------ | ------------ | | ------------ | ------------ |------------ | ------------ |
|resourceTypes | number | 是 |应用的资源类型 | |[resourceTypes](#resourcetype) | number | |应用的资源类型 |
|name |string | | 应用名 | |name |string | | 应用名 |
|duration | number | | 豁免时长 | |duration | number | | 豁免时长 |
## ResourceRequest ## ResourceRequest
待机资源请求体 待机资源请求体
<br>
**系统API:** 此接口为系统接口。
**需要权限:** ohos.permission.DEVICE_STANDBY_EXEMPTION **需要权限:** ohos.permission.DEVICE_STANDBY_EXEMPTION
**系统API:** 此接口为系统接口
|名称 |类型 | 必填 |说明 | |名称 |类型 | 必填 |说明 |
| ------------ | ------------ |------------| ------------ | | ------------ | ------------ |------------| ------------ |
|resourceTypes | number | 是 |应用的资源类型 | |[resourceTypes](#resourcetype) | number | |应用的资源类型 |
|uid | number | |应用uid | |uid | number | |应用uid |
|name |string | | 应用名称 | |name |string | | 应用名称 |
|duration | number | | 豁免时长 | |duration | number | | 豁免时长 |
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册