错误信息修改

Signed-off-by: N yupeng74@huawei.com <yupeng74@huawei.com>

错误信息修改
Signed-off-by: N yupeng74@huawei.com <yupeng74@huawei.com>
ea40f2c9 · yupeng74@huawei.com · 3aaa08b1 · ea40f2c9 · ea40f2c9 · ea40f2c9
5 changed file
--- a/zh-cn/application-dev/device-usage-statistics/device-usage-statistics-dev-guide.md
+++ b/zh-cn/application-dev/device-usage-statistics/device-usage-statistics-dev-guide.md
-# 设备使用信息统计
+# 设备使用信息统计(API7)

 ## 场景介绍

@@ -27,21 +27,11 @@ import stats from '@ohos.bundleState';

 ## 开发步骤

-1. 在config.json文件中配置设备使用信息统计权限。
-
-    ```json
-    "module": {
-        "package": "com.example.deviceUsageStatistics",
-        ...,
-        "reqPermissions": [
-            {
-                "name": "ohos.permission.BUNDLE_ACTIVE_INFO"
-            }
-        ]
-    }
-    ```
+1. 获取设备使用信息之前，需要检查是否已经配置请求相应的权限。
+    系统提供的设备使用信息统计的权限是ohos.permission.BUNDLE_ACTIVE_INFO
+    具体配置方式请参考[权限申请声明](../security/accesstoken-guidelines.md)

-2. 通过指定起始和结束时间查询所有应用的事件集合，config.json中需要配置权限：ohos.permission.BUNDLE_ACTIVE_INFO。
+2. 通过指定起始和结束时间查询所有应用的事件集合，需要配置ohos.permission.BUNDLE_ACTIVE_INFO权限。

    ```js
    import stats from '@ohos.bundleState'
@@ -57,7 +47,7 @@ import stats from '@ohos.bundleState';
    });
    ```

-3. 通过指定起始和结束时间查询应用使用时长统计信息，config.json中需要配置权限：ohos.permission.BUNDLE_ACTIVE_INFO。
+3. 通过指定起始和结束时间查询应用使用时长统计信息，需要配置ohos.permission.BUNDLE_ACTIVE_INFO权限。

    ```js
    import stats from '@ohos.bundleState'
@@ -75,7 +65,7 @@ import stats from '@ohos.bundleState';
    });
    ```

-4. 通过指定起始和结束时间查询当前应用的事件集合，config.json中不需要配置权限。
+4. 通过指定起始和结束时间查询当前应用的事件集合，不需要配置权限。

    ```js
    import stats from '@ohos.bundleState'
@@ -91,7 +81,7 @@ import stats from '@ohos.bundleState';
    });
    ```

-5. 通过指定时间段间隔（天、周、月、年）查询应用使用时长统计信息，config.json中需要配置权限：ohos.permission.BUNDLE_ACTIVE_INFO。
+5. 通过指定时间段间隔（天、周、月、年）查询应用使用时长统计信息，需要配置ohos.permission.BUNDLE_ACTIVE_INFO权限。

    ```js
    import stats from '@ohos.bundleState'
@@ -108,7 +98,7 @@ import stats from '@ohos.bundleState';

    ```

-6. 查询（无参）当前调用者应用的使用优先级群组，config.json中不需要配置权限。
+6. 查询（无参）当前调用者应用的使用优先级群组，不需要配置权限。

    ```js
    import stats from '@ohos.bundleState'
@@ -120,7 +110,7 @@ import stats from '@ohos.bundleState';
    });
    ```

-7. 判断指定Bundle Name的应用当前是否是空闲状态，config.json中需要配置权限：ohos.permission.BUNDLE_ACTIVE_INFO，三方应用只能查询自身的空闲状态。
+7. 判断指定Bundle Name的应用当前是否是空闲状态，需要配置ohos.permission.BUNDLE_ACTIVE_INFO权限，三方应用只能查询自身的空闲状态。

    ```js
    import stats from '@ohos.bundleState'

--- a/zh-cn/application-dev/device-usage-statistics/device-usage-statistics-use-guide.md
+++ b/zh-cn/application-dev/device-usage-statistics/device-usage-statistics-use-guide.md
-# 设备使用信息统计
+# 设备使用信息统计(API9)

 ## 场景介绍

@@ -37,21 +37,11 @@ import usageStatistics from '@ohos.resourceschedule.usageStatistics';

 ## 开发步骤

-1. 在config.json文件中配置设备使用信息统计权限。
+1. 获取设备使用信息之前，需要检查是否已经配置请求相应的权限。
+    系统提供的设备使用信息统计的权限是ohos.permission.BUNDLE_ACTIVE_INFO
+    具体配置方式请参考[权限申请声明](../security/accesstoken-guidelines.md)

-    ```json
-    "module": {
-        "package": "com.example.deviceUsageStatistics",
-        ...,
-        "reqPermissions": [
-            {
-                "name": "ohos.permission.BUNDLE_ACTIVE_INFO"
-            }
-        ]
-    }
-    ```
-
-2. 通过指定起始和结束时间查询所有应用的事件集合，config.json中需要配置权限：ohos.permission.BUNDLE_ACTIVE_INFO。
+2. 通过指定起始和结束时间查询所有应用的事件集合，需要配置ohos.permission.BUNDLE_ACTIVE_INFO权限。

    ```js
    import usageStatistics from '@ohos.resourceschedule.usageStatistics'
