Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
128d9157
D
Docs
项目概览
OpenHarmony
/
Docs
1 年多 前同步成功
通知
159
Star
292
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看板
未验证
提交
128d9157
编写于
3月 10, 2023
作者:
O
openharmony_ci
提交者:
Gitee
3月 10, 2023
浏览文件
操作
浏览文件
下载
差异文件
!15853 资料一致性整改-monthly挑单
Merge pull request !15853 from zhouyan/cherry-pick-1678433723
上级
16318b01
088ab083
变更
3
隐藏空白更改
内联
并排
Showing
3 changed file
with
18 addition
and
16 deletion
+18
-16
zh-cn/application-dev/reference/apis/js-apis-abilityAccessCtrl.md
...plication-dev/reference/apis/js-apis-abilityAccessCtrl.md
+8
-6
zh-cn/application-dev/reference/apis/js-apis-permissionrequestresult.md
...ion-dev/reference/apis/js-apis-permissionrequestresult.md
+1
-1
zh-cn/application-dev/reference/apis/js-apis-privacyManager.md
.../application-dev/reference/apis/js-apis-privacyManager.md
+9
-9
未找到文件。
zh-cn/application-dev/reference/apis/js-apis-abilityAccessCtrl.md
浏览文件 @
128d9157
...
...
@@ -139,7 +139,7 @@ grantUserGrantedPermission(tokenID: number, permissionName: Permissions, permiss
| --------- | ------------------- | ---- | ------------------------------------------------------------ |
| tokenID | number | 是 | 目标应用的身份标识。可通过应用的
[
ApplicationInfo
](
js-apis-bundleManager-applicationInfo.md
)
获得。 |
| permissionName | Permissions | 是 | 被授予的权限名称,合法的权限名取值可在
[
系统权限定义列表
](
../../security/permission-list.md
)
中查询。 |
| permissionFlags | number | 是 | 授权选项
,1表示下次仍需弹窗,2表示允许、禁止后不再提醒,3表示系统授权不允许更改。
|
| permissionFlags | number | 是 | 授权选项
<br>
- 0表示权限未经过用户主动设置。
<br>
- 1表示当次用户若选择禁止该权限,下次权限弹窗仍可以弹出申请用户授权。
<br>
- 2表示当次用户若选择禁止该权限,下次不会再弹出权限弹窗,需要用户在setting的权限管理中进行授权。
<br>
- 4表示当次权限设置为系统授权,用户不可更改这个权限授权状态。
|
**返回值:**
...
...
@@ -196,7 +196,7 @@ grantUserGrantedPermission(tokenID: number, permissionName: Permissions, permiss
| --------- | ------------------- | ---- | ------------------------------------------------------------ |
| tokenID | number | 是 | 目标应用的身份标识。可通过应用的
[
ApplicationInfo
](
js-apis-bundleManager-applicationInfo.md
)
获得。|
| permissionName | Permissions | 是 | 被授予的权限名称,合法的权限名取值可在
[
系统权限定义列表
](
../../security/permission-list.md
)
中查询。 |
| permissionFlags | number | 是 | 授权选项
,1表示下次仍需弹窗,2表示允许、禁止后不再提醒,3表示系统授权不允许更改。
|
| permissionFlags | number | 是 | 授权选项
<br>
- 0表示权限未经过用户主动设置。
<br>
- 1表示当次用户若选择禁止该权限,下次权限弹窗仍可以弹出申请用户授权。
<br>
- 2表示当次用户若选择禁止该权限,下次不会再弹出权限弹窗,需要用户在setting的权限管理中进行授权。
<br>
- 4表示当次权限设置为系统授权,用户不可更改这个权限授权状态。
|
| callback | AsyncCallback
<
void
>
| 是 | 授予应用user grant权限。当授予权限成功时,err为undefine;否则为错误对象。 |
**错误码:**
...
...
@@ -250,7 +250,7 @@ revokeUserGrantedPermission(tokenID: number, permissionName: Permissions, permis
| --------- | ------------------- | ---- | ------------------------------------------------------------ |
| tokenID | number | 是 | 目标应用的身份标识。可通过应用的
[
ApplicationInfo
](
js-apis-bundleManager-applicationInfo.md
)
获得。 |
| permissionName | Permissions | 是 | 被撤销的权限名称,合法的权限名取值可在
[
系统权限定义列表
](
../../security/permission-list.md
)
中查询。 |
| permissionFlags | number | 是 | 授权选项
,1表示下次仍需弹窗,2表示允许、禁止后不再提醒,3表示系统授权不允许更改。
|
| permissionFlags | number | 是 | 授权选项
<br>
- 0表示权限未经过用户主动设置。
<br>
- 1表示当次用户若选择禁止该权限,下次权限弹窗仍可以弹出申请用户授权。
<br>
- 2表示当次用户若选择禁止该权限,下次不会再弹出权限弹窗,需要用户在setting的权限管理中进行授权。
<br>
- 4表示当次权限设置为系统授权,用户不可更改这个权限授权状态。
|
**返回值:**
...
...
@@ -307,7 +307,7 @@ revokeUserGrantedPermission(tokenID: number, permissionName: Permissions, permis
| --------- | ------------------- | ---- | ------------------------------------------------------------ |
| tokenID | number | 是 | 目标应用的身份标识。可通过应用的
[
ApplicationInfo
](
js-apis-bundleManager-applicationInfo.md
)
获得。 |
| permissionName | Permissions | 是 | 被撤销的权限名称,合法的权限名取值可在
[
系统权限定义列表
](
../../security/permission-list.md
)
中查询。 |
| permissionFlags | number | 是 | 授权选项
,1表示下次仍需弹窗,2表示允许、禁止后不再提醒,3表示系统授权不允许更改。
|
| permissionFlags | number | 是 | 授权选项
<br>
- 0表示权限未经过用户主动设置。
<br>
- 1表示当次用户若选择禁止该权限,下次权限弹窗仍可以弹出申请用户授权。
<br>
- 2表示当次用户若选择禁止该权限,下次不会再弹出权限弹窗,需要用户在setting的权限管理中进行授权。
<br>
- 4表示当次权限设置为系统授权,用户不可更改这个权限授权状态。
|
| callback | AsyncCallback
<
void
>
| 是 | 撤销应用user grant权限。当撤销权限成功时,err为undefine;否则为错误对象。 |
**错误码:**
...
...
@@ -461,6 +461,7 @@ on(type: 'permissionStateChange', tokenIDList: Array<number>, permissionLi
```
js
import
abilityAccessCtrl
,
{
Permissions
}
from
'
@ohos.abilityAccessCtrl
'
;
import
bundle
from
'
@ohos.bundle.bundleManager
'
;
let
atManager
=
abilityAccessCtrl
.
createAtManager
();
let
appInfo
=
bundle
.
getApplicationInfoSync
(
'
com.example.myapplication
'
,
0
,
100
);
...
...
@@ -511,6 +512,7 @@ off(type: 'permissionStateChange', tokenIDList: Array<number>, permissionL
```
js
import
abilityAccessCtrl
,
{
Permissions
}
from
'
@ohos.abilityAccessCtrl
'
;
import
bundle
from
'
@ohos.bundle.bundleManager
'
;
let
atManager
=
abilityAccessCtrl
.
createAtManager
();
let
appInfo
=
bundle
.
getApplicationInfoSync
(
'
com.example.myapplication
'
,
0
,
100
);
...
...
@@ -582,7 +584,7 @@ requestPermissionsFromUser(context: Context, permissionList: Array<Permission
以下错误码的详细介绍请参见
[
程序访问控制错误码
](
../errorcodes/errorcode-access-token.md
)
。
| 错误码ID | 错误信息 |
| -------- | -------- |
| 12100001 |
Parameter invalid
. |
| 12100001 |
The parameter is invalid. The context is invalid when it does not belong to the application itself
. |
**示例:**
...
...
@@ -628,7 +630,7 @@ requestPermissionsFromUser(context: Context, permissionList: Array<Permission
以下错误码的详细介绍请参见
[
程序访问控制错误码
](
../errorcodes/errorcode-access-token.md
)
。
| 错误码ID | 错误信息 |
| -------- | -------- |
| 12100001 |
Parameter invalid
. |
| 12100001 |
The parameter is invalid. The context is invalid when it does not belong to the application itself
. |
**示例:**
...
...
zh-cn/application-dev/reference/apis/js-apis-permissionrequestresult.md
浏览文件 @
128d9157
...
...
@@ -14,7 +14,7 @@
| 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- |
| permissions | Array
<
string
>
| 是 | 否 | 用户传入的权限。|
| authResults | Array
<
number
>
| 是 | 否 | 相应请求权限的结果:
<br>
-
1表示权限已设置,无需弹窗,需要用户在"设置"中修改。
<br>
0表示无需任何操作。
<br>
1表示需要动态弹窗授权。
<br>
2表示请求无效,可能原因有:
<br>
-未在设置文件中声明目标权限;
<br>
-权限名非法;
<br>
-部分权限存在特殊申请条件,在申请对应权限时未满足其指定的条件,见
[
ohos.permission.LOCATION
](
../../security/permission-list.md#ohospermissionlocation
)
与
[
ohos.permission.APPROXIMATELY_LOCATION
](
../../security/permission-list.md#ohospermissionapproximately_location
)
|
| authResults | Array
<
number
>
| 是 | 否 | 相应请求权限的结果:
<br>
-
-1:未授权,表示权限已设置,无需弹窗,需要用户在"设置"中修改。
<br>
- 0:已授权。
<br>
- 2:未授权,表示请求无效,可能原因有:
<br>
-未在设置文件中声明目标权限。
<br>
-权限名非法。
<br>
-部分权限存在特殊申请条件,在申请对应权限时未满足其指定的条件,见
[
ohos.permission.LOCATION
](
../../security/permission-list.md#ohospermissionlocation
)
与
[
ohos.permission.APPROXIMATELY_LOCATION
](
../../security/permission-list.md#ohospermissionapproximately_location
)
|
## 使用说明
...
...
zh-cn/application-dev/reference/apis/js-apis-privacyManager.md
浏览文件 @
128d9157
...
...
@@ -445,7 +445,7 @@ try {
## privacyManager.on
on(type: 'activeStateChange', permission
Name
List: Array
<
Permissions
>
, callback: Callback
<
ActiveChangeResponse
>
): void
on(type: 'activeStateChange', permissionList: Array
<
Permissions
>
, callback: Callback
<
ActiveChangeResponse
>
): void
订阅指定权限列表的权限使用状态变更事件。
...
...
@@ -458,7 +458,7 @@ on(type: 'activeStateChange', permissionNameList: Array<Permissions>, call
| 参数名 | 类型 | 必填 | 说明 |
| ------------------ | --------------------- | ---- | ------------------------------------------------------------ |
| type | string | 是 | 订阅事件类型,固定为'activeStateChange',权限使用状态变更事件。 |
| permission
Name
List | Array
<
Permissions
>
| 是 | 订阅的权限名列表,为空时表示订阅所有的权限使用状态变化。 |
| permissionList | Array
<
Permissions
>
| 是 | 订阅的权限名列表,为空时表示订阅所有的权限使用状态变化。 |
| callback | Callback
<
[ActiveChangeResponse](#activechangeresponse)
>
| 是 | 订阅指定权限使用状态变更事件的回调。 |
**错误码:**
...
...
@@ -478,9 +478,9 @@ on(type: 'activeStateChange', permissionNameList: Array<Permissions>, call
```
js
import
privacyManager
from
'
@ohos.privacyManager
'
;
let
permission
Name
List
=
[];
let
permissionList
=
[];
try
{
privacyManager
.
on
(
'
activeStateChange
'
,
permission
Name
List
,
(
data
)
=>
{
privacyManager
.
on
(
'
activeStateChange
'
,
permissionList
,
(
data
)
=>
{
console
.
debug
(
"
receive permission state change, data:
"
+
JSON
.
stringify
(
data
));
});
}
catch
(
err
)
{
...
...
@@ -490,7 +490,7 @@ try {
## privacyManager.off
off(type: 'activeStateChange', permission
Name
List: Array
<
Permissions
>
, callback?: Callback
<
ActiveChangeResponse
>
): void;
off(type: 'activeStateChange', permissionList: Array
<
Permissions
>
, callback?: Callback
<
ActiveChangeResponse
>
): void;
取消订阅指定权限列表的权限使用状态变更事件。
...
...
@@ -503,7 +503,7 @@ off(type: 'activeStateChange', permissionNameList: Array<Permissions>, cal
| 参数名 | 类型 | 必填 | 说明 |
| ------------------ | --------------------- | ---- | ------------------------------------------------------------ |
| type | string | 是 | 订阅事件类型,固定为'activeStateChange',权限使用状态变更事件。 |
| permission
Name
List | Array
<
Permissions
>
| 是 | 订阅的权限名列表,为空时表示订阅所有的权限状态变化,必须与on的输入一致。 |
| permissionList | Array
<
Permissions
>
| 是 | 订阅的权限名列表,为空时表示订阅所有的权限状态变化,必须与on的输入一致。 |
| callback | Callback
<
[ActiveChangeResponse](#activechangeresponse)
>
| 否 | 取消订阅指定tokenId与指定权限名状态变更事件的回调。|
**错误码:**
...
...
@@ -513,7 +513,7 @@ off(type: 'activeStateChange', permissionNameList: Array<Permissions>, cal
| 错误码ID | 错误信息 |
| -------- | -------- |
| 12100001 | The parameter is invalid. The permissionName in list is all invalid or the list size is larger than 1024. |
| 12100004 | The interface is not used
with
|
| 12100004 | The interface is not used
together with "on"
|
| 12100007 | Service is abnormal. |
| 12100008 | Out of memory. |
...
...
@@ -522,9 +522,9 @@ off(type: 'activeStateChange', permissionNameList: Array<Permissions>, cal
```
js
import
privacyManager
from
'
@ohos.privacyManager
'
;
let
permission
Name
List
=
[];
let
permissionList
=
[];
try
{
privacyManager
.
off
(
'
activeStateChange
'
,
permission
Name
List
);
privacyManager
.
off
(
'
activeStateChange
'
,
permissionList
);
}
catch
(
err
)
{
console
.
log
(
`catch err->
${
JSON
.
stringify
(
err
)}
`
);
}
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录