Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
083c79a9
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看板
提交
083c79a9
编写于
10月 13, 2022
作者:
C
chengjinsong2
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
V9 systemparamter刷新
Signed-off-by:
N
chengjinsong2
<
chengjinsong2@huawei.com
>
上级
d4c9246b
变更
2
隐藏空白更改
内联
并排
Showing
2 changed file
with
268 addition
and
15 deletion
+268
-15
zh-cn/application-dev/reference/apis/js-apis-system-parameter.md
...pplication-dev/reference/apis/js-apis-system-parameter.md
+15
-15
zh-cn/application-dev/reference/apis/js-apis-system-parameterV9.md
...lication-dev/reference/apis/js-apis-system-parameterV9.md
+253
-0
未找到文件。
zh-cn/application-dev/reference/apis/js-apis-system-parameter.md
浏览文件 @
083c79a9
...
...
@@ -12,11 +12,11 @@
## 导入模块
```
ts
import
parameter
from
'
@ohos.systemparameter
'
import
system
parameter
from
'
@ohos.systemparameter
'
```
## parameter.getSync
##
system
parameter.getSync
getSync(key: string, def?: string): string
...
...
@@ -41,7 +41,7 @@ getSync(key: string, def?: string): string
```
ts
try
{
var
info
=
parameter
.
getSync
(
"
const.ohos.apiversion
"
);
var
info
=
system
parameter
.
getSync
(
"
const.ohos.apiversion
"
);
console
.
log
(
JSON
.
stringify
(
info
));
}
catch
(
e
){
console
.
log
(
"
getSync unexpected error:
"
+
e
);
...
...
@@ -49,7 +49,7 @@ try {
```
## parameter.get
##
system
parameter.get
get(key: string, callback: AsyncCallback
<
string
>
): void
...
...
@@ -68,7 +68,7 @@ get(key: string, callback: AsyncCallback<string>): void
```
ts
try
{
parameter
.
get
(
"
const.ohos.apiversion
"
,
function
(
err
,
data
)
{
system
parameter
.
get
(
"
const.ohos.apiversion
"
,
function
(
err
,
data
)
{
if
(
err
==
undefined
)
{
console
.
log
(
"
get test.parameter.key value success:
"
+
data
)
}
else
{
...
...
@@ -80,7 +80,7 @@ try {
```
## parameter.get
##
system
parameter.get
get(key: string, def: string, callback: AsyncCallback
<
string
>
): void
...
...
@@ -100,7 +100,7 @@ get(key: string, def: string, callback: AsyncCallback<string>): void
```
ts
try
{
parameter
.
get
(
"
const.ohos.apiversion
"
,
"
default
"
,
function
(
err
,
data
)
{
system
parameter
.
get
(
"
const.ohos.apiversion
"
,
"
default
"
,
function
(
err
,
data
)
{
if
(
err
==
undefined
)
{
console
.
log
(
"
get test.parameter.key value success:
"
+
data
)
}
else
{
...
...
@@ -113,7 +113,7 @@ try {
```
## parameter.get
##
system
parameter.get
get(key: string, def?: string): Promise
<
string
>
...
...
@@ -138,7 +138,7 @@ get(key: string, def?: string): Promise<string>
```
ts
try
{
var
p
=
parameter
.
get
(
"
const.ohos.apiversion
"
);
var
p
=
system
parameter
.
get
(
"
const.ohos.apiversion
"
);
p
.
then
(
function
(
value
)
{
console
.
log
(
"
get test.parameter.key success:
"
+
value
);
}).
catch
(
function
(
err
)
{
...
...
@@ -150,7 +150,7 @@ try {
```
## parameter.setSync
##
system
parameter.setSync
setSync(key: string, value: string): void
...
...
@@ -169,14 +169,14 @@ setSync(key: string, value: string): void
```
ts
try
{
parameter
.
setSync
(
"
test.parameter.key
"
,
"
default
"
);
system
parameter
.
setSync
(
"
test.parameter.key
"
,
"
default
"
);
}
catch
(
e
){
console
.
log
(
"
set unexpected error:
"
+
e
);
}
```
## parameter.set
##
system
parameter.set
set(key: string, value: string, callback: AsyncCallback
<
void
>
): void
...
...
@@ -196,7 +196,7 @@ set(key: string, value: string, callback: AsyncCallback<void>): void
```
ts
try
{
parameter
.
set
(
"
test.parameter.key
"
,
"
testValue
"
,
function
(
err
,
data
)
{
system
parameter
.
set
(
"
test.parameter.key
"
,
"
testValue
"
,
function
(
err
,
data
)
{
if
(
err
==
undefined
)
{
console
.
log
(
"
set test.parameter.key value success :
"
+
data
)
}
else
{
...
...
@@ -208,7 +208,7 @@ try {
```
## parameter.set
##
system
parameter.set
set(key: string, value: string): Promise
<
void
>
...
...
@@ -233,7 +233,7 @@ set(key: string, value: string): Promise<void>
```
ts
try
{
var
p
=
para
.
set
(
"
test.parameter.key
"
,
"
testValue
"
);
var
p
=
systemparameter
.
set
(
"
test.parameter.key
"
,
"
testValue
"
);
p
.
then
(
function
(
value
)
{
console
.
log
(
"
set test.parameter.key success:
"
+
value
);
}).
catch
(
function
(
err
)
{
...
...
zh-cn/application-dev/reference/apis/js-apis-system-parameterV9.md
0 → 100755
浏览文件 @
083c79a9
# 系统参数
系统参数(SystemParameter)是为各系统服务提供的简单易用的键值对访问接口,各个系统服务可以定义系统参数来描述该服务的状态信息,或者通过系统参数来改变系统服务的行为。其基本操作原语为get和set,通过get可以查询系统参数的值,通过set可以修改系统参数的值。
详细的系统参数设计原理及定义可参考
[
系统参数
](
../../../device-dev/subsystems/subsys-boot-init-sysparam.md
)
。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> - 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
> - 由于系统参数都是各个系统服务的内部信息和控制参数,每个系统参数都有各自不同的DAC和MAC访问控制权限,三方应用不能使用此类接口。
## 导入模块
```
ts
import
systemparameter
from
'
@ohos.systemparameterV9
'
```
**错误码说明:**
| 错误码 | 定义名 | 说明 |
| -------- | -------- | -------- |
| -401 | SYSPARAM_INVALID_INPUT | Input parameter is missing or invalid. |
| -14700101 | SYSPARAM_NOT_FOUND | System parameter can not be found. |
| -14700102 | SYSPARAM_INVALID_VALUE | System parameter value is invalid. |
| -14700103 | SYSPARAM_PERMISSION_DENIED | System permission operation permission denied. |
| -14700104 | SYSPARAM_SYSTEM_ERROR | System internal error including out of memory, deadlock etc. |
| -14700105 | SYSPARAM_WAIT_TIMEOUT | System wait parameter value change time out. |
## systemparameter.getSync
getSync(key: string, def?: string): string
获取系统参数Key对应的值。
**系统能力:**
SystemCapability.Startup.SystemInfo
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| key | string | 是 | 待查询的系统参数Key。 |
| def | string | 否 | 默认值。 |
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| string | 系统参数值,若key不存在,返回默认值。若未指定默认值,返回空字符串。 |
**示例:**
```
ts
try
{
var
info
=
systemparameter
.
getSync
(
"
const.ohos.apiversion
"
);
console
.
log
(
JSON
.
stringify
(
info
));
}
catch
(
e
){
console
.
log
(
"
getSync unexpected error:
"
+
e
);
}
```
## systemparameter.get
get(key: string, callback: AsyncCallback
<
string
>
): void
获取系统参数Key对应的值。
**系统能力:**
SystemCapability.Startup.SystemInfo
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| key | string | 是 | 待查询的系统参数Key。 |
| callback | AsyncCallback
<
string
>
| 是 | 回调函数。 |
**示例:**
```
ts
try
{
systemparameter
.
get
(
"
const.ohos.apiversion
"
,
function
(
err
,
data
)
{
if
(
err
==
undefined
)
{
console
.
log
(
"
get test.parameter.key value success:
"
+
data
)
}
else
{
console
.
log
(
"
get test.parameter.key value err:
"
+
err
.
code
)
}});
}
catch
(
e
){
console
.
log
(
"
get unexpected error:
"
+
e
);
}
```
## systemparameter.get
get(key: string, def: string, callback: AsyncCallback
<
string
>
): void
获取系统参数Key对应的值。
**系统能力:**
SystemCapability.Startup.SystemInfo
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| key | string | 是 | 待查询的系统参数Key。 |
| def | string | 是 | 默认值。 |
| callback | AsyncCallback
<
string
>
| 是 | 回调函数。 |
**示例:**
```
ts
try
{
systemparameter
.
get
(
"
const.ohos.apiversion
"
,
"
default
"
,
function
(
err
,
data
)
{
if
(
err
==
undefined
)
{
console
.
log
(
"
get test.parameter.key value success:
"
+
data
)
}
else
{
console
.
log
(
"
get test.parameter.key value err:
"
+
err
.
code
)
}
});
}
catch
(
e
){
console
.
log
(
"
get unexpected error:
"
+
e
)
}
```
## systemparameter.get
get(key: string, def?: string): Promise
<
string
>
获取系统参数Key对应的值。
**系统能力:**
SystemCapability.Startup.SystemInfo
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| key | string | 是 | 待查询的系统参数Key。 |
| def | string | 否 | 默认值。 |
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
string
>
| Promise示例,用于异步获取结果。 |
**示例:**
```
ts
try
{
var
p
=
systemparameter
.
get
(
"
const.ohos.apiversion
"
);
p
.
then
(
function
(
value
)
{
console
.
log
(
"
get test.parameter.key success:
"
+
value
);
}).
catch
(
function
(
err
)
{
console
.
log
(
"
get test.parameter.key error:
"
+
err
.
code
);
});
}
catch
(
e
){
console
.
log
(
"
get unexpected error:
"
+
e
);
}
```
## systemparameter.setSync
setSync(key: string, value: string): void
设置系统参数Key对应的值。
**系统能力:**
SystemCapability.Startup.SystemInfo
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| key | string | 是 | 待设置的系统参数Key。 |
| value | string | 是 | 待设置的系统参数值。 |
**示例:**
```
ts
try
{
systemparameter
.
setSync
(
"
test.parameter.key
"
,
"
default
"
);
}
catch
(
e
){
console
.
log
(
"
set unexpected error:
"
+
e
);
}
```
## systemparameter.set
set(key: string, value: string, callback: AsyncCallback
<
void
>
): void
设置系统参数Key对应的值。
**系统能力:**
SystemCapability.Startup.SystemInfo
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| key | string | 是 | 待设置的系统参数Key。 |
| value | string | 是 | 待设置的系统参数值。 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数。 |
**示例:**
```
ts
try
{
systemparameter
.
set
(
"
test.parameter.key
"
,
"
testValue
"
,
function
(
err
,
data
)
{
if
(
err
==
undefined
)
{
console
.
log
(
"
set test.parameter.key value success :
"
+
data
)
}
else
{
console
.
log
(
"
set test.parameter.key value err:
"
+
err
.
code
)
}});
}
catch
(
e
){
console
.
log
(
"
set unexpected error:
"
+
e
);
}
```
## systemparameter.set
set(key: string, value: string): Promise
<
void
>
设置系统参数Key对应的值。
**系统能力:**
SystemCapability.Startup.SystemInfo
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| key | string | 是 | 待设置的系统参数Key。 |
| value| string | 是 | 待设置的系统参数值。 |
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
void
>
| Promise示例,用于异步获取结果。 |
**示例:**
```
ts
try
{
var
p
=
systemparameter
.
set
(
"
test.parameter.key
"
,
"
testValue
"
);
p
.
then
(
function
(
value
)
{
console
.
log
(
"
set test.parameter.key success:
"
+
value
);
}).
catch
(
function
(
err
)
{
console
.
log
(
"
set test.parameter.key error:
"
+
err
.
code
);
});
}
catch
(
e
){
console
.
log
(
"
set unexpected error:
"
+
e
);
}
```
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录