@@ -89,7 +79,7 @@ import usageStatistics from '@ohos.resourceschedule.usageStatistics';
    }
    ```

-3. 通过指定起始和结束时间查询应用使用时长统计信息，config.json中需要配置权限：ohos.permission.BUNDLE_ACTIVE_INFO。
+3. 通过指定起始和结束时间查询应用使用时长统计信息，需要配置ohos.permission.BUNDLE_ACTIVE_INFO权限。

    ```js
    import usageStatistics from '@ohos.resourceschedule.usageStatistics'
@@ -131,7 +121,7 @@ import usageStatistics from '@ohos.resourceschedule.usageStatistics';
    }
    ```

-4. 通过指定起始和结束时间查询当前应用的事件集合，config.json中不需要配置权限。
+4. 通过指定起始和结束时间查询当前应用的事件集合，不需要配置权限。

    ```js
    import usageStatistics from '@ohos.resourceschedule.usageStatistics'
@@ -169,7 +159,7 @@ import usageStatistics from '@ohos.resourceschedule.usageStatistics';
    }
    ```

-5. 通过指定时间段间隔（天、周、月、年）查询应用使用时长统计信息，config.json中需要配置权限：ohos.permission.BUNDLE_ACTIVE_INFO。
+5. 通过指定时间段间隔（天、周、月、年）查询应用使用时长统计信息，需要配置ohos.permission.BUNDLE_ACTIVE_INFO权限。

    ```js
    import usageStatistics from '@ohos.resourceschedule.usageStatistics'
@@ -207,7 +197,7 @@ import usageStatistics from '@ohos.resourceschedule.usageStatistics';
    }
    ```

-6. 查询（无参）当前调用者应用的使用优先级群组，config.json中不需要配置权限。
+6. 查询（无参）当前调用者应用的使用优先级群组，不需要配置权限。

    ```js
    import usageStatistics from '@ohos.resourceschedule.usageStatistics'
@@ -237,7 +227,7 @@ import usageStatistics from '@ohos.resourceschedule.usageStatistics';
    }
    ```

-7. 判断指定Bundle Name的应用当前是否是空闲状态，config.json中不需要配置权限，三方应用只能查询自身的空闲状态。
+7. 判断指定Bundle Name的应用当前是否是空闲状态，不需要配置权限，三方应用只能查询自身的空闲状态。

    ```js
    import usageStatistics from '@ohos.resourceschedule.usageStatistics'
@@ -267,7 +257,7 @@ import usageStatistics from '@ohos.resourceschedule.usageStatistics';
    }
    ```

-8. 查询FA使用记录。返回数量最大不超过maxNum设置的值，若不传入maxNum参数，则默认maxNum为1000。config.json中需要配置权限：ohos.permission.BUNDLE_ACTIVE_INFO。
+8. 查询FA使用记录。返回数量最大不超过maxNum设置的值，若不传入maxNum参数，则默认maxNum为1000, 需要配置ohos.permission.BUNDLE_ACTIVE_INFO权限。

    ```js
    import usageStatistics from '@ohos.resourceschedule.usageStatistics'
@@ -337,7 +327,7 @@ import usageStatistics from '@ohos.resourceschedule.usageStatistics';
    }
    ```

-9. 通过指定起始和结束时间查询所有应用的通知次数，config.json中需要配置权限：ohos.permission.BUNDLE_ACTIVE_INFO。
+9. 通过指定起始和结束时间查询所有应用的通知次数，需要配置ohos.permission.BUNDLE_ACTIVE_INFO权限。

    ```js
    import usageStatistics from '@ohos.resourceschedule.usageStatistics'
@@ -369,7 +359,7 @@ import usageStatistics from '@ohos.resourceschedule.usageStatistics';
    }
    ```

-10. 通过指定起始和结束时间查询系统事件（休眠、唤醒、解锁、锁屏）统计信息，config.json中需要配置权限：ohos.permission.BUNDLE_ACTIVE_INFO。
+10. 通过指定起始和结束时间查询系统事件（休眠、唤醒、解锁、锁屏）统计信息，需要配置ohos.permission.BUNDLE_ACTIVE_INFO权限。

    ```js
    import usageStatistics from '@ohos.resourceschedule.usageStatistics'
