Skip to content

D
Docs

OpenHarmony / Docs
1 年多 前同步成功

通知 159
Star 292
Fork 28
D
Docs
提交 64b35c29 编写于 作者: C chennian
浏览文件
操作

Signed-off-by:chennian<chennian1@huawei.com> 

Signed-off-by: Nchennian <chennian1@huawei.com>
上级 0fae7758
隐藏空白更改
内联 并排
Showing with 46 addition and 50 deletion
zh-cn/application-dev/reference/apis/js-apis-privacyManager.md
浏览文件 @ 64b35c29
...@@ -2,9 +2,9 @@ ...@@ -2,9 +2,9 @@
该模块主要提供权限使用记录等隐私管理接口。 该模块主要提供权限使用记录等隐私管理接口。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** > **说明：**
> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
> 本模块接口为系统接口，三方应用不支持调用。
## 导入模块 ## 导入模块
...@@ -17,11 +17,10 @@ import privacyManager from '@ohos.privacyManager'; ...@@ -17,11 +17,10 @@ import privacyManager from '@ohos.privacyManager';
addPermissionUsedRecord(tokenID: number, permissionName: string, successCount: number, failCount: number): Promise&lt;number&gt; addPermissionUsedRecord(tokenID: number, permissionName: string, successCount: number, failCount: number): Promise&lt;number&gt;
增加一条权限使用记录。 受应用权限保护的应用在被其他服务、应用调用时，可以使用该接口增加一条权限使用记录。使用Promise异步回调。
权限使用记录包括：调用方的应用身份标识、使用的应用权限名称，和其访问本应用成功、失败的次数。
此接口为系统接口，三方应用不支持调用。
**需要权限：** ohos.permission.PERMISSION_USED_STATS **需要权限：** ohos.permission.PERMISSION_USED_STATS，仅系统应用可用。
**系统能力：** SystemCapability.Security.AccessToken **系统能力：** SystemCapability.Security.AccessToken
...@@ -29,8 +28,8 @@ addPermissionUsedRecord(tokenID: number, permissionName: string, successCount: n ...@@ -29,8 +28,8 @@ addPermissionUsedRecord(tokenID: number, permissionName: string, successCount: n
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------- | ---- | ------------------------------------------ | | -------- | ------------------- | ---- | ------------------------------------------ |
| tokenID | number | 是 | 要新增记录的目标应用的身份标识。 | | tokenID | number | 是 | 调用方的应用身份标识。 |
| permissionName | string | 是 | 要新增记录的权限名称。 | | permissionName | string | 是 | 应用权限名称。 |
| successCount | number | 是 | 访问成功的次数。 | | successCount | number | 是 | 访问成功的次数。 |
| failCount | number | 是 | 访问失败的次数。 | | failCount | number | 是 | 访问失败的次数。 |
...@@ -38,7 +37,7 @@ addPermissionUsedRecord(tokenID: number, permissionName: string, successCount: n ...@@ -38,7 +37,7 @@ addPermissionUsedRecord(tokenID: number, permissionName: string, successCount: n
| 类型 | 说明 | | 类型 | 说明 |
| :------------ | :---------------------------------- | | :------------ | :---------------------------------- |
| Promise&lt;number&gt; | Promise实例，用于获取异步返回的操作结果。 | | Promise&lt;number&gt; | Promise对象。返回`0`表示成功增加记录，返回`-1`表示失败。 |
**示例：** **示例：**
...@@ -53,11 +52,10 @@ privacyManager.addPermissionUsedRecord(tokenID, "ohos.permission.PERMISSION_USED ...@@ -53,11 +52,10 @@ privacyManager.addPermissionUsedRecord(tokenID, "ohos.permission.PERMISSION_USED
addPermissionUsedRecord(tokenID: number, permissionName: string, successCount: number, failCount: number, callback: AsyncCallback&lt;number&gt;): void addPermissionUsedRecord(tokenID: number, permissionName: string, successCount: number, failCount: number, callback: AsyncCallback&lt;number&gt;): void
增加一条权限使用记录。 受应用权限保护的应用在被其他服务、应用调用时，可以使用该接口增加一条权限使用记录。使用callback异步回调。
权限使用记录包括：调用方的应用身份标识、使用的应用权限名称，和其访问本应用成功、失败的次数。
此接口为系统接口，三方应用不支持调用。
**需要权限：** ohos.permission.PERMISSION_USED_STATS **需要权限：** ohos.permission.PERMISSION_USED_STATS，仅系统应用可用。
**系统能力：** SystemCapability.Security.AccessToken **系统能力：** SystemCapability.Security.AccessToken
...@@ -65,17 +63,19 @@ addPermissionUsedRecord(tokenID: number, permissionName: string, successCount: n ...@@ -65,17 +63,19 @@ addPermissionUsedRecord(tokenID: number, permissionName: string, successCount: n
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------- | ---- | ------------------------------------------ | | -------- | ------------------- | ---- | ------------------------------------------ |
| tokenID | number | 是 | 要新增记录的目标应用的身份标识。 | | tokenID | number | 是 | 调用方的应用身份标识。 |
| permissionName | string | 是 | 要新增记录的权限名称。 | | permissionName | string | 是 | 应用权限名称。 |
| successCount | number | 是 | 访问成功的次数。 | | successCount | number | 是 | 访问成功的次数。 |
| failCount | number | 是 | 访问失败的次数。 | | failCount | number | 是 | 访问失败的次数。 |
| callback | AsyncCallback&lt;number&gt; | 是 | 指定的callback回调方法，用于获取返回值。 | | callback | AsyncCallback&lt;number&gt; | 是 | 回调函数。返回`0`表示成功增加记录，返回`-1`表示失败。 |
**示例：** **示例：**
```js ```js
let tokenID = 0; import bundle from '@ohos.bundle'
privacyManager.privacyManager.addPermissionUsedRecord(tokenID, "ohos.permission.PERMISSION_USED_STATS", 1, 0, data => { var appInfo = await bundle.getApplicationInfo('bundle_name', 0, 100);
var tokenID = appInfo.accessTokenId;
privacyManager.privacyManager.addPermissionUsedRecord(tokenID, "ohos.permission.PERMISSION_USED_STATS", 1, 0, (err, data) => {
console.log(`callback: data->${JSON.stringify(data)}`); console.log(`callback: data->${JSON.stringify(data)}`);
}); });
``` ```
...@@ -86,9 +86,7 @@ getPermissionUsedRecords(request: PermissionUsedRequest): Promise&lt;PermissionU ...@@ -86,9 +86,7 @@ getPermissionUsedRecords(request: PermissionUsedRequest): Promise&lt;PermissionU
获取历史权限使用记录。 获取历史权限使用记录。
此接口为系统接口，三方应用不支持调用。 **需要权限：** ohos.permission.PERMISSION_USED_STATS，仅系统应用可用。
**需要权限：** ohos.permission.PERMISSION_USED_STATS
**系统能力：** SystemCapability.Security.AccessToken **系统能力：** SystemCapability.Security.AccessToken
...@@ -96,13 +94,13 @@ getPermissionUsedRecords(request: PermissionUsedRequest): Promise&lt;PermissionU ...@@ -96,13 +94,13 @@ getPermissionUsedRecords(request: PermissionUsedRequest): Promise&lt;PermissionU
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------- | ---- | ------------------------------------------ | | -------- | ------------------- | ---- | ------------------------------------------ |
| request | PermissionUsedRequest | 是 | 查询权限使用记录的请求。 | | request | [PermissionUsedRequest](#permissionusedrequest) | 是 | 查询权限使用记录的请求。 |
**返回值：** **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| :------------ | :---------------------------------- | | :------------ | :---------------------------------- |
| Promise&lt;PermissionUsedResponse&gt; | Promise实例，用于异步返回查询的权限使用记录结果。 | | Promise<[PermissionUsedResponse](#permissionusedresponse)> | Promise对象。返回权限使用记录。|
**示例：** **示例：**
...@@ -128,9 +126,7 @@ getPermissionUsedRecords(request: PermissionUsedRequest, callback: AsyncCallback ...@@ -128,9 +126,7 @@ getPermissionUsedRecords(request: PermissionUsedRequest, callback: AsyncCallback
获取历史权限使用记录。 获取历史权限使用记录。
此接口为系统接口，三方应用不支持调用。 **需要权限：** ohos.permission.PERMISSION_USED_STATS，仅系统应用可用。
**需要权限：** ohos.permission.PERMISSION_USED_STATS
**系统能力：** SystemCapability.Security.AccessToken **系统能力：** SystemCapability.Security.AccessToken
...@@ -138,8 +134,8 @@ getPermissionUsedRecords(request: PermissionUsedRequest, callback: AsyncCallback ...@@ -138,8 +134,8 @@ getPermissionUsedRecords(request: PermissionUsedRequest, callback: AsyncCallback
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------- | ---- | ------------------------------------------ | | -------- | ------------------- | ---- | ------------------------------------------ |
| request | PermissionUsedRequest | 是 | 查询权限使用记录的请求。 | | request | [PermissionUsedRequest](#permissionusedrequest) | 是 | 查询权限使用记录的请求。 |
| callback | AsyncCallback&lt;PermissionUsedResponse&gt; | 是 | 指定的callback回调方法，用于获取权限使用记录。 | | callback | AsyncCallback<[PermissionUsedResponse](#permissionusedresponse)> | 是 | 回调函数。返回权限使用记录。 |
**示例：** **示例：**
...@@ -161,11 +157,11 @@ privacyManager.getPermissionUsedRecords(request, (err, data) => { ...@@ -161,11 +157,11 @@ privacyManager.getPermissionUsedRecords(request, (err, data) => {
## PermissionUsageFlag ## PermissionUsageFlag
表示使用记录的查询方式的枚举值。 使用记录的查询方式的枚举。
**系统能力：** SystemCapability.Security.AccessToken **系统能力：** SystemCapability.Security.AccessToken
| 名称 | 默认值 | 描述 | | 名称 | 值 | 描述 |
| ----------------------- | ------ | ---------------------- | | ----------------------- | ------ | ---------------------- |
| FLAG_PERMISSION_USAGE_SUMMARY | 0 | 表示查询总览数据，默认值。 | | FLAG_PERMISSION_USAGE_SUMMARY | 0 | 表示查询总览数据，默认值。 |
| FLAG_PERMISSION_USAGE_DETAIL | 1 | 表示查询详细数据。 | | FLAG_PERMISSION_USAGE_DETAIL | 1 | 表示查询详细数据。 |
...@@ -178,14 +174,14 @@ privacyManager.getPermissionUsedRecords(request, (err, data) => { ...@@ -178,14 +174,14 @@ privacyManager.getPermissionUsedRecords(request, (err, data) => {
| 名称 | 类型 | 必填 | 说明 | | 名称 | 类型 | 必填 | 说明 |
| -------- | -------------- | ---- | ---------------------------------------- | | -------- | -------------- | ---- | ---------------------------------------- |
| tokenId | number | 否 | 需要查询的目标应用的身份标识。 | | tokenId | number | 否 | 目标应用的身份标识。 |
| isRemote | boolean | 否 | 默认值false，当。 | | isRemote | boolean | 否 | 默认值false。 |
| deviceId | string | 否 | 需要查询的目标应用的所在的设备ID。 | | deviceId | string | 否 | 目标应用所在设备的ID。 |
| bundleName | string | 否 | 要查询的目标应用的包名。 | | bundleName | string | 否 | 目标应用的包名。 |
| permissionNames | Array&lt;string&gt; | 否 | 需要查询的权限集合。 | | permissionNames | Array&lt;string&gt; | 否 | 需要查询的权限集合。 |
| beginTime | number | 否 | 查询的起始时间，默认值0，不设定起始时间。 | | beginTime | number | 否 | 查询的起始时间，单位：ms，默认值0，不设定起始时间。 |
| endTime | number | 否 | 查询的终止时间，默认值0，不设定终止时间。 | | endTime | number | 否 | 查询的终止时间，单位：ms，默认值0，不设定终止时间。 |
| flag | PermissionUsageFlag | 是 | 查询方式，默认值FLAG_PERMISSION_USAGE_SUMMARY。 | | flag | [PermissionUsageFlag](#permissionusageflag) | 是 | 查询方式，默认值FLAG_PERMISSION_USAGE_SUMMARY。 |
## PermissionUsedResponse ## PermissionUsedResponse
...@@ -195,27 +191,27 @@ privacyManager.getPermissionUsedRecords(request, (err, data) => { ...@@ -195,27 +191,27 @@ privacyManager.getPermissionUsedRecords(request, (err, data) => {
| 名称 | 类型 | 必填 | 说明 | | 名称 | 类型 | 必填 | 说明 |
| -------- | -------------- | ---- | ---------------------------------------- | | -------- | -------------- | ---- | ---------------------------------------- |
| beginTime | number | 否 | 查询记录的起始时间。 | | beginTime | number | 否 | 查询记录的起始时间，单位：ms。 |
| endTime | number | 否 | 查询记录的终止时间。 | | endTime | number | 否 | 查询记录的终止时间，单位：ms。 |
| bundleRecords | Array&lt;BundleUsedRecord&gt; | 否 | 应用的权限使用记录集合。 | | bundleRecords | Array&lt;[BundleUsedRecord](#BundleUsedRecord)&gt; | 否 | 应用的权限使用记录集合。 |
## BundleUsedRecord ## BundleUsedRecord
每个应用下的权限访问记录。 某个权限的访问记录。
**系统能力：** 以下各项对应的系统能力均为SystemCapability.Security.AccessToken **系统能力：** 以下各项对应的系统能力均为SystemCapability.Security.AccessToken
| 名称 | 类型 | 必填 | 说明 | | 名称 | 类型 | 必填 | 说明 |
| -------- | -------------- | ---- | ---------------------------------------- | | -------- | -------------- | ---- | ---------------------------------------- |
| tokenId | number | 否 | 需要查询的目标应用的身份标识。 | | tokenId | number | 否 | 目标应用的身份标识。 |
| isRemote | boolean | 否 | 默认值false，当。 | | isRemote | boolean | 否 | 默认值false。 |
| deviceId | string | 否 | 需要查询的目标应用的所在的设备ID。 | | deviceId | string | 否 | 目标应用所在设备的ID。 |
| bundleName | string | 否 | 要查询的目标应用的包名。 | | bundleName | string | 否 | 目标应用的包名。 |
| permissionRecords | Array&lt;PermissionUsedRecord&gt; | 否 | 每个应用的权限使用记录集合。 | | permissionRecords | Array&lt;[PermissionUsedRecord](#PermissionUsedRecord)&gt; | 否 | 每个应用的权限使用记录集合。 |
## PermissionUsedRecord ## PermissionUsedRecord
表示每一个权限对应的访问记录。 某个权限的访问记录。
**系统能力：** 以下各项对应的系统能力均为SystemCapability.Security.AccessToken **系统能力：** 以下各项对应的系统能力均为SystemCapability.Security.AccessToken
...@@ -227,12 +223,12 @@ privacyManager.getPermissionUsedRecords(request, (err, data) => { ...@@ -227,12 +223,12 @@ privacyManager.getPermissionUsedRecords(request, (err, data) => {
| lastAccessTime | number | 否 | 最后一次访问时间，单位：ms。 | | lastAccessTime | number | 否 | 最后一次访问时间，单位：ms。 |
| lastRejectTime | number | 否 | 最后一次拒绝时间，单位：ms。 | | lastRejectTime | number | 否 | 最后一次拒绝时间，单位：ms。 |
| lastAccessDuration | number | 否 | 最后一次访问时长，单位：ms。 | | lastAccessDuration | number | 否 | 最后一次访问时长，单位：ms。 |
| accessRecords | Array&lt;UsedRecordDetail&gt; | 否 | 访问记录集合，当flag为FLAG_PERMISSION_USAGE_SUMMARY时生效，默认查询10条。 | | accessRecords | Array&lt;[UsedRecordDetail](#usedrecorddetail)&gt; | 否 | 访问记录集合，当flag为FLAG_PERMISSION_USAGE_SUMMARY时生效，默认查询10条。 |
| rejectRecords | Array&lt;UsedRecordDetail&gt; | 否 | 拒绝记录集合，当flag为FLAG_PERMISSION_USAGE_SUMMARY时生效，默认查询10条。 | | rejectRecords | Array&lt;[UsedRecordDetail](#usedrecorddetail)&gt; | 否 | 拒绝记录集合，当flag为FLAG_PERMISSION_USAGE_SUMMARY时生效，默认查询10条。 |
## UsedRecordDetail ## UsedRecordDetail
每一次访问记录的详情。 单次访问记录详情。
**系统能力：** 以下各项对应的系统能力均为SystemCapability.Security.AccessToken **系统能力：** 以下各项对应的系统能力均为SystemCapability.Security.AccessToken
......
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或