# 设置

## has.openSetting

has.openSetting(Object object)

调起元服务设置界面，并返回用户设置的操作结果。

**起始版本：** 1.0.0

**参数：**

参数为Object对象，包括以下字段。

|参数|类型|必填|描述|
|:-------|:-------|:-|:-------------------------------------|
|success|function|否|接口调用成功的回调函数。 从1.0.7版本开始，以键值对的形式返回授权结果。|
|fail|function|否|接口调用失败的回调函数。|
|complete|function|否|接口调用结束的回调函数（调用成功、失败都会执行）。|

**success返回值：**

|参数|类型|描述|
|:----------|:-----|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|authSetting|Object|以键值对的形式返回[授权](https://developer.huawei.com/consumer/cn/doc/atomic-ascf/develop-authorization)结果。例如： { "scope.userLocation": true, "scope.userFuzzyLocation": true, "scope.camera": false, "scope.record": false, "scope.bluetooth": true, "scope.addPhoneCalendar": false }。 **起始版本：** 1.0.7|

**错误码信息：**

|错误码|错误信息|
|:-------|:---------------------------------------------------------------------------------------------------------------------------|
|101|context is undefined.|
|11000501|openSetting error. 更多错误信息参考：[元能力子系统错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-ability)|

**示例：**

```js
has.openSetting({
  success: (res) => {
    console.info('openSetting success', res);
  },
  fail: (err) => {
    console.error('openSetting fail', err);
  },
  complete: (res) => {
    console.info('openSetting complete', res);
  }
});
```

## has.getSetting

has.getSetting(Object object)

获取用户的当前设置。**返回值中只会出现元服务已经向用户请求过的权限**。

**起始版本：** 1.0.4

**参数：**

|参数|类型|必填|描述|
|:-------|:-------|:-|:------------------------|
|success|function|否|接口调用成功的回调函数。|
|fail|function|否|接口调用失败的回调函数。|
|complete|function|否|接口调用结束的回调函数（调用成功、失败都会执行）。|

**success返回值：**

|参数|类型|描述|
|:----------|:-----|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|authSetting|Object|以键值对的形式返回[授权](https://developer.huawei.com/consumer/cn/doc/atomic-ascf/develop-authorization)结果。例如： { "scope.userLocation": true, "scope.userFuzzyLocation": true, "scope.camera": false, "scope.record": false, "scope.bluetooth": true, "scope.addPhoneCalendar": false }。|

**错误码信息：**

|错误码|错误信息|
|:-------|:-------------------------------------------------------|
|101|1. operation failed. 2. applicationContext is undefined.|
|11000901|1. get authSetting fail. 2. getSetting error.|

**示例：**

```js
has.getSetting({
  success: (res) => {
    let authSetting = res.authSetting;
    console.info('getSetting success', res);
  },
  fail: (err) => {
    console.error('getSetting fail', err);
  },
  complete: (res) => {
    console.info('getSetting complete', res);
  }
});
```