@@ -401,7 +391,7 @@ import usageStatistics from '@ohos.resourceschedule.usageStatistics';
    }
    ```

-11. 查询（无参）当前调用者应用的使用优先级群组，config.json中不需要配置权限。查询（有参）指定应用的使用优先级群组，config.json中需要配置权限：ohos.permission.BUNDLE_ACTIVE_INFO。
+11. 查询（无参）当前调用者应用的使用优先级群组，config.json中不需要配置权限。查询（有参）指定应用的使用优先级群组，需要配置ohos.permission.BUNDLE_ACTIVE_INFO权限。

     ```js
     import usageStatistics from '@ohos.resourceschedule.usageStatistics'
@@ -433,7 +423,7 @@ import usageStatistics from '@ohos.resourceschedule.usageStatistics';
    }
     ```

-11. 给应用名是bundleName的应用分组设置成newGroup，返回设置结果是否成功
+11. 给应用名是bundleName的应用分组设置成newGroup，返回设置结果是否成功, 需要配置ohos.permission.BUNDLE_ACTIVE_INFO权限。

    ```javascript
    import usageStatistics from '@ohos.resourceschedule.usageStatistics'
@@ -469,7 +459,7 @@ import usageStatistics from '@ohos.resourceschedule.usageStatistics';
    }
    ```

-12. 注册应用分组变化监听回调，返回注册是否成功，当应用分组发生变化时，会给所有已注册的监听者返回回调信息
+12. 注册应用分组变化监听回调，返回注册是否成功，当应用分组发生变化时，会给所有已注册的监听者返回回调信息， 需要配置ohos.permission.BUNDLE_ACTIVE_INFO权限

    ```javascript
    import usageStatistics from '@ohos.resourceschedule.usageStatistics'
@@ -515,7 +505,7 @@ import usageStatistics from '@ohos.resourceschedule.usageStatistics';
    }
    ```

-13. 解除应用分组监听回调
+13. 解除应用分组监听回调， 需要配置ohos.permission.BUNDLE_ACTIVE_INFO权限

    ```javascript
    import usageStatistics from '@ohos.resourceschedule.usageStatistics'

--- a/zh-cn/application-dev/reference/apis/js-apis-deviceUsageStatistics.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-deviceUsageStatistics.md
@@ -14,8 +14,12 @@
 - 查询应用分组信息（仅限自身应用）。
 - 查询应用事件（仅限自身应用）。

-> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
+> **说明：**
+>
 > 从API version9开始，该接口不再维护，推荐使用新接口[@ohos.resourceschedule.usageStatistics(设备使用信息统计)](js-apis-resourceschedule-deviceUsageStatistics.md)
+>
+> 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
+>


 ## 导入模块
@@ -442,13 +446,13 @@ queryCurrentBundleActiveStates(begin: number, end: number): Promise&lt;Array&lt;
 | bundleName               | string | 是    | 应用包名。                                    |
 | abilityPrevAccessTime    | number | 是    | 应用最后一次使用的时间。                             |
 | abilityInFgTotalTime     | number | 是    | 应用在前台使用的总时间。                             |
-| id                       | number | 否    | 用户id。<br>本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 |
-| abilityPrevSeenTime      | number | 否    | 应用最后一次在前台可见的时间。<br>本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 |
-| abilitySeenTotalTime     | number | 否    | 应用在前台可见的总时间。<br>本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 |
-| fgAbilityAccessTotalTime | number | 否    | 应用访问前台的总时间。<br>本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 |
-| fgAbilityPrevAccessTime  | number | 否    | 应用最后一次访问前台的时间。<br>本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 |
-| infosBeginTime           | number | 否    | BundleActiveInfo对象中第一条应用使用统计的记录时间。<br>本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 |
-| infosEndTime             | number | 否    | BundleActiveInfo对象中最后一条应用使用统计的记录时间。<br>本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 |
+| id                       | number | 否    | 用户id。|
+| abilityPrevSeenTime      | number | 否    | 应用最后一次在前台可见的时间。|
+| abilitySeenTotalTime     | number | 否    | 应用在前台可见的总时间。|
+| fgAbilityAccessTotalTime | number | 否    | 应用访问前台的总时间。|
+| fgAbilityPrevAccessTime  | number | 否    | 应用最后一次访问前台的时间。|
+| infosBeginTime           | number | 否    | BundleActiveInfo对象中第一条应用使用统计的记录时间。|
+| infosEndTime             | number | 否    | BundleActiveInfo对象中最后一条应用使用统计的记录时间。|

 ## BundleActiveState

