---
url: /api-proxy/device/screen/getScreenBrightness.md
---
## mpx.getScreenBrightness(Object object)

获取屏幕亮度

支持情况： 微信、支付宝

[参考文档](https://developers.weixin.qq.com/miniprogram/dev/api/device/screen/wx.getScreenBrightness.html)

### 参数 {#parameters}

**Object object**

| 属性    | 类型     | 默认值 | 必填 | 说明                 |
| ------- | -------- | ------ | ---- | -------------------- |
| success | function |        | 否   | 接口调用成功的回调函数 |
| fail    | function |        | 否   | 接口调用失败的回调函数 |
|complete |	function	||	否	| 接口调用结束的回调函数（调用成功、失败都会执行）|

**object.success 回调函数**

**参数**

**Object object**

| 属性  | 类型   | 说明                                 |
| ----- | ------ | ------------------------------------ |
| value | number | 屏幕亮度值，范围 0 ~ 1，0 最暗，1 最亮 |