@ohos.systemParameter (系统属性)

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

说明：

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

导入模块

import systemparameter from '@ohos.systemparameter'

systemparameter.getSync^(deprecated)

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

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

系统能力： SystemCapability.Startup.SystemInfo

参数：

返回值：

示例：

try {
    var info = systemparameter.getSync("const.ohos.apiversion");
    console.log(JSON.stringify(info));
}catch(e){
    console.log("getSync unexpected error: " + e);
}

systemparameter.get^(deprecated)

get(key: string, callback: AsyncCallback<string>): void

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

系统能力： SystemCapability.Startup.SystemInfo

参数：

示例：

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^(deprecated)

get(key: string, def: string, callback: AsyncCallback<string>): void

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

系统能力： SystemCapability.Startup.SystemInfo

参数：

示例：

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^(deprecated)

get(key: string, def?: string): Promise<string>

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

系统能力： SystemCapability.Startup.SystemInfo

参数：

返回值：

示例：

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^(deprecated)

setSync(key: string, value: string): void

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

系统能力： SystemCapability.Startup.SystemInfo

参数：

说明：

• 此接口只能用于系统应用的参数设置。
• 所授权的系统应用需要配置对应selinux和dac规则，具体配置方法请参照系统参数指导文档:系统参数。

示例：

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

systemparameter.set^(deprecated)

set(key: string, value: string, callback: AsyncCallback<void>): void

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

系统能力： SystemCapability.Startup.SystemInfo

参数：

说明：

• 此接口只能用于系统应用的参数设置。
• 所授权的系统应用需要配置对应selinux和dac规则，具体配置方法请参照系统参数指导文档:系统参数。

示例：

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^(deprecated)

set(key: string, value: string): Promise<void>

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

系统能力： SystemCapability.Startup.SystemInfo

参数：

返回值：

说明：

• 此接口只能用于系统应用的参数设置。
• 所授权的系统应用需要配置对应selinux和dac规则，具体配置方法请参照系统参数指导文档:系统参数

示例：

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);
}