harmony 鸿蒙@ohos.systemParameterEnhance (系统参数)

  • 2023-02-17
  • 浏览 (953)

@ohos.systemParameterEnhance (系统参数)

系统参数(SystemParameter)是为各系统服务提供的简单易用的键值对访问接口,各个系统服务可以定义系统参数来描述该服务的状态信息,或者通过系统参数来改变系统服务的行为。其基本操作原语为get和set,通过get可以查询系统参数的值,通过set可以修改系统参数的值。 详细的系统参数设计原理及定义可参考系统参数

说明:

  • 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
  • 本模块接口为系统接口。
  • 由于系统参数都是各个系统服务的内部信息和控制参数,每个系统参数都有各自不同的DAC和MAC访问控制权限,三方应用不能使用此类接口。

导入模块

import systemparameter from '@ohos.systemParameterEnhance';

systemparameter.getSync

getSync(key: string, def?: string): string

获取系统参数Key对应的值。

系统能力: SystemCapability.Startup.SystemInfo

参数:

参数名 类型 必填 说明
key string 待查询的系统参数Key。
def string def为所要获取的系统参数的默认值
def为可选参数,仅当系统参数不存在时生效
def可以传undefined或自定义的任意值

返回值:

类型 说明
string 系统参数值
若key存在,返回设定的值。
若key不存在且def有效,返回def;若未指定def或def无效(如undefined),抛异常。

错误码

错误码ID 错误信息
14700101 if key is not found
14700103 if permission denied
14700104 if system internal error

以上错误码详细介绍请参考errorcode-system-parameterV9

示例:

try {
    let info: string = 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> 回调函数。

错误码

错误码ID 错误信息
14700101 if key is not found
14700103 if permission denied
14700104 if system internal error

以上错误码详细介绍请参考errorcode-system-parameterV9

示例:

import { BusinessError } from '@ohos.base';

try {
    systemparameter.get("const.ohos.apiversion", (err: BusinessError, data: string) => {
    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> 回调函数。

错误码

错误码ID 错误信息
14700101 if key is not found
14700103 if permission denied
14700104 if system internal error

以上错误码详细介绍请参考errorcode-system-parameterV9

示例:

import { BusinessError } from '@ohos.base';

try {
    systemparameter.get("const.ohos.apiversion", "default", (err: BusinessError, data: string) => {
        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 def为所要获取的系统参数的默认值
def为可选参数,仅当系统参数不存在时生效
def可以传undefined或自定义的任意值

返回值:

类型 说明
Promise<string> Promise示例,用于异步获取结果。

错误码

错误码ID 错误信息
14700101 if key is not found
14700103 if permission denied
14700104 if system internal error

以上错误码详细介绍请参考errorcode-system-parameterV9

示例:

import { BusinessError } from '@ohos.base';

try {
    let p: Promise<string> = systemparameter.get("const.ohos.apiversion");
    p.then((value: string) => {
        console.log("get test.parameter.key success: " + value);
    }).catch((err: BusinessError) => {
        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 待设置的系统参数值。

错误码

错误码ID 错误信息
14700102 if value is invalid
14700103 if permission denied
14700104 if system internal error

以上错误码详细介绍请参考errorcode-system-parameterV9

示例:

import { BusinessError } from '@ohos.base';

try {
    systemparameter.setSync("test.parameter.key", "default");
} catch(e) {
    console.log("set unexpected error: " + e);
}

systemparameter.set

set(key: string, value: string, callback: AsyncCallback&lt;void&gt;): void

设置系统参数Key对应的值。

系统能力: SystemCapability.Startup.SystemInfo

参数:

参数名 类型 必填 说明
key string 待设置的系统参数Key。
value string 待设置的系统参数值。
callback AsyncCallback&lt;void&gt; 回调函数。

错误码

错误码ID 错误信息
14700102 if value is invalid
14700103 if permission denied
14700104 if system internal error

以上错误码详细介绍请参考errorcode-system-parameterV9

示例:

import { BusinessError } from '@ohos.base';

try {
    systemparameter.set("test.parameter.key", "testValue", (err: BusinessError, data: void) => {
    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&lt;void&gt;

设置系统参数Key对应的值。

系统能力: SystemCapability.Startup.SystemInfo

参数:

参数名 类型 必填 说明
key string 待设置的系统参数Key。
value string 待设置的系统参数值。

返回值:

类型 说明
Promise&lt;void&gt; Promise示例,用于异步获取结果。

错误码

错误码ID 错误信息
14700102 if value is invalid
14700103 if permission denied
14700104 if system internal error

以上错误码详细介绍请参考errorcode-system-parameterV9

示例:

import { BusinessError } from '@ohos.base';

try {
    let p: Promise<void>  = systemparameter.set("test.parameter.key", "testValue");
    p.then((value: void) => {
        console.log("set test.parameter.key success: " + value);
    }).catch((err: BusinessError) => {
        console.log(" set test.parameter.key error: " + err.code);
    });
} catch(e) {
    console.log("set unexpected error: " + e);
}

你可能感兴趣的鸿蒙文章

harmony 鸿蒙接口

harmony 鸿蒙系统公共事件定义(待停用)

harmony 鸿蒙系统公共事件定义

harmony 鸿蒙开发说明

harmony 鸿蒙企业设备管理概述(仅对系统应用开放)

harmony 鸿蒙BundleStatusCallback

harmony 鸿蒙@ohos.bundle.innerBundleManager (innerBundleManager模块)

harmony 鸿蒙@ohos.distributedBundle (分布式包管理)

harmony 鸿蒙@ohos.bundle (Bundle模块)

harmony 鸿蒙@ohos.enterprise.EnterpriseAdminExtensionAbility (企业设备管理扩展能力)

0  赞