@@ -463,9 +467,9 @@ queryCurrentBundleActiveStates(begin: number, end: number): Promise&lt;Array&lt;
 | bundleName            | string | 是    | 应用包名。                                    |
 | stateType             | number | 是    | 应用事件类型。                                  |
 | stateOccurredTime     | number | 是    | 应用事件发生的时间戳。                              |
-| appUsagePriorityGroup | number | 否    | 应用程序的使用优先级组。<br>本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 |
-| indexOfLink           | string | 否    | 快捷方式id。<br>本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 |
-| nameOfClass           | string | 否    | 类名。<br>本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 |
+| appUsagePriorityGroup | number | 否    | 应用程序的使用优先级组。|
+| indexOfLink           | string | 否    | 快捷方式id。|
+| nameOfClass           | string | 否    | 类名。|

 ## BundleActiveInfoResponse


--- a/zh-cn/application-dev/reference/apis/js-apis-resourceschedule-deviceUsageStatistics.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-resourceschedule-deviceUsageStatistics.md
@@ -17,8 +17,10 @@
 - 查询应用分组信息（仅限自身应用）。
 - 查询应用事件（仅限自身应用）。

-> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
+> **说明：**
+>
 > 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
+>


 ## 导入模块
@@ -1537,13 +1539,13 @@ FA卡片的使用信息的属性集合。
 | bundleName               | string | 是    | 应用包名。                                    |
 | abilityPrevAccessTime    | number | 是    | 应用最后一次使用的时间。                             |
 | abilityInFgTotalTime     | number | 是    | 应用在前台使用的总时间。                             |
-| id                       | number | 否    | 用户id。<br>本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 |
-| abilityPrevSeenTime      | number | 否    | 应用最后一次在前台可见的时间。<br>本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 |
-| abilitySeenTotalTime     | number | 否    | 应用在前台可见的总时间。<br>本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 |
-| fgAbilityAccessTotalTime | number | 否    | 应用访问前台的总时间。<br>本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 |
-| fgAbilityPrevAccessTime  | number | 否    | 应用最后一次访问前台的时间。<br>本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 |
-| infosBeginTime           | number | 否    | BundleActiveInfo对象中第一条应用使用统计的记录时间。<br>本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 |
-| infosEndTime             | number | 否    | BundleActiveInfo对象中最后一条应用使用统计的记录时间。<br>本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 |
+| id                       | number | 否    | 用户id。 |
+| abilityPrevSeenTime      | number | 否    | 应用最后一次在前台可见的时间。 |
+| abilitySeenTotalTime     | number | 否    | 应用在前台可见的总时间。 |
+| fgAbilityAccessTotalTime | number | 否    | 应用访问前台的总时间。 |
+| fgAbilityPrevAccessTime  | number | 否    | 应用最后一次访问前台的时间。|
+| infosBeginTime           | number | 否    | BundleActiveInfo对象中第一条应用使用统计的记录时间。 |
+| infosEndTime             | number | 否    | BundleActiveInfo对象中最后一条应用使用统计的记录时间。 |

 ## BundleEvents

@@ -1556,9 +1558,9 @@ FA卡片的使用信息的属性集合。
 | bundleName            | string | 是    | 应用包名。                                    |
 | eventId             | number | 是    | 应用事件类型。                                  |
 | eventOccurredTime     | number | 是    | 应用事件发生的时间戳。                              |
-| appGroup | number | 否    | 应用程序的使用优先级组。<br>本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 |
-| indexOfLink           | string | 否    | 快捷方式id。<br>本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 |
-| nameOfClass           | string | 否    | 类名。<br>本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 |
+| appGroup | number | 否    | 应用程序的使用优先级组。|
+| indexOfLink           | string | 否    | 快捷方式id。|
+| nameOfClass           | string | 否    | 类名。|

 ## BundleStatsMap


--- a/zh-cn/application-dev/reference/errorcodes/errcode-DeviceUsageStatistics.md
+++ b/zh-cn/application-dev/reference/errorcodes/errcode-DeviceUsageStatistics.md
@@ -88,7 +88,7 @@ The application is not installed.

 **处理步骤**

-操作应用信息时请先检查应用是否已安装且并未卸载。
+操作应用信息时请先检查应用是否存在。

 ## 10000006 获取应用信息失败

@@ -108,7 +108,7 @@ Get application info failed.

 **处理步骤**

-请检查入参合法性以及应用是否安装且并未卸载。
+请检查入参合法性以及应用是否存在。

 ## 10000007 时间操作失败

@@ -163,5 +163,5 @@ Get application group info failed. The application group infomation cannot be fo

 **处理步骤**

-请检查入参bundleName的正确性。
+请检查入参bundleName的合法性和应用是否存在。